Settings
Updates
Current version: —
IANA timezone for timestamps on the Requests page (e.g. Europe/London, UTC).
Library
Where finished downloads are moved. This folder is always scanned for track availability.
Additional directories scanned only for availability (not used as the download target). Paths must not duplicate the primary folder.
Use variables like %artist%, %album%, %title%,
%year%, %track_number%, %format%. Use
/ for folders. The extension is added automatically. Applies only to
new downloads.
Open a window to pick a local audio file, match it to Deezer, then run the same library import steps as after a download (tags, rename, move into the music library folder).
Requests
0 disables automatic removal.
0 disables automatic retry.
SMTP settings for the recurring Status email job (Jobs tab). Use TLS on port 587 or enable secure connection for port 465.
Optional if your relay does not require authentication.
Comma-separated addresses for the digest.
Download
Soulseek / slskd connection and download behavior.
Where slskd writes finished files before TrackFlow moves them into the library.
Leave empty to use the default cap (50 MiB).
Soulseek search attempts before marking a request failed (1–20).
How many approved requests run downloads at once (1–50).
Integrations
Plex
Often 4 — check your Plex library URL.
When enabled, the login page shows Sign in with Plex. New Plex sign-ins are added as users with provider Plex and role User.
When enabled, each Plex Sync job asks Plex Media Server to refresh the music library, runs a TrackFlow filesystem library scan, maps Plex rating keys for playlist sync, then syncs followed playlists.
When enabled, users who sign in with Plex use recent music play history from your configured Plex server to seed Discover track and artist recommendations instead of followed artists. Plays count only when at least half of the track was heard (short skips are ignored).
Jobs
Background tasks checked every minute. Intervals are in minutes.
| Description | Enabled | Interval | Last run | Result | Next scheduled | Run now |
|---|---|---|---|---|---|---|
| Refresh discover and recommendations cache | — | — | — | |||
| Scan library files in folder | — | — | — | |||
| Sync followed artists and playlists tracks | — | — | — | |||
| Completed download folder cleanup | — | — | — | |||
| Clear completed requests and retry failed | — | — | — | |||
| Send status email (digest) | — | — | — | |||
| Plex Sync (rating keys + playlists) | — | — | — |
Users
Create logins and assign Admin or User. Users only see their own track requests and cannot open Settings. The built-in administrator cannot be deleted or reassigned to User.
Existing users
| Username | Provider | Role | Jukebox | Actions |
|---|