awiteb/lprs
1
Fork 0
Code Issues 2 Pull requests Releases 3 Activity Actions
A local vault manager designed to securely store and manage your vaults https://lprs.4rs.nl
21 commits 1 branch 8 tags 507 KiB
Rust 98.4%
Just 1.6%
Find a file
Mohammed Alotaibi 6ae8dfb2a3
Merge pull request #6 from TheAwiteb/fix-issue-5 
Backward compatibility
2023-12-25 17:08:47 +03:00
src Use #[serde_with_macros::skip_serializing_none] on Password struct 2023-12-25 17:06:40 +03:00
.gitignore Add .gitignore 2023-12-23 22:48:32 +03:00
Cargo.lock Add serde_with_macros to dependencies 2023-12-25 17:05:23 +03:00
Cargo.toml Add serde_with_macros to dependencies 2023-12-25 17:05:23 +03:00
CONTRIBUTING.md Add README.md and CONTRIBUTING.md 2023-12-23 23:28:14 +03:00
LICENSE Add the license 2023-12-23 22:48:59 +03:00
README.md Update README.md 2023-12-25 04:41:25 +03:00

README.md

Passrs

Passrs is a local password manager designed to securely store and manage your passwords.

Installation

To install Passrs, you will need to have the Cargo package manager installed. If you do not have Cargo installed, you can install it by following the instructions here. Note the Minimum Supported Rust Version (MSRV) for Passrs is 1.70.0.

  1. Clone the Passrs repository:

    cargo install --locked --git https://github.com/theawiteb/passrs.git

  2. Run Passrs:

    passrs --help

Uninstallation

cargo uninstall passrs

Usage

Passrs provides a command-line interface for managing your passwords. The following commands are available:

Local CLI password manager

Usage: passrs [OPTIONS] <COMMAND>

Commands:
  add    Add new password
  remove  Remove password
  list   List your password and search
  clean  Clean the password file
  edit   Edit the password content
  gen    Generate password
  help   Print this message or the help of the given subcommand(s)

Options:
  -p, --passwords-file <PASSWORDS_FILE>
          The passwords json file, default: $HOME/.local/share/passrs/passwords.json
  -h, --help
          Print help
  -V, --version
          Print version

Example

passrs add -n "Gmail" -u "some@gmail.com" -p $(passrs gen 19 -u -l -s) -s "https://mail.google.com"

Result

This is the result when search for it

$ passrs list -e "mail" -p -s
Master Password: ***************
+-------+-------+----------------+---------------------+-------------------------+
| Index | Name  | Username       | Password            | Service                 |
+================================================================================+
| 31    | Gmail | some@gmail.com | >NC`q$%+Nno<y&<y]VB | https://mail.google.com |
+-------+-------+----------------+---------------------+-------------------------+

Contributing

Contributions to Passrs are welcome! If you would like to contribute, please follow the guidelines outlined in the CONTRIBUTING file.

License

Passrs is licensed under the GPL-3.0 License. This means that you are free to use, modify, and distribute the software under the terms of this license. Please refer to the LICENSE file for more details.