Awesome Open Source
Awesome Open Source

Command line tool that checks how much a password is safe
Coded with 💙 by edoardottt.

Mainteinance yes version pr-welcome ask me anything
go-report-card workflows ubuntu-build
gobadge license-GPL3

ExampleGet StartedDescriptionScoringContributingChangelog

This tool doesn't store any information!!
Remember, never use personal information in your password!

  • Use a password manager (I recommend BitWarden)
  • Don't use the same password for different services
  • Enable 2FA when possible

Example 📊


Get Started 🎉


go install -v[email protected]

From source

  • First of all, clone the repo locally

    • git clone
  • pwdsafety has external dependencies, so they need to be pulled in:

    • cd pwdsafety/cmd && go get && cd ..
  • Linux (Requires high perms, run with sudo)

    • make linux (to install)

    • make unlinux (to uninstall)

  • Windows (executable works only in pwdsafety folder. Alias?)

    • make windows (to install)

    • make unwindows (to uninstall)

Description 🔦

It reads from standard input the entered password.
First, it searches if the password or the password reversed is a well known pwd.
Then, just do little calculations, checking if the basic rules are respected, like if there are UPPERCASE CHARS, lowercase chars, numb3rs and symbols.
It stores the length of the password and the ratio [ unique different chars / total chars].
It calculates then the entropy of a password.
Password entropy is a measurement of how unpredictable a password is.
The formula for entropy is:


  • E = password entropy
  • R = pool of unique characters
  • L = number of characters in your password
  • Then R^L = the number of possible passwords

When the score <= 68(reasonable) it generates a random password.

Scoring 💯

Max score: 100


  • Very weak: 0 - 35
  • Weak: 36 - 59
  • Reasonable: 60 - 68
  • Strong: 69 - 80
  • Very strong: 81 -100

Scoring parameters:

  • Found in known password
  • Found in known password reversed
  • Password composition:
    • numbers
    • symbols
    • uppercase
    • lowercase
  • Unique different characters
  • Length
  • Entropy

Contributing 🛠

Just open an issue / pull request.

See also and CODE OF

Thanks to fabaff and ecnepsnai.

Changelog 📌

Detailed changes for each release are documented in the release notes.

License 📝

This repository is under GNU General Public License v3.0. to contact me.

Alternative Project Comparisons
Related Awesome Lists
Top Programming Languages
Top Projects

Get A Weekly Email With Trending Projects For These Topics
No Spam. Unsubscribe easily at any time.
Go (161,144
Golang (161,144
Cli (131,512
Security (31,799
Password (20,435
Command Line Tool (8,491
Security Tools (1,973
Password Generator (1,073
Golang Application (551
Security Scanner (295
Password Strength (256
Password Hash (223
Safety (210
Password Safety (109
Pwd (18
Pwdhash (3