|
1 | | -# ⏰ Simple Alarm Clock (Python + Tkinter) |
2 | | - |
3 | | -A lightweight **Alarm Clock GUI application** built using Python's `tkinter`. |
4 | | -You can set an alarm in **HH:MM:SS format**, and the app will alert you when the time is reached. |
| 1 | +<h1 align="center"> Advanced Alarm Clock (Python + Tkinter)</h1> |
| 2 | + |
| 3 | +<p align="center"> |
| 4 | + A simple yet powerful <b>Alarm Clock GUI application</b> built using <b>Python</b> and <b>Tkinter</b> . |
| 5 | + Set alarms easily, get notified when time’s up, and enjoy a clean, modern interface. |
| 6 | + Perfect for beginners exploring GUI programming with Python. |
| 7 | +</p> |
| 8 | + |
| 9 | +<p align="center"> |
| 10 | + <a href="https://www.python.org/"><img src="https://img.shields.io/badge/Python-3.8+-blue?style=for-the-badge&logo=python"></a> |
| 11 | + <a href="https://docs.python.org/3/library/tkinter.html"><img src="https://img.shields.io/badge/GUI-Tkinter-ff69b4?style=for-the-badge&logo=python"></a> |
| 12 | + <a href="https://github.com/mantrapatil03/python-beginner-friendly-projects/stargazers"><img src="https://img.shields.io/github/stars/mantrapatil03/python-beginner-friendly-projects?style=for-the-badge&logo=github"></a> |
| 13 | + <a href="https://opensource.org/licenses/MIT"><img src="https://img.shields.io/badge/License-MIT-green?style=for-the-badge&logo=opensourceinitiative&logoColor=white"></a> |
| 14 | + <a href="#"><img src="https://img.shields.io/badge/Platform-Cross%20Platform-orange?style=for-the-badge&logo=windows"></a> |
| 15 | +</p> |
5 | 16 |
|
6 | 17 | --- |
7 | 18 |
|
8 | | -## 🚀 Features |
9 | | -- 🕒 Set alarm time in **HH:MM:SS format** |
10 | | -- ✅ Validates input (shows error popup if format is wrong) |
11 | | -- 🔔 Alarm rings with a popup message |
12 | | -- ⏹ Stop button to cancel the alarm anytime |
13 | | -- 🎨 Simple and responsive Tkinter GUI |
| 19 | +## Features |
| 20 | + |
| 21 | +- **Set Alarms** – Enter time in `HH:MM:SS` format |
| 22 | +- **Input Validation** – Shows error message for invalid formats |
| 23 | +- **Popup Alerts** – Alarm notification when time is reached |
| 24 | +- **Stop Alarm Button** – Cancel active alarms easily |
| 25 | +- **Responsive Tkinter GUI** – Clean, minimal design with clear controls |
| 26 | +- **Lightweight & Beginner-Friendly** – Easy to understand and extend |
14 | 27 |
|
15 | 28 | --- |
16 | 29 |
|
17 | | -## 📂 Project Structure |
18 | | -``` |
19 | | -|-- HOW_IT_WORKS.MD # Working |
20 | | -|-- README.md # Project documentation |
21 | | -|-- alarm_clock.py # Main program file |
22 | | -|-- requirements.md # Dependencies |
23 | | -``` |
24 | 30 |
|
25 | 31 | --- |
26 | 32 |
|
27 | | -## 🛠 Requirements |
28 | | - |
29 | | -- Python **3.8+** |
30 | | - |
31 | | -- Tkinter (comes pre-installed with Python) |
32 | | - |
33 | | -- datetime (Python standard library) |
| 33 | +## Requirements |
34 | 34 |
|
35 | | -To check if Tkinter is installed, run: |
| 35 | +| Dependency | Description | |
| 36 | +|-------------|-------------| |
| 37 | +| **Python 3.8+** | Core programming language | |
| 38 | +| **Tkinter** | GUI framework (preinstalled with Python) | |
| 39 | +| **datetime** | For time management | |
36 | 40 |
|
| 41 | +Check if Tkinter is available: |
37 | 42 | ```python |
38 | 43 | import tkinter |
39 | 44 | print("Tkinter is working!") |
40 | 45 | ``` |
| 46 | +If missing on Linux, install it with: |
| 47 | +``` |
| 48 | +sudo apt-get install python3-tk |
| 49 | +``` |
| 50 | +## How to Run |
41 | 51 |
|
42 | | -If not installed on Linux: |
43 | | - |
44 | | -```sudo apt-get install python3-tk``` |
45 | | - |
46 | | -## ▶️ How to Run |
47 | | - |
48 | | -Clone the repository: |
49 | | - |
| 52 | +1️⃣ Clone the Repository |
50 | 53 | ``` |
51 | | -git clone https://github.com/mantrapatil03/python-beginner-friendly-projects/alarm-clock.git |
52 | | -cd alarm-clock |
| 54 | +git clone https://github.com/mantrapatil03/python-beginner-friendly-projects.git |
| 55 | +cd python-beginner-friendly-projects/alarm-clock |
53 | 56 | ``` |
54 | | -(Optional) Create a virtual environment: |
55 | 57 |
|
| 58 | +2️⃣ (Optional) Create a Virtual Environment |
56 | 59 | ``` |
57 | 60 | python -m venv venv |
58 | | -source venv/bin/activate # On Linux/Mac |
59 | | -venv\Scripts\activate # On Windows |
| 61 | +# Activate environment |
| 62 | +source venv/bin/activate # macOS/Linux |
| 63 | +venv\Scripts\activate # Windows |
60 | 64 | ``` |
61 | | -Install dependencies: |
| 65 | + |
| 66 | +3️⃣ Install Dependencies |
62 | 67 | ``` |
63 | 68 | pip install -r requirements.txt |
64 | 69 | ``` |
65 | | -Run the program: |
| 70 | +4️⃣ Run the App |
66 | 71 | ``` |
67 | 72 | python alarm_clock.py |
68 | 73 | ``` |
69 | | - |
70 | | - |
71 | | - |
72 | | -## 📌 Future Improvements |
73 | | - |
74 | | -🔊 Add alarm sound |
75 | | - |
76 | | -⏰ Allow multiple alarms |
77 | | - |
78 | | -🛌 Add snooze button |
79 | | - |
80 | | -📜 Save alarm history |
81 | | - |
82 | | -## 🏷 Author |
83 | | - |
84 | | -Mantra Patil |
| 74 | +> Tip: Keep the app running in the background — it will alert you when the alarm time matches your system clock. |
| 75 | +
|
| 76 | +### Future Roadmap |
| 77 | +| Feature | Status | Description | |
| 78 | +| --------------------- | :-------: | ---------------------------------- | |
| 79 | +| Add alarm sound | Planned | Play audio when alarm triggers | |
| 80 | +| Multiple alarms | Planned | Support for more than one alarm | |
| 81 | +| Snooze option | Planned | Add “Remind me later” button | |
| 82 | +| Save alarm history | Planned | Keep a log of past alarms | |
| 83 | +| Custom themes | Planned | Light/Dark mode for Tkinter window | |
| 84 | + |
| 85 | +### Contributing |
| 86 | + |
| 87 | +Contributions are always welcome! 🚀 |
| 88 | +- Fork this repository |
| 89 | +- Create a feature branch |
| 90 | + ``` |
| 91 | + git checkout -b feature/your-feature |
| 92 | + ``` |
| 93 | +- Commit your changes |
| 94 | +- Push to your fork |
| 95 | +- Open a Pull Request |
| 96 | +> Please follow clean code practices and PEP8 styling. |
| 97 | +
|
| 98 | +## Author |
| 99 | +**Mantra Patil** |
85 | 100 |
|
86 | 101 | 💼 LinkedIn: https://www.linkedin.com/in/mantrapatil25 |
87 | 102 |
|
88 | | -✉ techmantrapatil@gmail.com |
| 103 | +✉️ techmantrapatil@gmail.com |
| 104 | +
|
89 | 105 |
|
| 106 | +<h3 align="center">🎉 Thanks for checking out my Alarm Clock project! 🎉</h3> <p align="center"> If you found this helpful, please consider giving it a ⭐ on GitHub! <br><br> <img src="https://img.shields.io/badge/Keep%20Coding-Build%20with%20Python-orange?style=for-the-badge&logo=python"> </p> |
0 commit comments