apm

Simple pass(1) implementation
git clone https://codeberg.org/night0721/apm
Log | Files | Refs | README | LICENSE

README.md (1159B)


      1 # apm
      2 apm, argon password manager; a simple implementation of [pass](https://www.passwordstore.org/)(1) in C.  It uses a unique key to encrypt every password, it provides functionality to edit, add, generate, show, list, remove passwords. It uses argon2 to create hash of master password and uses XSalsa20 to encrypt the password.
      3 
      4 > The name "argon" is chosen as it uses argon2 algorithm and sodium(library) is stored with argon.
      5 
      6 Before using apm, you must export 2 environment variables in order to make it work
      7 ```sh
      8 export APM_DIR=~/secret/apm
      9 export APM_KEY=~/secret/apm_key
     10 ```
     11 
     12 `APM_DIR` is the directory where passwords are stored and `APM_KEY` is the path to the master key file.
     13 
     14 # Usage
     15 ```
     16 Usage: apm [-vhL] [[-e | -R | -I | -Q] <password>] [-M <file>] [-G <password> <length>]
     17 ```
     18 
     19 # Dependencies
     20 - libsodium 
     21 
     22 # Building
     23 You will need to run these with elevated privilages.
     24 ```
     25 $ make
     26 # make install
     27 ```
     28 
     29 # Contributions
     30 Contributions are welcomed, feel free to open a pull request.
     31 
     32 # License
     33 This project is licensed under the GNU Public License v3.0. See [LICENSE](https://github.com/night0721/apm/blob/master/LICENSE) for more information.