Skip to content

Repository files navigation

Download

Download the latest release for your platform. The builds are self-contained Native AOT executables - no .NET runtime required.

AutoMask for AutoSplit

This program uses preset split sequences and masks to automatically generate working AutoSplit images from your original screenshots. The generated images are automatically named with the correct filenames, including threshold levels, delay times, dummy tags, etc., all pre-defined by the preset.

A quick and easy way to instantly set up AutoSplit, given your desired category has an AutoMask preset.

AutoMask_NGWaCml5r6

How to Use

See the TUTORIAL for the full AutoSplit + OBS setup and step-by-step AutoMask walkthrough. I recommend following it even if you already have AutoSplit set up - small differences to your current setup may be significant for AutoMask to work correctly.

Live Output Tester

Click Live tester to open a real-time comparison window. It captures a live video feed from a webcam source (such as OBS Virtual Cam) and compares it against the current output image using the same L2 Norm algorithm as AutoSplit. See TESTER for details.

Presets

Presets define the sequence of splits and their mask images, thresholds, timing, and other settings for a specific game and category. They are stored in the presets/ folder next to the executable.

Click Edit next to the preset dropdown to open the preset editor, where you can create new presets, modify existing ones, and manage splits. See PRESETS for full documentation on the preset editor.

Savestates

A preset can bundle savestate files alongside its splits, letting you jump straight to the frame where each split image triggers in order to take base image screenshots easily. Each split can reference a single savestate file of any type (.gzs, .savestate, .sav, etc.) - the format isn't validated, so whatever your game/platform supports will work.

When a preset with savestates is selected, the status bar shows Savestates available and enables the Copy savestates button. Clicking it copies all savestate files in the current preset to the clipboard, renamed with the pattern {index}_{split name}.{ext} so you can paste them into your desired folder - such as your SD card - in split order. Savestate files are linked per-split in the preset editor - see PRESETS for details.

Each split with a savestate can also have free-form savestate instructions attached. If any split in the current preset has instructions, the Instructions button next to Copy savestates becomes enabled and opens a window listing every split's instructions in order.

Building from Source

Requires .NET 10 SDK. Release builds use Native AOT compilation.

# Build for your current OS
./build.ps1

# Build all platforms (uses Docker for cross-OS AOT)
./build.ps1 --all

The Linux cross-compilation requires Docker to be running.

About

Automatically mask and name images for use with AutoSplit using preset split packs.

Resources

Stars

Watchers

Forks

Releases

Used by

Contributors

Languages