Skip to content
sthbryanPublic

About

Want to get a secure password? EasyPass makes it easy.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

20 Commits

Folders and files

Repository files navigation

EasyPass

Want to use strong passwords but hate remembering them? EasyPass is a simple solution that generates secure passwords from a memorable "easy password" and a master password. Just run ep "easyPass" "masterSecret" and get a strong password you can use everywhere!

Installation

go install github.com/sthbryan/easypass@latest

Or build from source:

git clone https://github.com/sthbryan/easypass
cd easypass
make install

In macOS, you may need to remove the quarantine attribute:

xattr -d com.apple.quarantine $(which ep)

Usage

Generate password

ep "mypassword" "masterSecret"
# Output: Np3!!^NL])8D[^c)

# With clipboard
ep "mypassword" "masterSecret" -c

Configure

# Show current config
ep config show

# Basic options
ep config length 24
ep config uppercase false
ep config lowercase false
ep config numbers false
ep config symbols false

# Advanced options
ep config exclude-similar true     # Exclude: 0, O, l, 1, I
ep config custom-symbols "!@#$%^&*"  # Custom symbols
ep config min-symbols 2           # Minimum symbols required
ep config min-numbers 3          # Minimum numbers required

# Algorithm (argon2id, pbkdf2, scrypt)
ep config algorithm argon2id

Save passwords

ep save gmail "mySecretPass" "masterSecret"

Show saved password

ep show gmail "masterSecret"
# Password: x7Kk#mN2$pL9qR
# Copied to clipboard

List saved

ep list

Configuration

Option Default Description
length 16 Password length (8-128)
uppercase true Include uppercase (A-Z)
lowercase true Include lowercase (a-z)
numbers true Include numbers (0-9)
symbols true Include symbols
exclude-similar false Exclude 0, O, l, 1, I
custom-symbols !@#$%... Custom symbols set
min-symbols 0 Minimum symbols required
min-numbers 0 Minimum numbers required
algorithm argon2id Derivation algorithm

Algorithm

EasyPass uses Argon2id to derive a secure password from:

  • Your easy password (e.g., "twitter-password")
  • Your master password and secure password, save it on your mind!

Files

  • ~/.config/easypass/config.yaml - Configuration
  • ~/.config/easypass/passwords.enc - Encrypted passwords (AES-256-GCM)

Security

  • Master password is never stored
  • Passwords encrypted with AES-256-GCM
  • Uses Argon2id for derivation (GPU/ASIC resistant)
  • Option to exclude similar characters for readability

License

MIT License

Contributing

Contributions are welcome! Please open an issue or submit a pull request.

About

Want to get a secure password? EasyPass makes it easy.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages