You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: HELP.md
+23-23Lines changed: 23 additions & 23 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -28,47 +28,47 @@ The primary purpose of this tool is to create high-quality, consistent MP3 backu
28
28
## Main Window Explained <aname="main-window-explained"></a>
29
29
30
30
### URL & Output <aname="url--output"></a>
31
-
**Playlist or video URL:** The source URL from YouTube.
32
-
**Output folder:** The main directory where all files and logs will be saved.
31
+
**Playlist or video URL:** The source URL from YouTube.
32
+
**Output folder:** The main directory where all files and logs will be saved.
33
33
**Use per-run subfolder:** (Recommended) When checked, each time you click "Run", a new subfolder with a timestamp (e.g., `run_20250824_193000`) will be created inside your output folder. This is the safest way to keep download sessions separate and ensures the "Join" feature works correctly.
34
34
35
35
### Cookies <aname="cookies"></a>
36
-
**Cookies file:** You can provide a `cookies.txt` (Netscape format) or a `.json` file exported from a browser extension like "Cookie-Editor". The application will automatically convert `.json` files.
36
+
**Cookies file:** You can provide a `cookies.txt` (Netscape format) or a `.json` file exported from a browser extension like "Cookie-Editor". The application will automatically convert `.json` files.
37
37
**Use browser cookies:** Alternatively, select a browser and the application will attempt to use its live cookie data.
**Add numbering:** Prefixes filenames with a number (e.g., `001 - ...`, `002 - ...`).
47
-
**Include YouTube ID in filename:** Appends the unique YouTube video ID in brackets (e.g., `... [dQw4w9WgXcQ].mp3`). *Note:* Brackets can cause issues with some older media players.
48
-
**Sanitize filenames:** (Recommended) Removes special characters from filenames that can cause problems with playlists or scripts.
49
-
**Use download archive:** The app will keep a record of downloaded files in `download_archive.txt`. If you run the same playlist again, it will skip any files it has already downloaded.
50
-
**Normalize with MP3Gain:** Uses the mp3gain tool to adjust the volume of all tracks to a standard level without losing quality.
51
-
**De-duplicate artist in filename:** Removes duplicated artist names from filenames (e.g., `Artist - Artist - Title` → `Artist - Title`).
52
-
**Validate with ffprobe:** Validates sample rate/format using `ffprobe` after conversion.
53
-
**Verbose yt-dlp logging:** Runs yt-dlp in verbose mode for troubleshooting.
46
+
**Add numbering:** Prefixes filenames with a number (e.g., `001 - ...`, `002 - ...`).
47
+
**Include YouTube ID in filename:** Appends the unique YouTube video ID in brackets (e.g., `... [dQw4w9WgXcQ].mp3`). *Note:* Brackets can cause issues with some older media players.
48
+
**Sanitize filenames:** (Recommended) Removes special characters from filenames that can cause problems with playlists or scripts.
49
+
**Use download archive:** The app will keep a record of downloaded files in `download_archive.txt`. If you run the same playlist again, it will skip any files it has already downloaded.
50
+
**Normalize with MP3Gain:** Uses the mp3gain tool to adjust the volume of all tracks to a standard level without losing quality.
51
+
**De-duplicate artist in filename:** Removes duplicated artist names from filenames (e.g., `Artist - Artist - Title` → `Artist - Title`).
52
+
**Validate with ffprobe:** Validates sample rate/format using `ffprobe` after conversion.
53
+
**Verbose yt-dlp logging:** Runs yt-dlp in verbose mode for troubleshooting.
54
54
**Fallback to progressive:** If standard DASH download yields no audio, retry with progressive HTTP streams.
55
55
56
56
### Joining <aname="joining"></a>
57
-
**Join into one MP3:** Enables joining to combine all downloaded MP3s into a single large file.
58
-
**Name:** Filename for the final combined MP3.
59
-
**Write CUE for joined file:** Creates a `.cue` file with accurate `INDEX 01` markers.
60
-
**Embed ID3 chapters:** Embeds chapter markers directly into the joined MP3 (requires `mutagen`).
61
-
**Randomize order when joining:** Shuffles the playlist before combining.
62
-
**Keep temp WAVs:** Keep intermediate WAVs from the join pipeline (useful for debugging).
57
+
**Join into one MP3:** Enables joining to combine all downloaded MP3s into a single large file.
58
+
**Name:** Filename for the final combined MP3.
59
+
**Write CUE for joined file:** Creates a `.cue` file with accurate `INDEX 01` markers.
60
+
**Embed ID3 chapters:** Embeds chapter markers directly into the joined MP3 (requires `mutagen`).
61
+
**Randomize order when joining:** Shuffles the playlist before combining.
62
+
**Keep temp WAVs:** Keep intermediate WAVs from the join pipeline (useful for debugging).
63
63
**Write VLC segment playlist:** Creates an `.m3u` playlist that points to chapter start/stop times inside the joined MP3 for VLC.
64
64
65
65
### System Dependencies <aname="system-dependencies"></a>
66
-
**Verify Tools:** Checks if `yt-dlp`, `ffmpeg`, `ffprobe`, and `mp3gain` are installed and accessible.
66
+
**Verify Tools:** Checks if `yt-dlp`, `ffmpeg`, `ffprobe`, and `mp3gain` are installed and accessible.
0 commit comments