Skip to main content

Dub multiple videos at once (batch processing)

Use batch processing to queue many videos at once with a folder of sources and a spreadsheet that maps each file to its dub settings, all in one pass.

Batch processing lets you queue many videos in one go instead of creating each dub by hand. Every Dubly account can use it — you prepare a folder of source videos plus a spreadsheet that maps each file to its dub settings, and Dubly ingests the whole set in one pass.

💬 Have a very large or recurring volume, or want us to run it for you? See Requesting a custom batch project — we'll scope pricing and a delivery plan with you.

When to use batch processing

  • You have several videos that need the same or similar dub settings.

  • You'd rather set everything up once than click through the dub flow per video.

  • The videos share a source language and target language(s), or you can list per-video differences in a single sheet.

For a handful of videos, creating each dub the normal way is perfectly fine — batch processing pays off once you're dealing with many files at once.

What you need to prepare

Submit two things together:

  1. A folder containing every source video for the batch.

  2. A spreadsheet (Excel or CSV) with one row per video, mapping each video to its dub settings.

Your spreadsheet must include these columns:

Column

Notes

video_key

Must match your filename exactly, including the extension (e.g. episode_12.mp4). Filenames must not contain spaces, periods (other than the extension), special characters, or umlauts. This key pairs each row to its source file — if it doesn't match, the video can't be ingested.

video_url

Optional — only include this if you're sharing via a direct URL instead of, or in addition to, a folder.

title

The dub title as it will appear in your Dubly dashboard.

source_language

Language code of the original audio (e.g. en, de). Can be set per row if videos differ.

target_languages

Comma-separated language codes for the translations you need (e.g. de, fr, es).

speaker_count

Number of distinct speakers in the video (e.g. 1 for a single host, 2 for an interview).

custom_voice_id

Optional — leave blank for automatic speaker matching, or paste a specific custom voice ID from your account.

project_id

Optional — the Dubly project where the dubs should be assigned.

File requirements

  • Accepted formats: mp4 and mov, up to 5 GB per file.

  • Keep filenames clean: no spaces, periods (other than the extension), special characters, or umlauts.

  • Make sure every video_key in the spreadsheet matches a real file in the folder.

Mismatched filenames or formatting errors will prevent successful ingestion. A single bad row only blocks that video, but it's worth checking the whole sheet before you submit.

What happens next

  1. Dubly ingests the folder and reads your spreadsheet row by row.

  2. Each video is created as its own dub with the settings from its row.

  3. The dubs process like any other — each one moves through the normal phases (see How long does it take to dub a video?).

  4. You review and approve each dub in your normal Dubly project view.

Limits and tips

  • Every language is processed independently, so a batch with many target languages takes proportionally longer.

  • Turn Lip-Sync on only where you need it — it adds significant processing time per video.

  • For very large or recurring batches, or if you'd like us to handle ingestion and quality checks, request a custom batch project instead.

Still stuck? Contact support and include your spreadsheet so we can check the formatting with you.

Did this answer your question?