Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/thomasjvu/pomodaural
🍅 Pomodoro Timer Web Application Integrated with Binaural Frequencies
https://github.com/thomasjvu/pomodaural
Last synced: 9 days ago
JSON representation
🍅 Pomodoro Timer Web Application Integrated with Binaural Frequencies
- Host: GitHub
- URL: https://github.com/thomasjvu/pomodaural
- Owner: thomasjvu
- Created: 2023-05-27T04:46:41.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2024-09-10T00:24:36.000Z (4 months ago)
- Last Synced: 2024-11-09T15:52:26.678Z (about 2 months ago)
- Language: TypeScript
- Homepage: https://pomodaural.com
- Size: 1.82 MB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Pomodaural
🍅 A Pomodoro Timer Web Application Integrated with Binaural Frequencies
## About
Pomodaural is a unique web application that combines the Pomodoro Technique with Binaural Beats to enhance focus and productivity. It allows users to set focused study sessions typically consisting of 25 minutes of work followed by 5 minutes of rest.
### What is the Pomodoro Technique?
The Pomodoro Technique is a time management method developed by Francesco Cirillo in the late 1980s. It uses a timer to break work into intervals, traditionally 25 minutes in length, separated by short breaks. These intervals are known as "pomodoros," the plural in English of the Italian word pomodoro (tomato), after the tomato-shaped kitchen timer that Cirillo used as a university student.
### What are Binaural Beats?
Binaural beats are an auditory illusion perceived when two different pure-tone sine waves, both with frequencies lower than 1500 Hz, with less than a 40 Hz difference between them, are presented to a listener dichotically (one through each ear). Some studies suggest that binaural beats can help with focus, creativity, and relaxation, although research is ongoing.
## Features
- Customizable work and break durations
- Integrated binaural beat generator with adjustable frequencies
- Session tracking and history
- Mobile-responsive design
- Local storage for saving user preferences and session history
## Technologies Used
- React (Vite)
- TypeScript
- TailwindCSS (Daisy UI)
- LocalStorage API
- Web Audio API
## Getting Started
1. Clone the repository
```
git clone https://github.com/yourusername/pomodaural.git
```
2. Navigate to the project directory
```
cd pomodaural
```
3. Install dependencies
```
npm install
```
4. Start the development server
```
npm run dev
```
## Usage
1. Set your desired work and break durations
2. Choose a binaural frequency preset or set custom frequencies
3. Click "Start" to begin your Pomodoro session
4. Focus on your task until the timer ends
5. Take a break when prompted
6. Repeat the cycle as needed
## Contributing
Contributions are welcome! Please feel free to submit a Pull Request.
## License
This project is licensed under the [MIT License](LICENSE).
## Disclaimer
Please set your volume to a suitable level for your ears. Listening at high volumes may be harmful to your hearing. The effectiveness of binaural beats may vary from person to person, and this application should not be considered a substitute for medical advice or treatment.
## Contact
If you have any questions, feel free to reach out to me at [[email protected]].