arnef/godeez

Fork 0

Files

T

Mathis Maquenne 4286ccd626 docs: document self-update and new release asset names

2026-07-30 11:30:08 +02:00

6.5 KiB

Raw Blame History

GoDeez

A simple Go tool for downloading music from Deezer.

Features • Installation • Updating • Configuration • Usage • Contributing • Support • License

Features

Download playlists, albums, artists’ top tracks, and individual tracks
Choose audio quality: MP3 128kbps, MP3 320kbps (default), or FLAC (⚠️ non‑premium accounts are limited to 128kbps)
Automatically embed metadata tags (artist, album, title, artwork, etc.)
Fetch and tag songs with BPM, musical key, and genre
Skip already-downloaded files using hashes and metadata
Support Windows, macOS, and Linux
Provide a simple, easy-to-use CLI

Installation

To install GoDeez, download the latest binary for your platform from the Releases page.

Go to the Releases page.
Download the appropriate binary for your operating system and architecture, named godeez_<version>_<os>_<arch>.
(Optional) Move the binary to a directory included in $PATH for easier access.

Example (Linux/macOS):

# Make it executable and move it to /usr/local/bin for access from anywhere
chmod +x godeez_1.5.0_linux_amd64
mv godeez_1.5.0_linux_amd64 /usr/local/bin/godeez

Every release also ships a checksums.txt, so you can verify a download:

sha256sum -c checksums.txt --ignore-missing

macOS

The macOS binaries are not signed with an Apple Developer certificate, so Gatekeeper blocks them the first time. Clear the quarantine flag once:

xattr -d com.apple.quarantine /usr/local/bin/godeez

Updating

GoDeez can replace itself with the latest release:

# See whether a new version exists
godeez update --check

# Download, verify, and install it
godeez update

The new binary is verified against the release's published SHA256 checksum before it replaces the current one. If GoDeez lives in a directory you do not own (such as /usr/local/bin on some systems), run sudo godeez update.

To disable the notice about new versions:

export GODEEZ_NO_UPDATE_CHECK=1

To see what you are running:

godeez version

Configuration

GoDeez requires a Deezer ARL cookie for authentication. Set it as an environment variable:

export DEEZER_ARL="your_arl_cookie_here"

To make it persistent, add the line above to your shell profile (~/.bashrc, ~/.zshrc, etc.).

Open your browser and log in to your Deezer account.
Open the Developer Tools (right-click on the page and select “Inspect” or press F12).
Navigate to the Application tab (Chrome/Edge) or Storage tab (Firefox).
In the left panel, look for Cookies and select https://www.deezer.com.
Find the arl cookie and copy its value.

Note: The ARL cookie may expire after some time. If you get authentication errors, retrieve a fresh cookie using the steps above.

Output directory

Downloaded files are saved to ~/Music/GoDeez. The download database (.tracks.db) is stored alongside your music in the output directory.

Upgrading from v1.3.0? The ~/.godeez directory and config.toml are no longer used. Set the DEEZER_ARL environment variable instead. Your existing database will be migrated automatically on first run.

Usage

CLI Overview

Running godeez without arguments shows the help menu:

GoDeez is a tool to download music from Deezer

Usage:
  godeez [command]

Available Commands:
  completion  Generate the autocompletion script for the specified shell
  download    Download songs from Deezer
  help        Help about any command
  update      Update GoDeez to the latest version
  version     Print the GoDeez version

Flags:
  -h, --help   help for godeez

Use "godeez [command] --help" for more information about a command.

Download commands

Download songs from Deezer

Usage:
  godeez download [command]

Available Commands:
  album       Download songs from an album
  artist      Download top songs from an artist
  playlist    Download songs from a playlist
  track       Download a single track

Flags:
      --bpm                fetch BPM/key and add to file tags
      --genre              fetch genre and add to file tags
  -h, --help               help for download
  -q, --quality string     download quality [mp3_128, mp3_320, flac] (default "mp3_320")
      --strict             fail the song download if the quality is not available
  -t, --timeout duration   timeout for each download (e.g. 10s, 1m, 2m30s) (default 2m0s)

Use "godeez download [command] --help" for more information about a command.

Examples

# Download an album
godeez download album 12345678

# Download a playlist
godeez download playlist 87654321

# Download top tracks from an artist
godeez download artist 11223344 --limit 5

# Download a single track
godeez download track 98765432

# Download with specific quality, BPM and genre data
godeez download track 98765432 --quality flac --bpm --genre

Contributing

Contributions help make GoDeez a better tool for everyone, and any help is greatly appreciated. Whether it’s a bug fix, a new feature, or improving documentation, your input is valuable.

If you have an idea for improvement, feel free to fork the repository and submit a pull request. You can also open an issue if you spot a bug or have a feature suggestion.

Support the Project

If GoDeez helps you enjoy your music collection, please consider giving it a ⭐!

Why star us?

Helps more music lovers discover the project
Shows appreciation for the work and motivates development
Takes just one click but means the world to us!

License

This project is licensed under the MIT License. See the LICENSE file for details.

⚠️ This tool is provided for educational and personal use only. Please ensure your usage complies with Deezer’s Terms of Service.

6.5 KiB Raw Blame History Unescape Escape