Skip to content

🍅 Pomodoro Timer Web Application Integrated with Binaural Frequencies

Notifications You must be signed in to change notification settings

thomasjvu/pomodaural

Repository files navigation

Pomodaural

🍅 A Pomodoro Timer Web Application Integrated with Binaural Frequencies

pomodaural_cover

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.

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]].

About

🍅 Pomodoro Timer Web Application Integrated with Binaural Frequencies

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published