{"id":20095316,"url":"https://github.com/rlalpha49/spotifyskiptracker","last_synced_at":"2026-04-05T21:03:52.145Z","repository":{"id":258521323,"uuid":"869840655","full_name":"RLAlpha49/SpotifySkipTracker","owner":"RLAlpha49","description":"Spotify Skip Tracker is a application designed to monitor and track Spotify playback.","archived":false,"fork":false,"pushed_at":"2024-10-18T15:43:32.000Z","size":89,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"master","last_synced_at":"2024-10-19T11:41:53.607Z","etag":null,"topics":["api","automation","flask","music","python","spotify-api"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/RLAlpha49.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-10-09T01:34:01.000Z","updated_at":"2024-10-18T15:43:36.000Z","dependencies_parsed_at":"2024-10-19T11:42:00.886Z","dependency_job_id":"4e3162f0-4d9c-49a9-8c0f-5b5f80ca916f","html_url":"https://github.com/RLAlpha49/SpotifySkipTracker","commit_stats":null,"previous_names":["rlalpha49/spotifyskiptracker"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/RLAlpha49%2FSpotifySkipTracker","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/RLAlpha49%2FSpotifySkipTracker/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/RLAlpha49%2FSpotifySkipTracker/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/RLAlpha49%2FSpotifySkipTracker/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/RLAlpha49","download_url":"https://codeload.github.com/RLAlpha49/SpotifySkipTracker/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":241534677,"owners_count":19978020,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["api","automation","flask","music","python","spotify-api"],"created_at":"2024-11-13T16:54:50.263Z","updated_at":"2025-12-30T22:07:06.391Z","avatar_url":"https://github.com/RLAlpha49.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n\n![SpotifySkipTrackerIconTransparent](https://github.com/user-attachments/assets/4023e57b-64b6-4b60-a369-42290dc887ab)\n\n# Spotify Skip Tracker\n\nTrack, analyze, and refine your music library automatically\n\n[![GitHub license](https://img.shields.io/github/license/RLAlpha49/SpotifySkipTracker?style=flat-square)](https://github.com/RLAlpha49/SpotifySkipTracker/blob/master/LICENSE)\n[![GitHub stars](https://img.shields.io/github/stars/RLAlpha49/SpotifySkipTracker?style=flat-square)](https://github.com/RLAlpha49/SpotifySkipTracker/stargazers)\n[![GitHub issues](https://img.shields.io/github/issues/RLAlpha49/SpotifySkipTracker?style=flat-square)](https://github.com/RLAlpha49/SpotifySkipTracker/issues)\n\n\u003c/div\u003e\n\n## 🎵 Overview\n\nSpotify Skip Tracker is a desktop application that analyzes your Spotify listening habits, with a focus on identifying songs you frequently skip. It helps you maintain a cleaner music library by providing insights into which tracks you consistently skip over and offers tools to help manage your library based on your actual listening behavior.\n\n![Dashboard Screenshot](https://github.com/user-attachments/assets/7eac6386-d99e-4191-8f2c-9f8c659f3ad8)\n\n## ✨ Key Features\n\n- **Real-time Skip Tracking**: Monitors your Spotify playback in real-time and detects when you skip tracks\n- **Skip Pattern Analysis**: Identifies songs you frequently skip based on customizable thresholds\n- **Library Management**: Offers tools to remove frequently skipped tracks from your library\n- **Auto-Unlike Option**: Automatically removes tracks that exceed your skip threshold\n- **Statistics Dashboard**: Visualizes your listening and skipping patterns with beautiful charts\n- **Now Playing Integration**: Control your Spotify playback directly from the app\n- **Advanced Analytics**: Track listening time, discovery rate, repeat rate, and more\n- **Modern UI/UX**: Clean, responsive interface with light and dark themes\n\n![Skipped Tracks Screenshot](https://github.com/user-attachments/assets/83a4245e-c89e-45b8-9a29-4616886f7b46)\n\n## 📊 Analytics \u0026 Insights\n\nSpotify Skip Tracker doesn't just track skips - it provides comprehensive analytics on your listening habits:\n\n- **Skip Rate Analysis**: Understand which tracks, artists, and genres you skip most frequently\n- **Listening Patterns**: Visualize your listening habits by time of day, day of week, and more\n- **Artist \u0026 Track Insights**: See detailed statistics for your most-played artists and tracks\n- **Device Usage**: Track which devices you use most frequently for listening\n\n![Statistics Dashboard](https://github.com/user-attachments/assets/2dd977ba-6d09-4122-8d71-02f24edaa816)\n\n## 🚀 Getting Started\n\n### Installation\n\nDownload the latest release for your operating system from the [Releases page](https://github.com/RLAlpha49/spotify-skip-tracker/releases).\n\n#### Windows\n\n- Download `Spotify-Skip-Tracker-Setup.exe` or `Spotify-Skip-Tracker-Setup.msi`\n- Run the installer and follow the prompts\n- Once installed, launch Spotify Skip Tracker from the Start Menu or desktop shortcut\n\n#### macOS\n\n- Download `Spotify-Skip-Tracker.dmg` (recommended)\n  - Open the DMG file\n  - Drag the application to your Applications folder\n  - Right-click the app and select \"Open\" (required the first time to bypass Gatekeeper security)\n- Or download `Spotify Skip Tracker-darwin-arm64.zip` (alternative)\n  - Extract the ZIP file\n  - Move the extracted application to your Applications folder\n  - Right-click the app and select \"Open\" (required the first time to bypass Gatekeeper security)\n\n#### Linux\n\n- Download `spotify-skip-tracker_1.0.0_amd64.deb` for Debian-based distributions (Ubuntu, Mint, etc.)\n- Install using your package manager:\n\n  ```bash\n  sudo dpkg -i spotify-skip-tracker_1.0.0_amd64.deb\n  sudo apt-get install -f  # Install dependencies if needed\n  ```\n\n- Launch from your applications menu or run `spotify-skip-tracker` in the terminal\n\n### Platform Notes\n\n\u003e ⚠️ **Important**: This application was primarily developed and tested on Windows. The Linux and macOS versions may have platform-specific issues that haven't been identified yet. If you encounter any bugs or unexpected behavior on any platform (especially macOS or Linux), please [open an issue](https://github.com/RLAlpha49/spotify-skip-tracker/issues) with details about your operating system and the problem you're experiencing.\n\n## 🔧 Setup\n\n1. Create a Spotify Developer Application:\n   - Visit the [Spotify Developer Dashboard](https://developer.spotify.com/dashboard/)\n   - Create a new application\n   - Set the redirect URI to `http://localhost:8888/callback`\n   - Note your Client ID and Client Secret\n\n2. Enter your Spotify API credentials in the app settings\n3. Authorize the application with your Spotify account\n4. Configure your preferences in the Settings page\n\n![Settings Screenshot](https://github.com/user-attachments/assets/13e2f2cd-050b-484b-824a-11d3def54a0e)\n\n## ⚙️ Customization Options\n\nSpotify Skip Tracker offers various configuration options to tailor the experience to your preferences:\n\n- **Skip Detection**:\n  - Set the threshold percentage of a track that must be played before skipping counts\n  - Configure the minimum number of skips before a track is flagged\n  \n- **Library Management**:\n  - Enable/disable automatic removal of frequently skipped tracks\n  - Set the analysis timeframe for determining skip patterns\n\n- **User Interface**:\n  - Choose between light and dark themes\n\n- **Logging**:\n  - Configure log retention settings\n  - Set log level detail (DEBUG, INFO, WARNING, etc.)\n  - View and search detailed activity logs\n\n## 🤔 How It Works\n\n1. **Authentication**: Securely connect to your Spotify account via OAuth\n2. **Monitoring**: The app runs in the background, monitoring your Spotify playback\n3. **Skip Detection**: When you skip a track, the app records this action along with contextual data\n4. **Pattern Analysis**: Over time, algorithms identify which tracks you consistently skip\n5. **Insights Generation**: Statistics and visualizations help you understand your listening habits\n6. **Library Management**: Tools allow you to review and manage frequently skipped tracks\n\n## 💻 For Developers\n\nIf you want to contribute to the project or run it in development mode:\n\n### Prerequisites\n\n- Node.js (v22 or later)\n- npm or yarn\n- Spotify Developer credentials\n\n### Development Setup\n\n1. Clone the repository:\n\n   ```bash\n   git clone https://github.com/RLAlpha49/spotify-skip-tracker.git\n   cd spotify-skip-tracker\n   ```\n\n2. Install dependencies:\n\n   ```bash\n   npm install --force\n   ```\n\n3. Start in development mode:\n\n   ```bash\n   npm run start\n   ```\n\n### Building for Production\n\n```bash\nnpm run make\n```\n\n## 📝 Contributing\n\nContributions are welcome! Please feel free to submit a Pull Request. For major changes, please open an issue first to discuss what you would like to change.\n\n1. Fork the repository\n2. Create your feature branch: `git checkout -b feature/amazing-feature`\n3. Commit your changes: `git commit -m 'Add some amazing feature'`\n4. Push to the branch: `git push origin feature/amazing-feature`\n5. Open a Pull Request\n\n## 📜 License\n\nThis project is licensed under the MIT License - see the [LICENSE](https://github.com/RLAlpha49/spotify-skip-tracker/blob/master/LICENSE) file for details.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frlalpha49%2Fspotifyskiptracker","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Frlalpha49%2Fspotifyskiptracker","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frlalpha49%2Fspotifyskiptracker/lists"}