ytdlp_notes.html
⎇
Raw
1{{define "ytdlp_notes"}}
2<details class="ytdlp-notes">
3 <summary>
4 <span class="ytdlp-notes-icon" aria-hidden="true">ⓘ</span>
5 yt-dlp options managed by VidArchive
6 </summary>
7 <div class="ytdlp-notes-body">
8 <p>VidArchive sets a few yt-dlp options itself so downloads stay self-contained
9 and trackable. Passing any of these &mdash; or a conflicting inverse &mdash; in
10 <strong>Custom Flags</strong> will make the download fail with an error.</p>
11 <div class="ytdlp-notes-table-wrap">
12 <table>
13 <thead>
14 <tr><th>Option</th><th>Why it's managed</th></tr>
15 </thead>
16 <tbody>
17 <tr>
18 <td><code>-o</code></td>
19 <td>Output template is always overridden so each item lands in its own self-contained directory.</td>
20 </tr>
21 <tr>
22 <td><code>-P</code></td>
23 <td>Download path is set to a per-download working directory before items are imported into the library.</td>
24 </tr>
25 <tr>
26 <td><code>--cookies</code></td>
27 <td>Injected automatically from the cookies you save in <strong>Settings</strong> (when present).</td>
28 </tr>
29 <tr>
30 <td><code>--write-playlist-metafiles</code></td>
31 <td>Disabled so a playlist's own metadata file is not imported as if it were an item.</td>
32 </tr>
33 {{if .}}
34 <tr>
35 <td><code>--write-info-json</code></td>
36 <td>Always added for subscriptions so each item's stable identity (<code>id</code> + <code>extractor</code>) is recorded for refresh and de-duplication.</td>
37 </tr>
38 <tr>
39 <td><code>--download-archive</code></td>
40 <td>Added in <strong>Skip existing</strong> mode so entries already downloaded are skipped.</td>
41 </tr>
42 <tr>
43 <td><code>--skip-download</code></td>
44 <td>Added in <strong>Metadata only</strong> mode to refresh metadata without re-fetching media.</td>
45 </tr>
46 {{end}}
47 </tbody>
48 </table>
49 </div>
50 </div>
51</details>
52{{end}}
53