Live translation and captions — run from Australia, Europe and the United States
SpanVoice Try it free

Setup guide

Put live translated captions over your video stream.

If you stream or record video, the same translation the room reads can sit over your picture, so people watching online read it too. It is one page added to your streaming software as a browser source. This guide shows where to find the link, how to add it, how to place and style the band, and how to test it before you go live.

A camera on a tripod feeds a computer and its monitor, which connects by a blue lead to a large television showing the same scene with a dark two-line caption band.

Where the overlay fits

The words from the room reach the caption page, and your streaming software draws that page over the picture. Nothing is installed, and nobody operates the page during the event.

Speaker
SpanVoice
Streaming software caption page above the camera
Online viewers one language on the picture
The room still hears the speaker and reads on phones and screens as usual. This adds the stream.

Put captions over your stream in six steps

Most of the work is the first time. After that the link stays in your saved scene.

  1. Send the speaker’s audio to the venue first

    Adding the caption page to your streaming software does not start anything by itself. Before it can show words, the speaker’s audio has to reach the same venue through the desk app or the browser streamer. The caption page only displays the resulting text. It does not listen to your camera or to your streaming software.

    If that is not set up yet, start with the mixer to computer guide, the USB audio interface guide or the browser streaming guide.

    These captions are drawn into the video picture. Viewers cannot switch them off, and they cannot change their language with the video player’s own caption controls. A recording that includes the overlay keeps the captions in the picture. They show one language, the one set as The audience reads on the venue’s Settings tab, and a moderator can change it during the event. If online viewers should choose their own language, give them the listening link as well.

    Speaker
    SpanVoice
    Streaming computer caption page as a browser source
    Online viewers one language on the picture
    The caption page is a transparent layer. Your streaming software puts it over the picture.
  2. Find the captions link

    Each venue has a captions link of the form spanvoice.com/c/ followed by the venue code. It needs no sign-in and does not change, so it is safe to leave in a saved scene.

    You can copy it from the venue’s page in the admin, under For your team, where it is labelled Captions, or from the desk app under Links & QR. Make sure it is the captions link and not the projector or the audience link: they look similar and show different pages.

  3. Add it to OBS or vMix

    These sizes are for a 16:9 picture, 1920 × 1080. For another shape, such as a vertical stream, the layout needs adjusting and this guide does not cover it.

    In OBS

    • Add a Browser source to the scene you stream.
    • Paste the captions link into URL.
    • Set Width to 1920 and Height to 1080.
    • Place it above your camera or slides in the source list, so the band is not hidden behind the picture.

    In vMix

    • Choose Add Input, then Web Browser.
    • Paste the captions link as the address and set the width and height to 1920 and 1080.
    • Show the input with one of the Overlay channels so it sits over the main picture, rather than cutting to it as a scene of its own.

    The page is already transparent, so leave the background alone. The band sits near the bottom of the page by default.

  4. Keep it on air through scene changes

    A source only shows where it has been added, so check this before you go live.

    In OBS, reuse the same caption source in every scene that needs it, using Add Existing, or put it in its own scene and nest that scene inside the others. Then open the source’s properties and check two options:

    • Shutdown source when not visible unloads the page whenever the source is hidden or its scene is not active. Leave it off for captions.
    • Refresh browser when scene becomes active reloads the page each time you switch to the scene, which clears the words on screen. Leave it off too.

    Then switch between your scenes during the test and check the captions carry on.

    In vMix, keep the Overlay channel that holds the captions switched on while you cut between the camera inputs underneath it, and check it stays on across the cuts you use.

  5. Make it look right

    How the band looks is set on the venue’s Caption tab in the admin: the text colour, the colour and opacity of the band behind it, the font size, how many lines show (1 to 6), whether the band sits at the bottom, middle or top, left or centred text, the distance from the edge, the width of the band and how soon the caption clears when nobody is speaking. Press Save and an open overlay follows within a few seconds. The tab has a live preview over a stand-in backdrop. Two lines at the bottom is the default and suits most streams; use the top if your picture already has a lower-third graphic.

    For a change on one computer or one source only, add settings to the end of the link, for example ?lines=1&size=36&pos=bottom&margin=8. Anything in the link overrides the Caption tab for that source. If your software keeps a copy of the page, refresh the source after saving on the Caption tab.

  6. Test the finished stream, including the timing

    With the scene showing in your software’s preview, start a short event from the desk app, or play the test file, and speak a few sentences. The band should appear with the words, and hide again after a quiet pause. With no event running the band is hidden, so an empty preview is normal.

    Then check what viewers will see:

    • Watch the finished stream on another device, not only your own preview.
    • Compare each spoken sentence with the moment its words arrive. The words come a moment after the speaker, because the speech has to be heard and translated first.
    • If you also give viewers the listening link, remember the video and the phone follow different routes, so they will not line up. Do not rely on them matching.
    • Test again whenever you change the video or audio path.

    To check the look without a camera, add img= and the address of a still picture to the link. It only supplies a backdrop; no sample words appear, so you still need a running event to see text. Remove it before going live.

    The band hides itself after 5 seconds of quiet by default; the venue’s Caption tab can change that. Add idle=0 to the link to keep the latest words on screen, or a number of seconds for a different time. It does not create words when nothing has been said.

Settings you can add to the link

Use a question mark before the first setting and an ampersand between the rest. They override the Caption tab for that source only.

SettingWhat it doesValues
linesRows of text in the band1 to 6
sizeText size in pixels16 to 160
posWhere the band sitsbottom, top or middle
marginDistance from the top or bottom edge, as a percentage of the height. Not used for middle.0 to 40
widthBand width as a percentage of the picture20 to 100 (90 if not set)
boxbox=0 removes the dark band and leaves the text with its shadow0
alignCentres the textcenter
bgPage background. Leave it alone where you can, because the page is transparent. Green or blue is for software that cannot use a transparent source, and keying also removes any matching colour in your picture or text.transparent, black, green, blue, or a hex colour without the #
imgA still picture behind the band, to preview the look. It is only a backdrop and shows no words. If the address has a ? or & in it, encode it. Remove it before going live.an image address
idleSeconds of quiet before the band hides. 0 keeps the latest words on screen.0 to 3600 (the venue’s setting if not set; 5 by default)

Troubleshooting captions on a stream

Most problems are the link, the scene or the size.

Nothing appears at all

Check the source uses the captions link and not the projector or audience link. Check an event is running and that someone has spoken a sentence, because the band stays hidden until there are words.

The captions vanish or clear when I change scene

The source is only in some scenes, or its options are unloading or reloading it. In OBS, reuse the same source in each scene or nest a captions scene, and turn off Shutdown source when not visible and Refresh browser when scene becomes active. In vMix, keep the Overlay channel on while you cut.

The band is cropped or in the wrong place

Check the source is 1920 × 1080, and that it has not been scaled, cropped or moved in your software. This guide assumes a 16:9 picture.

The band is behind the camera picture

Move the caption source above the camera in the scene order.

A red “reconnecting…” label shows top right

The page has lost its connection and is retrying by itself. The label is drawn on the page itself, outside the band, so it is part of what your software captures and viewers can see it. If it stays on, check the streaming computer’s internet connection and refresh the source if it does not clear. Rehearse this before the day.

I changed the Caption tab and nothing changed

Refresh the browser source in your software. Also check the link does not carry its own setting for it, because settings in the link override the tab.

The band disappears during a pause

It hides after a quiet period and returns with the next words. Add idle=0 to the link to keep the latest words on screen.

My software cannot show a transparent source

Add bg=green to the link and key the green out in your software. Prefer a transparent source where you can, because keying also removes matching colours in the picture.

Still unsure

Questions about captions on a stream

Tell us your streaming software and we will tell you how to set it up.

Talk to us

Can I show captions over a stream in OBS or vMix?

Yes. In OBS, add the link as a Browser source sized 1920 × 1080 above the camera. In vMix, add it as a Web Browser input and show it with an Overlay channel. Other software that accepts a web page can do the same.

Can viewers turn these captions off?

No. They are drawn into the video picture, so the video player’s caption controls do not switch them off or change their language. A recording that includes the overlay keeps them. Use a separate listening link if viewers need their own choice.

Does the overlay listen to my stream?

No. It only shows the words from the venue. The speaker’s audio has to be sent to that venue through the desk app or the browser streamer.

Can viewers choose their own language on the stream?

No. The stream shows one language, set as The audience reads on the venue’s Settings tab, and a moderator can change it during the event. Give online viewers the listening link as well if they should choose their own.

Do I need to sign in to the page?

No. The captions link needs no sign-in and does not change, so it is safe to leave in a saved scene.

How do I change the look of the captions?

On the venue’s Caption tab in the admin: colours, opacity, size, number of lines and position. Add settings to the link to override them for one source.

Can I use it to preview the look without a camera?

Partly. img= and the address of a still picture puts that picture behind the band, but no sample words appear, so you still need a running event to see text. The Caption tab also has a live preview. Remove img= before going live.

Is this the page for the screen in the room?

No. The room screen uses the projector link, which shows a full page for people in the room. The captions link is the transparent layer for video. See the projector and phones guide.

Set up the caption overlay and test it on your own stream.

The free credit lets you rehearse in your own room. No credit card needed.

A$10 of free credit when you sign up, no credit card needed. Credit never expires — use it this week or next year.