Notion-Countdown-Timer

This project offers a countdown timer that utilizes the Youtube API Sound Player, making it embeddable into Notion pages via Apption.co. Users can easily set timers ranging from 5 minutes to 60 minutes and more to enjoy the convenience of a sound alarm upon completion.

Usage

1. Access the timer through this link.
2. Copy link and paste as embed into your notion pages.
3. Click on the timer buttons to add time to the countdown:
   • "+5 min": Adds 5 minutes to the current countdown.
   • "+15 min": Adds 15 minutes to the current countdown.
   • "+30 min": Adds 30 minutes to the current countdown.
   • "+60 min": Adds 60 minutes to the current countdown.
4. Press the "Play" button to start the countdown.
5. Use the "Pause" button to pause the countdown.
6. Press the "End" button to reset the timer.

Features

• Embedded Countdown Timer: Easily embeddable into Notion pages via Apption.co.
• Dynamic Incremental Timer: Swiftly add time to your timer by pressing any of the "minute add" buttons to increase the duration.
• Timer Controls: Start, pause, and end the timer with intuitive controls.
• Sound Alarm: Plays a sound notification upon timer completion.

Future Features

• Light Mode: Implement a light mode option for users who prefer a brighter interface.
• Custom Sounds: Allow users to choose custom alarm sounds from a selection of options or provide their own sound URL.
• Custom Backgrounds: Enable users to personalize the timer's appearance by selecting different background themes or uploading custom backgrounds.
• Saved Progress: Implement browser storage to save the timer's progress, allowing it to resume from the last known time even after the page is exited or refreshed.
• Add GitHub Pages: Enable open-source contributors to make their own changes to the codebase by hosting the project on GitHub Pages.
• Implement Testing: Ensure functionality remains intact by incorporating tests to prevent potential issues or bugs before changes are merged into the repository.

Donation

To upkeep this project and keep ADs away from your embed timer - please consider making a $1 donation once or monthly or whenever you can to support keeping this and future projects being free and available to you and everyone. Im a broke unemployed programmer so the help would be greatly appreciated 🙏 Make a 1 dollar Donation

Bugs to Fix

• YouTube API Delay: Address delay in YouTube API's response for timer sound.

Support and Contributions

• For issues or feature requests, please visit the GitHub page.
• Updates and maintenance will be done and pushed through by Apption.co.

---

License

This project is licensed under the MIT License, encouraging collaboration, innovation, and legal clarity. The MIT License allows users to freely use, modify, and distribute the software while providing clear legal terms and protecting the project's contributors.