Docs: clarify .wvd, audio qualities, and defaults

This commit is contained in:
Rafael Moraes
2026-03-22 15:10:00 -03:00
parent eb0c1d8434
commit a989039ed2
+10 -20
View File
@@ -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.**