studytimer

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

Features

• Countdown timer for study sessions
• Supports study sessions up to 24 hours
• Audible alarm when the timer reaches zero
• It works on Linux, Windows, and Mac OS systems
• 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

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

How It Works

1. Start the program
2. Enter a study duration in minutes
3. The countdown begins immediately
4. The remaining time is displayed in real time
5. When the timer reaches zero, an alarm starts playing
6. Press Ctrl+C to stop the alarm and exit

---

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 :)