Skip to content

Latest commit

 

History

History
57 lines (37 loc) · 2.79 KB

README.md

File metadata and controls

57 lines (37 loc) · 2.79 KB
Raw

Word Unscrambler 🧩

Word Unscrambler is a simple web application that helps you find words based on various criteria such as word length, letters to include, letters to avoid, and specific positions of letters within the word.

Features 🚀

  • Word Length: Specify the length of the word you're looking for.
  • Letters to Include: Provide letters that must be included in the word.
  • Letters to Avoid: Specify letters that should not be present in the word.
  • Specific Positions: Optionally, specify specific positions for letters that must be included or avoided.
  • Dynamic Filtering: The application dynamically filters a word list based on your criteria.
  • User-friendly Interface: Clean and intuitive user interface for easy interaction.

Usage 📝

  1. Open the Word Unscrambler application in your web browser.
  2. Fill in the desired criteria in the input fields:
    • Length of the word
    • Letters that must be included
    • Letters to avoid
    • Specific positions of letters to include
    • Specific positions of letters to avoid
    • Recently we updated letters that repeat option
  3. Click the "Submit" button to view the filtered list of words that match your criteria.

Why I Built This Project? 🌟

I was playing a word guessing game on Binance, and I kept running out of chances after a few tries. I searched online for help, but I couldn't find a word unscrambler that met my needs. Most of them didn't let me specify where certain letters should go in the word.

For example, if the word was 5 letters long and I knew 'a' and 'e' were in it, and I also know 'a' is in the first spot, I needed a way to tell the unscrambler that. But none of the unscrambler in the market had that option.

So, I decided to build one with all the features I needed. I hoped it would help others like me who were frustrated with the existing options.

And as for my own game on Binance, using my unscrambler, I finally solved it on my last try. The adrenaline rush and the dopamine hit me beautifully when I saw the result. It was a big relief!

Installation 🛠️

To run the Word Unscrambler application locally:

  1. Clone this repository to your local machine.
  2. Install the required Python libraries using pip install -r requirements.txt.
  3. Ensure that the index.html (HTML file) is stored in the templates folder.
  4. Run the Flask application using python word_unscrambler.py.
  5. Access the application in your web browser at http://localhost:5143.

Contributing 🤝

Contributions are welcome! If you have any suggestions, feature requests, or find any issues, please open an issue or submit a pull request.

Credits 🙏

The word list used in this project is sourced from dwyl/english-words.

License 📄

Free to use, no strings attached!