qpm

Crates.io	qpm
lib.rs	qpm
version	0.1.5
source	src
created_at	2024-02-14 18:46:19.262774
updated_at	2024-02-16 20:45:19.538892
description	Quick command line password manager written in Rust.
homepage
repository	https://github.com/khimchuk/qpm-cli
max_upload_size
id	1140139
size	29,633

Andrew Khimchuk (khimchuk)

documentation

https://docs.rs/crate/qpm/latest

README

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

Commit count: 0

qpm