Skip to content

Latest commit

 

History

History

Folders and files

NameName
Last commit message
Last commit date

parent directory

..
 
 
 
 
 
 
 
 

README.md

Advanced Alarm Clock (Python + Tkinter)

A simple yet powerful Alarm Clock GUI application built using Python and Tkinter . Set alarms easily, get notified when time’s up, and enjoy a clean, modern interface. Perfect for beginners exploring GUI programming with Python.


Features

  • Set Alarms – Enter time in HH:MM:SS format
  • Input Validation – Shows error message for invalid formats
  • Popup Alerts – Alarm notification when time is reached
  • Stop Alarm Button – Cancel active alarms easily
  • Responsive Tkinter GUI – Clean, minimal design with clear controls
  • Lightweight & Beginner-Friendly – Easy to understand and extend


Requirements

Dependency Description
Python 3.8+ Core programming language
Tkinter GUI framework (preinstalled with Python)
datetime For time management

Check if Tkinter is available:

import tkinter
print("Tkinter is working!")

If missing on Linux, install it with:

sudo apt-get install python3-tk

How to Run

1️⃣ Clone the Repository

git clone https://github.com/mantrapatil03/python-beginner-friendly-projects.git
cd python-beginner-friendly-projects/alarm-clock

2️⃣ (Optional) Create a Virtual Environment

python -m venv venv
# Activate environment
source venv/bin/activate   # macOS/Linux
venv\Scripts\activate      # Windows

3️⃣ Install Dependencies

pip install -r requirements.txt

4️⃣ Run the App

python alarm_clock.py

Tip: Keep the app running in the background — it will alert you when the alarm time matches your system clock.

Future Roadmap

Feature Status Description
Add alarm sound Planned Play audio when alarm triggers
Multiple alarms Planned Support for more than one alarm
Snooze option Planned Add “Remind me later” button
Save alarm history Planned Keep a log of past alarms
Custom themes Planned Light/Dark mode for Tkinter window

Contributing

Contributions are always welcome! 🚀

  • Fork this repository
  • Create a feature branch
    git checkout -b feature/your-feature
    
  • Commit your changes
  • Push to your fork
  • Open a Pull Request

Please follow clean code practices and PEP8 styling.

Author

Mantra Patil

💼 LinkedIn: https://www.linkedin.com/in/mantrapatil25

✉️ techmantrapatil@gmail.com

🎉 Thanks for checking out my Alarm Clock project! 🎉

If you found this helpful, please consider giving it a ⭐ on GitHub!