mirror of
https://github.com/glomatico/votify.git
synced 2026-09-29 04:22:34 +02:00
Docs: clarify .wvd, audio qualities, and defaults
This commit is contained in:
@@ -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.**
|
||||
|
||||
Reference in New Issue
Block a user