veodl 1.8.1

package/AGENTS.md

@@ -0,0 +1,11 @@
+# Working with veo
+
+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.
+- 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.

package/CHANGELOG.md

@@ -0,0 +1,264 @@
+# Changelog
+
+All notable changes to veo. This project follows [Semantic Versioning](https://semver.org/).
+
+## 1.8.1
+
+### Changed
+
+- Renamed package to `veodl` on npm.
+- Provided `veo`, `veod`, and `veodl` as parallel terminal commands (all execute the same CLI).
+
+## 1.8.0
+
+### Added
+
+- **`veo inspect <file>` and `veo inspect run <id>`**: Inspect local container and stream metadata with `--json`. Add `--check-audio` to decode audio tracks and verify signals above -60 dBFS. `veo inspect run <id>` locates saved run files by file identity, size, and sampled SHA-256 fingerprint, even after renames or moves (`--search <directory>`).
+- **`veo retry --last`**: Automatically retry the most recent failed or unfinished job without manually locating its job file.
+- **`veo history` improvements**: Added `--limit <1-1000>` to customize history entries and `--failed` to view only failed or cancelled attempts with their retry command and persistent `runId`.
+- **Config editor clipboard & mouse scrolling**: Added native system clipboard copy/paste (Ctrl+C / Ctrl+V) across Windows, macOS, Linux (Wayland/X11), and Termux, as well as mouse wheel and Ctrl+Up/Down scrolling.
+- **Termux desktop opener**: Supported `--open` in Android/Termux using `termux-open`.
+- **Agent guidelines**: Included AGENTS.md and docs/AGENT_GUIDE.md in the distributed package.
+
+## 1.7.2
+
+### Fixed
+
+- Stale download-history records referencing deleted files are automatically pruned on subsequent downloads, and empty `.veo-history` directories are removed.
+- `veo doctor` inspects `.veo-history` records, reports stale duplicate-detection records as warnings, and flags damaged history directories.
+
+## 1.7.1
+
+### Fixed
+
+- Progress adapts to narrow terminals, updates one line for parallel downloads, and marks estimated sizes instead of showing premature completion.
+- Download errors retain specific HTTP/network codes instead of replacing them with a generic network warning.
+- Files announced by a failed yt-dlp process are retained as unconfirmed, not treated as completed transfers; retry requires a successful backend exit.
+
+## 1.7.0
+
+### Added
+
+- Android/Termux automatically uses system yt-dlp and FFmpeg, with platform-specific doctor and backend-update instructions.
+- First downloads and `veo doctor fix` automatically install missing Termux tools (including JavaScript support) or acquire missing desktop media binaries in veo's cache; offline mode never installs packages.
+
+### Changed
+
+- Static desktop media tools are optional dependencies so unsupported binaries do not prevent npm installation.
+
+## 1.6.1
+
+### Added
+
+- `veo config reset` restores the current template after confirmation and saves an exact backup of the previous configuration, including malformed files.
+
+## 1.6.0
+
+### Added
+
+- Parallel URL and batch downloads with serialized jobs, per-item statistics, and adaptive retries with reduced concurrency.
+- Parallel playlist downloads (two playlist entries concurrently by default, `--playlist-concurrency 1-4`), with per-entry progress, serialized job updates, and cancellation that waits for active workers.
+- Concurrent DASH/HLS fragment downloads (up to eight DASH/HLS fragments concurrently by default; `-N` overrides this).
+- Safe filename and folder templates, free-space estimates, and phase timings.
+- Offline config commands: `veo config check` and `veo config show`, and full option documentation in the config editor.
+- Prefer H.264/AAC for explicit MP4 downloads, report incompatible original codecs, and add opt-in `--compatible` / `kompatibel` profile with conditional H.264/AAC conversion.
+- `--recode` flag for explicitly converting video formats when remuxing is incompatible.
+
+### Changed
+
+- Video `--format` now remuxes without quality loss; incompatible codecs fail instead of being converted silently.
+- Apply consistent terminal styling to all veo command reports and help, including stats; dim terminal status details and highlight titles, successful saves and failures; preserve plain JSON/piped output and honor `--no-color`, `NO_COLOR` and config color preferences.
+
+### Fixed
+
+- Fix Node.js DEP0190 warnings during Windows self-updates by invoking cmd.exe explicitly with a fixed npm command.
+
+## 1.5.0
+
+### Added
+
+- **`veo runs` and `veo stop`**: every run registers itself with a **6-character id** while
+  it works, so another terminal can watch and end it. `veo runs` lists active runs with PID,
+  state, start time, progress and output directory, `veo runs <id>` shows one run in detail
+  (URLs, media settings, job file and per-item state), `veo stop <id>` stops that run and
+  `veo stop` stops every run. A stop request is polled by the run itself, so no signals or
+  PIDs are needed; the stopped run exits like Ctrl+C and keeps its partial data and retry
+  job. Records of crashed runs are marked `stale` and removed by `veo stop`. Run records
+  never contain credentials or cookie settings, and an unknown or damaged record file is
+  ignored instead of breaking later runs.
+- **`veo history`**: shows the last 5 download attempts, newest first, with title, status,
+  media type, date, duration, URL and the saved files. Saved, skipped, failed and cancelled
+  items are recorded, including the reported failure reason; playlist entries and retries
+  count individually. `veo history --json` prints `{"count":N,"entries":[…]}` with the
+  complete file list for scripting. Records live as one small file per attempt in the
+  per-user veo cache's `history` directory and are kept by `veo flush`.
+
+### Changed
+
+- The run registry moved out of `veo flush` into `src/runs.js`; `veo flush` and `veo stop`
+  now stop the same registered runs, and `veo flush` keeps working with run records written
+  by older versions.
+
+## 1.4.0
+
+### Added
+
+- **Local download cache**: downloads and media processing now finish in the per-user veo
+  cache before the destination is written, so the output location is only touched once the
+  media is ready. Saving uses a hard link where supported and an exclusive copy across
+  drives or cloud mounts, with copied sizes verified. Existing files are still never
+  overwritten. The local original is removed only after files and history are saved.
+- **Recoverable transfers**: if saving fails or is cancelled after processing completed, the
+  finished local original and its sidecars are kept for **15 minutes** — with or without
+  `--resume`. Repeat the same command, or use the printed `--retry-failed` command, to retry
+  the transfer without contacting the source again. The same source, media settings and
+  destination identify a cached transfer; a repeated failure starts a fresh retention
+  period. Expired copies are removed on the next veo invocation, never by a background
+  timer, and active transfers are never expired.
+- **`veo stats`**: persistent counters for saved videos and audio, failed attempts, skips,
+  cancellations and total elapsed download-request time. `veo stats --json` prints the
+  totals as JSON. Playlist entries count individually and retries are new attempts.
+  Statistics hold counters and timestamps, not URLs or filenames.
+- **`veo flush [--stats]`**: stops active veo runs started with this version, then removes
+  temporary local downloads — including the 15-minute retained copies and unfinished resume
+  data — plus cached retry job files. Saved media, output history, config/profiles and
+  backend binaries are kept, and `--stats` additionally resets the statistics.
+- **`veo doctor fix`**: restores missing or damaged managed tools and then checks again,
+  staging bundled FFmpeg/FFprobe and downloading hash-verified yt-dlp when needed. With
+  `--offline` only local binaries are used, and `-o PATH` creates and checks an output
+  directory.
+- **Title placeholders** in `--rename` and the config/profile `rename` key: `-r "movie_*"`
+  inserts the original title (`movie_My Film.mp4`), and every `*` is substituted. Placeholders
+  make `--rename` usable with several URLs and playlists, where a plain name is still refused.
+- **`profiles.default`** is applied automatically when no profile is selected; other named
+  profiles keep using the global defaults instead of inheriting `default`. `veo config edit`
+  adds an empty `default` profile to existing configurations without changing settings, and
+  the wizard preselects it.
+- Config syntax errors now name the line and column and explain the likely mistake, such as
+  Markdown code fences, a trailing comma or an unescaped Windows path, without echoing
+  private config values.
+- The packaged-tarball check now verifies that every relative import resolves inside the
+  tarball and that the tarball, `package.json` and CHANGELOG versions agree, so an
+  incompletely bumped or incompletely packed release fails before publishing.
+
+### Changed
+
+- `veo doctor` no longer warns about a missing system FFmpeg when the selected FFmpeg and
+  FFprobe work, and it reports retained local downloads and copied-size mismatches.
+- Resume state and partial data now live in the local per-user cache under `downloads`
+  instead of the output directory, and the request hash also separates destinations,
+  playlist entries and source URLs. Legacy `.veo-part-<video id>` folders in the output
+  directory are left untouched and are not migrated automatically.
+- Unfinished downloads are discarded on failure or cancellation unless `--resume` is given;
+  a completed download is the only thing retained for a transfer retry. Local disk space is
+  therefore needed for the complete download and its processing files.
+
+## 1.3.0
+
+### Added
+
+- **Interactive wizard**: run `veo` without arguments in a terminal to be guided through a
+  download — profile, link, video or audio, available resolution, output directory, and
+  playlist entry selection. It enables resume and offers to skip already downloaded files.
+  Redirected input never starts a prompt.
+- **Named profiles** in the config file (`"profiles": { "music": {...} }`) plus
+  `veo config edit|path|profiles`. Global defaults are merged first, then the profile
+  selected with `--profile`, then explicit flags.
+- **Negated boolean flags** such as `--no-open`, `--no-audio` or `--no-resume` switch off a
+  stored default for one invocation; `--no-subs` also disables stored subtitle languages
+  and subtitle embedding.
+- **URL list files** with `--batch-file <file>` (one URL per line, blank lines and `#`
+  comments ignored), combinable with URLs on the command line.
+- **Durable batch jobs and `--retry-failed <file>`**: failed or cancelled runs print a
+  ready-to-use retry command, and retries keep the resolved output directory and settings
+  even from another working directory. Completed playlist jobs retry only failed indices.
+- **A final summary** per run, counting saved, skipped and failed items. With `--open`,
+  successful files are opened even when another URL or playlist entry fails.
+- **Playlist entries one at a time**: a failed entry keeps previously saved files and does
+  not stop the remaining entries. `--playlist-items 1,3-5` selects entries by original
+  one-based index, and the selection count plus available size estimates are shown first.
+- **`--skip-existing`** reuses the recorded source and settings history and re-checks that
+  the files are still on disk. A different quality or format, or a deleted output, is
+  downloaded again.
+- **Resume by source and settings hash**: partial data lives in
+  `.veo-part-<hash>`, guarded by a lock and a manifest that records backend-confirmed
+  completion, so an unprocessed file is never mistaken for a finished video. Each playlist
+  entry has its own state; completed entries are skipped on a later run and unfinished ones
+  are preserved independently.
+- **Labelled phases** in the terminal title and progress output: current item, source title,
+  video/audio/media stream, conversion or merge, and saving.
+- **Workflow regression tests** and real-backend smoke coverage for URL lists, profiles,
+  retry, duplicate detection and playlist selection.
+
+### Changed
+
+- Generated configuration comments, the example profiles (`music`, `archive`),
+  documentation and sample filenames are English throughout. Previously generated German
+  template comments are translated by the next `veo config edit`, preserving existing
+  settings, paths and custom profile names.
+- `veo config edit` fills new or empty files with a commented template and gives existing
+  files a one-time commented reference guide, without changing stored settings. Config
+  files accept `//` line and `/* ... */` block comments.
+- Ambiguous "resume folders" are replaced by the source/settings hash layout; only
+  backend-confirmed postprocessed media is reused.
+- Other positive numeric resolutions, such as `-q 540p`, are accepted instead of only the
+  documented list.
+
+## 1.2.0
+
+Everything below ships together: `1.1.0` was prepared but never published, so this
+release is the first to contain these changes.
+
+### Changed
+
+- **`--quality` is now an upper bound.** `-q 720p` downloads the best resolution at or
+  below 720p and never fetches 2160p instead. If a source offers nothing at or below the
+  request, veo stops before downloading and names the resolutions that do exist. The
+  historical "nearest available height" rule is still available as `--closest-quality`
+  and may pick a resolution above the request. Sources without resolution metadata fall
+  back to the best available stream, as before.
+- A finished download is now linked into place instead of copied. Staging lives inside
+  the output directory, so a hard link is enough; filesystems without hard links still
+  fall back to a copy. This removes a full extra read and write per download, roughly
+  halves the peak disk usage, and makes saving cancellable.
+- Fewer duplicated downloads in `veo update`: an explicitly installed backend release
+  is no longer pruned.
+- Metadata and media tools are prepared before any network work, so an unusable local
+  setup fails before a backend download starts.
+
+### Added
+
+- **Multiple URLs** in one invocation: `veo <url1> <url2> ...`. Downloads run
+  sequentially, a failure does not stop the remaining URLs, and the exit status is `1`
+  if any URL failed.
+- **`--playlist`** to download every entry of a playlist or channel URL. Each entry keeps
+  its own title, and `--no-playlist` remains the default.
+- **Subtitles**: `--subs`, `--sub-langs <langs>`, `--embed-subs`.
+- **Metadata**: `--embed-metadata`, `--embed-thumbnail`, `--sponsorblock-remove <categories>`,
+  `--section <range>`, and `-N/--concurrent-fragments <n>` for faster fragmented downloads.
+- **`--resume`** keeps partial data in `.veo-part-<video id>` and continues an interrupted
+  download, including one that was cancelled with Ctrl+C.
+- **`--cookies <file>` and `--cookies-from-browser <browser[:profile]>`** for content you
+  are authorized to access. Cookie files are validated before any network work and a
+  world-readable file produces a warning.
+- **`--dry-run`** reports the title, quality and destination path without downloading.
+- **`--list-formats`** prints the backend's own format table.
+- **`--json`** prints one JSON object per URL for scripting.
+- **`veo doctor`** checks Node.js, the output directory, the backend cache, yt-dlp,
+  FFmpeg/FFprobe, the config file, leftover partial downloads and network reachability.
+  It downloads nothing and exits `1` when a check fails.
+- **`veo backend update [--check]`** installs a newer yt-dlp release without waiting for a
+  new veo release, verified against that release's own `SHA2-256SUMS`. `veo backend reset`
+  returns to the release pinned and hash-verified at build time.
+- **Config file** for defaults (output directory, quality, format, subtitle preferences,
+  and so on). Explicit command-line flags always win.
+- **Windows on ARM** is no longer rejected: when the bundled static media tools are
+  unavailable, veo uses a system FFmpeg installation found on `PATH`.
+
+### Fixed
+
+- `--rename` is applied again; it had stopped affecting the saved filename.
+
+## 1.0.2
+
+- Initial published release.

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 veo contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.