Play dub packs on iPhone and Mac

Community dub packs, the scenes players cut from films, series and games, import into Dubloon as they are. This page covers how to get one in, what Dubloon can read, what to do when a pack refuses, and how a pack is put together.

What a dub pack is

A dub pack is one scene, ready to be voiced. It holds the video with the dialogue taken out, the music and effects that stay underneath, and for every line a short recording of the original delivery and a note of when it starts. A dubbing game plays the picture, cues you line by line, records you, and puts your voice where the actor's was.

Players have built up a large library of packs from films, series, anime and games. Dubloon reads them on the iPhone and the Mac without converting or repackaging anything.

Four scenes come with Dubloon so you can start straight away: Camp Rules from Sprite Fright, Awesome in Space from Tears of Steel, A Kindred Spirit from Sintel and Stuck Up from The Outsider (1951). You can dub two lines of Camp Rules in your browser to see how it feels.

Import a dub pack on an iPhone

  1. Find a scenePlayers share packs on GameBanana. Pick one you like and open its page.
  2. Download itTap Download and choose the file: a .zip, .7z or .rar. Safari saves it to the Files app, in Downloads.
  3. Let it finishWait for the download to complete. If the file is in iCloud Drive, open it once in Files so it is really on the phone.
  4. Import itIn Dubloon, open Movie Scene Dub, tap + and pick the file from Downloads. Dubloon unpacks it and the scene appears in your list.

You can also send a pack straight to Dubloon from the Files share sheet or by AirDrop from another device. There is no need to unzip anything first.

Import a dub pack on a Mac

  1. Download the packSave the folder or archive anywhere, Downloads is fine. Leave archives as they are.
  2. Bring it inChoose File ▸ Import Dub Pack… or press ⌘O and select it. Or drag the folder or archive from Finder onto the Dub Packs list in the sidebar.
  3. Open the sceneIt appears in the sidebar, with its lines in a list, the picture in the viewer and a timeline for your takes.

What Dubloon can read

Packs in the wild are not uniform. Different tools write different files, and Dubloon accepts the variations it has met so far.

Part of the packAccepted
ContainerA plain folder, or a .zip, .7z or .rar archive. Zip files that were cut off at the end are recovered where possible.
Line recordings.wav, .mp3 and Ogg Vorbis .ogg. Ogg is converted on the device during import.
Line notesOne .txt or .ini file per line with its start time, character and caption.
Video.mp4, and Theora .ogv, which is converted on the device. The conversion takes about a minute for a typical scene.
Backing trackThe scene's music and effects as .wav, .mp3, .m4a or .ogg.

Password-protected archives cannot be opened. Everything is unpacked and converted on your device, and nothing is uploaded.

If a pack won't import

Dubloon says what went wrong rather than failing silently. These are the usual causes.

The file is still in iCloud

A file with a cloud icon in Files has not been downloaded. Open it once in Files so it arrives on the device, then import it.

The archive has a password

Ask whoever made the pack for a copy without one.

The archive will not unpack

Unpack it on a computer and save it again as a .zip, or import the unpacked folder.

Dubloon says it is not a dub pack

A dub pack needs a text file and a recording for every line. Downloads from the same sites that are other kinds of mods, such as voice packs or skins, have no lines to perform.

Your dub is out of sync with the picture

Bluetooth headphones add a delay, so you hear the original late and come in late. Wired headphones, or none, fix it.

Inside a pack

If you want to make your own, this is the whole of Camp Rules, one of the scenes that ships with Dubloon. The files sit at the top level of the folder or archive.

_pack_info.ini        title, authors, rights
dub_video.mp4         the scene, without its dialogue
_backing_track.m4a    music and effects
001_Rex.txt           line 1: start time, character, caption
001_Rex.wav           line 1: the original delivery
002_Ellie.txt
002_Ellie.wav
…one pair per line

The pack file names the scene and says who made it and under what terms:

[pack]
title = "Camp Rules"
authors = ["Blender Studio", "CC BY 4.0"]
icon = "shot_rex.jpg"

Each line file says when the line starts, in seconds from the start of the video, who speaks it and what they say:

[data]
dub_timestamps = [0.350]
dub_characters = ["Rex"]
caption = "Oy, fungus freak! Make yourself useful and fix the tent."

Number the files in the order the lines are spoken. Keep each recording to the one line, starting where the speech starts, and leave the dialogue out of the backing track so the dub does not fight the original.

Rights matter. Dubloon does not host, include or sell films beyond its four scenes, which are Creative Commons or public domain. Only make and dub packs from material you have the right to use, and follow the copyright rules where you live.

Questions

Do dub packs need converting before Dubloon can open them?

No. Import the pack as it was shared: a folder, or a .zip, .7z or .rar archive. Dubloon converts Ogg audio and Theora video on the device during import.

Do I need Dubloon Pro to import dub packs?

Yes. Movie Scene Dub, including the four built-in scenes and every pack you import, is part of Dubloon Pro. Pro is a one-time purchase or a subscription and unlocks on iPhone and Mac. Reverse Singing and Home Video Dub are free.

Why won't my dub pack import?

The usual causes are a file that is still in iCloud and not downloaded, a password-protected archive, an archive format other than .zip, .7z or .rar, or a download that is not a dub pack at all. A dub pack has a text file and a recording for every line.

Pick a scene. Press record.