stash

Simple password manager shell script
Log | Files | Refs | README

README.md (1778B)


      1 # STA.SH
      2 Sta.sh is a simple password mananger shell script.
      3 
      4 ## Features
      5 - Simple keyboard-driven UI via [tofi](https://github.com/philj56/tofi)
      6   - Wayland-only. I might add support for
      7     [dmenu](https://tools.suckless.org/dmenu) as an x11 option in the future.
      8 - Securely encrypted data via [age](https://age-encryption.org/)
      9   - All information is encrypted by a master key, which itself is encrypted by a
     10     master password of the user's choice.
     11 - OTP 2FA via [oath-toolkit](https://oath-toolkit.codeberg.page/)
     12   - Simply set the otp field to your secret and the 6-digit code will be
     13     automatically generated when you access it.
     14 - Arbitrary fields
     15   - When in the 'modify' menu for a login, you can simply type anything and it
     16     will be saved as a field.
     17 - Quick logins
     18   - When quick login is activated for a certain account, it will queue existing
     19     username, password and otp fields in that order onto your clipboard. This
     20     means you can just hit paste 3 times and they will automatically be pasted
     21     in the right order. I found this was a good balance between a browser
     22     extension auto-filling fields and manually copying them.
     23 
     24 ## Motivation
     25 I've been feeling dissatisfied with contemporary password managers, so I decided
     26  to write my own. I am pretty happy with the result.
     27  
     28 ## TODO
     29 - Add the ability to initialize sta.sh outside of the terminal
     30   - I'm either going to have to patch age again to support this or use some kind
     31     of multiplexer to simulate user input.
     32 - Require master password when changing fields
     33   - It's one thing to require a password to decrypt information, but it's still
     34     too easy to just overwrite all of someone's information in order to lock
     35     them out.
     36 - Rewrite in C / Rust?
     37   - Would be more secure (I think).