onilock 1.6.1

Password Manager CLI

OniLock - Secure Password Manager CLI

OniLock is a command-line password manager that allows you to securely store, retrieve, and manage your passwords with ease. Designed for simplicity and security, OniLock offers encryption and clipboard integration to keep your credentials safe.

📖 Introduction

Most password managers focus on graphical interfaces, leaving terminal enthusiasts behind. Onilock changes that by offering a sleek, terminal-based user experience paired with a comprehensive set of command-line options.

It’s designed for those working without a graphical interface, users who need quick password access over SSH, or anyone who simply prefers the command line over traditional GUI tools.

With full support for command-line arguments, Onilock empowers users to create custom aliases and streamline password management to fit their unique workflows.

🚀 Features

• Initialize a secure profile using onilock init
• Store new accounts with onilock new
• List stored accounts using onilock list
• Copy passwords to clipboard securely with onilock copy
• Remove accounts using onilock remove
• Generate strong passwords with onilock generate
• Shell completion support for faster command-line usage

🛠 Installation

OniLock is best installed using pipx to keep it isolated:

1. Install pipx

sudo apt install pipx

2. Install OniLock systemwide

N.B. Make sure you don't have any active virtual environments before executing this command.

pipx install onilock

⚠️ Issues

If you encounter any issues with the init command, make sure the following dependancies are setup in your system:

1. Ensure dbus and a keyring backend are installed. If not, run the following command

sudo apt install gnome-keyring dbus-x11

2. Start the key-ring daemon

eval $(dbus-launch --sh-syntax)
export $(gnome-keyring-daemon --start)

📌 Usage

Once installed, you can use onilock directly from your terminal:

onilock --help

🔹 Initialize OniLock

Before using OniLock, initialize your profile:

onilock init

🔹 Add a New Account

onilock new

You will be prompted to enter the account name, username, and password.

🔹 List Stored Accounts

onilock list

Displays all saved accounts.

🔹 Copy a Password to Clipboard

onilock copy <account_name>

This copies the password to your clipboard securely.

🔹 Remove an Account

onilock remove <account_name>

Deletes the stored credentials.

🔹 Generate a Secure Password

onilock generate

Creates a strong random password.

🔒 Security

• OniLock encrypts stored passwords and prevents direct file access.
• Uses the system keyring for secure storage (if available).
• Passwords copied to the clipboard are automatically cleared after a short period.

🖥️ Shell Autocompletion

Enable shell autocompletion for easier usage:

onilock --install-completion

📜 License

OniLock is open-source and licensed under the Apache 2.0 License.

🤝 Contributing

Contributions are welcome! Feel free to submit issues and pull requests.

📝 Changelog

v1.6.0

• Fix some bugs.
• Implement support for terminal-based distros.
• Implement git-hub actions for auto-deployment when a new release is created.
• Improve project structure, and implement some design patterns

v1.5.4

• Update version command
• Ignore case for delete and copy commands
• Detect file corruption and manipulation using checksums

v1.5.0

• Rename shadow to vault
• Clear clipboard after 25 seconds if it still contains the password.
• Encrypt json files using PGP key instead of storing them as raw json file.
• Detect file corruption and manipulation using checksums

v1.4.0

• Publish the project under the Apache 2.0 license
• Multiple refactoring
• Big upgrade to README.md file.

View full changelog history on CHANGELOG.md file.

📧 Contact

Author: Mouad Kommir
Email: [e-mail]