A modern, responsive Pomodoro Timer web app with customizable durations and integrated Spotify playlist support.
Features a settings modal, background blur, and a floating Spotify button with animated feedback.
- Pomodoro Timer: Start, pause, and reset a customizable Pomodoro timer.
- Custom Durations: Set your preferred Pomodoro and break durations in the settings modal.
- Spotify Integration:
- Floating Spotify button (FAB) always visible.
- Click the button to reveal a Spotify playlist player with animation.
- Paste any Spotify playlist URL in settings to change the playlist.
- The FAB vibrates (dances) when the player is open.
- Responsive Design: Works and looks great on desktop and mobile.
- Aesthetic UI: Clean, modern look with background blur and smooth transitions.
- Persistent Settings: Your timer settings are saved in your browser.
-
Clone or Download this Repository
git clone https://github.com/yourusername/pomodoro-spotify.git cd pomodoro-spotify -
Add Your Assets
- Place your background image as
hero.pngin the project root orassets/folder. - (Optional) Update screenshots in the
assets/folder.
- Place your background image as
-
Open
index.htmlin your browser
- Start Timer: Click on the timer to start.
- Reset Timer: Click the "Reset" button.
- Open Settings: Click the ⚙️ icon (top right) to adjust durations and playlist.
- Change Playlist: Paste a Spotify playlist URL in the settings modal and click "Update Playlist".
- Spotify Player:
- Click the floating Spotify icon (bottom left) to open the player.
- Click outside the player or on the player to close it.
- The icon vibrates while the player is open.
- Background: Replace
hero.pngwith your own image for a new look. - Colors & Styles: Edit
style.cssfor further customization. - Sounds: Add your own alarm sound in
script.jsif desired.
- Spotify Embed: Only plays 30 seconds unless the user is logged in with a Spotify Premium account in their browser.
- No Play/Pause Detection: The FAB vibrates when the player is open, not based on actual playback state (due to Spotify embed limitations).
- Spotify for the embed player and icon.
- Simple Icons for the Spotify SVG.
- Inspired by the Pomodoro Technique.
MIT License