https://github.com/techgaun/saancho
:closed_lock_with_key: :lock: :key: Command Line Password Manager
https://github.com/techgaun/saancho
gpg password-generator password-manager
Last synced: about 1 year ago
JSON representation
:closed_lock_with_key: :lock: :key: Command Line Password Manager
- Host: GitHub
- URL: https://github.com/techgaun/saancho
- Owner: techgaun
- License: apache-2.0
- Created: 2016-11-16T07:32:56.000Z (over 9 years ago)
- Default Branch: master
- Last Pushed: 2018-10-02T22:41:21.000Z (over 7 years ago)
- Last Synced: 2025-02-11T21:51:21.420Z (over 1 year ago)
- Topics: gpg, password-generator, password-manager
- Language: Shell
- Homepage:
- Size: 26.4 KB
- Stars: 3
- Watchers: 4
- Forks: 1
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# saancho
> Command Line Password Manager
Saancho (Key) is a command line password manager that uses [gnupg](https://www.gnupg.org/) and AES256 symmetric encryption (AES256). All you have to remember is a single passphrase for your _saancho_ store and you are good to go. If you have used LastPass or Keepass, Saancho is similar thing but CLI based, small, simple and does exactly what I needed.
Implementation of Saancho is plain simple. All it does is use a file (defaults to `$HOME/.saancho.gpg` and overridable via `$SAANCHO_FILE` environment variable) to store the appropriate data and use grep and gpg (gpg2 is favored over gpg) commands.
## Installation
- Fire up your terminal and copy and run the following command:
```shell
sudo wget "https://raw.githubusercontent.com/nepalihackers/saancho/master/saancho" -O /usr/bin/saancho && sudo chmod +x /usr/bin/saancho
```
## Usage
Assuming you have done a global install of `saancho`, you can run it as:
```
$ saancho
Enter the passphrase for your saancho store:
Options available
c - create new credential
r - read existing credential
d - delete credential
b - backup credentials
i - delete credential file(re-initialize)
p - change the passphrase for saancho
e - exit Saancho
Enter the action you wish to perform:
```
- The keystore is saved at `$HOME/.saancho.gpg` but if you wish to customize that, you can set `$SAANCHO_FILE` environment variable to whatever path you wish.
- Saancho can copy password to your clipboard automatically if your search yields single result. This is not enabled by default and can be enabled
by setting `SAANCHO_CLIPBOARD` env-var to `true`
## Features
- safe storage of password data (make sure to choose good passphrase)
- create/search/read/delete credentials
- random password generation
- copy to clipboard feature for single search results and for randomly generated passwords
- change the passphrase of the keystore
## Development
There's a [Dockerfile](Dockerfile) that you can use to locally test saancho during development.
##### Build a docker image
```shell
docker build -t nepalihackers/saancho .
```
##### Run the image
```shell
docker run --name s1 -it nepalihackers/saancho saancho
```
##### Restart if you exit the container
```shell
docker start s1
```
##### Execute saancho again
```shell
docker exec -it s1 saancho
```
## To Do
- ~~Implement random password generation~~
- Implement backup feature to backup to one of the cloud services (yet to figure out what service)
- ~~Implement Copy to clipboard option~~