u-he-preset-randomizer

Generate u-he synth presets through randomization and merging of your existing presets (genetics like).

This tool can generate random presets in three different modes:

• Generate fully random presets based on real values and value distributions in your preset library
• Randomize existing presets, with a customizable amount of randomness
• Merge multiple presets together, with randomness introduced by different ratios between them.

The randomization / merging approach is very generic as it analyzes your actual preset library and bases the random values on the resulting statistical distributions.

There are optional flags / modes that that affect the randomization:

• Narrow down the analyzed presets that are the basis for random generation.
  • E.g. by only using a sub-folder, a certain tag category, author or a favorite file export.
  • This will influence / limit the range of values in the generated presets.
• Use stable mode for more reliable, but slightly less random results
• Use binary mode, see --binary CLI arguments documentation.

It should work for all u-he synths on all platforms. Some synths may work better, due to their simpler architecture (e.g. u-he Diva, Repro). More modular synths like Bazille or Zebra also work, but you'll get more "varied" results or broken presets.

How to use

This is a CLI application that you need to run in your terminal / command line.

First you need to install the Node.js runtime. Then you can open your Terminal / Console / Command Prompt and start it by entering a command, optionally with some arguments. They start with npx u-he-preset-randomizer@latest, which will download and run the latest version of this tool:

npx u-he-preset-randomizer@latest

This will start the tool in interactive mode. It will guide you though the necessary choices. Alternatively, you can pass some arguments if you already know the choices (non interactive).

The generated patches will be put into your selected synth preset directory, under a /RANDOM folder in your user presets.

If you want to download the tool for offline use and manual updates:

# install it as a global CLI tool
npm i -g u-he-preset-randomizer

# Now you can run it without npx:
u-he-preset-randomizer

MCP Server Interface

In addition to the CLI, this tool provides a Model Context Protocol (MCP) server that allows AI assistants like Claude to interact with your u-he presets through natural conversation.

Features:

• 🔍 Search and browse your preset libraries conversationally
• 📝 Get detailed explanations of what makes presets unique
• 🎲 Generate random presets with natural language instructions
• 🔄 Create variations and merge presets through AI-assisted workflows
• 💾 Stateful sessions - select a synth once, then explore freely

Quick Setup for Claude Desktop:

Add this to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json on macOS):

{
  "mcpServers": {
    "u-he-preset-randomizer": {
      "command": "u-he-mcp-server"
    }
  }
}

Then you can ask Claude things like:

• "What synths do I have installed?"
• "Show me bass presets from Diva"
• "Create 5 variations of the '303 Bass' preset with 30% randomness"
• "Merge my favorite pad presets to create hybrid sounds"

📚 Read the full MCP Server documentation →

CLI Usage Examples

Generate Fully Randomized Presets

This command will run the randomizer to generate 3 fully randomized Diva presets. Random values will be based on real values (and their distribution) of your actual presets.

npx u-he-preset-randomizer@latest --synth Diva --amount 3

Randomize a particular Preset

This command will take one particular preset "HS

... View full README on GitHub