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.
- Automatic database migration from
~/.godeez/tracks.dbto~/Music/GoDeez/.tracks.db.
- Configuration now uses
DEEZER_ARLenvironment variable (replacesconfig.toml). - Database moved from
~/.godeez/tracks.dbto~/Music/GoDeez/.tracks.db. - Show warning count in download summary.
config.tomlconfiguration file and~/.godeezdirectory.--configflag from CLI.secret_keyandoutput_dirconfiguration options.- Watcher feature (
watchsubcommands).
- Track number zero-padding for correct file sorting.
- Add new
trackcommand to download individual songs. - Add
--genreflag to fetch and embed genre information into file metadata tags.
- Handle empty media resources gracefully to prevent crashes.
- Add new
artistcommand to download an artist’s top tracks. - Add
--limitflag for theartistcommand to restrict the number of tracks. - Add
--strictflag for downloads: fail if the requested quality is unavailable.
- Set default download quality to MP3 320kbps.
- Remove
--quality=bestoption. Fallback to lower quality is now the default behavior; use the--strictflag to prevent fallback.
- Handle error when
SNG_CONTRIBUTORSmetadata is empty.
- Restore ability to download tracks without a Deezer Premium account (limited to MP3 128kbps for free accounts).
- 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.
- Replace the
godeezfile in the user’s home directory with a.godeez/directory, which now stores bothconfig.tomlandtracks.db.
👉 If upgrading, move your existing config into.godeez/config.toml. - Simplify
config.toml: remove the need forivandlicense_token. - Automatically delete corrupted or incomplete files on download failure.
- Initial release of GoDeez with basic Deezer album and playlist downloading capabilities.