2 releases

0.1.5 Feb 16, 2024
0.1.4 Feb 16, 2024

#196 in Authentication

MIT license

18KB
443 lines

About

Quick Password Manager is a password manager written in Rust. It uses encryption, which helps you store passwords securely.

Installation

First of all, install the required dependencies in order to build qpm.

Distribution Instructions
Debian, Ubuntu, Kali apt install libsqlite3-dev gcc
Arch pacman -S sqlite gcc
Void xbps-install -S sqlite-devel gcc
Gentoo emerge dev-db/sqlite sys-devel/gcc
Fedora dnf install sqlite-devel gcc

You will also need to install Rust using rustup(recommended). Run the following in your terminal, then follow the onscreen instructions:

curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh

Next, you can choose two installation paths: through the cargo package manager or compile it yourself from sources

Install via cargo

Run the following command in your terminal:

cargo install qpm --locked

Install from sources

Step 1.

Clone the repository:

git clone https://github.com/khimchuk/qpm-cli.git

Step 2.

Install qpm using quick. Go to the qpm directory (qpm-cli by default) and run the following command:

./quick install

Verify that qpm was successfully installed:

$ qpm --version
Quick Password Manager 0.1.3

How to use?

When adding a password, you need to enter your secret. A secret is a universal key to your passwords. It can be unique for everyone, you can also come up with your own secret for each password or group of passwords, you are not limited in this way. The main advantage is that qpm does not report whether the password was decrypted correctly, so you need to remember the secret, otherwise if you enter the wrong secret you will get an incorrectly decrypted password.

You can learn about all the functions of qpm by running the command qpm --help in your terminal.

$ qpm --help
Usage: qpm [OPTION]
       qpm [OPTION] [ARGUMENT]

Options:
    -h, --help              help message.
    -V, --version           qpm version.

     s, set [NAME]          set password. 
     g, get                 get password.
     d, delete              remove password.
     r, rename              rename password.
     l, list                get all password names.
     
Type for more information:
    qpm help [OPTION]

Report bugs to <khimchuk.io@gmail.com>

You can also find out how to use a specific function by running the command qpm help [OPTION]. For example:

$ qpm help l
Usage: qpm list
       qpm l

License

Quick Password Manager is released under the MIT License. You can find a copy of the license text here: LICENSE

Dependencies

~21–30MB
~454K SLoC