typr is a Python-based application that utilizes the 'rich' module to provide you with a simple yet satisfying tui when typing, typr is designed to be simple & easy to use; Whenever you want a simple but satisfying typing test tool.
- Check Python Version:
Ensure you have Python 3.8 or higher installed. If not, install it from the official Python website.
- Clone typr Repository:
Clone typr repository to your desired location.
git clone https://github.com/DriftingOtter/Typr.git
cd TyprCLI
- Run install script:
chmod +x install.sh
./install.sh
- Install rich Python module:
If you have not already done so, install the rich Python module, as it's a critical library for typr.
pip install rich
- Clone typr Repository:
Clone typr repository to your desired location using Git
git clone https://github.com/DriftingOtter/Typr.git
cd TyprCLI
- Locate main.py:
Make sure you know the correct path to your main.py file within the TyprCLI/src/ directory you just cloned.
- Set up Aliases (Optional)*
Please check with your shell's documentation on how to add aliases to your rc files.
Here are some commonly used shell alias commands you can copy.
Add the following line to your ~/.bashrc file:
alias typr="python3 /path/to/TyprCLI/src/main.py"
Add the following line to your ~/.bashrc file:
alias typr="python3 /path/to/TyprCLI/src/main.py"
Add the following line to your ~/.config/fish/config.fish file:
alias typr="python3 /path/to/TyprCLI/src/main.py"
Add the following line to your ~/.xonshrc file:
aliases['typr'] = 'python3 /path/to/TyprCLI/src/main.py'
- Test The Alias
Open a new terminal window and type typr. It should execute your typr application.
You can also run typr -h to output the manual page for the application to see all the addional run-time flags you can utilize.
If you want to contribute to this project, please feel free to read the CONTRIBUTING.md document to gain a better understanding of how to make changes, and improve this application.
- Freepik.com for astronaut logo
(Image by catalyststuff on Freepik)
-
katto-studios for the default word list
-
monkeytype for the inspiration for the CONTRIBUTING.md document