docs: update for v1.2.0

This commit is contained in:
Mathis Maquenne
2025-08-18 11:20:29 +02:00
parent be40910480
commit c4329431b5
2 changed files with 25 additions and 9 deletions
+16
View File
@@ -5,6 +5,22 @@ 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/), 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). and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
## [1.2.0] - 2025-08-18
### Added
- New `artist` command to download an artists top tracks.
- `--limit` flag for the `artist` command to restrict the number of tracks.
- `--strict` flag for downloads: fail if the requested quality is unavailable.
### Changed
- Default download quality is now **MP3 320kbps**.
### Removed
- The `--quality=best` option. Fallback to lower quality is now the **default behavior**; use the new `--strict` flag if you want to prevent fallback.
### Fixed
- Handle error when `SNG_CONTRIBUTORS` metadata is empty.
## [1.1.1] - 2025-06-16 ## [1.1.1] - 2025-06-16
### Fixed ### Fixed
+9 -9
View File
@@ -19,8 +19,8 @@ A simple Go tool for downloading music from [Deezer](https://www.deezer.com).
## Features ## Features
* Download playlists and albums from Deezer * Download playlists, albums, and artists' top tracks from Deezer
* Select audio quality: MP3 128kbps, MP3 320kbps, or FLAC (⚠️ non-premium accounts are limited to 128kbps) * Select audio quality: MP3 128kbps, MP3 320kbps (default), or FLAC (⚠️ non-premium accounts are limited to 128kbps)
* Automatically adds metadata tags to downloaded files * Automatically adds metadata tags to downloaded files
* Fetch and tag songs with BPM and musical key * Fetch and tag songs with BPM and musical key
* Smart skip system: avoids re-downloading already existing files using hashes and metadata * Smart skip system: avoids re-downloading already existing files using hashes and metadata
@@ -38,7 +38,7 @@ To install **GoDeez**, simply download the latest binary for your platform from
Example (Linux/macOS): Example (Linux/macOS):
```bash ```bash
# Move the downloaded binary to /usr/local/bin for easy access from anywhere # Move the downloaded binary to /usr/local/bin for easy access from anywhere
mv godeez-1.1.0-linux-amd64 /usr/local/bin/godeez mv godeez-1.2.0-linux-amd64 /usr/local/bin/godeez
``` ```
## Configuration ## Configuration
@@ -119,18 +119,18 @@ Usage:
godeez download [command] godeez download [command]
Available Commands: Available Commands:
album Download songs from album album Download songs from an album
playlist Download songs from playlist artist Download top songs from an artist
playlist Download songs from a playlist
Flags: Flags:
--bpm fetch BPM/key and add to file tags --bpm fetch BPM/key and add to file tags
--config string config file (default ~/.godeez/config.toml)
-h, --help help for download -h, --help help for download
-q, --quality string download quality [mp3_128, mp3_320, flac, best] (default "best") -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) -t, --timeout duration timeout for each download (e.g. 10s, 1m, 2m30s) (default 2m0s)
Global Flags:
--config string config file (default ~/.godeez/config.toml)
Use "godeez download [command] --help" for more information about a command. Use "godeez download [command] --help" for more information about a command.
``` ```