feat(roadmap): surface stale checkboxes + collection output-path setting

Command preview + incognito toggle were already wired end-to-end in the
DownloadBar (Show command button, Incognito checkbox) — flipped the two
stale ROADMAP.md checkboxes with notes; verified live in the preview.

Output-path setting (PINCHFLAT): new Settings.collectionOutputTemplate — a
raw yt-dlp -o template overriding the default Channel/Playlist/NNN-Title
layout for Library downloads (empty = default). collectionOutputTemplate()
takes an optional custom template (joined under outDir, left for yt-dlp to
expand); download.ts passes the setting; zod schema validates it as a safe
relative template; Settings -> Filenames field. Tests in buildArgs +
settingsSchema; live-verified the field renders.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

src/main/core/buildArgs.ts

@@ -290,17 +290,29 @@ export function sanitizeDirSegment(name: string): string {
 }
 
 /**
- * Build the `-o` output template for a collection download:
+ * Build the `-o` output template for a collection download. The default layout is
  *   <outDir>/<Channel>/<Playlist>/<NNN> - <baseFilename>
  * where NNN is the 1-based playlist index zero-padded to three digits and
  * baseFilename keeps its yt-dlp field tokens (e.g. '%(title)s.%(ext)s') so they
  * still expand. Channel/playlist are sanitized via sanitizeDirSegment.
+ *
+ * A power user can override the folder layout with a raw yt-dlp `-o` template
+ * (`Settings.collectionOutputTemplate`, PINCHFLAT output-path setting) — passed
+ * as `customTemplate`. When present, it's joined under `outDir` and left for
+ * yt-dlp to expand against ITS own metadata fields (`%(uploader)s`,
+ * `%(playlist)s`, `%(playlist_index)s`, `%(title)s`, `%(ext)s`, …), so the raw
+ * template escapes AeroFetch's fixed three-segment layout entirely. It's
+ * validated as a safe relative template (no absolute path, no `..`) before it
+ * ever reaches here.
  */
 export function collectionOutputTemplate(
   outDir: string,
   c: CollectionContext,
-  baseFilename: string
+  baseFilename: string,
+  customTemplate?: string
 ): string {
+  const custom = customTemplate?.trim()
+  if (custom) return join(outDir, custom)
   const n = Number.isFinite(c.index) && c.index > 0 ? Math.floor(c.index) : 1
   const nnn = String(n).padStart(3, '0')
   const segments = [sanitizeDirSegment(c.channel), sanitizeDirSegment(c.playlist)]

src/main/download.ts

@@ -200,10 +200,17 @@ export function buildCommand(opts: StartDownloadOptions, cookiesFile?: string):
   const perKindDir = (opts.kind === 'audio' ? settings.audioFolder : settings.videoFolder)?.trim()
   const outDir = safeOverride || perKindDir || getDefaultMediaDir(opts.kind)
   // A collection (media-manager) download is filed into <channel>/<playlist>/
-  // <NNN> - <title> folders; an ordinary download uses the flat filenameTemplate.
+  // <NNN> - <title> folders by default, or into a power-user's raw yt-dlp `-o`
+  // layout (Settings.collectionOutputTemplate); an ordinary download uses the
+  // flat filenameTemplate.
   const filenameTemplate = settings.filenameTemplate?.trim() || '%(title)s.%(ext)s'
   const outputTemplate = opts.collection
-    ? collectionOutputTemplate(outDir, opts.collection, '%(title)s.%(ext)s')
+    ? collectionOutputTemplate(
+        outDir,
+        opts.collection,
+        '%(title)s.%(ext)s',
+        settings.collectionOutputTemplate
+      )
     : join(outDir, filenameTemplate)
   // Per-download override wins; otherwise use the persisted defaults.
   const options = opts.options ?? settings.downloadOptions

src/main/settingsSchema.ts

@@ -87,6 +87,10 @@ export const SETTINGS_FIELD_SCHEMAS: { [K in keyof Settings]: z.ZodType<Settings
   videoFolder: trimmedWhere((v) => v === '' || isSafeOutputDir(v)),
   audioFolder: trimmedWhere((v) => v === '' || isSafeOutputDir(v)),
   filenameTemplate: trimmedWhere(isSafeFilenameTemplate),
+  // Collection folder layout (PINCHFLAT): empty = built-in default; otherwise a
+  // safe relative yt-dlp template (isSafeFilenameTemplate allows '/'-separated
+  // path segments and rejects absolute paths + '..' traversal).
+  collectionOutputTemplate: trimmedWhere((v) => v === '' || isSafeFilenameTemplate(v)),
   defaultVideoQuality: z.enum(VIDEO_QUALITY_OPTIONS),
   defaultAudioQuality: z.enum(AUDIO_QUALITY_OPTIONS),
   rateLimit: trimmedWhere((v) => RATE_LIMIT_RE.test(v)),

src/renderer/src/views/settings/FilenamesCard.tsx

@@ -6,6 +6,7 @@ import { useSettingsStyles } from './settingsStyles'
 export function FilenamesCard(): React.JSX.Element {
   const styles = useSettingsStyles()
   const filenameTemplate = useSettings((s) => s.filenameTemplate)
+  const collectionOutputTemplate = useSettings((s) => s.collectionOutputTemplate)
   const restrictFilenames = useSettings((s) => s.restrictFilenames)
   const useDownloadArchive = useSettings((s) => s.useDownloadArchive)
   const update = useSettings((s) => s.update)
@@ -29,6 +30,17 @@ export function FilenamesCard(): React.JSX.Element {
         Example: {filenameTemplate.replace('%(title)s', 'My Video').replace('%(ext)s', 'mp4')}
       </Caption1>
 
+      <Field
+        label="Collection folder layout"
+        hint="How channel/playlist (Library) downloads are foldered. Leave blank for the default Channel / Playlist / Title. Power users: a raw yt-dlp -o template, e.g. %(uploader)s/%(playlist)s/%(playlist_index)s - %(title)s.%(ext)s"
+      >
+        <Input
+          value={collectionOutputTemplate}
+          placeholder="Channel / Playlist / NNN - Title (default)"
+          onChange={(_, d) => update({ collectionOutputTemplate: d.value })}
+        />
+      </Field>
+
       <Field
         label="Restrict filenames"
         hint="Sanitize titles to plain ASCII letters/digits, no spaces -- safer for old filesystems and shells."

src/shared/ipc.ts

@@ -565,6 +565,14 @@ export interface Settings {
   maxConcurrent: number
   /** yt-dlp output template, e.g. '%(title)s.%(ext)s' */
   filenameTemplate: string
+  /**
+   * Raw yt-dlp `-o` template for COLLECTION downloads (a channel/playlist from
+   * the Library), overriding the default `Channel/Playlist/NNN - Title` folder
+   * layout. Empty = the built-in default. A relative template (no absolute path,
+   * no `..`); yt-dlp expands its own fields (`%(uploader)s`, `%(playlist)s`,
+   * `%(playlist_index)s`, `%(title)s`, `%(ext)s`, …). PINCHFLAT output-path setting.
+   */
+  collectionOutputTemplate: string
   /** UI color theme: explicit light/dark, or 'system' to follow the OS */
   theme: ThemeMode
   /** brand accent preset (buttons, links, selected nav item) */
@@ -659,6 +667,7 @@ export const DEFAULT_SETTINGS: Settings = {
   defaultAudioQuality: 'Best',
   maxConcurrent: 2,
   filenameTemplate: '%(title)s.%(ext)s',
+  collectionOutputTemplate: '',
   // Follow the OS theme on first launch (SR1) so a dark-mode Windows user isn't
   // greeted by a bright white window despite full system-theme support.
   theme: 'system',