# 🔐 Lox - CLI Based Vault
Safeguard anything that matters — from passwords to private files — with uncompromising security and simplicity.
## ✨ Features
- **🔒 Military-grade encryption** - AES with bcrypt hashing
- **👥 Multi-user support** - Separate vaults for different users
- **⏰ Auto-lock** - Sessions lock after 60 seconds of inactivity
- **📋 Smart clipboard** - Auto-clears passwords after 20 seconds
- **🛡️ Recovery system** - Never lose access with recovery tokens
- **🖥️ Cross-platform** - Works on Windows, macOS, and Linux
## ✨ Use Cases
- **Passwords**
- **API Keys, SSH Keys**
- **Secret Messages**
- **(Soon) File Encryption & Storage**
## 🚀 Quick Start
**Coming soon to PyPI!** For now, clone and run locally:
```bash
git clone https://github.com/adchad90/Lox.git
cd Lox
python -m venv venv
# Activate virtual environment:
# Linux/Mac: source venv/bin/activate
# Windows: venv\Scripts\activate
pip install -r requirements.txt
python -m Lox.main
```
## 📖 Usage
### First Time Setup
1. Clone and set up the project (see Quick Start above)
2. Run `python -m Lox.main`
3. Create a new user
4. Set a master password
5. **IMPORTANT:** Save the recovery token somewhere safe offline!
### Daily Use
1. Activate your virtual environment
2. Run `python -m Lox.main`
3. Login with your master password
4. Manage your passwords securely
## 🔧 Commands
Once running, use these options:
- `1` - Get Secret (copies to clipboard)
- `2` - Create/Update Entry
- `3` - Delete Entry
- `4` - List All Entries
- `5` - Change Master Password
- `6` - Logout
- `7` - Exit
## 🛡️ Security
- **Encryption:** AES
- **Hashing:** bcrypt with random salts
- **Local storage:** All data stays on your machine
- **Recovery tokens:** Secure backup for master password reset
- **Auto-lock:** Prevents unauthorized access after inactivity
- **Clipboard security:** Passwords auto-clear after 20 seconds
## 📁 Data Location
Your encrypted vaults are stored locally at:
- **Linux:** `~/.local/share/lox/users/`
- **macOS:** `~/Library/Application Support/lox/users/`
- **Windows:** `%APPDATA%/lox/users/`
## 🚀 Coming to PyPI
Soon you'll be able to install with just:
```bash
pip install loxword
lox
```
## 🤝 Contributing
Found a bug or want to contribute? Issues and pull requests are welcome!
1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Submit a pull request
## 📄 License
MIT License - see [LICENSE](LICENSE) for details.
---
**⚠️ Security Notice:** This tool stores passwords locally with strong encryption. Always keep your recovery tokens safe and consider regular backups of your vault files. Never share your master password or recovery tokens.
Raw data
{
"_id": null,
"home_page": null,
"name": "loxword",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.7",
"maintainer_email": null,
"keywords": "password, manager, security, cli, encryption, vault, bcrypt",
"author": null,
"author_email": "Aditya Chavan <iaditya.2016@gmail.com>",
"download_url": "https://files.pythonhosted.org/packages/ba/17/7e273edeec7c8c3cea7e20dc15ac84f1303c81f21c12d7f32ee746e40d65/loxword-0.0.4.tar.gz",
"platform": null,
"description": "# \ud83d\udd10 Lox - CLI Based Vault\n\nSafeguard anything that matters \u2014 from passwords to private files \u2014 with uncompromising security and simplicity.\n\n## \u2728 Features\n\n- **\ud83d\udd12 Military-grade encryption** - AES with bcrypt hashing\n- **\ud83d\udc65 Multi-user support** - Separate vaults for different users\n- **\u23f0 Auto-lock** - Sessions lock after 60 seconds of inactivity\n- **\ud83d\udccb Smart clipboard** - Auto-clears passwords after 20 seconds\n- **\ud83d\udee1\ufe0f Recovery system** - Never lose access with recovery tokens\n- **\ud83d\udda5\ufe0f Cross-platform** - Works on Windows, macOS, and Linux\n\n## \u2728 Use Cases\n\n- **Passwords** \n- **API Keys, SSH Keys**\n- **Secret Messages**\n- **(Soon) File Encryption & Storage**\n\n## \ud83d\ude80 Quick Start\n\n**Coming soon to PyPI!** For now, clone and run locally:\n\n```bash\ngit clone https://github.com/adchad90/Lox.git\ncd Lox\npython -m venv venv\n# Activate virtual environment:\n# Linux/Mac: source venv/bin/activate\n# Windows: venv\\Scripts\\activate\npip install -r requirements.txt\npython -m Lox.main\n```\n\n## \ud83d\udcd6 Usage\n\n### First Time Setup\n1. Clone and set up the project (see Quick Start above)\n2. Run `python -m Lox.main`\n3. Create a new user\n4. Set a master password\n5. **IMPORTANT:** Save the recovery token somewhere safe offline!\n\n### Daily Use\n1. Activate your virtual environment\n2. Run `python -m Lox.main`\n3. Login with your master password\n4. Manage your passwords securely\n\n## \ud83d\udd27 Commands\n\nOnce running, use these options:\n- `1` - Get Secret (copies to clipboard)\n- `2` - Create/Update Entry\n- `3` - Delete Entry \n- `4` - List All Entries\n- `5` - Change Master Password\n- `6` - Logout\n- `7` - Exit\n\n\n## \ud83d\udee1\ufe0f Security\n\n- **Encryption:** AES\n- **Hashing:** bcrypt with random salts\n- **Local storage:** All data stays on your machine\n- **Recovery tokens:** Secure backup for master password reset\n- **Auto-lock:** Prevents unauthorized access after inactivity\n- **Clipboard security:** Passwords auto-clear after 20 seconds\n\n## \ud83d\udcc1 Data Location\n\nYour encrypted vaults are stored locally at:\n- **Linux:** `~/.local/share/lox/users/`\n- **macOS:** `~/Library/Application Support/lox/users/`\n- **Windows:** `%APPDATA%/lox/users/`\n\n## \ud83d\ude80 Coming to PyPI\n\nSoon you'll be able to install with just:\n```bash\npip install loxword\nlox\n```\n\n## \ud83e\udd1d Contributing\n\nFound a bug or want to contribute? Issues and pull requests are welcome!\n\n1. Fork the repository\n2. Create a feature branch\n3. Make your changes\n4. Submit a pull request\n\n## \ud83d\udcc4 License\n\nMIT License - see [LICENSE](LICENSE) for details.\n\n---\n\n**\u26a0\ufe0f Security Notice:** This tool stores passwords locally with strong encryption. Always keep your recovery tokens safe and consider regular backups of your vault files. Never share your master password or recovery tokens.\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "A secure CLI password manager with multi-user support and auto-lock features.",
"version": "0.0.4",
"project_urls": {
"Homepage": "https://github.com/adchad90/Lox",
"Issues": "https://github.com/adchad90/Lox/issues",
"Repository": "https://github.com/adchad90/Lox.git"
},
"split_keywords": [
"password",
" manager",
" security",
" cli",
" encryption",
" vault",
" bcrypt"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "3946db5966bb873b4b3ffecf87c001dff21060b70dcbd431acd89c92e0e966a2",
"md5": "19625bebb0b81fa4094021b7c2a68dac",
"sha256": "28784292df1ce1ee130899a32e65758c0eb50ce61810b6b243109d7a1caa4e0c"
},
"downloads": -1,
"filename": "loxword-0.0.4-py3-none-any.whl",
"has_sig": false,
"md5_digest": "19625bebb0b81fa4094021b7c2a68dac",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.7",
"size": 9852,
"upload_time": "2025-08-22T13:30:41",
"upload_time_iso_8601": "2025-08-22T13:30:41.274225Z",
"url": "https://files.pythonhosted.org/packages/39/46/db5966bb873b4b3ffecf87c001dff21060b70dcbd431acd89c92e0e966a2/loxword-0.0.4-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "ba177e273edeec7c8c3cea7e20dc15ac84f1303c81f21c12d7f32ee746e40d65",
"md5": "dbcfb1c242ba4be07047b7746f805716",
"sha256": "f7c51e2bd0f31c81988df9ba2d988a3b7ffffdd10c5018e0383a7f03639f56d4"
},
"downloads": -1,
"filename": "loxword-0.0.4.tar.gz",
"has_sig": false,
"md5_digest": "dbcfb1c242ba4be07047b7746f805716",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.7",
"size": 10124,
"upload_time": "2025-08-22T13:30:43",
"upload_time_iso_8601": "2025-08-22T13:30:43.256861Z",
"url": "https://files.pythonhosted.org/packages/ba/17/7e273edeec7c8c3cea7e20dc15ac84f1303c81f21c12d7f32ee746e40d65/loxword-0.0.4.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-08-22 13:30:43",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "adchad90",
"github_project": "Lox",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"requirements": [
{
"name": "cryptography",
"specs": []
},
{
"name": "bcrypt",
"specs": []
},
{
"name": "pyperclip",
"specs": []
}
],
"lcname": "loxword"
}
JSON
