⏳ studytimer

A lightweight terminal study timer with a built-in audible alarm.

Features

• Countdown timer for study sessions
• Displays remaining time in HH:MM:SS format
• Colorized terminal interface
• Audible alarm when the timer reaches zero
• Supports study sessions up to 24 hours
• Built-in input validation and error handling
• Works on Linux and Windows

Requirements

• Python 3.x
• playsound3

Installation

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

Install dependencies:

pip install -r requirements.txt

Or:

pip install playsound3

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

Error Codes

Code	Description
err101	Invalid timer Maximum allowed is 1440 minutes (24 hours)
err102	Invalid input (integer numbers only)

Notes

The alarm sound requires a working audio playback system on your device.

---

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.