https://github.com/osama-yusuf/shell-guard
ShellGuard: Secure Shell Based Password Manager
https://github.com/osama-yusuf/shell-guard
bash-script password-manager security technology
Last synced: 3 months ago
JSON representation
ShellGuard: Secure Shell Based Password Manager
- Host: GitHub
- URL: https://github.com/osama-yusuf/shell-guard
- Owner: Osama-Yusuf
- License: mit
- Created: 2024-06-06T23:16:29.000Z (12 months ago)
- Default Branch: main
- Last Pushed: 2024-06-12T07:45:24.000Z (12 months ago)
- Last Synced: 2024-12-29T01:57:23.096Z (5 months ago)
- Topics: bash-script, password-manager, security, technology
- Language: Shell
- Homepage:
- Size: 543 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# ShellGuard: Your Secure Shell Password Manager 🛡️
#### 🌟 Features of ShellGuard
* **Session PIN Lock** 🔐: ShellGuard secures your session using a PIN. Once unlocked, the session remains open until you exit, so no need to re-enter the PIN constantly.
* **Encryption** 🔒: Utilizes AES-256 encryption with PBKDF2 enhancement for your password file, ensuring top-level security.
* **Ease of Use** 🎉: Simple command-line interface for adding, retrieving, and managing passwords.
* **Clipboard Support** 📋: Easily copy passwords to your clipboard on retrieval for convenient use.
* **OS Compatibility** 💻: Custom clipboard commands for different operating systems ensure seamless user experience across platforms.
#### Getting Started with ShellGuard 🚀
1. **Initial Setup**
* Download or clone the repository.
* Open your terminal and navigate to the repository directory.
* Run the script with your desired PIN:
```bash
./setup.sh -p YOUR_PIN_HERE
```
* This creates an encrypted file `passwords.enc`, securely storing your passwords.
2. **Using ShellGuard**
* Run the password manager script:
```bash
./pwd_mgr.sh
```
* Follow the on-screen prompts to manage your passwords:
```text
ShellGuard Menu:
1. Add a new password
2. Retrieve a password
3. List all users
4. Quit
Choose an option (1-4):
```
#### Developer Notes 🛠️
* For manual decryption (for testing only):
```bash
./setup.sh -d YOUR_PIN_HERE
```
#### Contribute 🌐
* Contributions are welcome! Fork the repository and submit pull requests to help improve ShellGuard.
Feel free to start managing your passwords more securely with ShellGuard today! 🌟