# SoulSync - Music Sync & Manager

## System Dashboard

Monitor your music system health and manage operations

### Service Status

Spotify ●

Disconnected

Response: --

Plex ●

Disconnected

Response: --

Soulseek ●

Disconnected

Response: --

### System Statistics

Active Downloads

0

Currently downloading

Finished Downloads

0

Completed this session

Download Speed

0 KB/s

Combined speed

Active Syncs

0

Playlists syncing

System Uptime

0m

Application runtime

Memory Usage

--

Current usage

### Tools & Operations

#### Database Updater

Last Full Refresh: Never

Artists: 0
Albums: 0
Tracks: 0
Size: 0.0 MB

Idle

0 / 0 artists (0.0%)

#### Metadata Updater

Updates artist photos, genres, and album art from Spotify.

Current Artist: Not running

0 / 0 artists (0.0%)

### Recent Activity

📊

System Started

Dashboard initialized successfully

Now

## Playlist Sync

Synchronize your Spotify, Tidal, and YouTube playlists with your media server

### Your Spotify Playlists

Click 'Refresh' to load your Spotify playlists.

### Your Tidal Playlists

Click 'Refresh' to load your Tidal playlists.
Parsed YouTube playlists will appear here.

## 🎵 Music Downloads

Search, discover, and download high-quality music

Type:
Format:
Sort by:

Ready to search • Enter artist, song, or album name

### Search Results

Your search results will appear here.

### Download Manager

• Active Downloads: 0

• Finished Downloads: 0

No active downloads.
No finished downloads.

## Artists

## Settings

### API Configuration

#### Spotify

Client ID:
Client Secret:
Required Redirect URI:
http://127.0.0.1:8888/callback
Add this URL to your Spotify app's 'Redirect URIs' in the Spotify Developer Dashboard

#### Tidal

Client ID:
Client Secret:
Required Redirect URI:
http://127.0.0.1:8889/tidal/callback
Add this URL to your Tidal app configuration

#### Soulseek

slskd URL:
API Key:

### Server Connections

Plex Server URL:
Plex Token:
Jellyfin Server URL:
API Key:

### Download Settings

Preferred Quality:
Slskd Download Dir:
Matched Transfer Dir (Plex Music Dir?):

### Database Settings

Concurrent Workers:
Number of parallel threads for database updates. Higher values = faster updates but more server load.

### 🎵 Metadata Enhancement

Enable metadata enhancement with Spotify data
Embed high-quality album art from Spotify
Supported Formats:
MP3, FLAC, MP4/M4A, OGG

### Playlist Sync Settings

Create playlist backups before sync

### Logging Information

Log Level:
DEBUG
Log Path:
logs/app.log
Processing...

## Match Download to Spotify

### Step 1: Select the correct Artist

Choose the artist that best matches your download

#### Top Suggestions

#### Or, Search Manually

### Step 2: Select the correct Album

Choose the album that best matches your download for

#### Top Suggestions

#### Or, Search Manually

## What's New in SoulSync

Version 0.65 - Tidal Playlist Integration