apppass 🚀🔒

apppass is a powerful command-line application that allows you to generate, manage, and secure passwords efficiently. With advanced features like temporary passwords (OTP), memorable passwords, import/export, and auto-lock, apppass takes password management to the next level. ✨

---

🔧 Installation

Install apppass easily with:

Homebrew (macOS & Linux)

Install with default features (CLI + TUI):

brew install stescobedo92/tap/apppass

Custom installations:

# Install only the CLI console
brew install stescobedo92/tap/apppass --without-tui

# Install only the interactive TUI
brew install stescobedo92/tap/apppass --without-console

Winget (Windows)

winget install apppass

Note: The Winget package includes both CLI and TUI features by default.

Cargo (Rust Package Manager)

# Install with all features (default - includes CLI and TUI)
$ cargo install apppass

# Install with only CLI (console) support
$ cargo install apppass --no-default-features --features console

# Install with only TUI (interactive UI) support  
$ cargo install apppass --no-default-features --features tui

Available Features

Feature	Description
console	Command-line interface with all CLI commands
tui	Interactive terminal UI with keyboard navigation
default	Both console and tui features enabled

---

✨ Key Features

• 🔒 Secure Password Generation: Create highly secure random passwords.
• ⏰ Temporary Passwords (OTP): Generate passwords valid for a limited time.
• 🤓 Memorable Passwords: Easy-to-remember yet secure passwords.
• 🔄 Full Password Management: List, update, delete, import, and export passwords.
• 🕗 Auto-Lock: Locks the application after a period of inactivity.
• 📂 Export/Import: Exchange passwords via CSV files.

---

🚀 Core Commands

🔒 Generate a Password

Create a password for an application:

$ ./apppass --app gmail
Password generated and saved for the application: gmail

Specify the password length:

$ ./apppass --app github --length 40
Password generated and saved for the application: github

---

🔍 Retrieve a Password

Retrieve the password for an application:

$ ./apppass --get gmail
Application_Name: gmail
Password: aB1nwWQyyu2rts7xc3vh90hGk0amlt

---

🔄 List All Passwords

Show all registered applications and their passwords:

$ ./apppass --list
Application_Name: github_credential
Password: JsHx7YX4jAaH4L54uBKoNbuHd59ABO

Application_Name: gmail
Password: aB1nwWQyyu2rts7xc3vh90hGk0amlt

---

❌ Delete a Password

Delete the password for an application:

$ ./apppass --delete gmail
Application 'gmail' deleted successfully.

---

♻️ Update a Password

Update the password for an application (regenerates a new secure password):

$ ./apppass --update gmail
Password updated successfully for 'gmail'.
New Password: xY9zK8mN7pQ6rS5t

Update with a custom password:

$ ./apppass --update-custom gmail --password "MySecurePassword123!"
Password updated successfully for 'gmail'.

---

📂 Export Passwords to a CSV File

Save all your passwords to a file:

$ ./apppass --export passwords.csv
Passwords exported to 'passwords.csv'.

---

📂 Import Passwords from a CSV File

Import passwords from an existing file:

$ ./apppass --import passwords.csv
Passwords imported from 'passwords.csv'.

---

⏰ Generate a Temporary Password (OTP)

Create a password that expires after a defined time:

$ ./apppass --otp MyApp --ttl 300
Temporary Password: 7aB8cD9EfG
Expires at: 2025-01-10 12:00:00

---

🤓 Generate a Memorable Password

Create a secure and easy-to-remember password:

$ ./apppass --memorizable BlogApp
Memorizable Password for 'BlogApp': Tiger-85-Cloud

---

🕗 Set Auto-Lock

Configure an inactivity period after which the application locks:

$ ./apppass --lock 60
Auto-lock set to 60 seconds.

---

🖥️ Interactive TUI Mode

Launch the interactive terminal user interface (requires tui feature):

$ ./apppass --ui

The TUI provides a menu-driven interface with keyboard navigation:

• ↑↓: Navigate menu items
• Enter: Select option
• Tab: Switch between input fields
• Esc: Go back / Cancel
• q: Quit

Features available in TUI:

• Create auto-generated or custom passwords
• List and view all passwords
• Update auto-generated passwords (regenerates new password)
• Update custom passwords (edit password manually)
• Delete passwords
• Generate OTP and memorizable passwords
• Export/Import passwords
• Configure default password length

---

🙌 Contribute

Have an idea to improve apppass? We welcome contributions! You can send a pull request or open an issue on the GitHub repository.

---

🚀 Next Steps

• Cloud synchronization support.
• Security report generation.
• Integration with other password managers.

---