deemix

Download music from Deezer without subscription

TLDR

Download a track or playlist

$ deemix [https://www.deezer.com/us/track/00000000]

Download track/playlist at a specific bitrate

$ deemix --bitrate [FLAC|MP3] [url]

Download to a specific path

$ deemix --bitrate [bitrate] --path [path] [url]

Create a portable deemix configuration file in the current directory

$ deemix --portable --bitrate [bitrate] --path [path] [url]

deemix [options] [command] [arguments]

Examples:
deemix download https://www.deezer.com/album/123456789
deemix -a 123456789
deemix search "Artist - Song Title"
deemix config

PARAMETERS

--help, -h
    Display a help message and exit.

--version, -v
    Show program's version number and exit.

--arl , -A
    Set your Deezer ARL token for authentication.

--quality , -q
    Desired quality tags (e.g., FLAC, 320, 128).

--output

, -o
    Specify the output directory for downloads.

--recursive, -r
    Download all contents of a playlist or album (e.g., all tracks).

--no-metadata
    Prevent writing metadata tags to downloaded files.

--no-cover
    Prevent downloading and embedding cover art.

--no-lyrics
    Prevent downloading and embedding lyrics.

--ignore-existing
    Skip downloading files that already exist in the output directory.

--overwrite
    Overwrite existing files instead of skipping them.

--track , -t
    Download a specific track by its Deezer ID.

--album , -a
    Download a specific album by its Deezer ID.

--playlist , -p
    Download a specific playlist by its Deezer ID.

--config , -c
    Specify an alternative configuration file.

--disable-config
    Do not load any configuration file.

--loglevel , -l
    Set the logging level (e.g., DEBUG, INFO, WARNING, ERROR).

--portable
    Use a portable configuration setup (config file in same directory as executable).

--no-files
    Do not create song files; only process metadata. Useful for testing or metadata cleanup.

--bitrate
    Set specific bitrate to download (e.g., FLAC, 320, 128). Note: --quality is often preferred.

--max-bitrate
    Set maximum allowed bitrate for download (e.g., 320, 128).

DESCRIPTION

deemix is a powerful, open-source command-line utility for downloading music directly from Deezer.
Written in Python, it allows users to download tracks, albums, and playlists in various qualities, including lossless FLAC where available, provided they have a valid Deezer ARL token.
Beyond just downloading, deemix offers extensive options for organizing output, embedding metadata (like tags and cover art), and skipping existing files. It's designed to be cross-platform and offers a robust solution for archiving your favorite music from Deezer's extensive catalog, acting as a direct successor to popular older Deezer downloaders.

CAVEATS

deemix relies heavily on the Deezer API, and any changes made by Deezer can potentially break its functionality, requiring updates from the developers.
Usage may violate Deezer's Terms of Service and applicable copyright laws. Users should be aware of the legal implications in their jurisdiction.
The availability of FLAC quality downloads depends on your Deezer subscription level (e.g., Deezer HiFi) and the specific content on Deezer.

ARL TOKEN ACQUISITION

How to obtain a Deezer ARL Token
The ARL token is a critical authentication key for deemix. It can be obtained from your browser while logged into Deezer. Typically, you can find it in your browser's developer tools (F12), under the 'Application' or 'Storage' tab, within the 'Cookies' section for the deezer.com domain. Look for the cookie named 'arl'. This token is unique to your session and account.

PERSISTENT CONFIGURATION

deemix supports a configuration file (often config.json or .deemixrc, depending on setup) where you can store your ARL token, default download quality, output directory, and other preferences.
This allows for consistent usage without re-typing options for every download. The default location is usually in your user's configuration directory (e.g., ~/.config/deemix/ on Linux).

HISTORY

deemix emerged as a direct descendant and successor to earlier popular Deezer downloaders, most notably Deezloader Remix.
The project was initiated to provide an updated and maintained solution for downloading music from Deezer after its predecessors became defunct or unmaintained due to changes in Deezer's infrastructure or legal pressures.
The deemix-py project specifically focuses on providing a robust command-line interface, building upon the core functionalities established by the original deemix project which also included a GUI.