You are a live streamer using OBS ( Open Broadcaster Software ) and you are open to experimental ways to increase followers on your stream. And you don't want to spend money, because reasons and the internet should be free!
Follow the easy 60 second installation. To install Subtitles in OBS for Twitch, start by visiting the URL above.
It's easy to change various aspects of the voice capture system including language and text styles.
The default language is detected by your country of origin. However you may wish to set the language to English.
The following will change the language to USA English:
You can change the language to any language code. The following are just a few examples:
- English:
language=en-US - Spanish:
language=es - Mandarin:
language=zh - German:
language=de - Japanese:
language=ja
More language codes shown here: https://www.w3schools.com/tags/ref_language_codes.asp
We've recently upgraded the voice detection algorithm!
The new algorithm offers a continuous stream of voice detection. The old V1 voice detection algorithm stopped recording for 0.2 - 1.5 seconds while a new voice recognition session initialized. The affect was a delay in recognizing your voice, also it would cause the text on the screen to clear.
The new V2 upgrade is a continuous voice session, without any pauses or delays. So overall it's an improved voice capture voice-to-text upgrade. However some may have relied on this.
To downgrade the algorithm, use the continuous=off parameter.
The above link will downgrade your voice-to-text to the old algorithm.
You can set the font display style using any valid CSS modifiers. Some defaults are available for you.
- Set Style:
?style=CSS_HERE - Set Background White:
?style=background:%23white - Set Font Red:
?style=color:%23red - Set Text Padding:
?style=padding:10px
Here are some pre-built options to try:
- Clean: https://stephenlb.github.io/twitch-tv-obs-subtitles/subtitles.html?subkey=sub-c-79b0a26a-80a9-11e8-8f4a-96bbd71e7d14&pubkey=pub-c-fd9b97a4-7b78-4ae1-a21e-3614f2b6debe&channel=1588208805983537980353&style=color%3Argba(0%2C0%2C0%2C.9)%3Btext-shadow%3A0%200%205px%20%23fff
- CC Caption: https://stephenlb.github.io/twitch-tv-obs-subtitles/subtitles.html?style=background%3A%23000%3Bfont-weight%3A600%3Btext-transform%3Auppercase%3Btext-shadow%3Anone%3Bpadding%3A10px
- Blue: https://stephenlb.github.io/twitch-tv-obs-subtitles/subtitles.html?subkey=sub-c-79b0a26a-80a9-11e8-8f4a-96bbd71e7d14&pubkey=pub-c-fd9b97a4-7b78-4ae1-a21e-3614f2b6debe&channel=1588208805983537980353&style=color%3A%2300f%3Bfont-weight%3A400%3Btext-shadow%3A0%200%205px%20%23fff
- Rainbow: https://stephenlb.github.io/twitch-tv-obs-subtitles/subtitles.html?subkey=sub-c-79b0a26a-80a9-11e8-8f4a-96bbd71e7d14&pubkey=pub-c-fd9b97a4-7b78-4ae1-a21e-3614f2b6debe&channel=1588208805983537980353&style=background%3Alinear-gradient(to%20right%2Corange%2C%23ff0%2Cgreen%2C%230ff%2C%2300f%2Cviolet)%20100%25%3Bfont-weight%3A800%3B-webkit-background-clip%3Atext%3B-webkit-text-fill-color%3Atransparent%3Btext-shadow%3Anone
Sky is the limit! Enjoy.
We've added a new feature to allow the text to clear from the screen after a
moment of silence.
The default is set to 4 seconds.
You can change this by setting the following:
Don't go lower than 2 seconds. It will cause unexpected problems for you.
- Clear Text after 2 Seconds: https://stephenlb.github.io/twitch-tv-obs-subtitles/subtitles.html?cleartime=2
- Clear Text after 5 Seconds: https://stephenlb.github.io/twitch-tv-obs-subtitles/subtitles.html?cleartime=5
- Clear Text after 10 Seconds: https://stephenlb.github.io/twitch-tv-obs-subtitles/subtitles.html?cleartime=10
- Clear Text after 100 Seconds: https://stephenlb.github.io/twitch-tv-obs-subtitles/subtitles.html?cleartime=100
And so on, you can change the value to any valid number. Just don't go lower than 2 seconds. Using the default of 4 seconds is recommended.
By default the intro text is set to "Start talking." You can change this value to anything you'd like:
- Intro Text BLANK: https://stephenlb.github.io/twitch-tv-obs-subtitles/subtitles.html?introtext=%20
- Intro Text "Hello!": https://stephenlb.github.io/twitch-tv-obs-subtitles/subtitles.html?introtext=Hello!
- Intro Text "Whatup": https://stephenlb.github.io/twitch-tv-obs-subtitles/subtitles.html?introtext=Whatup
Sometimes you don't want a wall of text. You want to set the display to show only the last two lines.
There's a way to crop using CSS like this bottom:92vh.
Change the CSS to match your desired display.
For example you may wish to fine-tune the crop effect using the calc operator:
bottom:calc(100vh%20+%201.3em)
Essentially you can add the CSS in the URL, or you can customize the look and feel by forking the repo and editing the HTML directly.
Nyan Cat helps you with closed captioning. Nyan Cat subtitles, just in case.
Since Twitch Subtitles and Streaming Closed Captions are open source and free tool, it's open to fully customize the display any way you like.
Setting the maximum display words is easy using this URL parameter:
This will display a maximum of 10 words, just as an example. Exclude the parameter to remove the limit.
If you want this page to only be used to display your voice transcript you can disable the microphone. This allows you to share a URL that is read-only.
Note that you need to specify the Subscribe Key and Channel, while excluding the Publish Key. This will prevent others from speaking over your output.
These keys are used for private account purposes. Only expose the Publish Key to your self, and do not share the key.
You can get a new key at https://dashboard.pubnub.com/
If you've downloaded this repository, made changes and want them to be available in your OBS, you need to follow these instructions. Due to security, you need to run an HTTP Server for OBS to access your local files. You'll do this by opening a terminal window and running a Simple HTTP server. Attempting to run Twitch Subtitles without an HTTP server will result in a non-working page with "Start talking." permanently stuck on the viewport.
1.) Download and Install Python: https://www.python.org/downloads/
Python Simple HTTP Server in the same director as the Twitch.TV Subtitles:
Windows: Press
WinKey+Rtypecmdand press "Enter" to open a Command Prompt
Mac: Press
Command+Spacetypeterminaland press "Enter".
Navigate to the Twitch TV Subtitles directory using cd command.
For Windows machines use:
cd twitch-tv-obs-subtitles
python -m http.server 8000For Mac machines use:
cd twitch-tv-obs-subtitles
python -m SimpleHTTPServer 8080If the
cdcommand fails, you need to know where the folder is located. You mustcdto the foldertwitch-tv-obs-subtitles. It may be in yourDownloadsfolder:cd Downloads/twitch-tv-obs-subtitles. If you are still having trouble, you may try theAlternatelower in this document.
3.) Copy the URL from Step 2 on the Subtitles Twitch.TV Page
The URL will look similar to this:
https://stephenlb.github.io/twitch-tv-obs-subtitles/subtitles.html?subkey=sub-c-79b0a26a-80a9-11e8-8f4a-96bbd71e7d14&pubkey=pub-c-fd9b97a4-7b78-4ae1-a21e-3614f2b6debe&channel=1552687539739502028833&style=background%3Ablack%3Bfont-weight%3A600%3Btext-transform%3Auppercase%3Btext-shadow%3Anone%3Bpadding%3A10px%3BKeep Subtitles Twitch.TV Page open. This page will capture your voice and transmit it to your local computer.
https://stephenlb.github.io/twitch-tv-obs-subtitles/subtitles.html with
http://0.0.0.0:8080/subtitles.html.
Your final URL will look like:
http://0.0.0.0:8080/subtitles.html?subkey=sub-c-79b0a26a-80a9-11e8-8f4a-96bbd71e7d14&pubkey=pub-c-fd9b97a4-7b78-4ae1-a21e-3614f2b6debe&channel=1552687539739502028833&style=background%3Ablack%3Bfont-weight%3A600%3Btext-transform%3Auppercase%3Btext-shadow%3Anone%3Bpadding%3A10px%3BNote that your final URL will differ from the one shown above.
That's it!
If you've made a mistake start over from the beginning
it won't hurt to repeat any of the steps.
However you may run into issues.
That's why we've included a second option that may work better for you.
While this method is easier, it is not the preferred method. This method introduces an opportunity for someone else to take over your subtitles mid-stream. It is unlikely that someone will know how to do this, however it is easy for a hacker. If you want to avoid a hacker taking over your subtitles, use the secure method: Secure Method.
Also if you're using Subtitles Twitch.TV Page directly off the PubNub website, then your are secured automatically.
It will look like this:
function username() {
return ""; // <-- Fill in your username
// example: return "ninja";
}And type in your Twitch Username like this:
function username() {
return "MY_TWITCH_ID_HERE"; // <-- Fill in your username
// example: return "ninja";
}2.) Copy the URL from Step 2 on the Subtitles Twitch.TV Page
It will look similar to this:
https://stephenlb.github.io/twitch-tv-obs-subtitles/subtitles.html?channel=1552687539739502028833&subkey=sub-c-79b0a26a-80a9-11e8-8f4a-96bbd71e7d14&pubkey=pub-c-fd9b97a4-7b78-4ae1-a21e-3614f2b6debe&style=background%3Ablack%3Bfont-weight%3A600%3Btext-transform%3Auppercase%3Btext-shadow%3Anone%3Bpadding%3A10px%3Bchannel=1552687539739502028833 with
channel=MY_TWITCH_ID_HERE.
https://stephenlb.github.io/twitch-tv-obs-subtitles/subtitles.html?channel=MY_TWITCH_ID_HERE&subkey=sub-c-79b0a26a-80a9-11e8-8f4a-96bbd71e7d14&pubkey=pub-c-fd9b97a4-7b78-4ae1-a21e-3614f2b6debe&style=background%3Ablack%3Bfont-weight%3A600%3Btext-transform%3Auppercase%3Btext-shadow%3Anone%3Bpadding%3A10px%3BWarning! Make sure only one Twitch.TV Subtile Page is open. If they are others, they will block your local page.
found in your folder twitch-tv-obs-subtitles.
That's it! Easy right?
Browser Sources can be added to your scenes of your streaming software and enable you to use web based content such as Flash and JavaScript applications, websites and so on and even customize them via CSS. Since this kind of content is usually not written in the same coding languages as your streaming application, a translator is needed to make it possible for both to communicate with each other.
Technically this software is considered as Open Captions,
as the captions are controlled by the streamer/broadcaster.
Closed Captions are controllable by the viewer of the stream.
You will not need to do this as it is only a tool used for building the
landing page on the PubNub Website.
This will build ./build/dashboard.html and copy source to your clipboard.
You can see a live version of the
Twitch TV OBS Subtitles Browser Source page.
./copy
We have built several more apps using the Spoken NPM Package. Check them out below.
How to build a voice-controlled intelligent chatbot who comprehends human speech and responses accordingly and naturally!
Learn how we built an OBS Plugin that adds Subtitles to your Live Stream.
Add Subtitles to your Twitch stream! Easy OBS integration. Plugins should be easy to make! And for OBS, this is true. Hurray! The best way by far, my opinion, is using OBS Browser Sources.