1. Download the latest version of this extension
2. Unzip ALL the files in the compressed file you’︀ve just downloaded to the “︀Application Extensions”︀ folder.
   If this folder does not exist, please create a new one.
   Path

   C:\ProgramData\VEGAS Pro\Application Extensions

3. Make sure that the DLL file is not locked.

4. Open Vegas Pro to launch it. Select menu View→Extension→Otomad Helper to open.

Otomad Helper is a YTPMV/otoMAD/YTP extension for Vegas Pro that enables Vegas to accept scores such as MIDI sequence files as input and automatically generate YTPMV tracks.

Check out the usage section for further information, including how to install the extension.

Languages

You can also click on the language button on the top right corner of any page to switch languages.

To learn more about the features of Otomad Helper, please continue reading on the next page…

Welcome to revise the documentation for Otomad Helper — a YTPMV/otoMAD/YTP extension for Vegas Pro. This site serves documentation for both the new version (v8, an extension) and the old version (v4, a script).

Project Overview

Otomad Helper is a tool that enables Vegas Pro to accept scores (such as MIDI sequence files) as input and automatically generate YTPMV/otoMAD/YTP tracks. This repository contains the documentation website source code for the project.

The documentation covers two major versions:

Tech Stack

How it works: When code is pushed to the docs branch on GitHub, Read the Docs automatically rebuilds the site and serves the static HTML pages at https://otomadhelper.readthedocs.io/.

Multi-Language Documentation Format

This project uses a custom single-file multi-language format. Instead of maintaining separate files for each language, all translations live together in one file. This makes it much easier to spot and fix errors across languages simultaneously.

Why This Format?

If the document contains 7 languages, when you need to fix a mistake that exists in multiple languages, the traditional approach requires you to:

1. Open 7 separate files (one per language).
2. Find the corresponding line in each file.
3. Make the same fix 7 times.

With the single-file format, translations sit right next to each other, so you can fix everything in one place.

Line-Level Multi-Language

For translating individual lines, use the @ prefix followed by a language tag, a space, and the translated content:

﹫en This is English content.
﹫zh 这是中文内容。
﹫ja これは日本語の内容です。

Currently supported language tags: en (English), zh (Simplified Chinese).

Block-Level Multi-Language

For large blocks of content — such as entire paragraphs with complex formatting, tables, or admonition blocks — use @@@ delimiters:

﹫﹫﹫en
This is a large block of English content.
It can span multiple lines and include **formatting**.
﹫﹫﹫zh
这是一大段中文内容。
它可以跨越多行并包含**格式**。
﹫﹫﹫

• Start a block with @@@ followed by a language tag.
• End the entire multi-language block with a bare @@@ on its own line.

Fallback Behavior

If a particular language is missing for a line or block, the site will automatically fall back to English. This means you only need to write translations for languages you know — missing ones will safely display English instead.

Important Rules

• Do not mix line-level (@) and block-level (@@@) syntax for the same content — pick one.
• The @ or @@@ markers must appear at the very beginning of a line.
• For line-level translations, languages can appear in any order, but keeping them consistent (e.g., always @en first, then @zh) helps readability.

How to Edit Documentation

The steps below are written for non-programmers. You do not need any coding experience — just follow along step by step. If you get stuck, ask a friend who is familiar with computers to help.

One-Time Setup

You only need to do this section once, the first time you set up the project on your computer.

Step 1: Install Node.js

Node.js is the runtime that powers the documentation toolchain.

1. Open your browser and go to https://nodejs.org/
2. Click the LTS (Long Term Support) download button — this is the stable version recommended for most users.
3. Once downloaded, double-click the installer file (e.g., node-vXX.XX.X-x64.msi on Windows).
4. Follow the installation wizard — you can accept all the default settings.
5. Click Finish when done.

Step 2: Install pnpm

pnpm is the package manager used by this project.

1. Open Command Prompt (Start Menu → type cmd → press Enter).
2. Type the following command and press Enter:
   bash

   npm install -g pnpm

3. Wait for the installation to complete.

Step 3: Install GitHub Desktop

GitHub Desktop provides a visual interface for Git, so you don’︀t need to memorize command-line instructions.

1. Go to https://desktop.github.com/
2. Click the Download button.
3. Once downloaded, run the installer.
4. When you open GitHub Desktop for the first time, it will ask you to sign in with your GitHub account. If you don’︀t have one:
   • Go to https://github.com/signup and create a free account.
   • Then sign in to GitHub Desktop with your new account.
5. Follow the setup prompts (you can skip configuring Git if asked — the defaults are fine).

Step 4: Clone the Repository

”︀Cloning”︀ means downloading a copy of the project to your computer.

1. In GitHub Desktop, click File → Clone repository…
2. Select the URL tab.
3. In the “︀Repository URL”︀ field, enter:

   https://github.com/otomad/OtomadHelper

4. For “︀Local path”︀, click Choose… and pick a folder on your computer where you want to store the project (e.g., D:\Documents\OtomadHelper).
5. Click Clone.
6. Important: After cloning, switch to the docs branch:
   • Near the top of GitHub Desktop, you’︀ll see a button labeled ”︀Current branch”︀ (it may say main or master).
   • Click it, then select the docs branch from the list.
   • If you don’︀t see docs in the list, click the ”︀Origin”︀ tab at the top of the branch list — branches that only exist on GitHub will appear there. Click docs to check it out.

Step 5: Install Project Dependencies

Dependencies are external libraries the project needs to work.

1. In GitHub Desktop, with the repository open, click Repository → Open in Terminal (or press Ctrl + `).
   • This opens a terminal window already pointing to the project folder.
2. In the terminal, type the following and press Enter:
   bash

   pnpm i

3. Wait for the installation to finish — it may take a minute or two. You’︀ll see a progress indicator, and it will end with something like “︀Done”︀.

You only need to run pnpm i once during setup. You generally don’︀t need to run it again unless someone tells you new dependencies were added.

Step 6 (Not Necessary, But Recommended): Install Visual Studio Code

While you can edit files with Notepad directly, Visual Studio Code (VS Code) is a free, powerful editor that makes editing much easier with syntax highlighting and file browsing.

1. Go to https://code.visualstudio.com/
2. Click Download and install it (accept all defaults).
3. After installation, in GitHub Desktop, you can right-click the repository and choose ”︀Open in Visual Studio Code”︀ to jump straight into editing.

Daily Editing Workflow

This is the workflow you’︀ll follow each time you want to make changes.

Step 1: Pull the Latest Changes

Before editing, always fetch the latest version to avoid conflicts with changes others may have made.

1. Open GitHub Desktop.
2. Make sure the current repository is OtomadHelper and the current branch is docs.
3. Click the ”︀Fetch origin”︀ button in the top toolbar.
4. If there are new changes, the button will change to ”︀Pull origin”︀ — click it to download the latest updates.

Step 2: Edit Documentation Files

The documentation files are Markdown (.md) files located in the docs/ folder.

1. Open the project folder in your file explorer, or open it in VS Code.
2. Navigate to the docs/ folder. Inside you’︀ll find:
   • .vitepress/ — Configuration and theme files (usually you won’︀t touch these)
   • zh-CN/**/*.md — Chinese-specific pages (home page, etc.)
   • **/*.md files — The new v8 extension version documentation pages (these use the multi-language format)
   • v4/**/*.md — the old v4 script version documentation pages (these use the multi-language format)
3. Open the file you want to edit. Most content files use the single-file multi-language format, so English and Chinese content sit together. See the Multi-Language Documentation Format section above for details.
4. Make your changes and save the file (Ctrl + S).

Step 3: Preview Your Changes Locally

Before pushing, you can preview the site on your own computer to see how your changes look.

1. If you have VS Code, please Press Ctrl + Shift + B, and then select npm: dev.

   If you don’︀t have VS Code, please:

   1. Open a terminal in the project folder:
      In GitHub Desktop: Click Repository → Open in Terminal.
   2. Type this command and press Enter:
      bash

      pnpm run dev

2. Wait a moment. You’︀ll see output like:

   vitepress vX.X.X
   ➜  Local:   http://localhost:7000/

3. Press Ctrl (or maybe Alt) and click the link http://localhost:7000/.
4. Navigate to the page(s) you edited and check that everything looks correct.

Step 4: Commit and Push Your Changes

”︀Committing”︀ saves your changes to the local repository. “︀Pushing”︀ uploads them to GitHub.

1. Open GitHub Desktop. You’︀ll see your changed files listed on the left.
2. In the bottom-left corner, find the ”︀Summary”︀ field. Write a short, clear description of what you changed. For example:
   • Fix typo in installation guide
   • Update audio page with new feature description
   • Add Chinese translation for FAQ page
3. Optionally, you can add more details in the ”︀Description”︀ field below.
4. Click the ”︀Commit to docs”︀ button.
5. After committing, click the ”︀Push origin”︀ button (top right) to upload your changes to GitHub.

Project Structure

OtomadHelper_docs/                     # Repository root (docs branch)
├── .gitignore                         # Files ignored by Git
├── .readthedocs.yaml                  # Read the Docs build configuration
├── package.json                       # Project dependencies and scripts
├── pnpm-lock.yaml                     # Dependency version lock file
├── tsconfig.json                      # TypeScript configuration
├── oxfmt.config.ts                    # Code formatter configuration
├── README.md                          # You are here
├── README_zh-CN.md                    # Chinese version of this file
└── docs/                              # Documentation source (VitePress root)
    ├── .vitepress/                    # VitePress configuration & theme
    │   ├── config.ts                  # Main site configuration
    │   ├── components/                # Custom Vue components
    │   ├── plugins/                   # Custom Markdown & build plugins
    │   ├── theme/                     # Custom theme overrides
    │   └── use-i18n.ts                # Internationalization helpers
    ├── assets/                        # Static assets (images, fonts, etc.)
    ├── img/                           # Documentation images
    ├── public/                        # Public static files
    │   ├── favicon.svg                # Site favicon
    │   └── favicon_1.ico              # Alternative favicon (RtD workaround)
    ├── index.md                       # Home page (English)
    ├── introduction.md                # Introduction page (multi-language)
    ├── installation.md                # Installation guide (multi-language)
    ├── usage.md                       # Usage guide (multi-language)
    ├── faq.md                         # FAQ (multi-language)
    ├── audio.md, visual.md, ...       # Feature pages (multi-language)
    ├── v4/                            # Old v4 documentation pages
    │   ├── introduction.md
    │   ├── installation.md
    │   └── ...
    └── zh-CN/                         # Chinese-specific pages
        ├── index.md                   # Home page (Chinese)
        └── v4/                        # Chinese v4 entry point

How Build & Deployment Works

1. You edit Markdown files and push to the docs branch on GitHub.
2. Read the Docs automatically detects the push.
3. RtD runs npm run build (configured in .readthedocs.yaml), which builds the VitePress site.
4. The generated static HTML files are served at https://otomadhelper.readthedocs.io/.
5. The build usually completes within 2–5 minutes after pushing.

Available Scripts

License

This documentation is released under the GPL 3.0 License.

Copyright © 2021–present

Using Otomad Helper is pretty straightforward from here. Here’︀s how to use it.

• You import and use a MIDI file to configure and generate the clips you want. You should use a MIDI which created by yourself and not someone else. It’︀s discourteous. Don’︀t create YTPMIDIs or any form of remix you didn’︀t create.
• You need to have a clip selected in the timeline in order to generate anything from the MIDI onto Vegas Pro.
  • Alternatively, you can use a clip or source from your computer to be used for generating the MIDI.
• The Audio and Visual pages will allow you to edit the settings of how the clips are generated, there is a variety of settings, play with them and tweak them to sort your needs for the start of your creation.
• There is also a variety of tools to help work on the most ludicrous of tasks for your projects, making the chore of editing certain clips to applying different effects easier said than done.

This setting can be toggled. (If your clip has audios, this is enabled by default.)
You can right-click or middle-click any setting slider to reset it.

Toggles

Loop

Makes the clip loop if applicable.

Normalize

Normalize the audio.

Truncate

Trims to the MIDI note instead of stretching.

Multitrack for Chords

Generates multiple audio tracks for chords.

Create Groups

Groups the Video and Audio Clips represented by the MIDI note(s).

Stack

Creates stacked audio clips on separate tracks when the MIDI contains multiple tracks.

Time unremapping

Disables all forms of time remapping of the clip! The start time will NOT reset as it will continue the clip from where it left off every note.

Auto Pan

Pans the Audio using Envelope Automation.

Stretch

Makes the clip stretch if applicable.

• None
  • Does not apply stretching to the clip.
• Flex and Extend
  • Stretches the clip completely.
• Extending Only
  • Stretches clip out.

    IMPORTANT

    This works best with MIDI Notes that are longer than the audio clip.

• Flexing Only
  • Stretches clip in.

    IMPORTANT

    This works best with MIDI Notes that are shorter than the audio clip.

Legato

Extends the audio outside the note’︀s length with any length chosen.

• Staccato
  • No Extension.
• Up to 1 Beat
  • Extends out 1 Beat

    IMPORTANT

    This will only work if the next clip is less than 1 beat apart.

• Up to 1 Bar
  • Extends out 1 Bar

    IMPORTANT

    This will only work if the next clip is less than 1 bar apart.

• Unlimited
  • Extends Unlimitedly.

Preferred Track

Creates a new track(s) or uses the track selected for generation.

Velocity

Settings to assign gain values relative to the MIDI notes.

• Mapping Velocity
  • Assigns the Notes to the Velocity from the MIDI File.
• Multiply Current Gain
  • Toggling multiplies the existing gain instead.
• Velocity
  • The Value of Velocity from Minimum to Maximum.
• Volume
  • The Value of Volume from Minimum to Maximum.

• Reset
  • Resets the settings to default.

Mapping Velocity Explanation

Tuning

Tuning Methods

• No Tuning
  • No Pitch Effect.
• Pitch Shift Audio Effect
  • Uses the “︀Pitch Shift”︀ Plugin (default for Vegas 13–15).
• Elastic Pitch Effect
  • Uses the Elastic Efficient Method (by default).
• Classic Pitch Effect
  • Uses the Classic Stretch Method.
• Scaleless Tuning
  • Locks the Stretch and Pitch.
• Granular Oscillator
  • Makes the sample super short and plays it, generating a pulse sequence corresponding to the pitch while creating a continuous pitch by exploiting the perception fusion effect of fast pulses.

If the pitch exceeds the range

• Switch to pitch shift plugin
  • Repeatedly uses the pitch shift plugin for exceeding limits.

    IMPORTANT

    Out of range notes will slow down the generation.

• Raise / Lower octaves
  • Shifts by octaves to keep the note inside ±24 semitones (safest option).
• Raise / Lower octaves (Experimental)
  • Allows a much larger range, up to roughly $\pm\frac{12}{\lg{2}}\ \left(\approx\pm39.863137\right)$ semitones.

    INFO

    If “︀Lock Stretch to Pitch”︀ is on, it can go as low as $-\frac{12}{\log_{20}{2}} \left(\approx-51.863137\right)$ semitones (upper limit stays +24).

    DANGER

    Use this at your risk! This method can CRASH Vegas Pro.

• Dock at Top / Bottom
  • Forces the note to the highest or lowest pitch still inside the normal range.
• Silent
  • Mutes notes that are out of range.

Lock Attributes

• Lock Stretch and Pitch
  • Adjust the stretch to change the pitch (Resample).
• Reserve Formant
  • Locks Formant, works only with “︀Mono”︀ and “︀Professional”︀

    INFO

    This locks formant so you get that “︀monophonic”︀ effect.

• Vocal Fry
  • Forces the sample to be 1 tick long.

    INFO

    Only usable with Granular Oscillator.

Base Pitch

Controls the base pitch for previewing and adjusting the Audio Track Event.

• Note Name
  • Controls the note name used for the base pitch.
• Octave
  • Controls the note octave used for the base pitch.

Preview

• Preview the Base Pitch
  • Previews the base pitch.
• Preview Audio
  • Previews the track event audio.

Preview Attributes

Tune generating methods for previewing the base pitch.

• Adjust Audio to Base Pitch
  • Adjusts the clip track event’︀s audio to the base pitch.

  INFO

  This is useful for older styles of remixes.

Parameters

• Set Fade by Percent
  • Sets the Value Measure to Percent Value.
• Set Fade by Timecode
  • Sets the Value Measure to Timecode Value.

Fade

Fade in

Length and Fade Type of the Audio Fade in on the Track Event.

Fade out

Length and Fade Type of the Audio Fade out on the Track Event.

This Index was created in mind to help guide users on what features do what and how to use them.

Basic Issues

System.DivideByZeroException: Attempted to divide by zero.

System.FormatException: Got an off without an on 0 NoteOn

at ScriptPortal.Vegas.Fade.set_Gain(Single value)

Installation Related

C:\Program Files\Sony\Vegas Pro 12.0\Script Menu\otomad_helper.cs(17): A new expression requires () or [] after type

public Dictionary<string, int> pitchMap = new Dictionary<string, int> {
    { "C0", 0 },
    { "C#0", 1 },
    // ...
    { "A#8", 106 },
    { "B8", 107 },
};

new Dictionary<string, int>

new Dictionary<string, int>()

C:\Program Files\VEGAS\VEGAS Pro 15.0\Script Menu\otomad_helper.cs(11)：The type or namespace name "Sony" does not exist (are you missing an assembly reference?)
C:\Program Files\VEGAS\VEGAS Pro 15.0\Script Menu\otomad_helper.cs(657)：The type or namespace name "Vegas" does not exist (are you missing an assembly reference?)

C:\Program Files\VEGAS\VEGAS Pro 15.0\Script Menu\otomad_helper.cs: Cannot find metadata file "C:\Program Files\VEGAS\VEGAS Pro 15.0\Script Menu\DLL\NAudio.dll"

System.Reflection.TargetInvocationException: Exception has been thrown by the target of an invocation. ---> System.FormatException: Not a MIDI file - header chunk missing
  at NAudio.Midi.MidiFile ..ctor(Stream inputStream, Boolean strictChecking, Boolean ownInputStream)
  at EntryPoint.FromVegas(Vegas vegas)
 --- End of inner exception stack trace ---
  at System.RuntimeMethodHandle.InvokeMethod(Object target, Object[] arguments, Signature sig, Boolean constructor)
  at System.Reflection.RuntimeMethodInfo.UnsafeInvokeInternal(Object obj, Object[] parameters, Object[] arguments)
  at System.Reflection.RuntimeMethodInfo.Invoke(Object obj, BindingFlags invokeAttr, Binder binder, Object[] parameters, CultureInfo culture)
  at ScriptPortal.Vegas.ScriptHost.ScriptManager.Run(Assembly asm, String className, String methodName)
  at ScriptPortal.Vegas.ScriptHost.RunScript(Boolean fCompileOnly)

System.Reflection. TargetInvocationException: Exception has been thrown by the target of an invocation. ---> System.NullReferenceException: Object reference not set to an instance of an object.
  at EntryPoint.FromVegas(Vegas vegas)
  --- End of inner exception stack trace ---
  at System.RuntimeMethodHandle.InvokeMethod(Object target, Object[] arguments, Signature sig, Boolean constructor)
  at System.Reflection.RuntimeMethodInfo.UnsafeInvokeInternal(Object obj, Object[] parameters, Object[] arguments)
  at System.Reflection.RuntimeMethodInfo.Invoke(Object obj, BindingFlags invokeAttr, Binder binder, Object[] parameters, CultureInfo culture)
  at Sony.Vegas.ScriptHost.ScriptManager.Run(Assembly asm, String className, String methodName)
  at Sony.Vegas.ScriptHost.RunScript(Boolean fCompileOnly)

System.Reflection.TargetInvocationException: Exception has been thrown by the target of an invocation. --->
System.ArgumentNullException: Value cannot be null.
  at ScriptPortal.Vegas.Effect..ctor(PlugInNode plugIn)
  at EntryPoint.FromVegas(Vegas vegas)
 --- End of inner exception stack trace ---
  at System.RuntimeMethodHandle.InvokeMethod(Object target, Object[] arguments, Signature sig, Boolean constructor)
  at System.Reflection.RuntimeMethodInfo.UnsafeInvokeInternal(Object obj, Object[] parameters, Object[] arguments)
  at System.Reflection.RuntimeMethodInfo.Invoke(Object obj, BindingFlags invokeAttr, Binder binder, Object[] parameters, CultureInfo culture)
  at ScriptPortal.Vegas.ScriptHost.ScriptManager.Run(Assembly asm, String className, String methodName)
  at ScriptPortal.Vegas.ScriptHost.RunScript(Boolean fCompileOnly)

vegas.AudioFX.FindChildByName("Pitch Shift");

vegas.AudioFX.FindChildByUniqueID("{ED1B4100-93BE-11D0-AEBC-00A0C9053912}");

System.Reflection.TargetInvocationException: Exception has been thrown by the target of an invocation. --->
System.Runtime.InteropServices.COMException: Error HRESULT E_FAIL has been returned from a call to a COM component.
  at ScriptPortal.Vegas.IEffectCOM.SetPreset(UInt32 sessionID, Int64 position, String presetName)
  at EntryPoint.FromVegas(Vegas vegas)
 --- End of inner exception stack trace ---
  at System.RuntimeMethodHandle.InvokeMethod(Object target, Object[] arguments, Signature sig, Boolean constructor)
  at System.Reflection.RuntimeMethodInfo.UnsafeInvokeInternal(Object obj, Object[] parameters, Object[] arguments)
  at System.Reflection.RuntimeMethodInfo.Invoke(Object obj, BindingFlags invokeAttr, Binder binder, Object[] parameters, CultureInfo culture)
  at ScriptPortal.Vegas.ScriptHost.ScriptManager.Run(Assembly asm, String className, String methodName)
  at ScriptPortal.Vegas.ScriptHost.RunScript(Boolean fCompileOnly)

System.Reflection.TargetInvocationException: Exception has been thrown by the target of an invocation. --->
System.ArgumentException: Media stream not specified.
  at Sony.Vegas.Take.AddSelf(UInt32 trackID, Int64 eventID, MediaType mediaType)
  at Sony.Vegas.TrackEvent.AddTake(MediaStream mediaStream)
  at EntryPoint.FromVegas(Vegas vegas)
 --- End of inner exception stack trace ---
  at System.RuntimeMethodHandle.InvokeMethod(Object target, Object[] arguments, Signature sig, Boolean constructor)
  at System.Reflection.RuntimeMethodInfo.UnsafeInvokeInternal(Object obj, Object[] parameters, Object[] arguments)
  at System.Reflection.RuntimeMethodInfo.Invoke(Object obj, BindingFlags invokeAttr, Binder binder, Object[] parameters, CultureInfo culture)
  at Sony.Vegas.ScriptHost.ScriptManager.Run(Assembly asm, String className, String methodName)
  at Sony.Vegas.ScriptHost.RunScript(Boolean fCompileOnly)

Deep Exploration

Core Script

1. Download the latest version of this script

2. Unzip ALL the files in the ZIP file you’︀ve just downloaded to the Script Menu folder in the Vegas installation directory, or the Vegas Script Menu folder in the Documents (formerly My Documents) folder. Specifically:

Install for a Specific Installed Vegas Version

If you want to install the script only for a specific installed Vegas version, please install into the Script Menu folder in the Vegas Pro directory.

C:\Program Files\BorisFX\Vegas Pro 2026\Script Menu

C:\Program Files\VEGAS\VEGAS Pro 23.0\Script Menu

C:\Program Files\VEGAS\VEGAS Pro 22.0\Script Menu

C:\Program Files\VEGAS\VEGAS Pro 21.0\Script Menu

C:\Program Files\VEGAS\VEGAS Pro 20.0\Script Menu

C:\Program Files\VEGAS\VEGAS Pro 19.0\Script Menu

C:\Program Files\VEGAS\VEGAS Pro 18.0\Script Menu

C:\Program Files\VEGAS\VEGAS Pro 17.0\Script Menu

C:\Program Files\VEGAS\VEGAS Pro 16.0\Script Menu

C:\Program Files\VEGAS\VEGAS Pro 15.0\Script Menu

C:\Program Files\VEGAS\VEGAS Pro 14.0\Script Menu

C:\Program Files\Sony\Vegas Pro 13.0\Script Menu

Install for All Installed Vegas Versions

If you want to install the script for all installed Vegas versions, please install into the Vegas Script Menu folder in the Documents folder.

%UserProfile%\Documents\Vegas Script Menu

C:\Users\(Your User Name)\Documents\Vegas Script Menu

If the folder does not exist, please follow these steps:

3. Make sure that the DLL file (DLL\NAudio.dll) is not locked.

At this point, your folder should look like this:

4. Open Vegas Pro to launch it. Select menu Tools→Scripting→Rescan Script Menu Folder.
5. Select menu Tools→Scripting→Otomad Helper to open.

Datamosh Extension Pack

If you want to use the full features of Datamosh, you have to install the Datamosh extension pack.

1. Download the Datamosh extension pack
2. Unzip the 7Z file and move the _internal folder to the same directory as the script Otomad Helper.{cs,dll}.

Quick Launch

You can add the script as a toolbar button for quick access rather than having to click troublesomely inside the Tools→Scripting submenu every times, by adding them to the toolbar using the Options→Customize Toolbar menu.

Compatibility

Vegas Pro 13+ supported.

Vegas Pro 16 and above support all features, and Vegas Pro 13 – 15 are compatible to run (some features are missing). The correct version must be installed though.

Otomad Helper is a YTPMV/otoMAD/YTP script for Vegas Pro that enables Vegas to accept MIDI sequence files as input and automatically generate YTPMV tracks.

The script is redeveloped based on the original author @Chaosinism’︀s open source code and uses the NAudio library.

Check out the usage section for further information, including how to install the script.

This documentation was originally written by @Evauation.

Sub-Features

It can also be used to make YTP, Sonar Effect (Motion Graphics Generation Feature), Datamosh.

The related features of YTP refer to YTP+.

Camera Shake feature refer to VegasShakeScript.

Sister Projects

om midi — A YTPMV/otoMAD assistant script for After Effects.

Languages

You can also click on the language button on the top right corner of any page to switch languages.

Translators

• Vietnamese translation provided by @Cyahega.
• Indonesian translation provided by @AdeGimank123 and @JujunG.

To learn more about the features of Otomad Helper, please continue reading on the next page…

Dataḁ̸̬͋ă̷͍ȧ̴͇͘͝ͅá̷̖̲͑ã̶̺̈́å̷͉̖͊̚ä̷̬̬â̷̡̱̑ Mo̴̞̜̯͋ȯ̴̪̏͂õ̷̧͚ͅȏ̸͇ö̵̟̻̹͌o̶͚͍̻̕ǒ̸̢͎̄o̵͔̘̓͘o̶͇̐o̸̬͒͗̎shDatamosh is a technique of damaging clips to create glitchy effects which frames that need to progress, don’︀t progress!
OH’︀s Datamosh was made possible with the use of Vegas-Datamosh by delthas

Datamosh

Datamoshes the video with determined settings.

• Frame Count
  • Amount of frames to use.
• Frame Repeat
  • Amount of times the frames will repeat.

This repeats N P-frames M times. N is the Frame count, M is the Frame repeats.

To use, make a selection in the timeline using I and O, then it will be rendered and datamoshed and added to your project, all in one click. It can take quite some time for long selections so wait if Vegas seems to freeze.

The start of the selection is the first P-frame that will be repeated. The P-frame will be relative to the previous frame, which will be rendered as an I-frame. So for best results, the start of the selection should be a frame with a lot of movement.

The end of the selection simply tells the script until which frame it should render the datamoshed file. The longer the selection, the longer the render time.

Datamix

Datamoshes the first frame of the selection.

This replaces the first I-frames of a clip by a frame of another clip.

To use, make a selection in the timeline using I and O, then it will be rendered and datamixed and added to your project, all in one click. It can take quite some time for long selections so wait if Vegas seems to freeze.

The start of the selection is the I-frame of the clip that will be replaced by another I-frame. The image used for the new I-frame will be the frame just before the start of the selection. So make sure to place the image you want to datamix from, just before the selection start.

If you want to datamix on a scene change, you can typically split the clip at the exact frame where the scene changes, and select the right clip. This will datamix the right-hand side clip onto the last frame of the left-hand side clip.

The end of the selection simply tells the script until which frame it should render the datamoshed file. The longer the selection, the longer the render time.

Layer

Layers’︀ the selected clip for moshing.

• Layer count
  • Amount of layers to generate.
• Layering offset
  • Offsets the layer by the number of frames specified.
• Render
  • Renders the clip selected after generating layers.

This does multilayering, by copying the select video clip/event N times, each time offsetting the clip by M frames. N is the Layer count, M is the Layering offset. You can also choose to automatically render the multilayered clip by checking the Render hitbox, otherwise the copies clips will simply be added to the timeline.

To use, select a single video clip/event, then it will be multilayered automatically, and rendered transparently if specified.

You can use a negative offset (eg -2 instead of 2), in which case the newest clips/events will be added at the back, instead of the front of the previous events.

If you choose to render automatically, the rendered file will support alpha/transparency, meaning you don’︀t need to add a green screen and remove it after, the alpha is handled automatically.

Render

Renders the clip within a timeline selection… (Yes that’︀s literally it.)

This simply renders a part of the timeline and places it into the timeline in a single click.

To use, make a selection in the timeline using I and O, then it will be rendered and added to your project, all in one click.

The rendered file will support alpha/transparency, meaning you don’︀t need to add a green screen and remove it after, the alpha is handled automatically.

Scramble

Scrambles the clip with random time placements dependent on the size.

• Scramble Size
  • The value of the size for the clips to be generated.

This simply scrambles multiple clips/events, by cutting them in subclips of length N, and shuffling the subclips. N is the Scramble size, and is usually 1.

To use, select several clips/events (they must be actually selected, not only in group-selected), then they will be scrambled automatically.

Clips starting and ending at the same time will be scrambled together, ie their subclips will be shuffled the same way.

Automator

Automates and Randomizes the values of Visual effects in the clip.

• Scramble
  • It will ask if you wish to automate the Visual effects in the clip, for each effect.

This randomizes the video effects of selected clips/events, by adding random keyframes every frame for each parameter type you select.

To use, select several clips/events which have video effects on them (they must be actually selected, not only in group-selected), then start the script. For each type of video effect parameter on any of the clips, you will be prompted for whether you want the script to scramble the parameter (replace all the current keyframes of the parameter with random keyframes), or not (leave the keyframes as is).

Only OFX video effects are supported (newsprint, mirror, …); they all have the same look, it’︀t easy to identify which effects are OFX. Other effects are ignored.

Stutter

Stutters clips by Forwarding and Reversing them in randomized intervals.

• Length in Seconds
  • Duration of clips to be generated.
• Stutter Window Bias
  • The value in which stutter will randomize the clips.

Shake

Shakes the clips.

• Speed
  • The frequency value of the shaking effect.
• H/V Synchronicity
  • The relative vertical speed value.
• Amount
  • The value of pixels the camera shifts from the center.

    IMPORTANT

    This also controls the margin of the zoom in.

• H/V ratio of displacement
  • The value of the horizontal distance multiplied.

    IMPORTANT

    This controls the zoom in.

• Reset Pan/Crop on first frame
  • Leave unchecked to shake within the current video zoom.
• Reset all frames before shaking
  • Leave unchecked to apply and multiple the shake effect with the previous shake effect.

Otomad Helper is licensed under the GPL 3.0.

Project Start Date: Sunday, September 5th, Anno Domini 2021 4:14:26 AM +08:00

Copyright © 2021–present - Licensed under GPLv3

Terms of Use

1. Respect the rights and interests of authors when creating with non-self-made MIDI/sources/materials.
2. Using this script requires some creative abilities from the users. This script should and should only be used to assist in creations. Do not rely solely on this script to generate productions nor learn to creating YTPMV/otoMAD as a beginner. Listen, don’︀t make YTPMIDI/otoMIDI!
3. After using this script to create a video and posting it to media platforms, please do not mention the name or website link of this script anywhere—such as video description and comments—to claim that this script was participated in the creation.

Permissions

If you use this script, the script will use the following permissions.

1. File read and write.
   1. The script reads and writes an INI user profile in your disk memory to save your user data.
      Path

      C:\Users\(Your User Name)\AppData\Roaming\VEGAS Pro\(Your Vegas Version)\Otomad Helper.ini

2. Registry read and write.
   1. The script need to read and write the registry to install or uninstall pitch-shift plugin presets.
      Path

       HKEY_CURRENT_USER\Software\DirectShow\Presets\{ED1B4100-93BE-11D0-AEBC-00A0C9053912}

   2. Configurations related to Datamosh are saved in the registry.
      Path

       HKEY_CURRENT_USER\SOFTWARE\VEGAS Creative Software\Custom Presets

Credits

This project references the following open source code:
We would like to thank their authors and contributors for their contributions to the open source cause!

Vegas Datamosh Libs

The following libs were used in Vegas Datamosh Extension Pack.

Old Documentation Links

Welcome to revise the documentation for Otomad Helper — a YTPMV/otoMAD/YTP extension for Vegas Pro. This site serves documentation for both the new version (v8, an extension) and the old version (v4, a script).

Project Overview

Otomad Helper is a tool that enables Vegas Pro to accept scores (such as MIDI sequence files) as input and automatically generate YTPMV/otoMAD/YTP tracks. This repository contains the documentation website source code for the project.

The documentation covers two major versions:

Tech Stack

How it works: When code is pushed to the docs branch on GitHub, Read the Docs automatically rebuilds the site and serves the static HTML pages at https://otomadhelper.readthedocs.io/.

Multi-Language Documentation Format

This project uses a custom single-file multi-language format. Instead of maintaining separate files for each language, all translations live together in one file. This makes it much easier to spot and fix errors across languages simultaneously.

Why This Format?

If the document contains 7 languages, when you need to fix a mistake that exists in multiple languages, the traditional approach requires you to:

1. Open 7 separate files (one per language).
2. Find the corresponding line in each file.
3. Make the same fix 7 times.

With the single-file format, translations sit right next to each other, so you can fix everything in one place.

Line-Level Multi-Language

For translating individual lines, use the @ prefix followed by a language tag, a space, and the translated content:

﹫en This is English content.
﹫zh 这是中文内容。
﹫ja これは日本語の内容です。

Currently supported language tags: en (English), zh (Simplified Chinese).

Block-Level Multi-Language

For large blocks of content — such as entire paragraphs with complex formatting, tables, or admonition blocks — use @@@ delimiters:

﹫﹫﹫en
This is a large block of English content.
It can span multiple lines and include **formatting**.
﹫﹫﹫zh
这是一大段中文内容。
它可以跨越多行并包含**格式**。
﹫﹫﹫

• Start a block with @@@ followed by a language tag.
• End the entire multi-language block with a bare @@@ on its own line.

Fallback Behavior

If a particular language is missing for a line or block, the site will automatically fall back to English. This means you only need to write translations for languages you know — missing ones will safely display English instead.

Important Rules

• Do not mix line-level (@) and block-level (@@@) syntax for the same content — pick one.
• The @ or @@@ markers must appear at the very beginning of a line.
• For line-level translations, languages can appear in any order, but keeping them consistent (e.g., always @en first, then @zh) helps readability.

How to Edit Documentation

The steps below are written for non-programmers. You do not need any coding experience — just follow along step by step. If you get stuck, ask a friend who is familiar with computers to help.

One-Time Setup

You only need to do this section once, the first time you set up the project on your computer.

Step 1: Install Node.js

Node.js is the runtime that powers the documentation toolchain.

1. Open your browser and go to https://nodejs.org/
2. Click the LTS (Long Term Support) download button — this is the stable version recommended for most users.
3. Once downloaded, double-click the installer file (e.g., node-vXX.XX.X-x64.msi on Windows).
4. Follow the installation wizard — you can accept all the default settings.
5. Click Finish when done.

Step 2: Install pnpm

pnpm is the package manager used by this project.

1. Open Command Prompt (Start Menu → type cmd → press Enter).
2. Type the following command and press Enter:
   bash

   npm install -g pnpm

3. Wait for the installation to complete.

Step 3: Install GitHub Desktop

GitHub Desktop provides a visual interface for Git, so you don’︀t need to memorize command-line instructions.

1. Go to https://desktop.github.com/
2. Click the Download button.
3. Once downloaded, run the installer.
4. When you open GitHub Desktop for the first time, it will ask you to sign in with your GitHub account. If you don’︀t have one:
   • Go to https://github.com/signup and create a free account.
   • Then sign in to GitHub Desktop with your new account.
5. Follow the setup prompts (you can skip configuring Git if asked — the defaults are fine).

Step 4: Clone the Repository

”︀Cloning”︀ means downloading a copy of the project to your computer.

1. In GitHub Desktop, click File → Clone repository…
2. Select the URL tab.
3. In the “︀Repository URL”︀ field, enter:

   https://github.com/otomad/OtomadHelper

4. For “︀Local path”︀, click Choose… and pick a folder on your computer where you want to store the project (e.g., D:\Documents\OtomadHelper).
5. Click Clone.
6. Important: After cloning, switch to the docs branch:
   • Near the top of GitHub Desktop, you’︀ll see a button labeled ”︀Current branch”︀ (it may say main or master).
   • Click it, then select the docs branch from the list.
   • If you don’︀t see docs in the list, click the ”︀Origin”︀ tab at the top of the branch list — branches that only exist on GitHub will appear there. Click docs to check it out.

Step 5: Install Project Dependencies

Dependencies are external libraries the project needs to work.

1. In GitHub Desktop, with the repository open, click Repository → Open in Terminal (or press Ctrl + `).
   • This opens a terminal window already pointing to the project folder.
2. In the terminal, type the following and press Enter:
   bash

   pnpm i

3. Wait for the installation to finish — it may take a minute or two. You’︀ll see a progress indicator, and it will end with something like “︀Done”︀.

You only need to run pnpm i once during setup. You generally don’︀t need to run it again unless someone tells you new dependencies were added.

Step 6 (Not Necessary, But Recommended): Install Visual Studio Code

While you can edit files with Notepad directly, Visual Studio Code (VS Code) is a free, powerful editor that makes editing much easier with syntax highlighting and file browsing.

1. Go to https://code.visualstudio.com/
2. Click Download and install it (accept all defaults).
3. After installation, in GitHub Desktop, you can right-click the repository and choose ”︀Open in Visual Studio Code”︀ to jump straight into editing.

Daily Editing Workflow

This is the workflow you’︀ll follow each time you want to make changes.

Step 1: Pull the Latest Changes

Before editing, always fetch the latest version to avoid conflicts with changes others may have made.

1. Open GitHub Desktop.
2. Make sure the current repository is OtomadHelper and the current branch is docs.
3. Click the ”︀Fetch origin”︀ button in the top toolbar.
4. If there are new changes, the button will change to ”︀Pull origin”︀ — click it to download the latest updates.

Step 2: Edit Documentation Files

The documentation files are Markdown (.md) files located in the docs/ folder.

1. Open the project folder in your file explorer, or open it in VS Code.
2. Navigate to the docs/ folder. Inside you’︀ll find:
   • .vitepress/ — Configuration and theme files (usually you won’︀t touch these)
   • zh-CN/**/*.md — Chinese-specific pages (home page, etc.)
   • **/*.md files — The new v8 extension version documentation pages (these use the multi-language format)
   • v4/**/*.md — the old v4 script version documentation pages (these use the multi-language format)
3. Open the file you want to edit. Most content files use the single-file multi-language format, so English and Chinese content sit together. See the Multi-Language Documentation Format section above for details.
4. Make your changes and save the file (Ctrl + S).

Step 3: Preview Your Changes Locally

Before pushing, you can preview the site on your own computer to see how your changes look.

1. If you have VS Code, please Press Ctrl + Shift + B, and then select npm: dev.

   If you don’︀t have VS Code, please:

   1. Open a terminal in the project folder:
      In GitHub Desktop: Click Repository → Open in Terminal.
   2. Type this command and press Enter:
      bash

      pnpm run dev

2. Wait a moment. You’︀ll see output like:

   vitepress vX.X.X
   ➜  Local:   http://localhost:7000/

3. Press Ctrl (or maybe Alt) and click the link http://localhost:7000/.
4. Navigate to the page(s) you edited and check that everything looks correct.

Step 4: Commit and Push Your Changes

”︀Committing”︀ saves your changes to the local repository. “︀Pushing”︀ uploads them to GitHub.

1. Open GitHub Desktop. You’︀ll see your changed files listed on the left.
2. In the bottom-left corner, find the ”︀Summary”︀ field. Write a short, clear description of what you changed. For example:
   • Fix typo in installation guide
   • Update audio page with new feature description
   • Add Chinese translation for FAQ page
3. Optionally, you can add more details in the ”︀Description”︀ field below.
4. Click the ”︀Commit to docs”︀ button.
5. After committing, click the ”︀Push origin”︀ button (top right) to upload your changes to GitHub.

Project Structure

OtomadHelper_docs/                     # Repository root (docs branch)
├── .gitignore                         # Files ignored by Git
├── .readthedocs.yaml                  # Read the Docs build configuration
├── package.json                       # Project dependencies and scripts
├── pnpm-lock.yaml                     # Dependency version lock file
├── tsconfig.json                      # TypeScript configuration
├── oxfmt.config.ts                    # Code formatter configuration
├── README.md                          # You are here
├── README_zh-CN.md                    # Chinese version of this file
└── docs/                              # Documentation source (VitePress root)
    ├── .vitepress/                    # VitePress configuration & theme
    │   ├── config.ts                  # Main site configuration
    │   ├── components/                # Custom Vue components
    │   ├── plugins/                   # Custom Markdown & build plugins
    │   ├── theme/                     # Custom theme overrides
    │   └── use-i18n.ts                # Internationalization helpers
    ├── assets/                        # Static assets (images, fonts, etc.)
    ├── img/                           # Documentation images
    ├── public/                        # Public static files
    │   ├── favicon.svg                # Site favicon
    │   └── favicon_1.ico              # Alternative favicon (RtD workaround)
    ├── index.md                       # Home page (English)
    ├── introduction.md                # Introduction page (multi-language)
    ├── installation.md                # Installation guide (multi-language)
    ├── usage.md                       # Usage guide (multi-language)
    ├── faq.md                         # FAQ (multi-language)
    ├── audio.md, visual.md, ...       # Feature pages (multi-language)
    ├── v4/                            # Old v4 documentation pages
    │   ├── introduction.md
    │   ├── installation.md
    │   └── ...
    └── zh-CN/                         # Chinese-specific pages
        ├── index.md                   # Home page (Chinese)
        └── v4/                        # Chinese v4 entry point

How Build & Deployment Works

1. You edit Markdown files and push to the docs branch on GitHub.
2. Read the Docs automatically detects the push.
3. RtD runs npm run build (configured in .readthedocs.yaml), which builds the VitePress site.
4. The generated static HTML files are served at https://otomadhelper.readthedocs.io/.
5. The build usually completes within 2–5 minutes after pushing.

Available Scripts

License

This documentation is released under the GPL 3.0 License.

Copyright © 2021–present

MIDI Configuration

(THIS IS IMPORTANT)

• Requires a MIDI File to make the YTPMV/otoMAD.
• You must select a MIDI file from your computer for the script to generate.

Start and End Time

Controls the range where the generation of MIDI starts and ends.

BPM Tempo

Controls the BPM the MIDI generates.

• MIDI Tempo
  • Uses the MIDI’︀s Tempo.
• Project Tempo
  • Uses the current Vegas Project’︀s Tempo.
• Custom
  • Uses the Custom Setting.

If the MIDI has changing tempos, the script will adapt and let you select what options you want to do with them.

• Variable MIDI tempo
  • Uses the changing tempo.
  • Hold
    • Notes Generated will stay held to their BPM.
  • Linear
    • Notes Generated will be based linearly on their BPM.
• MIDI Tempo
  • Uses the constant first tempo.

Auto Change Project Ruler Properties

Adjusts the project’︀s measure properties based on the MIDI.

• Tempo
  • Uses tempo as the setting.
• Time signature
  • Uses time signature as the setting.

• Apply Now
  • Automatically applies the MIDI’︀s tempo and time signature without generating the MIDI events.

Restrict Note Length

Controls the Note Output Length from the MIDI.

• Unconstrained
  • No note output change.
• Max Length
  • Notes will be restricted to the length provided.
• Fixed Length
  • Notes will attempt to generate to the length provided.

Use MIDI track

This allows you to select what tracks you want to generate from your MIDI file.

Commands

• Select all
  • Selects all tracks.
• Invert Selection
  • Inverts your selection.
• Single
  • Toggles selecting a single track.
• Multi
  • Toggles selecting multiple tracks.

Auto Layout Tracks

Refer to Tools

Sonar (Motion Graphics Generation Feature) is for creating beat-style visuals for Drums.

Reference:
『図形素材』、《图形练习》

This setting can be toggled.

Toggles

• Separate Drums
  • Makes the drums’︀ visuals generate on multiple layers.
• Different Composite Mode
  • Makes the layers generated with difference compositing (blending).
• Shadow
  • Generates visuals with a shadow.
• Shadow Color
  • Changes the shadow color.

Editor

• Reset
• Delete (Selection)
• Move Up (Selection)
• Move Down (Selection)
• Create New

Parameters

• Matched Drum Sound
  • The value of the drum sound used for the generation.

    IMPORTANT

    This should match what the individual drum is in your MIDI.

• Shape
  • The shape of the visual.
• Color
  • Controls the color of the visual.
• Duration
  • The value of the duration for the visual.
• Curve
  • The value of the keyframe type.
• Start Border
  • The value of the starting size of the border.
• End Border
  • The value of the ending size of the border.
• Start Size
  • The value of the starting overall size.
• End Size
  • The value of the ending overall size.

• X Center
  • The value of the center horizontal position.
• Y Center
  • The value of the center vertical position.

• Start X Offset Odd
  • The value of the X starting position for every odd visual.
• Start Y Offset Odd
  • The value of the Y starting position for every odd visual.
• Start X Offset Even
  • The value of the X starting position for every even visual.
• Start Y Offset Even
  • The value of the Y starting position for every even visual.

• Prestart X Offset Odd
  • Additional value of the X starting position for every odd visual.
• Prestart Y Offset Odd
  • Additional value of the Y starting position for every odd visual.
• Prestart X Offset Even
  • Additional value of the X starting position for every even visual.
• Prestart Y Offset Even
  • Additional value of the Y starting position for every even visual.

• Start Rotation Odd
  • The value of the starting rotation for every odd visual.
• Start Rotation Even
  • The value of the starting rotation for every even visual.
• Fade In
  • The value of the fade in.
• Fade Out
  • The value of the fade out.
• Fade In Curve
  • The keyframe type of the fade in.
• Fade Out Curve
  • The keyframe type of the fade out.

Source Configuration

Select source from

Allows selecting a media file or a track event chosen to be used.

Start and End Time

Trim the start time and end time of the clip used.

Generate at

Controls where the MIDI can be generated.

• Project Start
  • Generates the MIDI at the Start.
• Cursor
  • Generates the MIDI at the Cursor Position.
• Custom
  • Generates the MIDI at any Time Position chosen.

Below Top Adjustment Tracks

Places the Generated Tracks below the Adjustment Tracks.

Remove track events assigned as source material after the generation completes

Deletes the original source clip after the MIDI has been generated.

Select all generated events after the generation completes

Selects all events generated after the MIDI has been generated.

Move the Cursor to

Positions the cursor to a specified location in the timeline.

• Original Position
  • Retains the timeline cursor in the original position before you ran the script.
• Where Generate at
  • Moves the cursor to the start of the MIDI file.
• Before the First Event
  • Moves the cursor to before the first generated event in the timeline.
• After the Last Event
  • Moves the cursor to after the last generated event in the timeline.

Grouping Tracks

Creates groups for the tracks.

• Ungrouped
  • Disables track grouping.
• Group by MIDI track
  • Groups tracks based on the MIDI track used and uses the MIDI track name.
• Group by task session
  • Creates a new group whenever a new generation is completed.

• Collapse track groups by default
  • Collapses the track group list
• Reuse groups that have the same nonempty name
  • The generation of newly added tracks to be added to existing track groups with the same name.

Audio Bus Track

Routes audio tracks to audio buses (Mixing Console).

• Unrouted
  • Disables routing to audio buses.
• Route by MIDI track
  • Routes the audio track to the same bus based on the MIDI track used.
• Route by task session
  • Creates and routes the audio track to a new bus whenever a new generation is completed.

• Reuse audio bus tracks that have the same nonempty name
  • The generation of newly added tracks to be added to existing audio buses with the same name

Multisource Combination

Off

Disables the multisource features.

Mystery Box

Automatically picks from multiple selected sources in unpredictable ways.

Limited to selected sources

Only uses the sources selected in the timeline/project media.

Make each track different

Each track will generate with a different clip.

Switch once per marker

Changes the source when a MIDI marker is reached.

Switch once per bar or beat

Changes the source when a beat or bar has passed.

Lotion Bath Tactics

Forces the source to sequentially change at your specified duration.

Source Syncopator

Applies sources in a patterned, musical way.

Order

• Sequential
  • Uses clips in the order they were selected.
• Reversed
  • Uses clips in reverse order.
• Shuffled
  • Shuffles the order of the generation.

Repetitions per clip

Specifies the amount of times a source can be used before switching to the next clip.

Total repetition rounds

Specifies the amount of times to loop.

Apply visual effects by rounds

Applies video effects in cycles rather than every clip.

Mystery Box

Combines the Mystery Box behavior to the generation.

Accumulate overtones of chords separately

Makes use of multiple sources when a chord is generated.

Sustain source at same pitch

Uses the same source for the next note with the same pitch.

Pitch cache capacity

Specifies the amount of times it will repeat the source.

Source Orchestra

Assigns source clips to MIDI tracks, like assigning instruments to an orchestra.

Selection Mode

• Mystery Box
  • Uses the Mystery Box behavior
• Source Syncopator
  • Uses the Source Syncopator behavior

Descending

Reverses the order of sources used on each track.

Allow reuse

Allows the same clips to be used across different MIDI tracks multiple tracks.

Consonant Time

COMING SOON (patience)

Shupelunker Tactics & Tartar Tactics

COMING SOON (patience)

Staff Visualizer is for creating Sheet style visuals in a similar fashion to Piano Sheets.

This setting can be toggled. (This is disabled by default.)

Notes Parameters

• Using Relative Values
  • Uses Values relative to 1920×1080 size.

    IMPORTANT

    If off, it will use values based on your project size.

• Legacy Positioning Method
  • Uses the old method of placing visuals, uses Track Motion instead for the Notes and Lines.
• Freeze at note off
  • Freezes the note upon MIDI note’︀s end.
• Lengthen to bar end
  • Extends the clip to the end of the measure.

• Clef
  • Controls what the Clef is.

  INFO

  Treble is for Higher Sounding Notes, Bass is for Lower Sounding Notes.

• Line Gap
  • Controls the Pixel Gap for the Visuals and the Sheet.
• Padding Left
  • Controls the Value of the Gap Distance from the Left.
• Padding Right
  • Controls the Value of the Gap Distance from the Right
• Surface Position
  • Controls the Value of the Gap Distance from the Middle Line.
• Notes Shift
  • Shifts Notes in the Sheet based on the Value of the Key Change.

Lines Parameters

• Generate Lines
  • Generates the lines for the Staff.

• Line Thickness
  • Controls the size of the Line Thickness in the Staff Sheet.
• Line Color
  • Controls the Line Color.

Clef Parameters

• Generate Clef
  • Generates the Clef Symbol at the front beginning of the sheet.

• Clef Scale
  • Controls the Clef Symbol scale generation.
• Clef Color
  • Controls the Clef Symbol color.

These QoL Functions within the script make creating YTPMVs and otoMADs a little less painful for setting up or working with. These don’︀t require any adjustments to any of the previous parameters.

• Close this dialog after the operation completes

  Self-explanatory.

Auto Layout Tracks

Layout controls for visuals.

Grid Layout

Array

• Square
  • Makes the standard layout.

    INFO

    This makes the Layout 2×2, 3×3, etc.

• Custom
  • Customize the Layout Format.

Parameters

• Columns
  • The value of Columns.
• Rows
  • The value of Rows.

Fit

• Cover
  • Adapts the size of the boxes to fit with the layout.

    IMPORTANT

    This will stretch them if applicable.

• Contain
  • Keep the boxes’︀ original size and adapt them to the layout.
• Overlay
  • Crops the window of the visuals to the columns and rows specification.

Mirror Edges

Mirrors the Tracks in a Parity Pattern.

• Horizontal Flip
  • Flips the Columns in the pattern chosen.
• Vertical Clip
  • Flips the Rows in the pattern chosen.

Descending

Reverses the layout sorting method (when ticked off).

Padding

Adjust the track boxes to be less cluttered with other boxes.

3D Box Layout

This will create a cube with the tracks you select.

Delete Original Track

Deletes the original track(s) when the layout generates.

Use Longer Side of Edge Length

This may make the cube more natural.

Gradient Tracks

This makes the video tracks have a gradient style color effect in your layout.

• Gradient Effect
  • The Effect Presets.
• Descending
  • Reverses the Gradient Order.

Clear Tracks Motion

Resets the Track Motion Box.

Clear Tracks Effect

Removes all the Track Effects.

Track Legato

• Stacking Clips (for current tracks)
  • Stacks all Clips together in the selected tracks.
• Stacking Clips (for all tracks)
  • Stacks all Clips together on every track.
• Stretch Clips (within stretch limits)
  • Stretch Clips without Extending the clips’︀ length.
• Stretch Clips (lengthen when outside stretch limit)
  • Stretch Clips and Lengthens the Clips.
• Lengthen Clips (changes clips length)
  • Lengthens the Clips.
• Increase Spacing (current track)
  • Divides the Spacing of Each Clip in the Track.
• Increase Spacing (all track)
  • Divides the Spacing of Each Clip for all Tracks.
• For Selected Track Events Only
  • Allows Track Legato to be applied on selected track events only.
• Include the Track Events within a Group
  • Allows Track Legato to be applied on the Grouped Clips.
• Reverse Direction
  • Applies the Legato Effect Backwards.

Quick Select Interval

This can select specific clips in the track that are selected.

• Select one for every few
  • Selects every other clip based on the interval value.
• Select which one of the group
  • Selects which order of track clips in the selection.
• Select how many at a time
  • Selects how many clips at a time per group.
• Reset Selection
  • Resets back to the selection pre-running the script.

Quick Config Properties

Set the properties of the event clips selected.

Video clips

• Hide
  • Toggles the video.
• Lock
  • Toggles video lock.
• Loop
  • Toggles video looping.
• Maintain aspect ratio
  • Lock the aspect ratio.
• Reduce interlace flicker
  • Toggles the interlace flicker.
• Resample Mode
  • Sets the resample mode of the video.
• Playback rate settings
  • Sets the playback rate of the video.
• Set undersample rate
  • Sets the undersample rate of the video.
• Opacity Settings
  • Sets the opacity of the video.

Audio clips

• Mute
  • Toggles the audio.
• Lock
  • Toggles audio lock.
• Loop
  • Toggles audio looping.
• Invert phase
  • Inverts the audio phase.
• Normalize settings
  • Sets the normalize settings of the audio.
• Playback rate settings
  • Sets the playback rate of the audio.
• Volume settings
  • Sets the volume of the audio.

Replace Track Events

Replaces selected track events with specific preferences.

Specify simultaneously

• The Selected Track Events can be replaced with whatever you have selected at the end of the selection, you can choose a clip from another track and use that as the replacement and all the track clips that you have set before it will be replaced with that clip.

Specify separately

• Replaces specific clips in the track with any clip you select in any order you want.
• Explanation in Extra Info

Options

• Replace other clips in a event group
  • Replaces Other Clips from the Same Track Event Group.

    IMPORTANT

    Doesn’︀t apply if the clip is not in a group.

• Reserve original clip name
  • Reserves the original clip name of the original clips after the replacement.
• Reserve original clip offset
  • Reserves the original offset of the clip used in the timeline.

Change Tuning Method

Changes the Tuning Method to the selected track events.

Refer to ”︀Audio”︀ on details about the Audio Tuning Methods

Pitch Semitones

• Pitch Lock
  • Locks the Pitch Value.
• Lock Pitch instead of rate
  • Locks the Pitch instead of the Stretch Rate.

Formant Shift

• Reserve Formant
  • Locks Formant.

Batch Subtitle Generation

Creates batches of text using the Title Media Generator with any duration.

• Import from File
  • Import a text file to be used for subtitles.

• Preset
  • Controls the Preset Selection.
• Input
  • Input text, line by line.

    IMPORTANT

    Blank lines are ignored.

• Duration
  • Duration of each line.

Find Track Events

Find and Select all the track events that match the specified.

Options

• Matching Same Source
• Matching Same Source with Same Starting Offset
• Matching Specified Name

Search Text Box

Search for any video, audio or both track events in your project.

• Both
  • Searches for both video and audio events.
• Video events
  • Searches for only video events.
• Audio events
  • Searches for only audio events.

Apply Visual Effect

Apply Visual Effects to selected Track Events.

Refer to ”︀Visual”︀ for details on the Visual effects you can use.

Convert Music Beats

Converts Music Beats to a Different Time Signature.

Custom Fade Gain

Adjusts Gain/Volume Range for Selected Track Events.

• From Value
  • The Value of the Starting Fade Effect.
• To Value
  • The Value of the Ending Fade Effect.

Export MIDI File

Exports Tracks or Track Events to a Score Sequence File.

Settings

• All Tracks
  • Selects all tracks.
• Video Tracks
  • Selects only video tracks.
• Audio Tracks
  • Selects only audio tracks.
• Base Pitch
  • Sets the default base pitch (C5).
• Export loop region only
  • Exports the MIDI with only the selected loop region track events.

Vegas Track List

Select the tracks to be added to the MIDI File.

Options

• Add to each new tracks
  • Adds the selected track(s) to new MIDI tracks with MIDI channels.
• Add to a same new track
  • Adds the selected track(s) to 1 new MIDI track with MIDI channels.
• Add to current track
  • Adds the selected track(s) to the selected MIDI track with new MIDI channels.
• Preview
  • Previews the track(s) selected.

MIDI Track List

Manage the track list for the MIDI being prepared. Displays how many created tracks in the preparation list and how many Vegas tracks and notes in each MIDI Track.

Options

• Move up
  • Moves the selected track up.
• Move down
  • Moves the selected track down.
• Remove
  • Removes the selected track from the list.
• Add a new empty track
  • Creates a new MIDI track.
• Insert a new empty track
  • Insert a new MIDI track on top of selected.

• Name
  • Input a name for the track.

MIDI Channel List

Manage the channel list from the select track in the track list. Displays how many Vegas tracks and notes created in the selected MIDI track.

Options

• Remove
  • Removes the selected channel from the list.
• Channel
  • Set the channel the selected track is on.

• Instrument
  • Displays used MIDI instrument for the channel.

MIDI Instrument list

List of instruments selected to their according MIDI channel that can be changed.

Options

• Dispatch Instrument to Channel
  • Changes and sets instrument to the selected MIDI channel.

Footnotes

To make visuals insanely quickly with Otomad Helper

• You will need a Vegas Pro (13+);

  WARNING

  If you have ANY other editor that you use for remixes, you’︀re out of luck.

• You will need the Otomad Helper Script;
• You will need FL Studio (or any other DAW, that you use for remixes).

Using Otomad Helper is pretty straightforward from here.
Here’︀s how to use it.

• You import and use a MIDI file to configure and generate the clips you want. You should use a MIDI which created by yourself and not someone else. It’︀s discourteous. Don’︀t create YTPMIDIs or any form of remix you didn’︀t create.
• You need to have a clip selected in the timeline or media pool in order to generate anything from the MIDI onto Vegas Pro.
  • Alternatively, you can use a clip or source from your computer to be used for generating by the MIDI.
• The Audio and Visual pages will allow you to edit the settings of how the clips are generated, there is a variety of settings, play with them and tweak them to sort your needs for the start of your creation.
• There is also a variety of tools to help work on the most ludicrous of tasks for your projects, making the chore of editing certain clips to applying different effects easier said than done.

To get started (with FL Studio)

There is now a feature where you can load the last configuration used instantly.

• Hold Ctrl while running the script, it will load and generate the last configuration used in the script.

Footnotes

Also known as Video or PV.

This setting can be toggled. (If your clip has visuals, this is enabled by default.)
You can right-click or middle-click any setting slider to reset it.

Toggles

Loop

Makes the clip loop if applicable.

Static Visual

Makes the clip freeze at the start of the clip.

Truncate

Makes the clip freeze at the end of the clip.

Multitrack for Chords

Generates multiple video tracks for visuals.

Create Groups

Groups the video clips and the related audio clips together.

Glissando

Creates a Swirl Effect if the note pitch bends or slides.

Stack

Creates stacked video clips on separate tracks when the MIDI contains multiple tracks.

Time Unremapping

Disables all forms of time mapping of the clip! The start time will NOT reset as it will continue the clip from where it left off every note.

Stretch

Makes the clip stretch if applicable

• None
  • Applies no stretching to the clip.
• Flex and Extend
  • Stretches the clip completely.
• Extending Only
  • Stretches clip out.

    IMPORTANT

    This works best with MIDI Notes that are longer than the Visual clip.

• Flexing Only
  • Stretches clip in.

    IMPORTANT

    This works best with MIDI Notes that are shorter than the Visual clip.

Legato

Extends the clip beyond the note’︀s duration.

• Staccato
  • No Extension.
• Up to 1 Beat
  • Extends out 1 Beat

    IMPORTANT

    This will only work if the next clip is less than 1 beat apart.

• Up to 1 Bar
  • Extends out 1 Bar

    IMPORTANT

    This will only work if the next clip is less than 1 bar apart.

• Unlimited
  • Extends Unlimitedly.

Preferred Track

Creates a new track(s) or uses the track selected for generation.

Velocity

Settings to assign opacity values relative to the MIDI notes.

• Mapping Velocity
  • Assigns the Notes to the Velocity from the MIDI File.
• Multiply Current Gain
  • Toggling multiplies the existing gain instead.
• Velocity
  • The Value of Velocity from Minimum to Maximum.
• Opacity
  • The Value of Opacity from Minimum to Maximum.

• Reset
  • Resets the settings to default.

Mapping Velocity Explanation

Effects

Visual Effects

Make your visuals whatever you want. The default is Horizontal Flip.

Initial Step

The Value Setting for the visuals.

Advanced - PV Rhythm & Cadence Dynamic Pulsing Visual Effect

• Flip Class
  • Selects a Visual type from the Flip Class.
• Rotation Class
  • Selects a Visual type from the Rotation Class.
• Scale Class
  • Selects a Visual type from the Scale Class.
• Mirror Class
  • Selects a Visual type from the Mirror Class.
• Invert Class
  • Selects a Visual type from the Invert Class.
• Hue Class
  • Selects a Visual type from the Hue Class.
• Monochrome Class
  • Selects a Visual type from the Monochrome Class.
• Time Class
  • Selects a Visual type from the Time Class.
• Time Class 2
  • Selects a Visual type from the Time Class 2.
• Expansion & Compression Class
  • Selects a Visual type from the Expansion & Compression Class.
• Swing Class
  • Selects a Visual type from the Swing Class.
• Blur Class
  • Selects a Visual type from the Blur Class.
• Wipe Class
  • Selects a Visual type from the Wipe Class.

Parameters

Various Effects for the visual generation.

Presets

Premade effect visuals for your convenience.

• Set Fade by Percent
  • Sets the Value Measure to Percent Value.
• Set Fade by Timecode
  • Sets the Value Measure to Timecode Value.

Fade

Fade in

Length of the Video Fade in on the Track Event.

Fade out

Length of the Video Fade out on the Track Event.

Glow

Glow

Value of the “︀Glow”︀ Effect that adds a glow to your visual!

Glow Brightness

Value of the Glow Brightness in your visual.

Constrain keyframes length

Specifies the length of keyframes to generate for the following properties.

• Unconstrained
  • Keyframes will generate normally from start to end of the MIDI note.
• Min length
  • Keyframes will never be shorter than the set length. If the note is shorter, they get truncated.
• Fixed length
  • Keyframes are forced to exactly the set length.

Transform

Start Size

Value of the Starting Size for Pan/Crop.

End Size

Value of the Ending Size for Pan/Crop.

Start Rotation

Value of the Starting Rotation for Pan/Crop.

End Rotation

Value of the Ending Rotation for Pan/Crop.

Start X Shift

Value of the Starting X Shift Position for Pan/Crop.

End X Shift

Value of the Ending X Shift Position for Pan/Crop.

Start Y Shift

Value of the Starting Y Shift Position for Pan/Crop.

End Y Shift

Value of the Ending Y Shift Position for Pan/Crop.

Color Grading

Start Hue

Value of the Starting Hue.

End Hue

Value of the Ending Hue.

Start Saturation

Value of the Starting Saturation.

End Saturation

Value of the Ending Saturation.

Start Contrast

Value of the Starting Contrast.

End Contrast

Value of the Ending Contrast.

Start Threshold

Value of the Starting Contrast Threshold.

End Threshold

Value of the Ending Contrast Threshold.

YTP is for creating YTPs using various effects known in the YTP Genre.
(YTP supports multisource)

Effects

• Chorus
  • Chorus Wobble Effect.
• Change Pitch
  • Change Pitch to Random Value.
• Vibrato
  • Pitch Weirdness Effect.
• Reverse
  • Reverses Clip.
• Delay
  • Delay Echo.
• Change Speed
  • Stretches Video.
• Change Hue
  • Changes Color.
• Rotate Hue
  • Animated Changing Color.
• Black and White
  • Mono Color.
• Negative
  • Inverts Color.
• High-Frequency Repeat
  • Repeats Clip rapidly.
• Random Tuning
  • Random Generated Pattern of Pitches.
• Enlarge
  • Upsizing Video Randomly.

    IMPORTANT

    Also Increases Volume.

• Sphericalization
  • Fish Eye Effect.
• Mirroring
  • Mirrors Clip.
• High Contrast
  • Increases Contrast.

    IMPORTANT

    Also Maxs Volume.

• Oversaturation
  • Max Saturation.

    IMPORTANT

    Also does a pitch-up effect.

• Thrice to Emphasize
  • Up Pitch as it repeats in a sporadic motion.

Parameters

• Minimum Length
  • Controls the Minimum Length for the Clip to Generate.
• Maximum Length
  • Controls the Maximum Length for the Clip to Generate.
• Number of Clips
  • The Value of Clips Generated.

    IMPORTANT

    The max number of clips generated is 300.