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.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 songs.
• 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 320kbps.

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 128kbps 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.