Skip to content

A game based on guessing one of the top 500 most used passwords.

License

Notifications You must be signed in to change notification settings

uptudev/passwerdle

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

24 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

# Passwerdle

A game based on guessing one of the top 500 most used passwords.

Table of Contents

Installation

Pre-built Binaries

Pre-built binaries are available for Windows, macOS (Intel chips, NOT Apple Silicon; please build from source if you have an Apple CPU) and Linux in the releases section. Download the appropriate binary for your system and run it in a terminal.

Building from Source

Passwerdle is written in V, a simple, fast, safe, compiled language. To build from source, install V by following the instructions on the official website.

Once you have V installed, you can clone the repository and build the game:

# Clone the repository and navigate into it
git clone https://github.com/uptu-dev/passwerdle.git
cd ./passwerdle

# Build the game
v .

Usage

To start the game, run the compiled binary in a terminal (see Installation for instructions on building the game):

Linux/macOS/UNIX

./passwerdle

Windows

passwerdle.exe

Contributing

This is a personal project and I'm not looking for regular contributions at the moment. However, feel free to fork the repository and modify the game for your own use. I do review pull requests and issues, so feel free to open them if you have any suggestions or feedback.

License

This project is licensed under the GNU GPL v3 License - see the LICENSE file for details. In a nutshell, this means that you are free to use, modify, and distribute the code as long as you include the same license in your distribution and state any changes.

Additional Information

rockyou.txt in this project is a list of the top 5000 most used passwords, which I have reduced to the top 500 for this game. The full list is available on the internet and is often used for password cracking and security research. The full list is not included in this repository, but you can easily find it by searching for "rockyou.txt" on the internet. Note that this will not work inserted into this program as is, as game assumes a maximum word length of 16 characters, and the full list contains much longer words and may cause issues due to the size of the full list.

Custom Word List

If you want to use a custom word list, simply specify the path to the file as an argument when running the game. Note that for lists that aren't 500 words long, the max_index should be specified with the -i or --max_index flag. For example, to use a custom word list located at /path/to/your/wordlist.txt, run the game as follows

# Either
./passwerdle -l /path/to/your/wordlist.txt -i 123

# or
./passwerdle --load /path/to/your/wordlist.txt --max_index 123

Tips

  • Numbers are allowed and may sometimes be the entire password.
  • The game is case-insensitive for simplicity.
  • Yellow blocks indicate that the password contains the letter you guessed, but does not specify how many times it appears.