Releases: Nezreka/SoulSync
Version 1.8 - Automations
v1.8 — Automation Engine & Discovery Pipeline
SoulSync now runs itself. Build visual automations that chain triggers, actions, and notifications — then watch them work in
real-time.
Automation Engine
- Visual drag-and-drop builder: connect WHEN triggers → DO actions → NOTIFY alerts - 20+ triggers: schedule (interval, daily, weekly), or react to events (track downloaded, batch complete, new release found, playlist changed, discovery complete, and more) - 14 actions: process wishlist, scan watchlist, refresh/discover/sync playlists, database update, quality scan, backup, and more
- Conditions with match modes (All/Any) and operators (contains, equals, starts_with, not_contains)
- Configurable delay on actions — wait N minutes after trigger fires before executing
- System automations for wishlist (every 30 min) and watchlist (every 24 hr) with cross-guards
- Run Now button on every card for instant testing
- Live progress tracking — real-time output panels on automation cards showing progress bars and scrolling per-item logs as
actions run
Playlist Discovery Pipeline
- New Discover Playlist action matches raw YouTube/Tidal tracks to official Spotify or iTunes metadata
- Fuzzy title/artist matching with confidence scoring (minimum 0.7 threshold)
- Discovery results cached globally across playlists for instant repeat lookups
- Sync Playlist now only includes discovered tracks — undiscovered tracks are skipped entirely
- Prevents garbage metadata (wrong artist, no album, no cover art) from reaching the wishlist
- Spotify-sourced playlists auto-discovered during refresh at confidence 1.0
- Chain automations: Refresh → Playlist Changed → Discover → Discovery Complete → Sync
Notification Integrations
- Discord Webhook — post automation results to any channel
- Pushbullet — push notifications to phone and desktop
- Telegram Bot — send alerts via Telegram Bot API
- Variable substitution in messages: {artist}, {title}, {album}, {quality}, {time}, and more
Version 1.7 - Tidal downloads if authorized - REST API 1.0 - Local profiles
Tidal as a Download Source — Tidal joins Soulseek and YouTube as a full download source. Authenticate via device flow, pick your quality (AAC 96k up to HiRes FLAC 24-bit), and use it standalone or in Hybrid mode with fallback between sources.
SoulSync REST API v1.0 now live
Rebuilt incremental scan to detect removed items
Local profiles
Mirrored playlists
Version 1.6 - Local import, enhanced tagging, mobile layout
Update version to 1.6 in sidebar and API. Add local import, enhanced tagging, mobile layout, and performance improvements. Fix track popularity field access for upcoming Spotify API changes (February 2026).
Loads of bug fixes and ongoing bug fixes in this release
Version 1.5 - AcoustID audio verification, MusicBrainz enrichment UI
Add optional post-download audio fingerprint verification using AcoustID.
Downloads are verified against expected track/artist using fuzzy string
matching on AcoustID results. Mismatched files are quarantined and
automatically added to the wishlist for retry.
- AcoustID verification with title/artist fuzzy matching (not MBID comparison)
- Quarantine system with JSON metadata sidecars for failed verifications
- fpcalc binary auto-download for Windows, macOS (universal), and Linux
- MusicBrainz enrichment worker with live status UI and track badges
- Settings page AcoustID section with real-fingerprint connection test
- Source reuse for album downloads to keep tracks from same Soulseek user
- Enhanced search queries for better track matching
- Bug fixes: wishlist tracking, album splitting, regex & handling, log rotation
Version 1.4 - Apple Music metadata support
Apple Music added as fallback metadata source if Spotify is not available. Spotify is always preferred if it is available with its richer data responses. Will easily swap from Spotify to Apple Music on the fly if you are rate limited by Spotify or worse, temp banned.
Apple Music and Spotify will now each have their own discovery pool for the discover page. Both will always be updated on every watchlist scan so long as Spotify is authorized, otherwise only Apple Music data is pulled.
Known issues:
Any artist image pulled while Apple Music is the primary source will only pull album art for that artist since they do not provide artist images :( Since the app uses a random album image as artist photo this can, very rarely, lead to cases where the album image that is pulled could have another another artist displayed if it's some collab single, EP or something. Seen it happen once with an indie artist so it's possible.
Looking for a great api / website to parse easily specifically for artist photos and a huge db to pull from.
1.4 Also includes Album level auto search for soulseek results.
Version 1.3 - Youtube as download source. Hybrid Soulseek / Youtube.
With this release, SoulSync can now search YouTube as a primary source. Includes some backwards compatibility changes.
1.2 Enhanced Search
Unified search across Spotify, your library, and Soulseek with categorized results (artists, albums, tracks)
1.1 - Discovery page
Added a new Discover page that utilizes the user watchlist which generates a discovery pool that is automatically updated every day. The discovery pool is used to display a large list of playlists similar to what you would find on Spotify. 'Fresh Tape' == 'Release Radar', at least that is the intent. Also includes seasonal playlists that will appear at the appropriate times. The discover pool will maintain one year rolling history of the data it collects. After that point the oldest data is removed as new data is added. The more artists you have in your watchlist, the better the discovery pool results.
1.0 Gui / Webui / Docker / Navidrome Support
Rebuilt the entire app to run in flask web browser and docker compatibility.