A Python program with a PyQt5 UI used for practicing your typing skills and keeping track of your progress
Project description
ps-typer
Description
A Python program built on the PyQt5 GUI framework, used for practicing your typing skills and keeping track of your progress.
Index
Dependencies
- Python3 (v3.6 or later)
- All Python packages required are listed in
requirements.txt
and are installed automatically with the default installation process (including PyQt5 and PyQtGraph)
Installation
To download this program, click on Code
at the top right of this page, then download as a zip file. You can unzip using your preferred program.
Alternatively, clone the repository using git
:
git clone https://github.com/Rolv-Apneseth/ps-typer.git
Linux
Navigate to the project's home directory and run the command:
sudo make install
- This will place a script for easy launching at
/usr/local/ps-typer
To launch the program, run the command:
ps-typer
- This runs the
run_program.sh
script (located in thebin
directory) which will create a virtual envirionment, install all required Python packages and then launch the program.
Windows
Navigate to the project's bin
directory and double click on run_program.bat
- This will create a virtual envirionment, install all required Python packages and then launch the program.
Manual
Navigate to the project's home directory and run the command:
python3 -m pip install -r requirements.txt
To launch the program, navigate into the ps-typer
directory and run the command:
python3 main.py
Windows users, replace python3
with just python
in the above commands
Usage
- Select a mode from the dropdown menu (Default on first start is Common Phrases)
- Click on begin and start typing! Characters typed correctly are highlighted green and characters typed incorrectly are highlighted red.
- When finished, a window will appear displaying your accuracy, average w.p.m and whether or not you set a daily or all-time high score.
- Note: The high scores are stored in the assets folder in
highscores.pkl
andbackup_highscores.pkl
and can be deleted if you want to reset your high score.- There are however GUI options for resetting high scores in the Statistics window
- Note: The high scores are stored in the assets folder in
Modes
Select one of the following options to choose what you will be typing out:
-
Common Phrases
-
Facts
-
Famous Literature Excerpts
-
Famous Quotes
-
Random Text Options
- These 3 options are achieved using corpora from nltk, for which documentation can be found here. The corpora included are:
- Brown, which is the first million-word electronic corpus of English.
- Gutenberg, which is a small selection of texts from the Project Gutenberg electronic text archive, which contains some 25,000 free electronic books, hosted here.
- Webtext, a collection of web text includes content from a Firefox discussion forum, conversations overheard in New York, the movie script of Pirates of the Carribean, personal advertisements, and wine reviews, for more informal text.
- To reduce the number of dependencies, as well as the processing that needs to be done for formatting the text, the corpora are already processed into plain text files stored in the
assets/texts/
directory, along with the python script used to generate them.
W.P.M.
Your typing speed is measured by your average wpm, multiplied by your accuracy.
Wpm is calculated as words per minute (w.p.m) using (characters typed/5)/minutes
This gives a more fair w.p.m calculation since longer words would be worth more than short words. This figure is then multiplied by your accuracy percentage.
Accuracy is taken into account to incentivise you to type all the text out correctly and not enforce bad habits.
Statistics
High scores can be set both daily or as an all-time high score. Both values are displayed in the main menu and saved for future sessions.
The program will save all of your daily high scores. This data is then visualised in the statistics window using a graph of wpm over time so you can get a sense of how you're progressing.
License
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.