From a989039ed2aecb8d9a5752fb8e7bca9f6108d28b Mon Sep 17 00:00:00 2001 From: Rafael Moraes <50295204+glomatico@users.noreply.github.com> Date: Sun, 22 Mar 2026 15:10:00 -0300 Subject: [PATCH] Docs: clarify .wvd, audio qualities, and defaults --- README.md | 30 ++++++++++-------------------- 1 file changed, 10 insertions(+), 20 deletions(-) diff --git a/README.md b/README.md index 34932a9..d410324 100644 --- a/README.md +++ b/README.md @@ -26,17 +26,10 @@ A command-line app for downloading songs, podcasts and videos from Spotify. - **Spotify cookies** - Export your browser cookies in Netscape format while logged in at the Spotify homepage: - Firefox: [Export Cookies](https://addons.mozilla.org/addon/export-cookies-txt) - Chromium-based browsers: [Get cookies.txt LOCALLY](https://chromewebstore.google.com/detail/get-cookiestxt-locally/cclelndahbckbenkjhflpdbgdldlbecc) -- **FFmpeg** on your system PATH. Recommended builds: - - Windows: [AnimMouse's FFmpeg Builds](https://github.com/AnimMouse/ffmpeg-stable-autobuild/releases) - - Linux: [John Van Sickle's FFmpeg Builds](https://johnvansickle.com/ffmpeg/) -- **[.wvd file](https://github.com/hyugogirubato/KeyDive)** - Required to decrypt music videos and AAC songs. Use [KeyDive](https://github.com/hyugogirubato/KeyDive) to extract it from an Android device. Files from emulated devices may not work. > [!WARNING] -> **Some users have reported that Spotify suspended their accounts after using Votify.** Use it at your own risk. - -> [!NOTE] -> - A .wvd file is not needed if you only plan to download podcasts. In this case, you can use the `--no-drm` flag to disable the .wvd file requirement. -> - FFmpeg can also be skipped when downloading podcasts in Vorbis codec. +> - **Some users have reported that Spotify suspended their accounts after using Votify.** Use it at your own risk. +> - You may not be able to download songs if your account is too new. In this case, try specifying a .wvd file. ### Optional @@ -47,6 +40,7 @@ Add these tools to your system PATH or specify their paths via command-line argu - **[mp4decrypt](https://www.bento4.com/downloads/)** - Required when using `mp4box` or `mp4decrypt` as remux mode. - **[aria2c](https://github.com/aria2/aria2/releases)** - Required when using `aria2c` as download mode. - **[cURL](https://curl.se/download.html)** - Required when using `curl` as download mode. +- **.wvd file** - Required to download music videos and songs in AAC quality. Use KeyDive to extract it from an Android device. Files from emulated devices may not work. ## 📦 Installation @@ -59,10 +53,6 @@ Add these tools to your system PATH or specify their paths via command-line argu - Place the cookies file in your working directory as `cookies.txt`, or - Specify its path using `--cookies-path` or in the config file. -3. Set up the `.wvd` file: - - Place it in your working directory as `device.wvd`, or - - Specify its path using `--wvd-path` or in the config file. - ## 🚀 Usage ```bash @@ -190,7 +180,7 @@ The file is created automatically on first run. Command-line arguments override | `--playlist-file-template` / `playlist_file_template` | File template for M3U8 playlists | `Playlists/{playlist_artist}/{playlist_title}` | | `--date-tag-template` / `date_tag_template` | Date tag template | `%Y-%m-%dT%H:%M:%SZ` | | **Song / Podcast** | | | -| `--audio-quality` / `audio_quality` | Comma-separated audio quality priority | `aac-medium` | +| `--audio-quality` / `audio_quality` | Comma-separated audio quality priority | `vorbis-medium` | | `--audio-download-mode` / `audio_download_mode` | Audio download mode to use | `ytdlp` | | `--audio-remux-mode` / `audio_remux_mode` | Audio remux mode to use | `ffmpeg` | | `--synced-lyrics-only` / `synced_lyrics_only` | Only download synced lyrics file | `false` | @@ -241,12 +231,12 @@ Tags usable in the `exclude_tags` list only: ### Audio qualities -- `aac-medium` - AAC 128kbps -- `aac-high` - AAC 256kbps, songs only, requires an active premium subscription -- `vorbis-low` - Vorbis 96kbps, podcasts only -- `vorbis-medium` - Vorbis 160kbps, unsupported -- `vorbis-high` - Vorbis 320kbps, unsupported, requires an active premium subscription -- `flac` - FLAC lossless, songs only, requires an active premium subscription +- `vorbis-low` - Vorbis 96kbps +- `vorbis-medium` - Vorbis 160kbps, songs only +- `vorbis-high` - Vorbis 320kbps, songs only, requires an active premium subscription +- `aac-medium` - AAC 128kbps, .wvd file required for songs +- `aac-high` - AAC 256kbps, songs only, .wvd required, requires an active premium subscription +- `flac` - FLAC lossless, songs only, .wvd required, requires an active premium subscription > [!NOTE] > - **FLAC quality requires a L1 .wvd file.**