https://github.com/luizvilasboas/app-passwordmanager
Simple password manager for adding, listing, editing, deleting, and copying passwords to the clipboard
https://github.com/luizvilasboas/app-passwordmanager
cli-app perl
Last synced: 9 months ago
JSON representation
Simple password manager for adding, listing, editing, deleting, and copying passwords to the clipboard
- Host: GitHub
- URL: https://github.com/luizvilasboas/app-passwordmanager
- Owner: luizvilasboas
- License: mit
- Created: 2025-07-06T14:33:07.000Z (12 months ago)
- Default Branch: main
- Last Pushed: 2025-08-31T18:11:04.000Z (10 months ago)
- Last Synced: 2025-08-31T20:27:16.208Z (10 months ago)
- Topics: cli-app, perl
- Language: Perl
- Homepage:
- Size: 11.7 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# App-PasswordManager
`App::PasswordManager` is a command-line password manager written in Perl. It allows users to securely add, list, edit, remove, and copy passwords. The passwords are stored in an encrypted format using PBKDF2 and saved in a JSON file located in the user's home directory.
## Features
- **Add Password**: Add a new password entry for a specific login.
- **List Passwords**: Display a list of all stored logins.
- **Edit Password**: Edit the password for an existing login.
- **Remove Password**: Delete a password entry for a specific login.
- **Copy to Clipboard**: Copy the password to the clipboard for easy use.
- **Encrypted Storage**: Passwords are securely stored in an encrypted format in a JSON file in the user's home directory.
## Installation
You can install `App::PasswordManager` manually or from [MetaCPAN](https://metacpan.org/dist/App-PasswordManager).
### Manual Installation
1. Clone or download the repository.
2. Navigate to the project directory.
3. Run the following commands to build and install the module:
```
perl Makefile.PL
make
sudo make install
```
### MetaCPAN
1. User [cpanm](https://metacpan.org/dist/App-cpanminus/view/lib/App/cpanminus/fatscript.pm) to install the app:
```
cpanm install App::TodoList
```
## Usage
### Command-Line Tool
After installation, you can use the password manager via the command-line interface. The following options are available:
```
password_manager --add # Add a new password
password_manager --list # List all passwords
password_manager --edit # Edit a password
password_manager --remove # Remove a password
password_manager --copy # Copy the password to the clipboard
```
For example, to add a password:
```
password_manager --add "user1" "mysecretpassword"
```
To list all passwords:
```
password_manager --list
```
To edit a password:
```
password_manager --edit "user1" "newpassword"
```
To remove a password:
```
password_manager --remove "user1"
```
To copy a password to the clipboard:
```
password_manager --copy "user1"
```
## Dependencies
- `Crypt::PBKDF2`
- `File::HomeDir`
- `File::Spec`
- `JSON`
You can install the necessary dependencies via `cpanm`:
```
cpanm Crypt::PBKDF2 File::HomeDir File::Spec JSON
```
## Contributing
1. Fork the repository.
2. Create a new branch (`git checkout -b feature-branch`).
3. Make your changes.
4. Commit your changes (`git commit -am 'Add new feature'`).
5. Push to the branch (`git push origin feature-branch`).
6. Create a merge request.
## License
This project is licensed under the MIT License - see the [MIT](https://github.com/luizvilasboas/App-PasswordManager/blob/main/LICENSE) file for details.