deemix

deemix is a self-hosted Deezer downloader. It returns tagged files with cover art, so Aurral can use it as a download source for flows and playlists.

Aurral talks to the deemix web server. It searches Deezer for the track, adds the best match to the deemix queue, waits for the queue item to finish, and then imports the file that deemix wrote.

Aurral does not store your ARL. Sign in once in the deemix web UI. Aurral reuses that login through the deemix API.

deemix hands that login back over the address you configure, and that address is usually plain HTTP on your own network. Keep deemix on a network you trust, or put it behind HTTPS if the connection leaves one.

Setup

Run deemix and open its web UI. Sign in with your ARL.
Open Settings > Download clients > deemix.
Turn on Enable deemix.
Set Server URL to your deemix address, for example http://localhost:6595.
Choose a Bitrate. FLAC is the default. Your Deezer plan has to allow it: FLAC needs a lossless plan, and MP3 320 needs a high quality plan. Test connection warns you when the selected bitrate is above your plan, and deemix refuses those downloads rather than lowering the quality.
If necessary, set Source priority.
Select Test connection.
Settings save automatically after each change.

The deemix default priority is 15. The slskd default is 10. The Usenet default is 20. The yt-dlp default is 50.

Path mapping

deemix writes files into its own download folder. Aurral has to read that same file.

Mount the deemix download folder into the Aurral container at the same path, or add a remote path mapping under Settings > Download clients > Remote path mappings with Applies to set to deemix. Use the path that deemix reports as the remote path and the path that Aurral sees as the local path.

Aurral moves the imported file into your Downloads Folder, so the track does not stay in the deemix download folder.

Behavior

Aurral tries download sources in priority order. It ranks Deezer results by title, artist, album, and duration, and it skips tracks that your account cannot stream.

Aurral validates the downloaded audio with the same track validation that it uses for other sources, then writes the playlist’s title, artist, album, album artist, year, and track number into the file.

When a downloaded file matches the requested track but its duration differs significantly, Aurral retains it under Activity > Queue for preview, approval, or denial.

Aurral removes its own queue entry from deemix before it imports the file, including for a track it retains for review, so a repeated request downloads again instead of matching a finished queue item.

If a repeated deemix completion targets a file that is already in the playlist library, Aurral keeps the existing file instead of creating a numbered duplicate.

deemix can also serve quality upgrades. Its bitrate setting fixes the tier it delivers, so Aurral compares that tier against the tier of the file you already have and skips deemix when it cannot improve on it. A deemix set to FLAC upgrades an MP3, and a deemix set to MP3 128 is not asked to upgrade anything better. Downloaded files are checked against the quality profile as well, so a track is never replaced by a worse one.

Download source priority

See Usenet for how priority and fallback work across sources.