veodl 1.10.0 → 1.11.0

package/AGENTS.md

@@ -2,10 +2,10 @@
 
 Read [the agent guide](docs/AGENT_GUIDE.md) before automating downloads or media checks.
 
-- Use `veo <url> --dry-run --json` to inspect the intended output, then `veo <url> --json` to download authorized content.
+- Use `veo <url> --list-qualities --json` to inspect available video resolutions, `veo <url> --dry-run --json` to preview output, then `veo <url> --json` to download authorized content.
 - Parse one JSON object per stdout line. Read stderr and the exit code too; a nonzero exit means the request did not fully succeed.
 - Use `veo runs --json` or `veo runs <id> --json` for active runs, and `veo history --json --limit 20` for finished attempts. Download JSON and history include the persistent `runId`.
 - Use `veo inspect <file> --check-audio --json` to distinguish an audio track from a measured signal. The check decodes the full audio track and may take time.
 - Use `veo inspect run <id> --json` to inspect files from a finished run. It verifies file presence first and searches the output tree by fingerprint after a rename; use `--search <directory>` after a move outside that tree.
-- Use `veo retry --last --json` for the latest failed or unfinished job. Avoid `veo flush` unless the user asked to remove temporary data and retry jobs.
-- Keep scripts non-interactive. `veo` without arguments starts a wizard only in a terminal.
+- Use `veo retry --last --json` or `veo --retry-failed <runId> --json` for failed or unfinished jobs. Avoid `veo flush` unless the user asked to remove temporary data and retry jobs.
+- Keep scripts non-interactive. `veo` without arguments starts a wizard only in a terminal; fragment concurrency above 16 requires `--experimental-fragments` in scripts.

package/CHANGELOG.md

@@ -2,6 +2,35 @@
 
 All notable changes to veo. This project follows [Semantic Versioning](https://semver.org/).
 
+## 1.11.0
+
+### Added
+
+- **Incognito Downloads**: Added `--incognito` (and `"incognito": true` in configuration/profiles) to save media without creating run records, persistent retry jobs, run archives, download history, `.veo-history` records, or download statistics. Uses an isolated temporary staging directory and completely removes it upon completion, failure, or cancellation, and disables yt-dlp's filesystem cache.
+- **Neutral Filenames**: Added `--neutral-filename` (and `"neutralFilename": true`) to generate unidentifiable random filenames (e.g. `video-a1b2c3d4e5f6.mp4`), suppressing video titles, channel names, and custom folder templates in filesystem paths.
+- **Subtitle Inspection & Automatic Captions**:
+  - Added `veo subs <url>` (alias `--list-subs` / `--list-subtitles`) to inspect available manual and automatically generated subtitle tracks, languages, and source formats without downloading.
+  - Added `--auto-subs` (and `"autoSubs": true`) to download automatically generated captions/subtitles.
+  - Added `--sub-format <format>` (and `"subFormat": string`) to express a preferred subtitle source format (e.g. `srt/vtt/best`).
+- **Post-Download Media Verification**: Added `--verify` (and `"verify": true`) to probe saved media files with FFprobe before recording success, verifying container integrity and stream presence. Retains saved files for inspection if verification fails.
+
+## 1.10.1
+
+### Added
+
+- Added `veo <url> --list-qualities` (alias `--list-qualitys`) to list available video resolutions ordered highest first without downloading media. Supports `--json` and discovered `--source <n>`.
+- Expanded `--concurrent-fragments` (or `-N`) to support values from 1 to 64. Experimental values between 17 and 64 require interactive `[y/N]` confirmation in terminals, or explicit opt-in via `--experimental-fragments` (or `"experimentalFragments": true` in configuration/profiles) for scripts and automated jobs. Values above 64 are rejected.
+- Added support for passing run IDs directly to `--retry-failed` (e.g. `veo --retry-failed <runId>`), automatically locating and resolving the corresponding retry job and rejecting active runs.
+- Added clickable OSC 8 directory links for saved file destinations, config paths, and editor headers in supported terminals (Windows Terminal, iTerm2, WezTerm, Kitty, VS Code, and VTE).
+- Added inline terminal region support (`createInlineRegion`) to smoothly render live progress and status in place without flickering, entering fullscreen, or wiping terminal scrollback.
+
+### Fixed
+
+- Handled terminal window resize events during live progress display, dynamically refitting titles and status lines.
+- Improved terminal title and line wrapping to display up to three lines for long titles before truncating.
+- Improved interactive config editor footer layout for long status messages and ensured stdin is paused cleanly upon exit.
+- Preserved complete original values in JSON and redirected output while adapting prose output to the active terminal width.
+
 ## 1.10.0
 
 ### Added

package/README.md

@@ -68,9 +68,13 @@ Options:
   --recode                  Explicit video conversion (requires --format)
   --playlist-concurrency <n> Parallel playlist entries, 1-4 (default: 2)
   --playlist                Download every entry of a playlist or channel URL
-  -N, --concurrent-fragments <n>   Parallel fragments, 1-16 (default: 8)
+  -N, --concurrent-fragments <n>   Parallel fragments, 1-64 (default: 8; 17-64 experimental)
+  --experimental-fragments  Explicitly accept experimental values above 16
   --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>     Prefer subtitle formats, e.g. srt/vtt/best
+  --list-subs               Show manual and automatic subtitle availability
   --embed-subs              Embed subtitles into the video file
   --embed-metadata          Embed title, date and other metadata
   --embed-thumbnail         Embed the thumbnail
@@ -79,12 +83,16 @@ Options:
   --cookies <file>          Netscape cookie file, for content you may access
   --cookies-from-browser <browser[:profile]>
   --resume                  Keep partial data and continue an interrupted download
+  --incognito               Save media without run ID, history, stats or retry data
+  --neutral-filename        Optional random filename instead of title and templates
+  --list-qualities          Show available video resolutions and exit
   --list-formats            Show available formats and exit
   --dry-run                 Show what would be downloaded and exit
+  --verify                  Probe saved media files with FFprobe (default: off)
   --json                    One JSON object per URL instead of prose
   --profile <name>          Use a named profile from the config file
   --batch-file <file>       Read one URL per line (blank lines and # comments ignored)
-  --retry-failed <file>     Retry failed/unfinished downloads from a saved job
+  --retry-failed <id|file>  Retry failed/unfinished downloads by run ID or job file
   --playlist-items <list>   Select entries, e.g. 1,3-5 (implies --playlist)
   --skip-existing          Skip matching downloads that are still on disk
   --no-<boolean-option>    Disable a default, e.g. --no-open or --no-audio
@@ -108,7 +116,7 @@ npx veodl "https://example.com/video.mp4" --output ./downloads
 
 ### Several URLs and playlists
 
-Playlist downloads use two concurrent entries by default; use `--playlist-concurrency 1` for sequential downloads. Each entry uses up to eight concurrent DASH/HLS fragments by default (`-N 1` disables fragment parallelism). More connections help only when the source and connection have spare capacity. Video format changes preserve the encoded streams unless `--recode` is explicitly enabled; audio extraction and precise section cuts retain their existing conversion behavior.
+Playlist downloads use two concurrent entries by default; use `--playlist-concurrency 1` for sequential downloads. Each entry uses up to eight concurrent DASH/HLS fragments by default (`-N 1` disables fragment parallelism). Fragment counts between 1 and 16 need no confirmation. Values from 17 to 64 are experimental and prompt for `y/N` confirmation in terminals, or require `--experimental-fragments` (or `"experimentalFragments": true` in configuration/profiles) in non-interactive environments and JSON mode. Values above 64 are rejected. More connections help only when the source and connection have spare capacity, and excessive connections may trigger server limits. Video format changes preserve the encoded streams unless `--recode` is explicitly enabled; audio extraction and precise section cuts retain their existing conversion behavior.
 
 - Pass any number of URLs; up to two run concurrently by default. Use
   `--concurrent-downloads 1` for sequential processing. A failure is reported
@@ -125,7 +133,7 @@ Playlist downloads use two concurrent entries by default; use `--playlist-concur
 - `--batch-file links.txt` accepts a UTF-8 URL list, optionally alongside URLs on the command
   line. A final summary counts saved, skipped and failed videos. Successful files are opened
   with `--open` even if another URL or playlist entry fails.
-- Failed or cancelled jobs print a ready-to-use `veo --retry-failed "<job.json>"` command.
+- Failed or cancelled jobs print a ready-to-use `veo --retry-failed <runId>` command. Saved job file paths are also accepted.
 - Use `veo retry --last` to retry the newest failed or unfinished job without copying its path. Active runs are ignored; use `veo runs` to inspect them.
   Jobs are stored under the per-user veo cache's `jobs` directory. Retries retain resolved
   output directories and settings, even from a different working directory, and explicit
@@ -141,6 +149,7 @@ veo --batch-file links.txt --profile archive
 veo "https://example.com/playlist" --playlist-items 1,3-5 --resume
 veo "https://example.com/playlist" --playlist --skip-existing
 veo --retry-failed "C:\path\to\job.json"
+veo --retry-failed abc123
 veo retry --last
 ```
 
@@ -193,11 +202,11 @@ example through `veo config edit`. Enable it with `veo URL --profile kompatibel`
   reserved by concurrent downloads in the same process. Unknown sizes are reported as
   unknown; conversion sizes and other processes' disk usage cannot be predicted exactly.
   Use `--no-check-space` to disable this conservative check.
-- `--timings` shows phase times at the end of the run. Single downloads show
-  timing without a summary; multiple downloads show timing below the summary.
-  The phases cover setup, metadata, download/backend, processing, saving and retry waits.
-  Download/backend includes the backend's own startup and extraction overhead;
-  these are summed per-download times, not a diagnosis of network speed.
+- `--timings` shows phase times at the end of the run. Single downloads show
+  timing without a summary; multiple downloads show timing below the summary.
+  The phases cover setup, metadata, download/backend, processing, saving and retry waits.
+  Download/backend includes the backend's own startup and extraction overhead;
+  these are summed per-download times, not a diagnosis of network speed.
   JSON results include `timings` in milliseconds, or `entryTimings` for playlists.
   Use `--no-timings` to hide/omit them.
 - Terminal details are gray, titles bold, saves green and errors red. The same styling
@@ -205,6 +214,12 @@ example through `veo config edit`. Enable it with `veo URL --profile kompatibel`
   interactive prompts. For example, `veo stats --no-color` disables it for one command. Redirected output
   and JSON have no color escapes. `--no-color`, `"color": false`, `NO_COLOR`,
   and `TERM=dumb` disable colors.
+  Terminal reports shorten long URLs, paths and detail values to the current window
+  width. Titles can use up to three lines before an ellipsis is added. This also
+  applies with `--no-color`; JSON and redirected output retain complete values.
+  Downloads stay in the normal terminal flow. Only the current progress block is
+  updated in place; narrow windows put the statistics below the progress bar.
+  Existing logs remain in scrollback and are not replayed or rewritten on resize.
   This can be set independently per profile, for example
   `"profiles": { "default": { "color": true }, "plain": { "color": false } }`.
   Use `veo stats --profile plain` or `veo URL --profile plain`; `--color` or
@@ -232,7 +247,7 @@ veo config show --profile fast
 Config checks validate every effective profile (or the selected one), including unknown
 settings, ranges and conflicting options. Show prints merged built-in, global and profile
 settings as JSON, with credential paths/browser profiles redacted. Neither command contacts
-video sites. All new options are also documented in `veo config guide`.
+video sites. All new options are also documented in `veo config guide`.
 
 ### Files, names and resume
 
@@ -283,8 +298,13 @@ video sites. All new options are also documented in `veo config guide`.
 
 ### Metadata and subtitles
 
-- `--subs` writes subtitle files, `--sub-langs de,en` selects languages, and `--embed-subs`
-  embeds them into the video container instead.
+- `veo subs <URL>` lists manual and automatically generated subtitles separately, including
+  their languages and source formats. `--json` returns one object without subtitle URLs.
+- `--subs` writes manual subtitle files. `--auto-subs` adds generated subtitles, or selects
+  only generated subtitles when used alone. `--sub-langs de,en` selects languages;
+  `--sub-format srt/vtt/best` prefers available source formats in that order. A format
+  preference does not convert subtitles. `--embed-subs` embeds selected subtitles into
+  the video container.
 - `--embed-metadata` and `--embed-thumbnail` use FFmpeg to write metadata and cover art.
 - `--sponsorblock-remove sponsor,selfpromo` cuts sponsor segments (YouTube) and requires
   FFmpeg; the cut re-encodes the affected parts.
@@ -292,6 +312,16 @@ video sites. All new options are also documented in `veo config guide`.
 - `-N 8` downloads several fragments in parallel, which is noticeably faster on HLS/DASH
   sources and heavier on the network.
 
+### Optional post-download verification
+
+Use `veo <URL> --verify` or set `"verify": true` in a config profile to check
+saved media with FFprobe before recording a successful download. It checks that
+the container can be probed and contains a video track (or an audio track for
+`--audio`). Verification is off by default; `--no-verify` overrides a profile.
+This quick check does not decode the whole file or prove that the audio is
+audible. Use `veo inspect <file> --check-audio` for a full audio signal check.
+If verification fails, veo reports failure and keeps the saved file for review.
+
 ### Access and credentials
 
 veo downloads publicly accessible content. It does not bypass access controls, and it does
@@ -309,10 +339,10 @@ download fails because a login is required, the error message points at these fl
 
 ### Inspection and scripting
 
-- `veo <page-url> --list-sources` opens the page in a temporary headless Chrome,
-  Edge or Chromium profile, repeatedly checks for visible Play controls (including
-  controls added later or inside frames), and watches media requests after interaction.
-  Use `--json` for numbered source
+- `veo <page-url> --list-sources` opens the page in a temporary headless Chrome,
+  Edge or Chromium profile, repeatedly checks for visible Play controls (including
+  controls added later or inside frames), and watches media requests after interaction.
+  Use `--json` for numbered source
   metadata. Each result includes its title, host, HLS/DASH/direct type, known
   resolutions, estimated MiB size and Mbit/s bitrate when the source provides them. Signed media
   URLs are not printed. Set `VEO_BROWSER_PATH` if the browser is not found.
@@ -324,17 +354,22 @@ download fails because a login is required, the error message points at these fl
   is reached, verified sources found so far are shown with a timeout notice.
   A deep scan covers observed requests; it cannot discover sources that the
   page never loads. The timeout does not stop a subsequent download.
-- For an unsupported single page URL, veo searches for media automatically and
-  uses the only verified source when there is one. If several sources are found,
-  the terminal asks which one to use; scripts receive a numbered source list and
-  a nonzero exit. `veo <page-url> --source 2 --dry-run --json` previews a chosen
-  source, and `veo <page-url> --source 2 --json` downloads it. Scripts never
-  receive an interactive prompt.
+- For an unsupported single page URL, veo searches for media automatically and
+  uses the only verified source when there is one. If several sources are found,
+  the terminal asks which one to use; scripts receive a numbered source list and
+  a nonzero exit. `veo <page-url> --source 2 --dry-run --json` previews a chosen
+  source, and `veo <page-url> --source 2 --json` downloads it. Scripts never
+  receive an interactive prompt.
   Retry jobs retain the page URL and selected number and discover a fresh media
   URL, because player links may expire. Browser discovery uses a temporary
-  profile without copying browser cookies, and cannot unlock DRM content.
-  Misspelled flags and commands show a nearby valid spelling, for example
-  `--deepscan` suggests `--deep-scan`.
+  profile without copying browser cookies, and cannot unlock DRM content.
+  Misspelled flags and commands show a nearby valid spelling, for example
+  `--deepscan` suggests `--deep-scan`.
+- `veo <url> --list-qualities` lists available video resolutions, highest first,
+  without downloading media. `--list-qualitys` is an alias. Add `--json` for
+  a `qualities` array (e.g. `["1080p", "720p"]`); use `--quality 720p` to select
+  an upper bound. Unknown resolutions are reported without guessing. Audio-only,
+  storyboard and DRM formats are excluded. Supports `--source <number>` for embedded players.
 - `--list-formats` prints the backend's own format table for one URL and exits.
 - `--dry-run` prints the title, the resolved quality and the destination path that would be
   used — without creating the output directory or downloading anything.
@@ -383,10 +418,11 @@ are not allowed.
 }
 ```
 
-Supported keys: `output`, `quality`, `format`, `rename`, `audio`, `open`, `resume`,
-`closestQuality`, `cookies`, `cookiesFromBrowser`, `playlist`, `concurrentFragments`, `playlistConcurrency`, `recode`, `compatible`, `concurrentDownloads`, `adaptiveConcurrency`,
+Supported keys: `output`, `quality`, `format`, `rename`, `audio`, `open`, `resume`, `incognito`, `neutralFilename`,
+`closestQuality`, `cookies`, `cookiesFromBrowser`, `playlist`, `concurrentFragments`,
+`experimentalFragments`, `playlistConcurrency`, `recode`, `compatible`, `concurrentDownloads`, `adaptiveConcurrency`,
 `filenameTemplate`, `folderTemplate`, `checkSpace`, `timings`, `color`,
-`subs`, `subLangs`, `embedSubs`, `embedMetadata`, `embedThumbnail`, `sponsorblockRemove`,
+`subs`, `autoSubs`, `subLangs`, `subFormat`, `embedSubs`, `embedMetadata`, `embedThumbnail`, `sponsorblockRemove`, `verify`,
 `section`, `json`. An explicit command-line flag always wins over a stored default. An
 unknown key produces a warning; invalid JSON or a wrong value type is an error, because
 silently ignoring a typo would be worse.
@@ -394,29 +430,50 @@ silently ignoring a typo would be worse.
 Source discovery defaults are `deepScan` (boolean), `timeout` (string such as
 `"30s"` or `"2m"`), `listSources` (boolean) and `autoListSources` (boolean).
 `listSources: true` makes a single URL list sources and exit; use
-`--no-list-sources` to download for one invocation. `autoListSources` defaults
-to `true` and searches when ordinary extraction finds no downloadable video.
-Set it to `false` or pass `--no-auto-list-sources` to disable that fallback.
-A single verified source is selected automatically; multiple sources require
-a choice. `deepScan` and
+`--no-list-sources` to download for one invocation. `autoListSources` defaults
+to `true` and searches when ordinary extraction finds no downloadable video.
+Set it to `false` or pass `--no-auto-list-sources` to disable that fallback.
+A single verified source is selected automatically; multiple sources require
+a choice. `deepScan` and
 `timeout` apply to either kind of source search.
 
 Additional defaults are `skipExisting` and `playlistItems`. Boolean defaults can be disabled
 with `--no-open`, `--no-audio`, `--no-resume`, `--no-embed-metadata`, etc. `--no-subs` also
 disables stored subtitle languages and subtitle embedding for that invocation.
 
+### Incognito downloads
+
+Use `veo <url> --incognito` or set `"incognito": true` in a named profile. The
+downloaded media is saved normally. veo does not assign a run ID or write a
+retry job, run archive, download history, output `.veo-history` record, or
+statistics for that attempt. It uses a private temporary staging directory and
+removes it after success, failure, or cancellation. It also disables yt-dlp's
+filesystem cache. `--no-incognito` overrides
+a profile for one request. Incognito cannot be combined with `--resume`,
+`--skip-existing`, or `--retry-failed`; there is no veo retry for an incognito
+attempt. A force-killed process may leave temporary files that the OS can
+clean later. The destination file, shell history, network service, and source
+website can still reveal the download.
+
+Example profile: `"profiles": { "private": { "incognito": true } }`.
+Add `"neutralFilename": true` to that profile, or pass `--neutral-filename`,
+to save files as names such as `video-a1b2c3d4e5f6.mp4`. This is optional:
+incognito keeps the normal title by default. Neutral naming overrides `--rename`,
+`--filename-template`, and `--folder-template` for that request. The selected
+output directory, media contents, and embedded metadata are unaffected.
+
 ### Named profiles
 
-If no profile is selected, `profiles.default` is applied automatically. `veo profile music`
-selects another named profile for future commands and stores it as `activeProfile` in the
-config; `veo profile` shows the current choice, and `veo profile list` marks it in
-the list. `veo profile reset` removes the stored choice and returns to `default`.
-You can also use `veo profile default` to select it explicitly.
-The names `list` and `reset` are reserved for these commands and cannot be used as profile names.
-`--profile NAME` overrides this choice for one command. Named profiles use global defaults
-rather than inheriting `default`. The wizard preselects the active profile.
-New configurations include an empty `default` profile and the example profiles. Existing configurations are
-left unchanged when opened. An empty profile does not change download behavior.
+If no profile is selected, `profiles.default` is applied automatically. `veo profile music`
+selects another named profile for future commands and stores it as `activeProfile` in the
+config; `veo profile` shows the current choice, and `veo profile list` marks it in
+the list. `veo profile reset` removes the stored choice and returns to `default`.
+You can also use `veo profile default` to select it explicitly.
+The names `list` and `reset` are reserved for these commands and cannot be used as profile names.
+`--profile NAME` overrides this choice for one command. Named profiles use global defaults
+rather than inheriting `default`. The wizard preselects the active profile.
+New configurations include an empty `default` profile and the example profiles. Existing configurations are
+left unchanged when opened. An empty profile does not change download behavior.
 
 ```json
 {
@@ -429,15 +486,15 @@ left unchanged when opened. An empty profile does not change download behavior.
 }
 ```
 
-`veo <url> --profile music` merges global defaults, then the selected profile, then explicit
-CLI flags. `veo config profiles` lists profile names; `veo config path` prints the file path.
-The download status shows `Profile: NAME` (or `global (no profile)` when none is configured).
-`veo config edit` creates a small, valid configuration for new or empty files. Opening an
-existing configuration does not add or update comments. The current option guide is kept in
-the program; `veo config guide` prints it without changing the file. In the built-in editor,
-F3 offers **A** to add or update the guide at the top and **R** to remove a previously
-generated guide. Ctrl+S saves that choice. This can also clean up the long duplicate block
-inserted by older versions. Personal settings and notes below a generated block are preserved.
+`veo <url> --profile music` merges global defaults, then the selected profile, then explicit
+CLI flags. `veo config profiles` lists profile names; `veo config path` prints the file path.
+The download status shows `Profile: NAME` (or `global (no profile)` when none is configured).
+`veo config edit` creates a small, valid configuration for new or empty files. Opening an
+existing configuration does not add or update comments. The current option guide is kept in
+the program; `veo config guide` prints it without changing the file. In the built-in editor,
+F3 offers **A** to add or update the guide at the top and **R** to remove a previously
+generated guide. Ctrl+S saves that choice. This can also clean up the long duplicate block
+inserted by older versions. Personal settings and notes below a generated block are preserved.
 In an interactive terminal, it opens the built-in editor
 unless `VISUAL` or `EDITOR` is configured (an executable path, without shell arguments).
 The editor provides syntax colors, line numbers and live validation. Syntax errors mark
@@ -446,13 +503,13 @@ spelling suggestions, expected types and allowed values in the status area. Vali
 the same rules as the CLI, including profile overrides and audio/video formats.
 Press F2 on a property or value to open suggestions, use Up/Down to choose, Enter to apply
 or Esc to cancel. Suggestions require valid JSON syntax; free-text values and custom numeric
-resolutions such as `900p` remain supported. Ctrl+S validates and saves;
-Ctrl+Z undoes edits, Ctrl+Y redoes them, and Ctrl+A selects the whole file.
-Esc or Ctrl+Q exits, asking before discarding changes. Use arrows, Home/End and PageUp/PageDown
+resolutions such as `900p` remain supported. Ctrl+S validates and saves;
+Ctrl+Z undoes edits, Ctrl+Y redoes them, and Ctrl+A selects the whole file.
+Esc or Ctrl+Q exits, asking before discarding changes. Use arrows, Home/End and PageUp/PageDown
 to navigate. Invalid configurations cannot be saved. `--no-color` disables syntax colors.
 In terminals supporting SGR mouse reporting, left-click positions the cursor and dragging
-selects text, including across lines. Holding the pointer at the top or bottom while dragging
-scrolls the file and extends the selection. Backspace/Delete removes the selection; typing replaces
+selects text, including across lines. Holding the pointer at the top or bottom while dragging
+scrolls the file and extends the selection. Backspace/Delete removes the selection; typing replaces
 it. The mouse wheel scrolls without changing the editing position; Ctrl+Up/Down also scrolls.
 Ctrl+C copies selected text to the system clipboard, and Ctrl+V pastes clipboard text at the
 cursor or replaces the selection. Ctrl+Q or Esc exits the editor. The editor disables mouse
@@ -477,8 +534,8 @@ $env:VEO_CONFIG_EDITOR = 'external'
 
 Non-interactive sessions use the external editor unless `--terminal` is explicitly selected,
 in which case an interactive-terminal error is reported. The wizard also offers configured profiles.
-Generated guides and app messages are in English. Existing comments, profile names and
-settings are preserved when opening the editor.
+Generated guides and app messages are in English. Existing comments, profile names and
+settings are preserved when opening the editor.
 
 ### Terminal output
 
@@ -514,14 +571,14 @@ settings are preserved when opening the editor.
 ```bash
 veo version           # installed version (also: veo --version or veo -v)
 veo                   # interactive download wizard (terminal only)
-veo config edit       # create/open config; F3 offers the optional guide
-veo config guide      # print the current option guide
+veo config edit       # create/open config; F3 offers the optional guide
+veo config guide      # print the current option guide
 veo config reset      # confirm with y; back up config and restore the current template
-veo config profiles   # list available profiles
-veo profile            # show the currently selected profile
-veo profile list       # list all profiles and mark the active one
-veo profile music      # use music as the default for future commands
-veo profile reset      # return to default (or global settings if absent)
+veo config profiles   # list available profiles
+veo profile            # show the currently selected profile
+veo profile list       # list all profiles and mark the active one
+veo profile music      # use music as the default for future commands
+veo profile reset      # return to default (or global settings if absent)
 veo config path       # show the config file location
 veo doctor            # diagnose the local setup; exit 1 if a check fails
 veo doctor fix        # restore missing or damaged managed tools
@@ -533,6 +590,7 @@ veo retry --last       # retry the newest failed or unfinished job
 veo runs              # active runs with their id; veo runs <id> for details
 veo runs --json       # machine-readable active run metadata
 veo inspect FILE --check-audio --json  # track metadata and audio signal
+veo subs URL --json    # available manual and automatic subtitles
 veo inspect run ID --check-audio --json  # finished run and saved media
 veo stop [id]         # stop one run, or every active run
 veo flush             # stop runs, clear temporary downloads and retry jobs
@@ -814,3 +872,6 @@ replacing the CLI.
 ## License
 
 MIT for this CLI. yt-dlp and FFmpeg/FFprobe retain their respective upstream licenses.
+# Clickable paths
+
+In supported terminals (Windows Terminal, iTerm2, WezTerm, Kitty, VS Code and recent VTE terminals), the `Saved:` path, `veo config path` and the config editor's header link to the containing folder. Use the terminal's link gesture, usually Ctrl+click or Cmd+click. The terminal and operating system decide whether file links open the file manager; unsupported terminals and redirected output show plain paths. Missing paths are not linked. JSON output remains plain.

package/docs/AGENT_GUIDE.md

@@ -10,14 +10,14 @@ veo "https://example.com/video" --json --output ./downloads
 veo inspect "./downloads/video.mp4" --check-audio --json
 ```
 
-For a page with an embedded player that the normal extractor cannot identify,
-`veo "<page-url>" --dry-run --json` searches for playable media automatically.
-It uses a single verified source without a second command. If several sources
-are found, run `veo "<page-url>" --list-sources --json` and choose an `index`,
-then use `veo "<page-url>" --source <index> --dry-run --json` before downloading.
-Source discovery opens a temporary headless Chromium-based
-browser, repeatedly checks for Play controls, and observes media requests after
-interaction. It needs Chrome, Edge or Chromium,
+For a page with an embedded player that the normal extractor cannot identify,
+`veo "<page-url>" --dry-run --json` searches for playable media automatically.
+It uses a single verified source without a second command. If several sources
+are found, run `veo "<page-url>" --list-sources --json` and choose an `index`,
+then use `veo "<page-url>" --source <index> --dry-run --json` before downloading.
+Source discovery opens a temporary headless Chromium-based
+browser, repeatedly checks for Play controls, and observes media requests after
+interaction. It needs Chrome, Edge or Chromium,
 or `VEO_BROWSER_PATH`. A found source is verified by the backend; size may be
 unknown, and DRM-protected media is excluded. Source numbers are tied to the
 page's current discovery run and may change later.
@@ -31,6 +31,12 @@ not to a later download.
 
 Set `VEO_NO_UPDATE_CHECK=1` when a background update notice would distract a script. Use an explicit output directory to avoid depending on the agent's current working directory. `--dry-run` plans the download without saving media. It can still inspect the source and prepare backend tools on first use.
 
+Use `veo "<url>" --list-qualities --json` to list video resolutions without
+downloading media. The result has `status: "qualities"` and a `qualities` array
+ordered highest first, such as `["1080p", "720p"]`. `--list-qualitys` is an alias.
+An empty array means the video has no known resolution; audio-only and DRM
+formats are excluded. Use `--source <index>` for a discovered player source.
+
 ## Output and failures
 
 Download commands write **one JSON object per URL** to stdout with `--json`. Several URLs produce newline-delimited JSON, not a JSON array. Progress, summaries and errors go to stderr. A failed item can still contain saved files, especially within a playlist.
@@ -58,10 +64,12 @@ veo history --failed --limit 20 --json
 veo retry --last --json
 ```
 
-`runs` reports **active** runs, including their ID, state, options, job path and per-item progress. Completed runs disappear from this list. Download JSON and `history` retain the `runId`. `history` reports finished attempts with their outcome and saved file paths. A failed history entry may contain a `job` path, which can be passed to `veo --retry-failed "<job-path>"`; `veo retry --last` finds the newest retryable job automatically. Running jobs are excluded from `retry --last`.
+`runs` reports **active** runs, including their ID, state, options, job path and per-item progress. Completed runs disappear from this list. Download JSON and `history` retain the `runId`. `history` reports finished attempts with their outcome and saved file paths. Use `veo --retry-failed <runId>` to retry a failed or unfinished run; a saved `job` path is also accepted as `veo --retry-failed "<job-path>"`. The original retry job must still be present, and retrying an active run by ID is rejected. `veo retry --last` finds the newest retryable job automatically. Running jobs are excluded from `retry --last`.
 
 ## Inspect saved media and audio
 
+`veo subs <URL> --json` lists manual and automatic subtitle languages and formats without saving media. Select manual subtitles with `--subs --sub-langs de,en`, generated subtitles with `--auto-subs --sub-langs de,en`, and prefer a source format with `--sub-format srt/vtt/best`. `--verify` optionally probes saved media files before recording success; it is off by default and does not decode the full track.
+
 ```sh
 veo inspect "/downloads/Example.mp4" --json
 veo inspect "/downloads/Example.mp4" --check-audio --json
@@ -79,6 +87,12 @@ The run record is stored in veo's per-user cache on the device that ran the down
 
 ## Operational notes
 
+- `veo <URL> --incognito --json` saves media without a run ID, retry job, history, run archive, output duplicate record or statistics. It disables yt-dlp's filesystem cache. A config profile can set `"incognito": true`; `--no-incognito` overrides it. Incognito cannot use `--resume`, `--skip-existing`, or retry. Its temporary staging data is removed after the attempt; the output file and records outside veo (such as shell history or server logs) still exist.
+- Add `--neutral-filename` or `"neutralFilename": true` to use random media filenames instead of titles. This option is independent of `--incognito` and overrides custom file and folder naming for that request.
+
+- Fragment concurrency defaults to 8. Values 1-16 need no confirmation; 17-64 are experimental and require terminal `y/N` confirmation before downloading. Scripts and JSON calls must explicitly accept with `--experimental-fragments` or `"experimentalFragments": true` in the config/profile. Values above 64 are always rejected. More connections may trigger server limits and do not guarantee higher speed. Dry-runs and source/format listings do not require confirmation.
+- Example profile: `"experimental": { "concurrentFragments": 32, "experimentalFragments": true }`. Run with `veo <URL> --profile experimental`; use `--no-experimental-fragments` to revoke a stored opt-in.
+
 - Run `veo doctor --offline` to check the local setup without network repair. `veo doctor fix` may install missing tools.
 - Use `--resume` for interrupted downloads and `--skip-existing` when repeated saves should be avoided.
 - `veo flush` removes temporary downloads and retry jobs; do not run it as routine maintenance in an agent workflow.

package/package.json

@@ -1,58 +1,61 @@
-{
-  "name": "veodl",
-  "version": "1.10.0",
-  "description": "A clean, simple video downloader powered by yt-dlp.",
-  "type": "module",
-  "bin": {
-    "veo": "bin/veo.js",
-    "veodl": "bin/veo.js"
-  },
-  "files": [
-    "bin/",
-    "src/",
-    "docs/",
-    "AGENTS.md",
-    "README.md",
-    "CHANGELOG.md",
-    "LICENSE"
-  ],
-  "engines": {
-    "node": ">=22"
-  },
-  "scripts": {
-    "test": "node --test",
-    "test:smoke": "node scripts/smoke.js",
-    "test:open": "node scripts/smoke-open.js",
-    "check:package": "node scripts/check-package.js",
-    "prepublishOnly": "npm test",
-    "test:workflows": "node scripts/smoke-workflows.js"
-  },
-  "keywords": [
-    "cli",
-    "video",
-    "downloader",
-    "yt-dlp",
-    "audio",
-    "youtube",
-    "playlist",
-    "subtitles"
-  ],
-  "license": "MIT",
-  "author": "Mailo037",
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/Mailo037/veodl.git"
-  },
-  "bugs": {
-    "url": "https://github.com/Mailo037/veodl/issues"
-  },
-  "homepage": "https://github.com/Mailo037/veodl#readme",
-  "preferGlobal": true,
-  "publishConfig": {
-    "access": "public"
-  },
-  "optionalDependencies": {
-    "ffmpeg-static": "5.3.0",
-    "ffprobe-static": "3.1.0"
-  }
-}
+{
+  "name": "veodl",
+  "version": "1.11.0",
+  "description": "A clean, simple video downloader powered by yt-dlp.",
+  "type": "module",
+  "bin": {
+    "veo": "bin/veo.js",
+    "veodl": "bin/veo.js"
+  },
+  "files": [
+    "bin/",
+    "src/",
+    "docs/",
+    "AGENTS.md",
+    "README.md",
+    "CHANGELOG.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=22"
+  },
+  "scripts": {
+    "test": "node --test",
+    "test:smoke": "node scripts/smoke.js",
+    "test:open": "node scripts/smoke-open.js",
+    "check:package": "node scripts/check-package.js",
+    "prepublishOnly": "npm test",
+    "test:workflows": "node scripts/smoke-workflows.js"
+  },
+  "keywords": [
+    "cli",
+    "video",
+    "downloader",
+    "yt-dlp",
+    "audio",
+    "youtube",
+    "playlist",
+    "subtitles"
+  ],
+  "license": "MIT",
+  "author": "Mailo037",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Mailo037/veodl.git"
+  },
+  "bugs": {
+    "url": "https://github.com/Mailo037/veodl/issues"
+  },
+  "homepage": "https://github.com/Mailo037/veodl#readme",
+  "preferGlobal": true,
+  "publishConfig": {
+    "access": "public"
+  },
+  "optionalDependencies": {
+    "ffmpeg-static": "5.3.0",
+    "ffprobe-static": "3.1.0"
+  },
+  "devDependencies": {
+    "@xterm/headless": "6.0.0"
+  }
+}