godeez/CHANGELOG.md

Changelog

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

[1.5.0] - 2026-08-05

Added

• Add new login and logout commands to authenticate with your Deezer email and password. Credentials are stored in the system keyring. Requires DEEZER_MOBILE_API_KEY and DEEZER_MOBILE_GW_KEY to be set.
• Add new update command to replace the binary in place with the latest release, with --check to only report availability and --force to reinstall.
• Add new version command to print the version, commit, build date, and platform.
• Notify when a newer version is available after a download completes.
• Add WAV download quality (--quality=wav): the FLAC stream is converted locally to lossless WAV.

Changed

• DEEZER_ARL is now optional. When it is unset, the credentials stored by godeez login are used instead, and expired sessions are renewed automatically.
• Release binaries are now named godeez_<version>_<os>_<arch> (previously godeez-<version>-<os>-<arch>) and are published alongside a checksums.txt file.

Fixed

• Interrupted downloads no longer leave partial files behind.
• Avoid overwriting an existing file when another track resolves to the same name.
• Report a clear error when the database is already in use by another process.
• Migrate the legacy database when ~/.godeez and ~/Music/GoDeez are on different filesystems.
• Write metadata tags even when the cover art or track duration is missing.

[1.4.0] - 2026-03-01

Added

• Automatic database migration from ~/.godeez/tracks.db to ~/Music/GoDeez/.tracks.db.

Changed

• Configuration now uses DEEZER_ARL environment variable (replaces config.toml).
• Database moved from ~/.godeez/tracks.db to ~/Music/GoDeez/.tracks.db.
• Show warning count in download summary.

Removed

• config.toml configuration file and ~/.godeez directory.
• --config flag from CLI.
• secret_key and output_dir configuration options.
• Watcher feature (watch subcommands).

Fixed

• Track number zero-padding for correct file sorting.

[1.3.0] - 2025-09-11

Added

• Add new track command to download individual tracks.
• Add --genre flag to fetch and embed genre information into file metadata tags.

Fixed

• Handle empty media resources gracefully to prevent crashes.

[1.2.0] - 2025-08-18

Added

• Add new artist command to download an artist’s top tracks.
• Add --limit flag for the artist command to restrict the number of tracks.
• Add --strict flag for downloads: fail if the requested quality is unavailable.

Changed

• Set default download quality to MP3 320 kbps.

Removed

• Remove --quality=best option. Fallback to lower quality is now the default behavior; use the --strict flag to prevent fallback.

Fixed

• Handle error when SNG_CONTRIBUTORS metadata is empty.

[1.1.1] - 2025-06-16

Fixed

• Restore ability to download tracks without a Deezer Premium account (limited to MP3 128 kbps for free accounts).

[1.1.0] - 2025-05-19

Added

• Support downloading full albums and playlists with more than 40 tracks (previous limit removed).
• Fetch and embed BPM and musical key into metadata tags.
• Add local database system (tracks.db) to track downloaded files and avoid re-downloading, even if files are renamed or moved.
• Improve CLI output formatting for a cleaner and more informative user experience.

Changed

• Replace the godeez file in the user’s home directory with a .godeez/ directory, which now stores both config.toml and tracks.db.
  👉 If upgrading, move your existing config into .godeez/config.toml.
• Simplify config.toml: remove the need for iv and license_token.
• Automatically delete corrupted or incomplete files on download failure.

[1.0.0] - 2024-10-15

Added

• Initial release of GoDeez with basic Deezer album and playlist downloading capabilities.