Nezreka / SoulSync

SoulSync - Intelligent Music Discovery & Automation Platform **Spotify-quality music discovery for self-hosted libraries.** Automates downloads, curates playlists, monitors artists, and organizes your collection with zero manual effort. > **IMPORTANT**: Configure file sharing in slskd to avoid Soulseek bans. Set up shared folders at . **Community**: Discord | **Support**: GitHub Issues | **Donate**: Ko-fi --- What It Does SoulSync bridges streaming services to your media server with automated discovery: • **Monitors artists** → Automatically detects new releases from your watchlist • **Generates playlists** → Release Radar, Discovery Weekly, Seasonal, Decade/Genre mixes • **Downloads missing tracks** → From Soulseek, Tidal (lossless/Hi-Res), YouTube, Beatport charts, Spotify/Tidal/YouTube playlists • **Verifies downloads** → AcoustID fingerprinting confirms you got the right track • **Enriches metadata** → LRC lyrics, album art, MusicBrainz IDs, proper tags • **Organizes files** → Custom templates for clean folder structures • **Syncs media server** → Plex, Jellyfin, or Navidrome stay updated automatically --- Key Features Discovery Engine **Release Radar** - 30 new tracks from watchlist artists (updates daily) **Discovery Weekly** - 50 tracks from similar artists using custom algorithm • 20 popular + 20 mid-tier + 10 deep cuts • Built from 1000+ track discovery pool • Refreshes every 24 hours **Seasonal Playlists** - Halloween, Christmas, Valentine's, Summer, Spring, Autumn (auto-generated based on time of year) **Personalized Playlists** (12+ types) • Recently Added, Top Tracks, Forgotten Favorites • Decade Playlists (1960s-2020s), Genre Playlists (15 categories) • Daily Mixes, Hidden Gems, Popular Picks, Discovery Shuffle, Familiar Favorites • Custom Playlist Builder **ListenBrainz** - Import recommendation and community playlists **Beatport** - Full electronic music integration with genre browser (39+ genres) • Top 100, Hype Charts, DJ Charts, Staff Picks, New Releases • Browse by genre with dedicated discovery UI Multi-Source Downloads **Download Sources**: Soulseek (FLAC priority), Tidal (direct streaming up to Hi-Res FLAC), YouTube (audio extraction), or Hybrid mode (tries primary source, falls back automatically) **Playlist Sources**: Spotify, Tidal, YouTube, Beatport charts, ListenBrainz **Tidal Downloads** - Full download source with lossless and Hi-Res audio • Device-flow OAuth — authenticate via from Settings • Quality tiers: AAC 96/320kbps, FLAC 16-bit/44.1kHz (lossless), FLAC 24-bit/96kHz (Hi-Res) • Automatic quality fallback: if requested tier is unavailable, tries next best • Hi-Res MP4-wrapped FLAC auto-extracted via FFmpeg • Works as a standalone source or as part of Hybrid mode fallback chain • Also supports playlist import: load your Tidal playlists, auto-match tracks to Spotify, then sync and download **Features** • Quality profiles with presets: Audiophile, Balanced, Space Saver • Per-format configuration (FLAC, MP3, OGG, AAC, WMA) with min/max size and priority • Automatic format fallback (FLAC → MP3 → next best) • Duplicate prevention against existing library • Batch processing with concurrent workers and automatic retry logic • Source reuse — when downloading an album, reuses the same uploader for consistency • Synchronized lyrics (LRC) via LRClib for every track Audio Verification **AcoustID Fingerprinting** (optional) - Verifies downloaded files actually match the expected track • Generates audio fingerprints and checks against AcoustID database • Compares title and artist using fuzzy matching with configurable thresholds • Fail-open design: verification errors never block downloads, only confident mismatches are rejected • Mismatched files are flagged and can be re-queued via the wishlist Dual-Source Metadata • **Primary**: Spotify — richer data, discovery features, playlist sync • **Backup**: iTunes/Apple Music — no authentication required, works out of the box • **Seamless switching**: If Spotify is unavailable, rate-limited, or unauthorized, SoulSync automatically falls back to iTunes for metadata, cover art, and artist info • **MusicBrainz enrichment** — background worker matches artists, albums, and tracks to MusicBrainz IDs with 90-day caching Advanced Matching Engine • Version-aware matching: strictly rejects remixes when you want the original (and vice versa) • Unicode and accent handling (KoЯn, Bjork, A$AP Rocky) • Fuzzy matching with weighted confidence scoring (title, artist, duration) • Album variation detection (Deluxe, Remastered, Taylor's Version, etc.) • Multi-query search strategy: generates 4-6 query variations per track • Short title protection: prevents "Love" from matching "Loveless" • Source-specific weighting: Soulseek prioritizes artist match, YouTube prioritizes title match Automation **Automation Engine** - Visual drag-and-drop builder for custom workflows • **Triggers**: Schedule (interval/daily/weekly), Track Downloaded, Batch Complete, Playlist Changed, Discovery Complete, and 10+ more event types • **Actions**: Process Wishlist, Scan Watchlist, Refresh Mirrored Playlist, Discover Playlist, Sync Playlist, Scan Library, Update Database, Run Duplicate Cleaner, Quality Scan, and more • **Notifications**: Discord webhooks, Pushbullet, Telegram — with variable substitution for dynamic messages • **Conditions**: Filter triggers by artist, title, playlist name, quality, and other fields with contains/equals/starts_with operators • **System Automations**: Built-in wishlist processing (every 30 min) and watchlist scanning (every 24 hr) — configurable but non-deletable • **Playlist Discovery Pipeline**: Automatically discovers official Spotify/iTunes metadata for YouTube/Tidal mirrored playlists, ensuring nothing syncs or downloads without verified context **Watchlist** - Monitor unlimited artists with per-artist configuration • Choose which release types to track: Albums, EPs, Singles • Content filters: Live, Remi…