Spotify Skip Tracker

Spotify Skip Tracker serves as a valuable tool for music enthusiasts seeking to gain insights into their listening habits on Spotify. By tracking all plays and skips across devices, this program enables users to understand their music preferences and behaviors over time.

Key Features

Core Tracking

• Cross-Device Skip Detection: Monitors song skips by polling the Spotify Web API every 7 seconds, ensuring accurate detection as songs play across devices.
• Accurate Skipping Logic: A song is registered as skipped only if less than 90% has been played, 30 seconds remain, and the skip is not due to shuffling or changing playlists.
• Multi-User Support: Each Spotify account has an independent tracking thread, ensuring complete isolation of user data.
• Persistent Tracking: The application runs continuously on Railway, maintaining functionality through token expiration and brief network disruptions.

Dashboard Overview

• Now Playing Widget: Displays the currently playing track with album art, plus historical skip rates.
• Statistics Overview: Provides insights into total plays, skips, overall skip rate, and longest listening streak.
• Charts: Visualizes skip rates by hour of the day, day of the week, artist, and listening context.
• Activity Heatmap: Presents a visualization of skips across the past year.
• Top Tables: Lists the most-skipped songs, most-completed tracks, and the most frequent listening contexts.
• Listening Score: Generates a score based on completion rates and consistency of listening sessions.

Intelligence Features

• Music Coach: Offers insights into listening patterns, including session timing and skip trends.
• Smart Skipper: Automatically skips songs with a high skip rate, along with a dry-run mode for testing.
• Playlist Janitor: Analyzes playlists to recommend tracks for removal based on consistent skipping behavior.

Additional Utilities

• Wrapped Report: Automatically generates monthly HTML summaries of listening statistics.
• CSV Export: Facilitates data exporting to spreadsheets.
• Album Art Backfill: Retrieves missing artwork for previously played tracks.
• Demo Mode: Displays a dashboard with static data for demonstration purposes.

Technical Stack

Utilizes the following technologies:

• Backend: Built with Python 3.12+, utilizing Flask for the web framework and PostgreSQL as the database.
• Frontend: Developed with React using TypeScript and styled with Tailwind CSS.
• Infrastructure: Deployed on Railway for runtime services and Vercel for static frontend hosting, sharing a Neon PostgreSQL database.

Architecture Overview

Designed to facilitate efficient tracking of Spotify accounts while maintaining performance and reliability, the architecture enables seamless data handling and user interaction.

Conclusion

Spotify Skip Tracker provides comprehensive tracking and analysis of Spotify listening behavior. Its robust features make it an essential tool for users aiming to understand and improve their musical experience.