Micromonsta 2 Patch Tools

A comprehensive CLI tool for managing Micromonsta 2 hardware synthesizer patch presets. Generate, edit, split, group, sort, and describe .syx (SysEx) patch files with schema validation and collision prevention.

Features

Generate randomized, schema-compliant patches by category (Bass, Lead, Pad, etc.)
Edit existing bundles by replacing specific presets by position or name (with random generation or specific preset files)
Describe patch contents to see what's inside any .syx file
Split multi-preset bundles into individual preset files
Extract specific presets from bundles by position or name
Group multiple .syx files (single presets or bundles) into one bundle
Sort presets in bundles by category then alphabetically
Rename individual presets (updates both SysEx data and filename)
Change category of individual presets (updates category in SysEx data and filename)
Bundle management with automatic descriptor files for multi-preset collections
Name collision prevention when editing existing bundles
Schema validation against comprehensive JSON parameter constraints
Embedded specs with support for custom overrides

Installation

go build .

Usage

Generate New Presets

# Generate a single preset
micromonsta2-patch-tools --category Lead --count 1

# Generate a bundle of 10 presets
micromonsta2-patch-tools --category Bass --count 10

Edit Existing Bundles

# Replace presets by position with randomly generated presets
micromonsta2-patch-tools --edit bundle.syx --replace "1,3,5" --category Lead

# Replace presets by name with randomly generated presets (case-insensitive)
micromonsta2-patch-tools --edit bundle.syx --replace "happy,sad" --category Pad

# Mix positions and names with randomly generated presets
micromonsta2-patch-tools --edit bundle.syx --replace "1,warm,3" --category Keys

# Replace presets with specific single preset files
micromonsta2-patch-tools --edit bundle.syx --replace "1,3,5" --replace-with "preset1.syx,preset2.syx,preset3.syx"

# Replace by name with specific preset files
micromonsta2-patch-tools --edit bundle.syx --replace "warm,bright" --replace-with "my_bass.syx,cool_lead.syx"

# If you have fewer replacement files than targets, files will be cycled
micromonsta2-patch-tools --edit bundle.syx --replace "1,2,3,4" --replace-with "preset1.syx,preset2.syx"
# This will use: preset1.syx, preset2.syx, preset1.syx, preset2.syx

Rename Individual Presets

# Rename a single preset
micromonsta2-patch-tools --edit Lead_bright_1720000000.syx --rename "killer"

# The tool will update both the internal preset name and create a new file
# Old: Lead_bright_1720000000.syx -> 'bright' (Lead)
# New: Lead_killer_1720000001.syx -> 'killer' (Lead)

The rename feature will:

Update the preset name inside the SysEx data
Create a new file with the updated name in the filename
Remove the original file (clean replacement)
Automatically truncate names longer than 8 characters (hardware limitation)
Maintain the original category

Change Category of Individual Presets

# Change a preset's category
micromonsta2-patch-tools --edit Bass_wobble_1720000000.syx --change-category "Lead"

# The tool will update the category in SysEx data and create a new file
# Old: Bass_wobble_1720000000.syx -> 'wobble' (Bass)
# New: Lead_wobble_1720000001.syx -> 'wobble' (Lead)

# You can also rename and change category at the same time
micromonsta2-patch-tools --edit Bass_wobble_1720000000.syx --rename "awesome" --change-category "Lead"
# Old: Bass_wobble_1720000000.syx -> 'wobble' (Bass)
# New: Lead_awesome_1720000001.syx -> 'awesome' (Lead)

The category change feature will:

Update the category byte inside the SysEx data
Create a new file with the updated category in the filename
Remove the original file (clean replacement)
Maintain the original preset name (unless also using --rename)
Support all available categories: Bass, Lead, Pad, Keys, Organ, String, Brass, Percussion, Drone, Noise, SFX, Arp, Misc, User1, User2, User3

Sort Presets in Bundles

# Sort presets by category then alphabetically
micromonsta2-patch-tools --sort my_bundle.syx

The sort feature will:

Display current preset order
Sort by category (Bass → Lead → Pad → Keys → Organ → String → Brass → Percussion → Drone → Noise → SFX → Arp → Misc → User1 → User2 → User3 → Unknown)
Within each category, sort alphabetically by preset name (case-insensitive)
Create a backup file before modifying
Update the descriptor file
Show the new order and number of presets that moved

Describe Patch Contents

# See what's inside any .syx file
micromonsta2-patch-tools --describe bundle.syx

Split Bundles

# Split a multi-preset bundle into individual files (all presets)
micromonsta2-patch-tools --split bundle.syx

# Extract specific presets by position
micromonsta2-patch-tools --split bundle.syx --extract "1,3,5"

# Extract specific presets by name (case-insensitive)
micromonsta2-patch-tools --split bundle.syx --extract "warm,bright,deep"

# Mix positions and names
micromonsta2-patch-tools --split bundle.syx --extract "1,warm,5,bright"

Split vs Extract:

--split alone: Extracts ALL presets from the bundle
--split with --extract: Extracts only the specified presets

The extract feature will:

Only work with bundle files (2+ presets)
Create individual preset files for selected presets only
Support both position numbers (1-based) and preset names (case-insensitive)
Create an output directory named OriginalName_extracted
Warn about invalid positions or names that can't be found

Group Files Together

# Group multiple files into a new bundle
micromonsta2-patch-tools --group "preset1.syx,preset2.syx,bundle.syx"
micromonsta2-patch-tools --group dirname/

Command Line Arguments

Flag	Description
`--category`	(Required for generate/edit with random presets) Patch category: Lead, Bass, Pad, Keys, Organ, String, Brass, Percussion, Drone, Noise, SFX, Arp, Misc, User1, User2, User3
`--count`	(Optional) Number of unique patches to generate. Default: `1`
`--specs`	(Optional) Path to custom spec directory. Default: `specs`
`--edit`	Path to existing `.syx` file to edit
`--replace`	Comma-separated list of preset positions (1-based) or names to replace
`--replace-with`	Comma-separated list of single preset `.syx` files to use as replacements
`--describe`	Path to `.syx` file to describe contents
`--split`	Path to `.syx` file to split into individual preset files
`--extract`	Comma-separated list of preset positions (1-based) or names to extract from bundle
`--group`	Comma-separated list of `.syx` files or directories to group into a bundle
`--sort`	Path to `.syx` file to sort presets by category then alphabetically

Output Structure

Single Preset

presets/
└── Lead_bright_1720000000.syx

Bundle (Multiple Presets)

presets/
└── Happy/
    ├── happy_bundle_1720000000.syx          # Combined bundle
    ├── happy_bundle_1720000000.txt          # Descriptor file
    ├── Lead_bright_1720000000.syx           # Individual presets
    ├── Lead_warm_1720000000.syx
    └── Bass_deep_1720000000.syx

Split Output

presets/
└── OriginalBundle_split/
    ├── Lead_bright_1720000000.syx
    ├── Bass_deep_1720000000.syx
    └── Pad_warm_1720000000.syx

Extract Output

presets/
└── OriginalBundle_extracted/
    ├── Lead_bright_1720000000.syx           # Only extracted presets
    └── Pad_warm_1720000000.syx

Group Output

presets/
└── Grouped/
    ├── grouped_grouped_1720000000.syx       # Combined bundle
    ├── grouped_grouped_1720000000.txt       # Descriptor file
    └── [individual preset files...]

Example Workflows

Create and Manage a Custom Bundle

# 1. Generate some presets
micromonsta2-patch-tools --category Lead --count 5
micromonsta2-patch-tools --category Bass --count 3

# 2. Group them together
micromonsta2-patch-tools --group "presets/Lead_*.syx,presets/Bass_*.syx"

# 3. Check what's inside
micromonsta2-patch-tools --describe presets/MyBundle/mybundle_grouped_*.syx

# 4. Sort presets by category and name
micromonsta2-patch-tools --sort presets/MyBundle/mybundle_grouped_*.syx

# 5. Replace a few presets with random ones
micromonsta2-patch-tools --edit presets/MyBundle/mybundle_grouped_*.syx --replace "2,5" --category Pad

# 6. Or replace with specific preset files
micromonsta2-patch-tools --edit presets/MyBundle/mybundle_grouped_*.syx --replace "1,3" --replace-with "my_favorite.syx,another_great.syx"

# 7. Split if needed
micromonsta2-patch-tools --split presets/MyBundle/mybundle_grouped_*.syx

Replace Presets with Specific Files

# See what you have
micromonsta2-patch-tools --describe my_bundle.syx
# Output:
# 1: oldlead (Lead)
# 2: oldbass (Bass)
# 3: oldpad (Pad)

# Replace specific positions with your own presets
micromonsta2-patch-tools --edit my_bundle.syx --replace "1,3" --replace-with "perfect_lead.syx,amazing_pad.syx"

# Replace by name
micromonsta2-patch-tools --edit my_bundle.syx --replace "oldbass" --replace-with "killer_bass.syx"

# Replace multiple presets with cycling through fewer files
micromonsta2-patch-tools --edit my_bundle.syx --replace "1,2,3,4" --replace-with "preset_a.syx,preset_b.syx"
# Will use: preset_a, preset_b, preset_a, preset_b

Organize and Manage Individual Presets

# Rename a preset for better organization
micromonsta2-patch-tools --edit Bass_adjective_1720000000.syx --rename "wobble"

# Change a preset's category
micromonsta2-patch-tools --edit Bass_wobble_1720000001.syx --change-category "Lead"

# Do both at once
micromonsta2-patch-tools --edit Lead_wobble_1720000002.syx --rename "awesome" --change-category "Pad"

# Generate some presets
micromonsta2-patch-tools --category Lead --count 3

# Organize them by renaming and categorizing
micromonsta2-patch-tools --edit Lead_random1_*.syx --rename "arp1" --change-category "Arp"
micromonsta2-patch-tools --edit Lead_random2_*.syx --rename "arp2" --change-category "Arp"
micromonsta2-patch-tools --edit Lead_random3_*.syx --rename "arp3" --change-category "Arp"

# Group them into a bundle
micromonsta2-patch-tools --group "Arp_arp1_*.syx,Arp_arp2_*.syx,Arp_arp3_*.syx"

Organize Existing Bundles

# See current organization
micromonsta2-patch-tools --describe messy_bundle.syx
# Output might show:
# 1: warm (Pad)
# 2: deep (Bass)
# 3: bright (Lead)
# 4: cool (Bass)
# 5: soft (Pad)

# Sort to organize better
micromonsta2-patch-tools --sort messy_bundle.syx
# New order will be:
# 1: cool (Bass)
# 2: deep (Bass)
# 3: bright (Lead)
# 4: soft (Pad)
# 5: warm (Pad)

Edit Existing Bundles

# See what's in your bundle
micromonsta2-patch-tools --describe my_bundle.syx
# Output:
# 1: happy (Lead)
# 2: warm (Bass)
# 3: bright (Pad)

# Replace with randomly generated presets
micromonsta2-patch-tools --edit my_bundle.syx --replace "warm,3" --category Keys
# This replaces "warm" and position 3 with new random Keys presets

# Replace with specific preset files
micromonsta2-patch-tools --edit my_bundle.syx --replace "1,warm" --replace-with "my_lead.syx,perfect_bass.syx"
# This replaces position 1 with my_lead.syx and "warm" with perfect_bass.syx

# Rename a single preset
micromonsta2-patch-tools --edit Lead_bright_1720000000.syx --rename "killer"
# This renames the preset internally and creates a new file

# Change category of a single preset
micromonsta2-patch-tools --edit Bass_wobble_1720000000.syx --change-category "Lead"
# This changes the category and creates a new file

# Rename and change category at the same time
micromonsta2-patch-tools --edit Bass_old_1720000000.syx --rename "new" --change-category "Pad"
# This does both operations and creates a new file

Synthesizer Compatibility

Micromonsta 2 firmware compatible with patch format
Use MIDI SysEx transfer tools to load .syx files:
- SysEx Librarian (macOS)
- MIDI-OX (Windows)
- SendMIDI (Cross-platform)

Technical Details

JSON Schema & Specs

micromonsta_patch_schema.json defines valid parameter ranges and constraints
specs/*.json files provide category-specific parameter metadata
Custom specs can be provided with --specs flag

Name Collision Prevention

When editing bundles, new preset names won't conflict with existing ones
Case-insensitive duplicate detection
Multiple replacements in one session are handled safely

Sort Algorithm

Primary sort: By category in a predefined order (Bass → Lead → Pad → etc.)
Secondary sort: Alphabetically by preset name (case-insensitive)
Stable sort: Presets with identical names maintain their original relative order
Backup: Creates a timestamped backup before modifying the original file

File Format

Standard MIDI SysEx format
176 bytes per patch
Embedded category and name information
Compatible with Micromonsta 2 hardware

License

MIT — use freely, modify safely, share joyfully.

Credits

Inspired by Micromonsta 2
Uses gojsonschema and go-randomdata

Name		Name	Last commit message	Last commit date
Latest commit History 44 Commits
presets		presets
specs-clops		specs-clops
specs-clsnt		specs-clsnt
specs-gp41		specs-gp41
specs-gp45		specs-gp45
specs-gpo4		specs-gpo4
specs-ms41		specs-ms41
specs-mso4		specs-mso4
specs-psytrance		specs-psytrance
specs-techno		specs-techno
specs-v1fc		specs-v1fc
specs		specs
.gitignore		.gitignore
Bass_Ancient_1749423125.syx		Bass_Ancient_1749423125.syx
LICENSE		LICENSE
P292_Init.syx		P292_Init.syx
README.md		README.md
go.mod		go.mod
go.sum		go.sum
main.go		main.go
micromonsta_patch_schema.json		micromonsta_patch_schema.json

Navigation Menu

Repository files navigation

Micromonsta 2 Patch Tools

Features

Installation

Usage

Generate New Presets

Edit Existing Bundles

Rename Individual Presets

Change Category of Individual Presets

Sort Presets in Bundles

Describe Patch Contents

Split Bundles

Group Files Together

Command Line Arguments

Output Structure

Single Preset

Bundle (Multiple Presets)

Split Output

Extract Output

Group Output

Example Workflows

Create and Manage a Custom Bundle

Replace Presets with Specific Files

Organize and Manage Individual Presets

Organize Existing Bundles

Edit Existing Bundles

Synthesizer Compatibility

Technical Details

JSON Schema & Specs

Name Collision Prevention

Sort Algorithm

File Format

License

Credits

About

Releases

Packages

Contributors

Languages

Folders and files

Latest commit

History

Repository files navigation

Micromonsta 2 Patch Tools

Features

Installation

Usage

Generate New Presets

Edit Existing Bundles

Rename Individual Presets

Change Category of Individual Presets

Sort Presets in Bundles

Describe Patch Contents

Split Bundles

Group Files Together

Command Line Arguments

Output Structure

Single Preset

Bundle (Multiple Presets)

Split Output

Extract Output

Group Output

Example Workflows

Create and Manage a Custom Bundle

Replace Presets with Specific Files

Organize and Manage Individual Presets

Organize Existing Bundles

Edit Existing Bundles

Synthesizer Compatibility

Technical Details

JSON Schema & Specs

Name Collision Prevention

Sort Algorithm

File Format

License

Credits

About

Topics

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages