Batch Processing

Sublarr’s batch operations turn one click into many. Instead of opening each episode and triggering the same action, you select a range and the system queues the work behind a job that you can monitor in Activity → Queue. Every batch is cancellable mid-flight; partial work is rolled back cleanly.

Where batch actions live

Surface	Selection mode	Available actions
Library	Range-select via Shift+Click, multi-select with Space.	Search, translate, extract, delete sidecars.
Wanted	Same.	Search now, blacklist, mark resolved.
Series detail	All seasons / all episodes selectors.	Search, translate, extract, post-process.
Activity → Queue	Range-select pending jobs.	Cancel, retry, change priority.

The Batch toolbar

When at least one row is selected, a sticky toolbar slides up at the bottom of the page. It carries the action buttons plus a count badge:

Element	Purpose
Selection count	”23 episodes selected” — click to clear selection.
Filter pill	Narrows to “items missing target language”, “items with errors”, etc.
Action buttons	Action set depends on the surface (see table above).
Run	Queues the batch and opens the job in Activity → Queue.

Common batches

Search wanted episodes

The most-used batch — find subtitles for everything that’s missing them.

1. Open Wanted.
2. Apply the Filter pill to narrow to a series, language, or age.
3. Ctrl+A selects all visible rows.
4. Click Search now. Sublarr queues a search per row, respecting per-provider rate limits.

The job appears in Activity → Queue with a per-row progress bar. Successful downloads land in the Library; failures fall through to the next provider in priority order, then surface as failed rows.

Batch translate downloaded subtitles

When translation is enabled, you can backfill translations for a whole series:

1. Open the series in Library.
2. Select all episodes that have a source-language sidecar.
3. Click Translate.
4. Pick the target language and backend (the form is pre-filled from the series profile).

Tip

Pre-filter to “missing target language” — translating something that already exists is wasted compute and (with a paid backend) wasted money.

Batch extract embedded subtitles

For files where the subtitle is inside the container (MKV/MP4) instead of a sidecar:

1. Open the series or Wanted filtered to “embedded only”.
2. Select rows.
3. Click Extract embedded.

Sublarr probes each container for embedded streams in your target language, extracts them with mkvextract / ffmpeg, and writes a sidecar next to the source. Foreign-track removal happens during the same pass if Settings → Subtitles → Stream Management → Cleanup after extract is on.

Batch delete sidecars

Useful for cleanup after a wrong-language download or a corrupted batch:

1. Select the rows.
2. Click Delete sidecars.
3. Confirm. Files move to Trash with the configured retention.

Caution

Batch delete uses the same path validation as single delete — it can’t escape the configured media root. Always preview the affected paths in the confirmation modal before clicking through.

Cancellation

Every batch job is cancellable from Activity → Queue. Cancellation is cooperative: in-flight items finish their current step, partial work is rolled back, and the job exits with cancelled. Translation jobs raise JobCancelledError internally so any subtitle text already translated isn’t half-written to disk.

Concurrency limits

To protect upstream providers and avoid hammering your hardware, Sublarr caps how many parallel items each batch can process. Defaults under Settings → Automation:

Limit	Default	Configurable at
Concurrent provider searches	4	Settings → Automation → Search & Scan
Concurrent translations	2	Settings → Translation → Workers
Concurrent extractions	2	Settings → Subtitles → Stream Management

Hitting a limit means your batch progresses at that pace — the rest queue. Raising the limits is fine on capable hosts; lowering helps when you’re sharing resources with other workloads.

Auditing the result

Every batch writes to Activity → History with a per-item outcome row. Use the History filter on batch_id to retrieve only the items from one job — useful for “what did that 200-episode translate run actually produce?” reviews.