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
• Installation
• Usage
• Modes
• W.P.M.
• Statistics
• License

Dependencies

• Python3 (v3.9 or later)
  • DateTime
  • PyQt5
  • PyQtGraph
  • Appdirs
  • Dataclasses-JSON

Installation

Using pip (if you're on Windows, replace python3 with just python down below):

python3 -m pip install ps-typer

Then, launch the program by running the command:

ps-typer

Note that if the command does not work you may need to configure your system PATH variable (check out some Stack Overflow answers linked below).

• Windows
• Linux or Mac

Usage

1. Select a mode from the dropdown menu (My recommendation is always Random Text: Brown)
2. Click on begin and start typing! Characters typed correctly are highlighted green and characters typed incorrectly are highlighted red.
3. 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.
4. Check out the Statistics section below

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:
  1. Brown, which is the first million-word electronic corpus of English.
  2. 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.
  3. 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 the accuracy percentage, but note that accuracy lower than 75% results in a 0 w.p.m. score. Accuracy is taken into account to incentivise you to type all the text out correctly and not enforce bad habits.

Statistics

The program will save all of your daily high scores and keep track of your all-time highscore. 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.

From here you can also reset your highscores if you so wish.

Please note: All the (very limited) data this program stores can be found in the user's data directory under ps-typer. By default, these should be:

• Linux: /home/your_username/.local/share/ps-typer
• Mac: /Users/your_username/Library/Application Support/ps-typer
• Windows: C:\\Users\\your_username\\AppData\\Local\\ps-typer

License

MIT