Sign inSign up

kylemmkay/deezer-engine

By kylemmkay

ā€¢Updated 4 months ago

Deezer Engine is a Python script that allows you to create and maintain smart playlists within Deeze

Image
0

8.6K

kylemmkay/deezer-engine repository overview

ā Deezer Engine (Smart Playlists)

Source on Codeberg Docker Hub Badge

Note

This repository was built with AI šŸ¤– assistance.

Deezer Engine is a Python-based pipeline system that allows you to create and maintain smart playlists using a declarative YAML configuration. Inspired by Goofyā .

Warning

**DATA LOSS RISK:** This script can delete songs from your playlists. Running this with an incorrect configuration may result in permanently lost playlists. It is under heavy revision; breaking changes are expected.

ā šŸš€ Quick Links

ā šŸ› ļø How it Works

  1. Sources: Pull tracks from your library, discovery mixes, or existing playlists.
  2. Transform: Apply modifiers like exclude, dedupe, or sort.
  3. Destinations: Sync the results back to a Deezer playlist automatically.
ā–‘ā–ˆā–€ā–„ā–‘ā–ˆā–€ā–€ā–‘ā–ˆā–€ā–€ā–‘ā–€ā–€ā–ˆā–‘ā–ˆā–€ā–€ā–‘ā–ˆā–€ā–„ā–‘ā–‘ā–‘ā–ˆā–€ā–€ā–‘ā–ˆā–€ā–ˆā–‘ā–ˆā–€ā–€ā–‘ā–€ā–ˆā–€ā–‘ā–ˆā–€ā–ˆā–‘ā–ˆā–€ā–€
ā–‘ā–ˆā–‘ā–ˆā–‘ā–ˆā–€ā–€ā–‘ā–ˆā–€ā–€ā–‘ā–„ā–€ā–‘ā–‘ā–ˆā–€ā–€ā–‘ā–ˆā–€ā–„ā–‘ā–‘ā–‘ā–ˆā–€ā–€ā–‘ā–ˆā–‘ā–ˆā–‘ā–ˆā–‘ā–ˆā–‘ā–‘ā–ˆā–‘ā–‘ā–ˆā–‘ā–ˆā–‘ā–ˆā–€ā–€
ā–‘ā–€ā–€ā–‘ā–‘ā–€ā–€ā–€ā–‘ā–€ā–€ā–€ā–‘ā–€ā–€ā–€ā–‘ā–€ā–€ā–€ā–‘ā–€ā–‘ā–€ā–‘ā–‘ā–‘ā–€ā–€ā–€ā–‘ā–€ā–‘ā–€ā–‘ā–€ā–€ā–€ā–‘ā–€ā–€ā–€ā–‘ā–€ā–‘ā–€ā–‘ā–€ā–€ā–€

Running Deezer-Engine v0.8.1
This is free software under the GNU GPL v3.0.
For more details, see https://codeberg.org/kylemmkay/deezer-engine
2026-01-23 04:27:05 - [DeezerEngine] [INFO] - Authenticated successfully as: k...y
2026-01-23 04:27:05 - [DeezerEngine] [INFO] - >>> START 1/5: Processing Strategy: Taylor Swift: The Timeline
2026-01-23 04:27:05 - [DeezerEngine] [INFO] - Action: Sorting by release_date (ascending)
2026-01-23 04:27:16 - [DeezerEngine] [INFO] - Syncing 789 tracks to 'Taylor Swift: Complete Discography' (Full Replace)
2026-01-23 04:27:50 - [DeezerEngine] [INFO] - Sync complete for 'Taylor Swift: Complete Discography'.
2026-01-23 04:27:50 - [DeezerEngine] [INFO] - >>> START 2/5: Processing Strategy: High-Rank Discovery
2026-01-23 04:27:50 - [DeezerEngine] [INFO] - Action: Filtered 'rank > 500000': Kept 14/40 tracks.
2026-01-23 04:27:50 - [DeezerEngine] [INFO] - Action: Deduplicated 0 tracks
2026-01-23 04:27:50 - [DeezerEngine] [INFO] - Action: Shuffling with 'smart' shuffle.
2026-01-23 04:27:53 - [DeezerEngine] [INFO] - Syncing 172 tracks to 'High-Rank Discovery' (Full Replace)
2026-01-23 04:28:04 - [DeezerEngine] [INFO] - Sync complete for 'High-Rank Discovery'.
...
ā Sequence Diagram
sequenceDiagram
    autonumber
    
    %% Use neutral tones for accessibility
    participant S as Deezer
    participant P as Pipeline (Engine)
    participant D as Database
    participant T as Transform (Modifiers)

    Note over S, D: 1. SOURCES STAGE
    loop For Each Source
        P->>S: Fetch Track IDs
        S-->>P: Return IDs
        P->>D: Cache Collection
        D-->>P: Identify New Tracks
        P->>S: Fetch New Metadata
        S-->>P: Metadata JSON
        P->>D: Cache in Local SQLite
    end

    Note over P, T: 2. TRANSFORM STAGE
    D->>P: Pull Collection from Cache
    alt source has sub-modifier
        P->>T: Apply Child Modifier
        T-->>P: Updated Tracklist
    else default
        P->>P: Pass-through
    end

    loop For Each Global Modifier
        P->>T: Apply Global Mod (BPM, Filter, etc.)
        T-->>P: Modified Pipeline State
    end

    Note over P, D: 3. DESTINATION STAGE
    P->>S: Upload Final Tracks

ā šŸ§‘ā€šŸ’» Development

For building, running, and testing Deezer Engine as a developer, see the Development Guideā . This includes instructions for local Docker builds and details on developer templates for config and strategy validation.

ā Acknowledgements

For all acknowledgements, see the wiki pageā 

ā License

Licensed under GNU GPLv3. See LICENSEā  for details.

Tag summary

Content type

Image

Digest

sha256:55e589fe8ā€¦

Size

55.1 MB

Last updated

4 months ago

docker pull kylemmkay/deezer-engine