Spotify Sync

Automatically sync your Last.fm listening history and maintain smart Spotify playlists based on your actual listening patterns.

Overview

This project fetches your complete listening history from Last.fm and uses it to automatically generate and update Spotify playlists:

• Most Listened To: Your top 50 all-time tracks by play count
• Recent Favorites: Top 25 tracks from the last 30 days
• Binged Songs: Top 25 songs you've played 3+ times in a single day

Features

• ✅ Fetches listening history from Last.fm
• ✅ Automatic syncing every 5 minutes
• ✅ Smart playlist generation based on listening patterns
• ✅ Web dashboard for monitoring and control
• ✅ SQLite database for local history storage
• ✅ Resume capability for interrupted syncs
• ✅ Comprehensive error handling and logging

Project Structure

spotify_sync/
├── src/                     # Source code
│   ├── api/                # External API clients
│   ├── core/               # Database and configuration
│   ├── services/           # Business logic
│   ├── scheduler/          # Automated tasks
│   └── web/                # Flask web application
├── scripts/                 # Utility and maintenance scripts
├── templates/               # HTML templates
├── static/                  # CSS/JS assets
├── tests/                   # Test suite
├── data/                    # Data files (gitignored)
│   ├── csv/                # CSV exports
│   ├── cache/              # API caches
│   └── db/                 # SQLite database
├── notebooks/               # Jupyter notebooks (archived)
├── logs/                    # Application logs
├── run.py                   # Main entry point
├── config.yaml             # Configuration file
└── requirements.txt        # Python dependencies

Setup

See the detailed setup guide for full instructions.

Quick Start

1. Clone the repository
2. Set up environment variables (see .env.example)
3. Run the automated system:

   python run.py

4. Access the web dashboard at http://localhost:5001

Data Flow

Last.fm API → SQLite Database → Spotify Playlists
     ↓              ↓                    ↑
(listening)    (storage)          (auto-update)

Requirements

• Python 3.10+
• Last.fm API credentials
• Spotify API credentials
• SQLite

Legacy Jupyter Notebook

The original Jupyter notebook implementation has been archived in the notebooks/ directory.