https://github.com/yasharthbajpai/alarm-
A Python-based alarm timer that counts down from a user-specified time and plays a sound when the time is up.
https://github.com/yasharthbajpai/alarm-
python3
Last synced: 2 months ago
JSON representation
A Python-based alarm timer that counts down from a user-specified time and plays a sound when the time is up.
- Host: GitHub
- URL: https://github.com/yasharthbajpai/alarm-
- Owner: yasharthbajpai
- License: cc0-1.0
- Created: 2025-03-22T10:10:45.000Z (2 months ago)
- Default Branch: main
- Last Pushed: 2025-03-22T10:12:19.000Z (2 months ago)
- Last Synced: 2025-03-22T11:23:02.386Z (2 months ago)
- Topics: python3
- Language: Python
- Homepage:
- Size: 8.21 MB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Alarm Timer
A simple Python-based alarm timer that counts down from a user-specified time and plays a sound when the timer reaches zero.
---
## Features
- Allows users to input the countdown time in minutes and seconds.
- Displays a live countdown timer in the terminal.
- Plays a sound (`nyc3.mp3`) when the timer finishes.
---
## Requirements
Before running the project, ensure you have Python installed and the following dependencies:
- `playsound==1.2.2`
- `pip` for managing Python packages.
---
## Installation
1. Clone this repository:
```bash
git clone https://github.com/yourusername/alarm-timer.git
cd alarm-timer
```
2. Install required dependencies:
```bash
pip install --upgrade pip setuptools wheel
pip install playsound==1.2.2
```
3. Place your sound file (`nyc3.mp3`) in the same directory as the script.
---
## Usage
Run the script using Python:
```bash
python alarm_timer.py
```
Follow the prompts to enter the countdown time in minutes and seconds. The timer will display a live countdown in the terminal and play the sound when time is up.
---
## License
This project is licensed under the **Creative Commons Zero v1.0 Universal** license.
Feel free to use, modify, and distribute this project without restrictions.
---
## Contributing
Feel free to open issues or submit pull requests if you find bugs or want to improve functionality.
---
## Author
Created by Yasharth Bajpai.
Let me know if you have any feedback or suggestions! 😊