A standalone desktop application designed for learning and mastering English vocabulary and spelling through interactive practice. Built with tkinter for a user-friendly interface, this tool leverages Excel files for word management and integrates Text-to-Speech (TTS) for pronunciation, offering a simple yet effective way to enhance spelling skills.
Mastering English vocabulary requires consistent practice and active recall. This application is tailored specifically for individuals looking for a simple, concise, and highly focused tool dedicated entirely to practicing English spelling. It systematically tests users on their personalized word lists, utilizing audio cues to simulate real dictation, and automatically tracks their progress until words are fully memorized.
"The first public release (v1.0.0) is the result of major internal iterations, extensive local testing, and continuous refinement before being open-sourced."
- 100% Mouse-Free Practice: The practice session is entirely keyboard-driven. The application intelligently manages text box focus and utilizes context-aware Enter key logic, allowing you to seamlessly type, reveal words, and navigate through your queue without ever touching the mouse.
- Muscle Memory Practice Mode: If you misspell a word or request a reveal, the app enters a dedicated practice mode. The typing box remains active, allowing you to re-type the target word as many times as needed to build muscle memory, complete with instant success/error audio feedback.
- Targeted Spelling Assistance (Highlighting Weak Spots): Prepare your vocabulary in an Excel file (like
new.xlsx) and simply bold the specific parts of any word you struggle to spell. The application smartly detects this and heavily bolds those exact letters during your practice sessions. This visual emphasis helps draw your attention to your weak spots, making it much easier to memorize difficult spellings. - Smart Vocabulary Management: Easily import your word lists via standard Excel files. The app automatically tracks your progress and seamlessly moves words you've successfully learned into a separate "memorized" list, keeping your daily practice focused and efficient.
- Batch Audio Downloading for Offline Use: A dedicated download feature fetches and saves missing pronunciations for your entire database based on your precise settings (US/UK accent, Slow/Normal speed). This guarantees instantaneous audio playback during practice and enables a fully offline learning experience.
- Advanced Audio Dictation: Listen to clear, precise pronunciations of your vocabulary. You can switch between US and UK accents, adjust the reading speed (slow, normal, or fast) to match your listening level, and dynamically fall back to Windows built-in offline voices if the internet disconnects.
- Comprehensive Tracking & Dynamic Reporting: Instantly view your learning progress through clean, center-aligned data tables. Column headers dynamically calculate and display real-time statistics (e.g., total active words, sum of correct hits, total attempts) so you can track your milestones at a glance.
- Customizable Learning Goals: Tailor the difficulty to your personal needs. You can easily adjust how many times you need to type a word correctly before it is officially considered "memorized" directly from the application's settings (the default is set to 5 successful attempts).
- Dynamic & Beautiful Interface: Personalize your learning environment with a built-in color picker featuring dozens of themes. The app automatically adjusts text colors, extends custom theme colors directly into the Windows title bars, and ensures a seamless, flicker-free UI experience across all menus.
- Safe & Portable: Your learning progress is always safe thanks to an automatic background backup system that prevents accidental data loss. Plus, the app is completely portable—no complex installation is required; just run it and start practicing.
To use the application on Windows:
- Navigate to the Releases page of this repository.
- Download the
Spelling-Injector-Windows.ziparchive. - Extract the ZIP file to a local directory.
- Open the
Spelling Injector.exefile to launch the application.
- Python 3.12 (Strictly required to function and compile correctly).
- C Compiler (MinGW-w64 is highly recommended for Windows compilation using Nuitka).
- Git (For cloning the repository).
- Clone this repository:
git clone https://github.com/HojjatSabzali/Spelling-Injector.git
cd Spelling-Injector- (Optional but recommended) Create and activate a virtual environment:
python -m venv venv
venv\Scripts\activate- Install the required Python packages:
pip install -r requirements.txtTo execute the raw Python script, run the following command:
python "main.py"To compile the raw Python script into a standalone .exe file without a background console, simply execute the included batch script. This script automatically cleans previous builds, compiles the code using Nuitka, includes the necessary asset directories (like icons), and packages everything into a ready-to-release ZIP file.
build.batIn the spirit of full transparency, please note that the core Python codebase of this application was generated using Gemini 3.1 Pro. My primary role in this project was focused on high-level system design, logic orchestration via detailed prompting, and rigorous debugging during the execution phases.
Copyright © 2026 Hojjat Sabzali
This project is open-source and available under the MIT License.
- Email: sabzali.hojjat@gmail.com
- LinkedIn: https://www.linkedin.com/in/hojjat-sabzali
- GitHub: https://github.com/HojjatSabzali/
Project Link: https://github.com/HojjatSabzali/Spelling-Injector