112 lines
4.0 KiB
Markdown
112 lines
4.0 KiB
Markdown
# Changelog
|
||
|
||
All notable changes to this project will be documented in this file.
|
||
|
||
The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
|
||
and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
|
||
|
||
## [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.
|