Metadata-Version: 2.4
Name: loxword
Version: 0.0.4
Summary: A secure CLI password manager with multi-user support and auto-lock features.
Author-email: Aditya Chavan <iaditya.2016@gmail.com>
License: MIT
Project-URL: Homepage, https://github.com/adchad90/Lox
Project-URL: Issues, https://github.com/adchad90/Lox/issues
Project-URL: Repository, https://github.com/adchad90/Lox.git
Keywords: password,manager,security,cli,encryption,vault,bcrypt
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: End Users/Desktop
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Security
Classifier: Topic :: Utilities
Classifier: Environment :: Console
Classifier: Topic :: Security :: Cryptography
Requires-Python: >=3.7
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: cryptography<44.0.0,>=39.0.0
Requires-Dist: bcrypt<5.0.0,>=4.0.0
Requires-Dist: pyperclip<2.0.0,>=1.8.0
Dynamic: license-file

# 🔐 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.
