AutoZWJ

A plugin for AviUtl2
An Otomad/YTPMV track alignment assistant supporting RPP, MIDI, and other project formats.

English | 简体中文 | 日本語

Import media items from REAPER project files (.rpp), standard MIDI files (.mid), UTAU/OpenUTAU files (.ust / .ustx), or LRC lyrics files (.lrc) into the AviUtl2 timeline as objects, using existing objects as style templates.

Features

• Parse REAPER .rpp / standard MIDI .mid / UTAU .ust / OpenUTAU .ustx / LRC .lrc files
• Use existing timeline objects as style templates, inheriting their effect chains and parameters
• Multi-source mapping: assign multiple templates using configurable strategies (sequential rotation / random selection / chord mapping / animation sequence [beta])
• Effect chain editor: view template effect chains and bake parameters with fixed values / variable mappings / evaluated expressions
• Script variable system: drive bake values with expressions such as $note.velocity$ / 127 * 200
• BPM grid sync: apply MIDI/RPP tempo maps to AviUtl2's BPM grid
• Internationalization: UI available in Simplified Chinese, English, and Japanese, with automatic host UI language detection
• Automatic layer allocation below the template, compactly arranged
• Alternating flips, object duration control, multi-note strategies, alternating row layout
• Object and note sync modes, including stretch-and-hold-last-frame with optional next-note stretching
• All parameters automatically read from the current scene (FPS, resolution) and persisted across sessions

Installation

Install with AviUtl2 Catalog

We recommend installing AutoZWJ through AviUtl2 Catalog for easier management and updates.

Drag-and-drop installation

Drag the AutoZWJ.aux2 file directly into AviUtl2's preview window to install it automatically.

Manual installation

Place AutoZWJ.aux2 in AviUtl2's Plugin directory, then launch AviUtl2.

Quick Start

1. Start
   Select any object on the timeline, right-click → Configure import.... If the timeline is empty, place any object first to serve as a template, or skip to step 2 and drop a project file

2. Load a project
   If no project is loaded yet, the plugin window opens on the import page automatically: drop a .rpp / .mid / .ust / .ustx file onto the AviUtl2 window, or choose a recent project / Browse... on the import page; then check the tracks to generate and click Confirm import

3. Configure and generate
   Adjust parameters on the config page → click OK or Apply

For detailed tutorials and feature explanations, see the documentation.

Build

Requires MinGW-w64 (g++ 15.2+), CMake 3.20+. The AviUtl2 SDK is managed as a git submodule; Dear ImGui is vendored under src/thirdparty/imgui at a fixed version. After the first clone, initialize the submodule:

git submodule update --init
cmake -S . -B build -DCMAKE_BUILD_TYPE=Debug -G "MinGW Makefiles"
cmake --build build

Output: build/AutoZWJ.aux2.

Official releases are built by GitHub Actions on v* tag pushes and published as GitHub Releases. See the build guide for details.

References

• AviUtl2 / AviUtl ExEdit2 Plugin SDK
• Dear ImGui
• RPPtoEXO ver2.0
• OtomadHelper
• om_midi
• import_midi_tempos.aux2
• UltraPaste

Contributing

Contributions to AutoZWJ are welcome, including bug fixes, feature improvements, documentation updates, and translations. We recommend the following process:

1. Fork this repository and create a dedicated branch
2. Make your changes and perform the necessary builds and tests before committing
3. Open a Pull Request describing the purpose, key changes, and verification results

For major features or architectural changes, please discuss the proposal in an Issue before starting implementation.

Reporting Issues

If you encounter a problem or have a feature request, submit it through Issues. Please include as much of the following information as possible:

• AutoZWJ version, AviUtl2 version, and Windows version
• Project format used (RPP, MIDI, or LRC) and reproducible steps
• Expected result and actual result
• Relevant logs, screenshots, and a sanitized minimal sample file when necessary

Please search existing Issues before submitting to avoid duplicates.

Donate

If AutoZWJ is useful to you, you can support its continued development through either platform below.

License

MIT License