Skip to main content
`Ctrl`+`K`

# Deezer Plugin

The `deezer` plugin provides metadata matches for the importer using the Deezer Album and Track APIs.

## Basic Usage

First, enable the `deezer` plugin (see Using Plugins).

You can enter the URL for an album or song on Deezer at the `enter Id` prompt during import:

    Enter search, enter Id, aBort, eDit, edit Candidates, plaY? i
    Enter release ID: https://www.deezer.com/en/album/572261

## Configuration

This plugin can be configured like other metadata source plugins as described in Using Metadata Source Plugins.

### Default

    deezer:
        search_query_ascii: no
        data_source_mismatch_penalty: 0.5
        search_limit: 5

search_query_ascii (default: `no`)

  If enabled, the search query will be converted to ASCII before being sent to Deezer. Converting searches to ASCII can enhance search results in some cases, but in general, it is not recommended. For instance, `artist:deadmau5 album:4×4` will be converted to `artist:deadmau5 album:4x4` (notice `×!=x`).

data_source_mismatch_penalty (default: `0.5`)

  Penalty applied when the data source of a match candidate differs from the original source of your existing tracks. Any decimal number between 0.0 and 1.0

  This setting controls how much to penalize matches from different metadata sources during import. The penalty is applied when beets detects that a match candidate comes from a different data source than what appears to be the original source of your music collection.

  Example configurations:

      # Prefer MusicBrainz over Discogs when sources don't match
      plugins: musicbrainz discogs

      musicbrainz:
          data_source_mismatch_penalty: 0.3  # Lower penalty = preferred
      discogs:
          data_source_mismatch_penalty: 0.8  # Higher penalty = less preferred

      # Do not penalise candidates from Discogs at all
      plugins: musicbrainz discogs

      musicbrainz:
          data_source_mismatch_penalty: 0.5
      discogs:
          data_source_mismatch_penalty: 0.0

      # Disable cross-source penalties entirely
      plugins: musicbrainz discogs

      musicbrainz:
          data_source_mismatch_penalty: 0.0
      discogs:
          data_source_mismatch_penalty: 0.0

  Tip

  The last configuration is equivalent to setting:

      match:
          distance_weights:
              data_source: 0.0  # Disable data source matching

source_weight (default: `0.5`)

  Deprecated since version 2.5: Use data_source_mismatch_penalty instead.

search_limit (default: `5`)

  Maximum number of search results to return.

## Commands

The `deezer` plugin provides an additional command `deezerupdate` to update the `rank` information from Deezer. The `rank` (ranges from 0 to 1M) is a global indicator of a song’s popularity on Deezer that is updated daily based on streams. The higher the `rank`, the more popular the track is.