User Guide
What is SubMachine?
SubMachine is a powerful subtitling tool that allows you to create accurate, word-by-word timing
with fun, animated, and expressive text to match.
SubMachine is powered by Adobe Premiere's AI Transcription and .MOGRTS, or Motion
Graphic Template files.
The SubMachine extension for Premiere Pro is the bridge between your transcription data and
the motion graphics. It intelligently parses the transcription and positions the graphics on your
timeline. It also includes robust tools for correcting text and adjusting its presentation.
After a brief transcription workflow, SubMachine can display and animate every word as
it’s being spoken, something that can take hours of tedious work to accomplish
manually.
Once you have a video that needs subtitles, the SubMachine extension installed, and a
SubMachine .mogrt that fits your needs, you are ready to begin using SubMachine to make
beautiful and engaging subtitles.
SubMachine Support
Discord Server:
[Link]
FAQs:
[Link]
Youtube Tutorials Playlist:
[Link]
Mogrt Gallery:
[Link]
w2Y/edit#slide=id.p
01. Getting SubMachine
To use SubMachine, you need to purchase and download the package from Gumroad. Your
purchase of a subscription or lifetime pass to SubMachine will come with:
● A .PKG file to install on MacOS.
● An .EXE file to install on Windows.
● A collection of .mogrt files to use.
● A license for registering your copy of SubMachine.
After purchase, you will be invited to register your Gumroad account to help manage your
subscription. Your license should arrive separately in an email from Gumroad.
02. Installing SubMachine
When installing the SubMachine extension, you should close Adobe Premiere Pro before
proceeding.
If you are installing on MacOS, you can begin by opening the .PKG file included with your
purchase. In order to open this file, you should first Right-Click or press control while clicking
and select the “open” option in the dialog box. MacOS should ask you if you’re sure you want to
open this file, to which you may respond yes.
On windows, you also may be warned about opening the the .EXE file, at which point you can
proceed by selecting “More Info” or “Advanced” and then selecting “Open Anyway.”
03. Accessing the extension.
After installing the extension, SubMachine should now be accessible within Adobe Premiere
Pro. To open the extension panel navigate to Window > Extension and select SubMachine.
Logging In:
When you open SubMachine for the first time on a computer you will receive an alert saying
“SubMachine is currently unverified.” or “You don’t seem to have logged in on this computer
before.”
Select OK to remove the alert. You will then be greeted by a splash screen showing the
SubMachine Tutorials & Documentation page. Select Create! In the top right corner to access
the main SubMachine user interface (UI). Select the Login tab, the last tab on the right after
Advanced Tools. Note that if your SubMachine window is much narrower than the one below
Login may be pushed beneath some of the other tabs.
Once in the Login tab enter the email address you signed up for SubMachine with and the
license key that you received from Gumroad in the corresponding fields making sure that
everything is spelled correctly. Then select the Login button.
If login is successful you should receive an alert saying that you’ve logged in successfully. Then
the red dot in the bottom left of the Submachine window will go green and your email address
will be listed alongside it.
If login is unsuccessful you will receive an alert explaining why. Follow the instructions to login
successfully. If this is not successful contact submachine@[Link].
Workspace Setup:
To most easily use SubMachine, we recommend that you set up your Premiere windows to
make sure that these windows are all readily available:
-The SubMachine extension panel.
-The Text panel
-The Program Monitor
-The Essential Graphics Panel
If you haven’t already, open up the Text panel by navigating to Window > Text and then
selecting the Transcription tab.
04. Creating your transcription. [Video Tutorial]
To begin working with SubMachine, you’ll need to use Adobe’s AI transcription engine included
in Premiere Pro.
Quick Tip: We recommend doing your work with SubMachine on a finished encode of a video to
keep playback snappy and the timeline clean. Alternatively, you can work with SubMachine
above a nested sequence.
In the Text window, select “Transcribe Sequence” and in a matter of seconds or minutes you
should have a transcription of your entire timeline.
Now that you have a transcript in your text window, you may correct any inaccuracies in this
panel before you proceed. This is not a requirement, though, as SubMachine has robust tools
for adjusting the contents of your transcript.
After the transcript is created, we’ll now need to “Create Captions” with the “CC” icon above
your transcript, using some special settings.
You can leave all settings as default except for the Last Four. All of these settings should be
brought to their minimum value, as pictured above.
Quick Tip: When dragging these sliders, you need to actually release your mouse click while it is
still inside the Create Captions dialog box. It’s a little clunky.
You can also import this preset in the Create Captions dialog box though we recommend just
doing the settings manually.
The resulting captions should appear in the Captions tab of the Text panel. Because of the
settings we chose, you should see only a single word or two on each line.
You can delete the yellow caption tracks that have appeared on your timeline, as those are just
standard captions and not the dynamic text we’re looking for.
05. Exporting Captions as SRT.
Now that we have a caption track with very short segments, we can export the captions as an
SRT.
In the Captions tab of the Text panel, select the “...” menu on the top right and select Export >
Export to SRT File.
Save the .SRT file somewhere you can find it quickly, like your current project files for the video
you’re subbing.
06. Generating MOGRTs from SRT. [Video Tutorial]
Now that we have our .SRT file, we’re ready to open up SubMachine. When SubMachine
opens, you’ll be greeted with a few video tutorials that go over some of these steps. To proceed
beyond that click “Create!”
You are now in the “Workflow” tab of SubMachine!
You will see our first two fields are “Short SRT” and “Mogrt.” Place the .SRT you just exported
into this field in one of two methods:
-Drag the file itself over the “Drop short SRT file here” field.
-Click “Short SRT” and use the file browser on your computer to find and select the SRT.
Now do the same with the Mogrt of your choosing. You can view and browse the features of the
Mogrts provided with SubMachine here.
Quick Tip: Your Mogrt and your sequence need to share the same frame rate. All of our
SubMachine mogrts are provided in the common frame rates.
Before you click “Create Subs” - consider briefly how long you want your individual sentences to
be. If you’re making a 9x16 vertical video, for example, it’s beneficial to limit how many words
will appear on screen at a time. Our slider has recommendations for which aspect ratios may
support the amount of maximum-characters you select.
Now it’s time to Create Subs! Do it, click the button!
07. So what do all these Mogrts do, exactly?
You should now see many individual Mogrts flying onto your timeline one by one. Before doing
anything else in the extension, it’s best to let them finish, but there’s no harm in pressing Play
while they generate. If you’ve already removed the Yellow Captions from the timeline so they
are not overlapping, you will see that each word is being displayed at the moment that the
speaker is saying them.
SubMachine has parsed your SRT file and broken it into phrases, based on your maximum
character limit. Each phrase alternates between video Track 2 and 3, or higher if you had any
clips already on those tracks.
And not only was your transcript broken into phrases, it was also broken down into Individual
Words.
Six Words, Six Mogrts.
In the animation above, you can see as we move from each Mogrt to the next, another word is
printed on screen. At the same time, the “Word Progression” value for the .Mogrt increases by
one. There are six words, and six Mogrts.
You can also see that the Text Input field in the mogrt contains the entire Phrase. Each mogrt
shares the same essential properties, including text, but it is limited to how many words will be
printed based on the Word Progression value in the mogrt.
All SubMachine mogrts will have this Word Progression slider as the core engine to allow word
by word animation and timing to work.
08. Syncing between Mogrts
SubMachine doesn’t only allow you to create all of this word-by-word timing automatically, it
allows you to Share information between Mogrts.
Because each word in a phrase is a separate word, in order to keep visual continuity throughout
a phrase, it’s important that changes we make to one mogrt be applied to the entire phrase. If
we moved the last mogrt in a phrase upwards and changed its color, it’d create an unpleasant
jump.
At the same time, nobody wants to change the same parameters over and over again, that goes
against the whole spirit of SubMachine. That’s why we built tools that read the changes you
make to the text input, position, style, or animation and allow you to easily propagate those
changes to hundreds of Mogrts, quickly.
There are three types of Sync tools in SubMachine:
What’s in the toolbox!?
Here’s a quick breakdown of the Tools tab:
Sync Style To All: This feature will reference any selected mogrt on the timeline and propagate
all non-phrase attributes to every other mogrt on the timeline. If you would like to add animation
or color across the board, this is the way to do it.
Sync Text Settings: Select the final mogrt of the phrase you'd like to edit. This will be your
reference clip. Any changes in Effect Controls or phrase attributes (P) in the Mogrt will be
applied to the entire phrase. Make your changes to the Last Mogrt in a phrase, then select all
of the Mogrts in the phrase, and click the Sync Text Settings button to apply.
Sync Style Settings: Works similarly as Text Settings, except it ignores all (P) values and
focuses instead on animation, color, style, etc. Use your last mogrt as a reference and apply to
the previous with a click.
Reset Word Progressions: A bit clunkily named as of now, but this feature is very handy. If you
need to add or remove words to a phrase, or create more or less mogrts for any reason, this
button will help you reset the Word-Progression from 1. Simply select all of the mogrts in a
phrase and click the button, and all of them will progress upward.
Word -1 / +1: This button will either add or remove the word progression value for all selected
mogrts.
Split & Join Selection: Isolates the selected mogrts into a new phrase across two different
phrases. Will also remove the isolated words from the surrounding mogrts so there is no
overlap. This tool combines the functions of “Split 1 Phrase” & “Join 2 Phrases”. Note that you
will need to check the styling of the new phrase as the style is not copied across.
Split 1 Entire Phrase: This splits 1 whole phrase into 2 separate phrases. All the selected clips
must be on 1 track and have the same source text. Note that you will need to check the styling
of the new phrase as the style is not copied across.
Join 2 Entire Phrases: This joins 2 whole phrases together to create 1 phrase by merging their
text fields and resetting the Word Progression count. The 2 phrases must be on separate tracks.
Note that you will need to check the styling of the new phrase as the style is not copied across.
Reset All Mogrt Properties: This resets all the mogrt properties for all of the selected mogrt
clips to the original mogrt settings. The only exceptions are the Word Progression (P) and the
Text Input (P) source text. These will be ignored. The location of the playhead/CTI is not taken
into account.
Reset Specific Mogrt Property: This resets 1 specific mogrt property (the name typed in the
text box box below) for all of the selected mogrt clips to the original mogrt settings. The only
exceptions are the Word Progression (P) and the Text Input (P) source text. These will be
ignored. The location of the playhead/CTI is not taken into account.
Editing Mogrts in After Effects
SubMachine is designed to make animating text easy for users in Premiere Pro. However, for
users that are comfortable in After Effects, it opens the door for amazing custom animations you
can integrate into our word-by-word workflow. This video from Premiere Gal covers a broad look
at opening and tweaking MOGRTs in after effects.
This section of our full walkthrough covers a special character: Ⓣ you can integrate into your
effects to make sure they are only applied to specific phrases.
An important concept to remember is that every MOGRT placed on the timeline is the same
composition, so your animations need to keep in mind that the next word can sometimes come
very quickly, sometimes only 3-5 frames. The best animations work even with rapid sequences
of words.
To edit your subs in After Effects open your version of After Effects and go to File > Open
Project.
Select your .mogrt file. You will be asked to select where you’d like to extract your new file to.
Open the Essential Graphics panel. Make sure you have the correct composition selected. Our
mogrts should only include a single composition to keep things as simple as possible but others
may include multiple comps.
Rename the mogrt at the top of the Essential Graphics panel where it says Name. Use
something that is unique and recognisable. Do not use all caps and make sure there are no
spaces at the end of the mogrt name. Renaming is a vital step. If you don’t rename your mogrt
file SubMachine may not be able to identify your mogrt and is likely to select the original version
instead of the new updated version.
Make any changes you’d like to the mogrt making sure to respect and maintain the Ⓣ Word
Progression and Ⓣ Text Input properties.
At the bottom of the Essential Graphics panel select Export Motion Graphics Template … to
export the .mogrt file to a known location.
Test the newly exported mogrt in Premiere Pro with SubMachine.
So, now what?
Hopefully these tools give you what you need to quickly and easily get word-by word timing for
your entire video! You’ll find yourself using Sync Text Settings and Style Settings a lot. The goal
is to allow you to be more creative with the way that the text appears instead of spending all
your time arranging and timing out words, so go nuts!
The animation tools are pretty powerful, there are pretty fun combinations you can make. You
can check out this guide breaking down each animation effect visually.
Tips
- The timing of some short phrases will not be word-specific because of limitations with
premiere’s caption creation. You will see that when generating the “Short” CSV there are
still captions that include more than one word. When editing Open Premiere’s
Transcription tab in the Text window and click on the word you’re trying to time -
premiere should bring the playhead to the exact word making adjusting those mogrts
quite easy.
- If you want to make changes to all mogrts on the timeline, be sure to do that first before
you make other specific style choices, as using the Sync All Mogrt Attributes feature
will overwrite previous style choices.
- Don’t sleep on “Reset Word Progressions” - this is often THE tool to use when you need
to make adjustments to your text input. The important thing is to make sure that if you
add a word in the phrase, you should add a mogrt/cut a mogrt in half in the right spot
- Advanced User tip: You can supply your own mogrt! Well, at the very least you can
tweak our ones. If you need some very specific font styling you can go ahead and make
your own mogrt and this script will still work so long as you do not remove the (P)’s or
move too many things around.
Known Issues
- Depending on how you made a new mogrt, be aware that the “In point” is not flexible, so
if you chop a mogrt in half the second half will not animate in unless you either use the
Slip tool, or just drag it back so it begins at it’s own “first frame”
- Occasionally there are blank spots and rounding errors that are usually very easy to
address.
- If your sequence does not start at 0 the subtitles/mogrts may appear at a different time
on the timeline. The relative timing should still be accurate so you should just need to
select all the mogrt clips and move them to the correct position using the yellow caption