veodl 1.10.0 → 1.11.0

package/src/cli.js

@@ -1,4 +1,5 @@
 import { outputOptions, outputStream, withOutputSettings } from './output.js';
+import { validateFragments, confirmExperimentalFragments } from './experimental-fragments.js';
 import { validateTemplate } from './naming.js';
 import { parseArgs } from 'node:util';
 import path from 'node:path';
@@ -7,10 +8,10 @@ import { createInterface } from 'node:readline/promises';
 import { createReporter } from './progress.js';
 import { openFile } from './open-file.js';
 import { maybeUpdateNotice, updateMain, UPDATE_HELP, defaultRegistry, packageVersion } from './updater.js';
-import { applyProfile, configMain, loadConfig, profileMain, selectedProfileName } from './config.js';
+import { applyProfile, configMain, loadConfig, profileMain, selectedProfileName } from './config.js';
 import { validateItems, describeEstimate } from './playlist.js';
-import { parseSourceTimeout } from './source-discovery.js';
-import { explainUnknownOption, optionSpellings, suggestOption } from './option-suggestions.js';
+import { parseSourceTimeout } from './source-discovery.js';
+import { explainUnknownOption, optionSpellings, suggestOption } from './option-suggestions.js';
 import { retryOptions, runJob, jobFilePath } from './jobs.js';
 import { QUALITIES, VIDEO_FORMATS, AUDIO_FORMATS, validateUrl, readableError, cleanText, validateCookieFile, validateBrowserSpec, cookieFileWarning } from './utils.js';
 
@@ -43,9 +44,14 @@ Options:
   --playlist-concurrency <n>  Simultaneous playlist downloads (1-4; default: 2)
   --playlist               Download every entry of a playlist or channel URL
   -N, --concurrent-fragments <n>
-                           Download this many fragments in parallel (1-16; default: 8)
+                           Parallel fragments (1-64; default: 8); 17-64 are experimental
+  --experimental-fragments  Explicitly accept experimental values above 16
+                           Otherwise requires terminal confirmation before download
   --subs                   Download subtitles (default languages: en)
-  --sub-langs <langs>      Subtitle languages, e.g. "de,en" (implies --subs)
+  --auto-subs              Include automatically generated subtitles
+  --sub-langs <langs>      Subtitle languages, e.g. "de,en" (manual unless --auto-subs)
+  --sub-format <format>    Preferred subtitle format, e.g. srt/vtt/best
+  --list-subs              Show manual and automatic subtitle languages, then exit
   --embed-subs             Embed subtitles into the video file
   --embed-metadata         Embed title, date and other metadata
   --embed-thumbnail        Embed the thumbnail
@@ -56,17 +62,22 @@ Options:
   --cookies-from-browser <browser[:profile]>
                            Read cookies from an installed browser
   --resume                 Keep partial data and continue an interrupted download
+  --incognito              Save media without run IDs, history, stats or retry data
+  --neutral-filename       Use a random video name; omit title and naming templates
+  --list-qualities         Show available video resolutions and exit
+  --list-qualitys          Alias for --list-qualities
   --list-formats           Show the available formats and exit
   --list-sources           Find video sources loaded by a web page and exit
-  --auto-list-sources      Search after no video is found (default: on)
+  --auto-list-sources      Search after no video is found (default: on)
   --source <n>             Select source number from that page (also for scripts)
   --deep-scan              Check every media candidate found during source search
   --timeout <duration>     Source search deadline, e.g. 30, 30s or 2m (5s-10m)
   --dry-run                Show what would be downloaded and exit
+  --verify                 Probe saved media files with FFprobe (default: off)
   --json                   Print one JSON object per URL instead of prose
   --profile <name>         Apply a named config profile
   --batch-file <file>      Read URLs from a file (one per line; # comments)
-  --retry-failed <file>    Retry failed/unfinished items from a saved job
+  --retry-failed <id|file> Retry failed/unfinished items by run ID or job file
   --playlist-items <list>  Select playlist entries, e.g. 1,3-5 (implies --playlist)
   --skip-existing         Skip matching downloads still present on disk
   --no-<boolean-option>   Disable a stored boolean default, e.g. --no-open
@@ -84,13 +95,14 @@ Commands:
   veo history --failed --limit 20  Filter and extend download history
   veo runs [id]            List active runs; add --json for metadata and progress
   veo inspect <file>        Read media metadata; --check-audio measures audio signal
+  veo subs <url>            List available manual and automatic subtitles
   veo inspect run <id>     Inspect saved files from a finished run by its id
   veo stop [id]            Stop one run, or every active run
   veo alias list|add|remove  Manage extra command names (wrappers calling veo)
   veo uninstall [-p <name>]  Remove one alias, or everything with --yes
   veo version              Show the installed version
-  veo config edit|path|profiles|guide|check|show|reset  Manage defaults and named profiles
-  veo profile [list|reset|name]  Show, list or change the default profile
+  veo config edit|path|profiles|guide|check|show|reset  Manage defaults and named profiles
+  veo profile [list|reset|name]  Show, list or change the default profile
   veo config edit [--external|--terminal]      Choose the configuration editor
 
 Run veo without arguments in a terminal for interactive setup.
@@ -123,6 +135,7 @@ const STRING_OPTIONS = {
   'cookies-from-browser': {},
   'concurrent-fragments': { short: 'N' },
   'sub-langs': {},
+  'sub-format': {},
   'sponsorblock-remove': {},
   section: {},
   profile: {},
@@ -134,6 +147,7 @@ const STRING_OPTIONS = {
 };
 
 const BOOLEAN_OPTIONS = {
+  'experimental-fragments': {},
   compatible: {},
   recode: {},
   'adaptive-concurrency': {},
@@ -143,12 +157,19 @@ const BOOLEAN_OPTIONS = {
   open: {},
   audio: {},
   resume: {},
+  incognito: {},
+  'neutral-filename': {},
   playlist: {},
   subs: {},
+  'auto-subs': {},
+  'list-subs': {},
+  verify: {},
   'embed-subs': {},
   'embed-metadata': {},
   'embed-thumbnail': {},
   'closest-quality': {},
+  'list-qualities': {},
+  'list-qualitys': {},
   'list-formats': {},
   'list-sources': {},
   'auto-list-sources': {},
@@ -180,14 +201,20 @@ export function optionDefaults(config = {}) {
     cookies: config.cookies,
     'cookies-from-browser': config.cookiesFromBrowser,
     'concurrent-fragments': String(config.concurrentFragments ?? 8),
+    'experimental-fragments': config.experimentalFragments ?? false,
     'sub-langs': config.subLangs,
     'sponsorblock-remove': config.sponsorblockRemove,
     section: config.section,
     open: config.open ?? false,
     audio: config.audio ?? false,
     resume: config.resume ?? false,
+    incognito: config.incognito ?? false,
+    'neutral-filename': config.neutralFilename ?? false,
     playlist: config.playlist ?? false,
     subs: config.subs ?? false,
+    'auto-subs': config.autoSubs ?? false,
+    'sub-format': config.subFormat,
+    verify: config.verify ?? false,
     'embed-subs': config.embedSubs ?? false,
     'embed-metadata': config.embedMetadata ?? false,
     'embed-thumbnail': config.embedThumbnail ?? false,
@@ -199,11 +226,11 @@ export function optionDefaults(config = {}) {
     timeout: config.timeout,
     'deep-scan': config.deepScan ?? false,
     'list-sources': config.listSources ?? false,
-    'auto-list-sources': config.autoListSources ?? true,
+    'auto-list-sources': config.autoListSources ?? true,
   };
 }
 
-export function cliOptions(config = {}) {
+export function cliOptions(config = {}) {
   const defaults = optionDefaults(config);
   const options = {};
   for (const [name, extra] of Object.entries(STRING_OPTIONS)) {
@@ -215,42 +242,42 @@ export function cliOptions(config = {}) {
     if (defaults[name] !== undefined) options[name].default = defaults[name];
   }
   return options;
-}
-
-const COMMAND_FLAGS = {
-  stats: ['--json'], history: ['--json', '--limit', '--failed'],
-  runs: ['--json'], stop: [], flush: ['--stats'],
-  inspect: ['--json', '--check-audio', '--search'],
-  doctor: ['--offline', '--output', '-o'],
-  update: ['--check'], up: ['--check'], upgrade: ['--check'], check: ['--check'],
-  backend: ['--check', '--keep-files'],
-  alias: ['--json', '--force', '--bin-dir'],
-  uninstall: ['--prefix', '-p', '--yes', '--keep-cache', '--keep-config', '--keep-aliases', '--json', '--bin-dir'],
-  config: ['--profile', '--external', '--terminal'],
-  profile: [],
-};
-const COMMAND_NAMES = [...Object.keys(COMMAND_FLAGS), 'retry', 'help', 'version'];
-
-function mistypedCommandOption(args) {
-  const command = args[0];
-  if (command && !command.startsWith('-') && !COMMAND_NAMES.includes(command)) {
-    const suggestion = suggestOption(command, COMMAND_NAMES);
-    if (suggestion) return `Unknown command "${command}". Did you mean "${suggestion}"?`;
-  }
-  const options = Object.hasOwn(COMMAND_FLAGS, command)
-    ? [...COMMAND_FLAGS[command], '--help', '-h', '--no-color', '--color', '--profile']
-    : command === 'retry' ? [...optionSpellings(cliOptions()), '--last'] : null;
-  if (!options) return null; // Download flags are checked by parseCli itself.
-  const start = ['config', 'backend', 'alias'].includes(command) && args[1] && !args[1].startsWith('-') ? 2 : 1;
-  for (const arg of args.slice(start)) {
-    if (arg === '--') break;
-    const name = arg.split('=')[0];
-    if (!name.startsWith('-') || options.includes(name)) continue;
-    const suggestion = suggestOption(name, options);
-    if (suggestion) return `Unknown option "${name}". Did you mean "${suggestion}"?`;
-  }
-  return null;
-}
+}
+
+const COMMAND_FLAGS = {
+  stats: ['--json'], history: ['--json', '--limit', '--failed'],
+  runs: ['--json'], stop: [], flush: ['--stats'],
+  inspect: ['--json', '--check-audio', '--search'],
+  doctor: ['--offline', '--output', '-o'],
+  update: ['--check'], up: ['--check'], upgrade: ['--check'], check: ['--check'],
+  backend: ['--check', '--keep-files'],
+  alias: ['--json', '--force', '--bin-dir'],
+  uninstall: ['--prefix', '-p', '--yes', '--keep-cache', '--keep-config', '--keep-aliases', '--json', '--bin-dir'],
+  config: ['--profile', '--external', '--terminal'],
+  profile: [],
+};
+const COMMAND_NAMES = [...Object.keys(COMMAND_FLAGS), 'retry', 'subs', 'help', 'version'];
+
+function mistypedCommandOption(args) {
+  const command = args[0];
+  if (command && !command.startsWith('-') && !COMMAND_NAMES.includes(command)) {
+    const suggestion = suggestOption(command, COMMAND_NAMES);
+    if (suggestion) return `Unknown command "${command}". Did you mean "${suggestion}"?`;
+  }
+  const options = Object.hasOwn(COMMAND_FLAGS, command)
+    ? [...COMMAND_FLAGS[command], '--help', '-h', '--no-color', '--color', '--profile']
+    : command === 'retry' ? [...optionSpellings(cliOptions()), '--last'] : null;
+  if (!options) return null; // Download flags are checked by parseCli itself.
+  const start = ['config', 'backend', 'alias'].includes(command) && args[1] && !args[1].startsWith('-') ? 2 : 1;
+  for (const arg of args.slice(start)) {
+    if (arg === '--') break;
+    const name = arg.split('=')[0];
+    if (!name.startsWith('-') || options.includes(name)) continue;
+    const suggestion = suggestOption(name, options);
+    if (suggestion) return `Unknown option "${name}". Did you mean "${suggestion}"?`;
+  }
+  return null;
+}
 
 export function parseCli(args, { config = {} } = {}) {
   if (args[0] === 'help') args = ['--help', ...args.slice(1)];
@@ -258,15 +285,15 @@ export function parseCli(args, { config = {} } = {}) {
     if (args.length !== 1) throw new Error('Usage: veo version');
     return { version: true };
   }
-  let preliminary;
-  try { preliminary = parseArgs({ args, allowPositionals: true, strict: true, allowNegative: true, options: cliOptions() }); }
-  catch (error) { throw explainUnknownOption(error, cliOptions()); }
-  const profileName = selectedProfileName(config, preliminary.values.profile);
-  config = applyProfile(config, preliminary.values.profile);
-  let parsed;
-  try { parsed = parseArgs({ args, tokens: true, allowNegative: true, allowPositionals: true, strict: true, options: cliOptions(config) }); }
-  catch (error) { throw explainUnknownOption(error, cliOptions(config)); }
-  const { values, positionals, tokens } = parsed;
+  let preliminary;
+  try { preliminary = parseArgs({ args, allowPositionals: true, strict: true, allowNegative: true, options: cliOptions() }); }
+  catch (error) { throw explainUnknownOption(error, cliOptions()); }
+  const profileName = selectedProfileName(config, preliminary.values.profile);
+  config = applyProfile(config, preliminary.values.profile);
+  let parsed;
+  try { parsed = parseArgs({ args, tokens: true, allowNegative: true, allowPositionals: true, strict: true, options: cliOptions(config) }); }
+  catch (error) { throw explainUnknownOption(error, cliOptions(config)); }
+  const { values, positionals, tokens } = parsed;
   if (values.help || values.version) return values;
   // A stored default conflicting with a flag typed right now is a user error;
   // a stored default merely ignored by another flag is not.
@@ -287,14 +314,36 @@ export function parseCli(args, { config = {} } = {}) {
     } else { validateItems(values['playlist-items']); values.playlist = true; }
   }
   if (values['retry-failed'] && (positionals.length || values['batch-file'])) throw new Error('--retry-failed cannot be combined with URLs or --batch-file.');
+  if (values.incognito && values['retry-failed']) throw new Error('--incognito cannot retry a saved job. Use --no-incognito for this request.');
+  if (values.incognito && values.resume) {
+    if (tokens.some(token => token.name === 'resume')) throw new Error('--incognito cannot be combined with --resume.');
+    values.resume = false;
+  }
+  if (values.incognito && values['skip-existing']) {
+    if (tokens.some(token => token.name === 'skip-existing')) throw new Error('--incognito cannot be combined with --skip-existing.');
+    values['skip-existing'] = false;
+  }
   if (!values.output.trim()) throw new Error('The output directory cannot be empty.');
   if (values.rename !== undefined && !cleanText(values.rename)) throw new Error('The custom filename cannot be empty.');
-  if (positionals.length > 1 && values.rename !== undefined && !values.rename.includes('*')) throw new Error('--rename only applies to a single URL unless the name contains * for the original title.');
+  if (!values['neutral-filename'] && positionals.length > 1 && values.rename !== undefined && !values.rename.includes('*')) throw new Error('--rename only applies to a single URL unless the name contains * for the original title.');
   if (values.audio && values.quality !== 'best' && typed.quality) throw new Error('--quality is for video; omit it when using --audio.');
   if (values.audio && values['closest-quality'] && typed.closest) throw new Error('--closest-quality is for video; omit it when using --audio.');
   if (values['closest-quality'] && values.quality === 'best' && typed.closest) throw new Error('--closest-quality requires a numeric --quality such as 1080p.');
+  values['list-qualities'] = Boolean(values['list-qualities'] || values['list-qualitys']);
+  delete values['list-qualitys'];
+  if (values['list-qualities']) {
+    if (positionals.length !== 1 || values['batch-file'] || values['retry-failed']) throw new Error('--list-qualities accepts exactly one URL.');
+    if (values['list-formats'] || values['list-sources'] || values['list-subs']) throw new Error('--list-qualities cannot be combined with other listing actions.');
+    if (values.audio || values.playlist) throw new Error('--list-qualities requires a single video without --audio or --playlist.');
+  }
   if (values['list-formats'] && (values.audio || values.format)) throw new Error('--list-formats cannot be combined with --audio or --format.');
   if (values['list-formats'] && positionals.length > 1) throw new Error('--list-formats accepts exactly one URL.');
+  if (values['list-subs']) {
+    if (positionals.length !== 1 || values['batch-file'] || values['retry-failed']) throw new Error('--list-subs accepts exactly one URL.');
+    if (values['list-formats'] || values['list-sources']) throw new Error('--list-subs cannot be combined with other listing actions.');
+    if (values.playlist) throw new Error('--list-subs requires a single video without --playlist.');
+  }
+  if (values['sub-format'] && (!/^[a-z0-9]+(?:\/[a-z0-9]+)*$/i.test(values['sub-format']) || values['sub-format'].length > 100)) throw new Error('--sub-format must be a format or preference list such as srt/vtt/best.');
   if (values.source && (!/^[1-9]\d*$/.test(values.source) || !Number.isSafeInteger(Number(values.source)))) throw new Error('--source requires a positive source number.');
   if (values.source && values['list-sources'] && !tokens.some(token => token.name === 'list-sources')) values['list-sources'] = false;
   if (values['list-sources'] && !tokens.some(token => token.name === 'list-sources')
@@ -310,7 +359,7 @@ export function parseCli(args, { config = {} } = {}) {
   if ((values.source || values['list-sources']) && values.playlist) throw new Error('--source and --list-sources cannot be combined with --playlist.');
   if (values['concurrent-fragments'] !== undefined) {
     const fragments = Number(values['concurrent-fragments']);
-    if (!Number.isInteger(fragments) || fragments < 1 || fragments > 16) throw new Error('--concurrent-fragments must be a whole number between 1 and 16.');
+    validateFragments(fragments);
   }
   const concurrency = Number(values['playlist-concurrency']);
   if (!Number.isInteger(concurrency) || concurrency < 1 || concurrency > 4) throw new Error('--playlist-concurrency must be a whole number between 1 and 4.');
@@ -340,26 +389,28 @@ export function parseCli(args, { config = {} } = {}) {
   if (!Number.isInteger(options.concurrentDownloads) || options.concurrentDownloads < 1 || options.concurrentDownloads > 4) throw new Error('--concurrent-downloads must be a whole number between 1 and 4.');
   if (options.filenameTemplate !== undefined) validateTemplate(options.filenameTemplate);
   if (options.folderTemplate !== undefined) validateTemplate(options.folderTemplate, { folders: true });
-  if (options.rename && options.filenameTemplate) throw new Error('--rename and --filename-template cannot be combined.');
+  if (options.rename && options.filenameTemplate && !options.neutralFilename) throw new Error('--rename and --filename-template cannot be combined.');
   const disableSubs = values.subs === false && tokens.some(token => token.name === 'subs');
-  if (options.subLangs && !disableSubs) options.subs = true;
-  if (disableSubs) {
-    options.subLangs = undefined;
-    options.embedSubs = false;
-  }
-  options.profile = profileName;
-  return options;
-}
+  if (options.subLangs && !disableSubs && !options.autoSubs) options.subs = true;
+  if (disableSubs) {
+    options.embedSubs = false;
+    if (!options.autoSubs) options.subLangs = undefined;
+  }
+  options.profile = profileName;
+  return options;
+}
 
-export async function main(args = process.argv.slice(2), { config } = {}) {
-  if (args[0] === 'help') args = ['--help', ...args.slice(1)];
-  const mistyped = mistypedCommandOption(args);
-  if (mistyped) { process.stderr.write(`veo: ${mistyped}\n`); return 1; }
+export async function main(args = process.argv.slice(2), { config } = {}) {
+  if (args[0] === 'help') args = ['--help', ...args.slice(1)];
+  const mistyped = mistypedCommandOption(args);
+  if (mistyped) { process.stderr.write(`veo: ${mistyped}\n`); return 1; }
   let color = !args.includes('--no-color') && !args.includes('--json');
   let display;
+  let loadedConfig;
   try {
     display = outputOptions(args);
     const loaded = config ?? await loadConfig();
+    loadedConfig = loaded.config || {};
     color = !args.includes('--json') && (display.color ?? applyProfile(loaded.config || {}, display.profile).color ?? true);
     // Validate explicit profiles even when a color flag overrides their setting.
     if (display.profile) applyProfile(loaded.config || {}, display.profile);
@@ -375,7 +426,12 @@ export async function main(args = process.argv.slice(2), { config } = {}) {
   // One throttled (once per day) update hint after every successful command.
   // Failures, cancellations, help/version output and the update commands
   // themselves never trigger it; VEO_NO_UPDATE_CHECK=1 disables it for scripts.
-  if (code === 0 && shouldUpdateNotice(args)) {
+  let incognitoRequest = !args.length;
+  if (!incognitoRequest && code === 0 && shouldUpdateNotice(args)) {
+    try { incognitoRequest = Boolean(parseCli(args, { config: loadedConfig }).incognito); }
+    catch { /* Non-download commands have their own argument parser. */ }
+  }
+  if (code === 0 && shouldUpdateNotice(args) && !incognitoRequest) {
     try {
       const notice = await maybeUpdateNotice({ currentVersion: await packageVersion() });
       if (notice) process.stderr.write(`${notice}\n`);
@@ -421,7 +477,7 @@ async function runMain(args, { config }) {
     try { return await (await import('./runs.js')).stopMain(args.slice(1)); }
     catch (error) { stderr.write(`veo: ${readableError(error)}\n`); return 1; }
   }
-  if (args[0] === 'retry') {
+  if (args[0] === 'retry') {
     if (args[1] !== '--last') {
       stderr.write('veo: Usage: veo retry --last [download options]\n');
       return 1;
@@ -430,12 +486,23 @@ async function runMain(args, { config }) {
       const { latestFailedJob } = await import('./jobs.js');
       args = ['--retry-failed', await latestFailedJob(), ...args.slice(2)];
     } catch (error) { stderr.write(`veo: ${readableError(error)}\n`); return 1; }
-  }
-  if (args[0] === 'profile') {
-    try { return await profileMain(args.slice(1)); }
-    catch (error) { stderr.write(`veo: ${readableError(error)}\n`); return 1; }
-  }
-  const { cleanupDownloadCache } = await import('./download-cache.js');
+  }
+  if (args[0] === 'subs') {
+    if (args[1] === '--help' || args[1] === '-h') {
+      stdout.write('veo subs <url> [--json] [--source <n>] [--profile <name>]\n\nList manual and automatically generated subtitle languages and source formats without downloading media.\n');
+      return 0;
+    }
+    if (!args[1] || args[1].startsWith('-')) {
+      stderr.write('veo: Usage: veo subs <url> [--json] [--source <n>]\n');
+      return 1;
+    }
+    args = [args[1], '--list-subs', ...args.slice(2)];
+  }
+  if (args[0] === 'profile') {
+    try { return await profileMain(args.slice(1)); }
+    catch (error) { stderr.write(`veo: ${readableError(error)}\n`); return 1; }
+  }
+  const { cleanupDownloadCache } = await import('./download-cache.js');
   await cleanupDownloadCache().catch(error => stderr.write(`veo: Could not clean expired local downloads: ${readableError(error)}\n`));
   // update/upgrade/up/check subcommands are handled before URL validation.
   if (['update', 'up', 'upgrade', 'check'].includes(args[0])) {
@@ -446,10 +513,10 @@ async function runMain(args, { config }) {
     }
     return updateMain(args, { registry: defaultRegistry() });
   }
-  if (args[0] === 'config') {
-    try { return await configMain(args.slice(1)); }
-    catch (error) { stderr.write(`veo: ${readableError(error)}\n`); return 1; }
-  }
+  if (args[0] === 'config') {
+    try { return await configMain(args.slice(1)); }
+    catch (error) { stderr.write(`veo: ${readableError(error)}\n`); return 1; }
+  }
   if (args[0] === 'doctor') {
     try {
       const { doctorMain } = await import('./doctor.js');
@@ -493,9 +560,6 @@ async function runMain(args, { config }) {
   process.once('SIGINT', cancel);
   process.once('SIGTERM', cancel);
   try {
-    if (!args.includes('--help') && !args.includes('-h') && !args.includes('--version')) {
-      run = await (await import('./runs.js')).registerRun(cancel);
-    }
     const loaded = config ?? await loadConfig();
     for (const warning of loaded.warnings || []) stderr.write(`veo: ${warning}\n`);
     if (!args.length && process.stdin.isTTY && process.stderr.isTTY) {
@@ -510,19 +574,20 @@ async function runMain(args, { config }) {
       stdout.write(`${pkg.version}\n`);
       return 0;
     }
+    if (!options.incognito) run = await (await import('./runs.js')).registerRun(cancel);
     let retryItems;
     if (options.retryFailed) {
       retryItems = await retryOptions(options.retryFailed);
       // Revalidate stored options and apply only flags explicitly supplied now.
       const retryArgs = args.filter((arg, index) => arg !== '--retry-failed' && args[index - 1] !== '--retry-failed' && !arg.startsWith('--retry-failed='));
-      const overrideProfile = retryArgs.some(arg => arg === '--profile' || arg.startsWith('--profile='));
-      retryItems = retryItems.map(item => {
-        const resumed = parseCli([item.url, ...retryArgs], { config: overrideProfile
-          ? { ...item, profiles: loaded.config?.profiles }
-          : item });
-        if (!overrideProfile) resumed.profile = item.profile;
-        return resumed;
-      });
+      const overrideProfile = retryArgs.some(arg => arg === '--profile' || arg.startsWith('--profile='));
+      retryItems = retryItems.map(item => {
+        const resumed = parseCli([item.url, ...retryArgs], { config: overrideProfile
+          ? { ...item, profiles: loaded.config?.profiles }
+          : item });
+        if (!overrideProfile) resumed.profile = item.profile;
+        return resumed;
+      });
       options = { ...retryItems[0], urls: retryItems.map(item => item.url) };
     }
     if (options.batchFile) {
@@ -530,28 +595,29 @@ async function runMain(args, { config }) {
       options.urls.push(...lines.map(validateUrl));
       options.url = options.urls[0];
       if (!options.urls.length) throw new Error('The URL list is empty.');
-      if (options.rename && options.urls.length > 1 && !options.rename.includes('*')) throw new Error('--rename only applies to a single URL unless the name contains * for the original title.');
+      if (!options.neutralFilename && options.rename && options.urls.length > 1 && !options.rename.includes('*')) throw new Error('--rename only applies to a single URL unless the name contains * for the original title.');
       if (options.listFormats && options.urls.length > 1) throw new Error('--list-formats accepts exactly one URL.');
     }
+    await confirmExperimentalFragments(retryItems || [options], { signal: controller.signal });
     // The job file is created before the first download, so another terminal can
     // follow this run's per-item progress with `veo runs <id>`.
-    const jobFile = options.listFormats || options.listSources || options.dryRun ? null : jobFilePath();
-    await run?.describe({ urls: options.urls, output: options.output ? path.resolve(options.output) : null,
-      audio: options.audio, quality: options.quality, format: options.format, profile: options.profile || null,
-      playlist: options.playlist, job: jobFile });
-    reporter.configure?.({ color: options.color && !options.json });
-    reporter.start(options.rename);
-    if (!options.dryRun && !options.listFormats && !options.listSources) reporter.profile(options.profile);
-    const preparedBackends = new Map();
-    const reuseBackend = request => preparedBackends.has(request.url) ? async () => preparedBackends.get(request.url) : undefined;
-    const cookieWarning = cookieFileWarning(options.cookies);
+    const jobFile = options.incognito || options.listQualities || options.listFormats || options.listSources || options.listSubs || options.dryRun ? null : jobFilePath();
+    await run?.describe({ urls: options.urls, output: options.output ? path.resolve(options.output) : null,
+      audio: options.audio, quality: options.quality, format: options.format, profile: options.profile || null,
+      playlist: options.playlist, job: jobFile });
+    reporter.configure?.({ color: options.color && !options.json });
+    reporter.start(options.rename);
+    if (!options.dryRun && !options.listQualities && !options.listFormats && !options.listSources && !options.listSubs) reporter.profile(options.profile);
+    const preparedBackends = new Map();
+    const reuseBackend = request => preparedBackends.has(request.url) ? async () => preparedBackends.get(request.url) : undefined;
+    const cookieWarning = cookieFileWarning(options.cookies);
     if (cookieWarning) stderr.write(`veo: ${cookieWarning}\n`);
 
     // For a single page, fall back to media requests observed while its player loads.
     // Explicit --source always rediscovers: signed media URLs can expire between runs.
     if (!retryItems && options.urls.length === 1 && (!options.playlist || options.listSources)) {
-      const discovery = await resolvePageSource(options, { signal: controller.signal, stderr, reporter,
-        onBackend: backend => preparedBackends.set(options.url, backend) });
+      const discovery = await resolvePageSource(options, { signal: controller.signal, stderr, reporter,
+        onBackend: backend => preparedBackends.set(options.url, backend) });
       if (options.listSources) {
         if (options.json) stdout.write(`${JSON.stringify({ url: options.url, status: 'sources', timedOut: Boolean(discovery.sources.timedOut), sources: discovery.sources.map(({ url, pageUrl, ...safe }) => safe) })}\n`);
         else for (const source of discovery.sources) stdout.write(`${discovery.formatSource(source)}\n`);
@@ -574,21 +640,45 @@ async function runMain(args, { config }) {
     }
     if (retryItems) for (const item of retryItems) {
       if (!item.source) continue;
-      const discovery = await resolvePageSource(item, { signal: controller.signal, stderr, reporter,
-        onBackend: backend => preparedBackends.set(item.url, backend) });
+      const discovery = await resolvePageSource(item, { signal: controller.signal, stderr, reporter,
+        onBackend: backend => preparedBackends.set(item.url, backend) });
       item.mediaUrl = discovery.mediaUrl;
     }
 
+    if (options.listSubs) {
+      const { listSubtitles } = await import('./downloader.js');
+      const result = await listSubtitles(options, { signal: controller.signal, reporter, backendResolver: reuseBackend(options) });
+      if (options.json) stdout.write(`${JSON.stringify(result)}\n`);
+      else {
+        stdout.write(`Subtitles: ${cleanText(result.title || options.url)}\n`);
+        for (const [label, entries] of [['Manual', result.manual], ['Automatic', result.automatic]]) {
+          stdout.write(`${label}:\n`);
+          if (!entries.length) stdout.write('  none\n');
+          for (const entry of entries) stdout.write(`  ${cleanText(entry.language)}${entry.name ? ` (${cleanText(entry.name)})` : ''}: ${entry.formats.join(', ') || 'unknown'}\n`);
+        }
+      }
+      return 0;
+    }
+    if (options.listQualities) {
+      const { listQualities } = await import('./downloader.js');
+      const result = await listQualities(options, { signal: controller.signal, reporter, backendResolver: reuseBackend(options) });
+      if (options.json) stdout.write(JSON.stringify(result) + '\n');
+      else {
+        stdout.write('Available qualities: ' + (result.qualities.join(', ') || 'resolution unknown') + '\n');
+        if (result.qualities.length) stdout.write('Choose with --quality ' + result.qualities[0] + '\n');
+      }
+      return 0;
+    }
     if (options.listFormats) {
       const { listFormats } = await import('./downloader.js');
-      stdout.write(await listFormats(options, { signal: controller.signal, reporter, backendResolver: reuseBackend(options) }));
+      stdout.write(await listFormats(options, { signal: controller.signal, reporter, backendResolver: reuseBackend(options) }));
       return 0;
     }
     if (options.dryRun) {
       const { planDownload } = await import('./downloader.js');
       for (const request of retryItems || options.urls.map(url => ({ ...options, url }))) {
         const { url } = request;
-        const plan = await planDownload(request, { signal: controller.signal, reporter, backendResolver: reuseBackend(request) });
+        const plan = await planDownload(request, { signal: controller.signal, reporter, backendResolver: reuseBackend(request) });
         if (options.json) stdout.write(`${JSON.stringify({ url, status: 'planned', ...plan })}\n`);
         else {
           stdout.write(`URL: ${url}\n`);
@@ -602,14 +692,18 @@ async function runMain(args, { config }) {
     const { download } = await import('./downloader.js');
     const { createStatsRecorder } = await import('./stats.js');
     const { createHistoryRecorder } = await import('./history.js');
-    const result = await runJob(options, { download: (request, dependencies) => download(request, { ...dependencies, backendResolver: reuseBackend(request) }),
-      reporter, signal: controller.signal, openFile, items: retryItems, jobFile: jobFile || undefined, runId: run?.id, recordStats: createStatsRecorder(), recordHistory: createHistoryRecorder() });
+    if (!options.json && process.stdout.isTTY) reporter.enableInline();
+    const result = await runJob(options, { download: (request, dependencies) => download(request, { ...dependencies, backendResolver: reuseBackend(request) }),
+      reporter, stdout: reporter.output(stdout), stderr: reporter.output(stderr), signal: controller.signal, openFile, items: retryItems, jobFile: jobFile || undefined, runId: run?.id,
+      recordStats: options.incognito ? undefined : createStatsRecorder(), recordHistory: options.incognito ? undefined : createHistoryRecorder() });
     return result;
   } catch (error) {
     reporter.fail(controller.signal.aborted);
+    reporter.dispose();
     stderr.write(`veo: ${readableError(error)}\n`);
     return controller.signal.aborted || error.name === 'AbortError' ? 130 : 1;
   } finally {
+    reporter.dispose();
     await run?.unregister();
     process.removeListener('SIGINT', cancel);
     process.removeListener('SIGTERM', cancel);
@@ -622,12 +716,12 @@ async function askSourceQuestion(prompt, signal) {
   finally { rl.close(); }
 }
 
-export async function resolvePageSource(options, { signal, stderr, reporter, onBackend, inspect, discover, ask = askSourceQuestion,
-  backendResolver, interactive = Boolean(process.stdin.isTTY && process.stderr.isTTY && !options.json) }) {
+export async function resolvePageSource(options, { signal, stderr, reporter, onBackend, inspect, discover, ask = askSourceQuestion,
+  backendResolver, interactive = Boolean(process.stdin.isTTY && process.stderr.isTTY && !options.json) }) {
   const { fetchMetadata, prepareBackend, runBackend } = await import('./downloader.js');
   const { discoverSources, formatSource, shouldOfferSourceDiscovery } = await import('./source-discovery.js');
-  const backend = inspect ? null : await (backendResolver || prepareBackend)(options, { signal, reporter });
-  if (backend) onBackend?.(backend);
+  const backend = inspect ? null : await (backendResolver || prepareBackend)(options, { signal, reporter });
+  if (backend) onBackend?.(backend);
   const inspectMedia = (request, requestSignal = signal) => inspect ? inspect(request, requestSignal) : fetchMetadata(request, { signal: requestSignal, backend, runner: runBackend });
   let originalError;
   if (!options.source && !options.listSources) {
@@ -638,10 +732,10 @@ export async function resolvePageSource(options, { signal, stderr, reporter, onB
       }
       return {};
     }
-    catch (error) { originalError = error; }
-    if (!shouldOfferSourceDiscovery(originalError)) throw originalError;
-    if (options.autoListSources === false) throw new Error(`${originalError.message} Use --list-sources to search this page, then --source <number> to select one.`);
-    stderr.write('veo: No direct video found; searching the page for a playable source…\n');
+    catch (error) { originalError = error; }
+    if (!shouldOfferSourceDiscovery(originalError)) throw originalError;
+    if (options.autoListSources === false) throw new Error(`${originalError.message} Use --list-sources to search this page, then --source <number> to select one.`);
+    stderr.write('veo: No direct video found; searching the page for a playable source…\n');
   }
   let sources;
   try {
@@ -656,18 +750,18 @@ export async function resolvePageSource(options, { signal, stderr, reporter, onB
   }
   if (options.listSources) return { sources, formatSource };
   if (sources.timedOut) stderr.write(`veo: Source search timed out after ${options.timeout || (options.deepScan ? '120s' : '45s')}; showing verified sources found so far.\n`);
-  if (!sources.length) {
-    if (originalError) throw originalError;
-    throw new Error('No downloadable video sources were found on this page.');
-  }
-  let index = Number(options.source);
-  if (!index) {
-    if (sources.length === 1) index = 1;
-    else if (!interactive) return { sources, formatSource, needsSelection: true };
-  }
-  if (!index) {
-    for (const source of sources) stderr.write(`${formatSource(source)}\n`);
-    const answer = await ask('Source number (Enter to cancel): ', signal);
+  if (!sources.length) {
+    if (originalError) throw originalError;
+    throw new Error('No downloadable video sources were found on this page.');
+  }
+  let index = Number(options.source);
+  if (!index) {
+    if (sources.length === 1) index = 1;
+    else if (!interactive) return { sources, formatSource, needsSelection: true };
+  }
+  if (!index) {
+    for (const source of sources) stderr.write(`${formatSource(source)}\n`);
+    const answer = await ask('Source number (Enter to cancel): ', signal);
     if (!/^[1-9]\d*$/.test(answer.trim())) throw new Error('No source selected.');
     index = Number(answer.trim());
   }