deemix
deemix is a self-hosted Deezer downloader. It returns tagged files with cover art. Aurral can use it as a download source for flows, playlists, and Aurral albums.
Aurral talks to the deemix web server. From a Deezer album that is exactly the requested release, it adds the URL of each track you want to the deemix queue, or the album URL when you want every track. A search for a single track adds that track’s URL. Aurral imports only the files that pass its checks.
Aurral does not store your ARL. Sign in once in the deemix web UI. Aurral reuses that sign-in through the deemix API.
deemix uses the address that you configure, which is usually plain HTTP on your own network. Keep deemix on a network that you trust, or put it behind HTTPS if the connection leaves that network.
- Run deemix, open its web UI, and 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.
- If necessary, set Source priority. The default is
15. - Select Test connection.
Your Deezer plan must allow the bitrate. FLAC needs a lossless plan, and MP3 320 needs a high-quality plan. If the bitrate is above your plan, Test connection warns you. deemix refuses those downloads. It does not lower the quality.
Path mapping
Section titled “Path mapping”deemix writes files to its own download folder. Aurral must read the same files.
Mount the deemix download folder in Aurral at the same path. If you cannot, add a mapping in Settings > Download clients > Remote path mappings, with Applies to set to deemix. Use the path that deemix reports as Remote path, and the path inside Aurral as Local path.
Aurral moves each checked file into the Downloads Folder. A file that fails the checks stays outside the Library.
Behavior
Section titled “Behavior”Aurral tries download sources in priority order. It ranks Deezer results by title, artist, album, and duration. It skips tracks that your account cannot stream.
Aurral checks each downloaded file in the same way as files from other sources. It then writes the title, artist, album, album artist, year, and track number into the file.
For a track whose album Aurral knows, Aurral first searches Deezer for that album. It does this for a single track, a playlist track, a flow track, and an upgrade too, but not for a Re-search replacement. A Deezer album counts only when its full tracklist is exactly the requested release, including tracks that your account cannot stream:
- Its artist and title name the requested artist and album.
- It has every track of the release, each within 2 seconds of the track’s length on the release.
- It has no other song. A deluxe edition with a bonus track is a different release.
- No track is a live, acoustic, remix, or other version, unless the album or track you asked for names that version, the artist is a karaoke, nightcore, or tribute act, or MusicBrainz lists the album as a live, remix, or demo release.
Your account must be able to stream every track you want from that album. Aurral queues only the tracks you want, and queues the whole album only when you want every track. When no Deezer album is exactly the release, Aurral tries the next download source that can supply the release, and then searches for each track on its own.
If an album download finishes with errors, Aurral assigns the finished files to their tracks. The missing and failed tracks continue through the next matching album and the other sources. One file never fills two tracks.
A track that fails Aurral’s checks is not offered again for that request.
If a file matches the requested track but its duration is very different, Aurral holds it in Activity > Queue. You can preview, approve, or deny it.
Aurral removes a track from the deemix queue before it imports the file or holds it for review. It removes an album from the queue after it processes the album. A new request can then start a new download.
If deemix finishes the same track again and the file already exists in the playlist folder, Aurral keeps the existing file. It does not create a numbered copy.
Upgrades
Section titled “Upgrades”deemix can supply quality upgrades. Because its Bitrate setting fixes the quality that it delivers, Aurral compares that quality with the file that you have. Aurral skips deemix when it cannot deliver a better file. For example, deemix set to FLAC can upgrade an MP3, but deemix set to MP3 128 does not upgrade anything better than MP3 128. Aurral also checks each downloaded file against the quality profile, so an upgrade never replaces a file with a worse one.