The canonical glossary for Arroxy. Every entry below is a domain term you can use
to explain how the app works — in a PR, a support reply, or a translation note —
without any code detail. It is a glossary and nothing else: no module names, no
function names, no constants, no decisions. Implementation lives in the code (the
source of truth); architectural decisions live in docs/adr/.
When two words exist for one concept, the canonical word is the bold heading and
the rejected alternatives are listed under _Avoid_. Use the canonical word in
code, UI copy, docs, and every locale.
Job: One download attempt for a single video. It runs, then ends as complete, failed, or cancelled. Avoid: task, download, pull, attempt
Phase: One step inside a running job — fetching the media, merging audio and video, embedding subtitles or metadata. Avoid: stage, step
Soft failure: A non-fatal miss that still leaves a usable result, so the job finishes as complete. Subtitles that could not be fetched are the typical case — the video is kept. Avoid: warning, partial failure
Hard failure: A fatal error that ends a job with no usable result. Avoid: crash, fatal error
Resume context: The saved state that lets a paused or failed job restart from its partial files instead of starting over. Only certain media failures are resumable. Avoid: checkpoint, savepoint, retry state
Status: The labelled phase or outcome a job is currently in — preparing, downloading, merging, complete, error. Avoid: state
Progress: The live percentage and detail line within the current phase. Distinct from status: status is which phase, progress is how far through it. Avoid: percent
Artifact: A file produced by a queue item, such as media, sidecar subtitles, a thumbnail, a description, or a companion file. Avoid: payload, attachment
Queue: The ordered set of jobs waiting to run, running, or finished. It survives an app restart. Avoid: list, batch
Queue item: A single job's persistent entry in the queue, including its source, output target, status, and resume state. Avoid: row, entry, task
Output target: The folder assigned to a queue item and its artifacts. Avoid: save path, output path
Downloads view: The user-facing management surface where users inspect, filter, select, and act on queue items. Avoid: queue view, drawer, task list
Queue action: A user command applied to one or more selected queue items. It applies only where valid for each queue item's current status. Avoid: bulk action, mass action
Lane: The scheduling tier of a queue item. A normal-lane item respects the simultaneous-download cap and the pacing delay between starts; a priority-lane item skips the pacing delay but still respects the hard cap. Avoid: tier, track, priority level
Held pause: A queue item paused before it ever started running. Resuming simply lets it start. Avoid: queued pause, idle pause
Active pause: A queue item paused after its download had already begun. Resuming continues from its partial files, even across an app restart. Avoid: live pause, running pause
Wizard: The guided step flow that takes a user from a URL, through format choice and save location, to a final confirmation. Avoid: flow, stepper, form
Probe: Inspecting a URL to discover its title, available formats, and metadata before any download starts. Avoid: fetch, inspect, scan, lookup
Preset: A named quality choice for a single download — best quality, balanced, small file, audio-only, subtitle-only. Avoid: quality, mode, profile
URL intent: The classification of a pasted URL as a single video, a playlist, a mix of both, or unknown. Avoid: URL type, URL kind
Playlist: A source URL that expands into multiple videos queued together — including a channel or a search, which Arroxy treats as playlists. The URL classifier may still tag the source as playlist, channel, or search for routing. Avoid: collection, batch
Download profile: A saved, reusable set of download settings the user applies in one click, without walking the wizard. Avoid: preset, template, config
Quick download: Starting a download straight from a saved profile, skipping the wizard steps. Avoid: instant download, one-click download
Sidecar subtitles: Subtitles saved as a separate file alongside the video. Avoid: external subtitles
Embedded subtitles: Subtitles muxed into the video file as a selectable track. Avoid: burned-in, hardcoded, baked-in subtitles
Dependency: One of the external programs Arroxy drives to do its work — the downloader and the media tools it relies on. Avoid: binary, tool, executable
Binary manifest: The versioned list that tells Arroxy which managed binary build to fetch for the current platform. Avoid: index, build list
Managed binary: A dependency Arroxy downloads and caches itself, as opposed to one bundled inside the app or found already installed on the system. Avoid: downloaded binary, fetched binary
Warmup: The startup readiness check that verifies the dependencies are present and working — fetching any that are missing — before downloads are allowed. Avoid: bootstrap, init, preflight