studytimer

A lightweight study timer built with Python, running in the terminal with a built-in audible alarm and low resource usage.

Features

• Set your own study duration, from 1 minute up to 24 hours
• Clear, live display of remaining time during the session
• Automatic audio alert to remind you to take a break when time's up
• Easily stop the alarm as soon as you hear it
• Lightweight and works well on devices with limited resources

Supported Platforms

• Windows
• Linux
• macOS

Requirements

• Python 3.10 or later
• miniaudio
• Terminal with ANSI escape sequence support

Installation

Clone the repository :

git clone https://github.com/MohssineX/studytimer.git
cd studytimer

Install dependencies :

pip install -r requirements.txt

Or

pip install miniaudio

Usage

Run the program :

python studytimer.py

If your system uses python3 :

python3 studytimer.py

License

This project is licensed under the MIT License.

---

Author

Mohssine : https://github.com/MohssineX

---

🐱 Special Thanks

A special thanks to mimi — the legendary, the great, the gentle cat.

---

If you like it, give it a star :)