plugin manager · original OP-1 · firmware 246

Pick your mods.

Opus 1 was a pack. Opus 2 is the loader: a small core, and every feature a plugin file you copy onto the OP-1's disk. Add one, remove one, swap them. No reflashing.

opus 2 · public beta 2

screen
keys
plugin

How it works

Opus 2 is a small core that lives in the firmware, and plugins that live on the OP-1's disk. The core owns every hook into the OS and hands each plugin the services it asks for: effects, engines, pages, settings, storage. A plugin never patches the firmware on its own.

1.1A plugin is a file

Copy a .opmod file into the disk's mods folder. At the next start the core reads each file's description, checks it and loads it, and the menu's mods page lists it with its CPU and memory. Take the file out and it's gone, with nothing left behind in the firmware. The whole starter pack, loaded, takes 1.27 MB of the plugins' 6 MB.

OP-1 disk/ mods

    1.2Every plugin on a budget

    The OP-1 makes its sound in blocks, and each block has 580,525 CPU cycles to share. The core times every plugin's audio work in every block and keeps its worst one, so you can see what a plugin costs before it costs you a glitch. The pack's heaviest plugins, by their worst block:

    Measured in an emulator running the OP-1's own firmware, with its cache timing. On the developer's OP-1, dx's worst block came out at 93k cycles against the emulator's 84k.

    worst block, share of one audio block

      1.3Any plugin can be a manager

      A plugin can provide types of module: effects, engines and sequencers for now, LFOs later. Any plugin may run effects too, so an effect you download works everywhere effects go: in the OP-1's own effect slots, and in every plugin that runs effects, without its author ever knowing. Fx overdrive is the first such manager: it runs a second effect behind every sound's and the master's.

      types bitcrushchorusplatefilteryours
      any manager runs any type
      managers the OP-1's effect slotsfx overdriveany plugin

      1.4Checked, never forced

      Before a plugin changes a place in the firmware, the core checks the place is still stock, and a place holds one plugin. When two plugins want the same place or the same keys, the one later by file name is refused, and the mods list says which plugin has them, before anything breaks. So is a plugin that needs another one, a library, that's missing or too old. A plugin that crashes the OP-1 is left out at the next start, and one that takes far more CPU than it should is switched off. Hold stop while switching on to start without any.

      1.5Where stock features live

      Effects sit in the OS's effect list and engines in its engine list, each with its own pages and a shift layer, drawn by the OS's own renderer. Nothing hides in a menu of its own unless it has to.

      1.6Your sounds stay

      A sound that needs a plugin you've removed is kept exactly as it is, and the OP-1 tells you which plugin it needs. Put the plugin back and it plays again. Sounds saved with Opus 1 carry over.

      The starter pack

      Every Opus 1 feature, rebuilt as a plugin, and three new ones. Take them all, or only the ones you want: each is one file.

      2.1New in Opus 2

      2.2Opus 1, as plugins

      2.3New in the core

      Diagnostics

      A task manager on the menu's T3. Processes lists the audio, every plugin, the core and each of the OS's threads with their CPU and memory. Performance draws the audio's load over the last minute, memory maps the OP-1's 64 MB, and system shows the battery, uptime and build. It only measures while it's on screen.

      Voices

      The system menu sets how many voices the synth plays, 1 to 6, and how many the unison mode stacks. Fewer voices leave more CPU for heavy engines and effects.

      Date and time

      The OP-1's own clock screen has a row in the system menu now. Stock opened it with shift + help, and help is Opus's FN key: hold it for a plugin's extra controls.

      2.4Fixed in the stock OS

      Bugs in TE's own firmware that the core fixes, with or without plugins. Each was found and checked in an emulator running the OP-1's own firmware.

      • The USB disk on Windows. Stock's USB code went deaf after a computer reset the connection or woke it from power saving, and Explorer froze on the OP-1's folders until the cable came out. Opus 2 sets the connection up again in a fraction of a second. USB MIDI too.
      • Recording wore out good flash. Stock wrote the tape from a buffer the recording kept filling, so the flash's check after each write failed and good blocks were marked bad for good. Opus writes from a copy, and the storage page (menu, T4) now counts the flash's dead blocks. Credit to op1r, whose release notes also pointed at it.
      • Saves cut off by a crash, stop or the power switch are undone at the next start, not left half done.
      • Out of memory in long sessions. The sound database has twice stock's memory; big preset lists used to fill it until the OP-1 stopped.
      • A large shape on the screen no longer stops the OP-1 when the next one is drawn.
      • Keys pressed while disk mode starts on a nearly full flash no longer stop the OP-1.
      • From Opus 1: disk mode no longer leaks a file handle for every sampler preset, or moves on into never-written flash every session.

      Install

      Two parts: the core, made in your browser from your own copy of TE's firmware 246 and installed like any OP-1 update, and the plugins, copied onto the OP-1's disk. Recovery, te-boot, is never changed, so the way back is always there.

      3.1The core

      1. Back up first: in disk mode (com, then T1) copy your tape, synth and drum folders to a computer.
      2. Make the update in the patcher, from your own op1_246.op1. It runs in your browser; nothing is uploaded.
      3. Switch the OP-1 off, hold com and switch it on. Press 1 (upload firmware) in the TE-BOOT menu, never 7 or 8, which erase.
      4. Connect it, copy the update onto the OP-1 disk and eject it. The OP-1 installs it and restarts. It goes over stock, Opus 1, op1r or Hundekraft, and your sounds, presets and tape stay.

      3.2The plugins

      1. Download the starter pack from GitHub, or single plugins from their cards' info, and unzip it.
      2. Put the OP-1 in disk mode (com, then T1) and drag the pack's mods folder onto the disk. It merges with the one there.
      3. Leave disk mode. The OP-1 loads the plugins at its next start, and Opus's menu (synth drum tape mixer together) lists them on T2.

      3.3Current version

      opus 2 beta 2 beta

      core
      · 2026-10-29
      update file
      SHA-256
      made from
      op1_246.op1 (#246), your own copy
      plugins
      20 in the starter pack:
      its SHA-256

      3.4Add, remove, swap

      A plugin in mods is installed; take it out and it's gone at the next start. Updating one is replacing its file. On the mods page, push for a plugin's settings, for its controls, for its details. A sound whose plugin is gone shows "needs" and its name, and plays again once it's back.

      3.5Back to stock

      Opus's menu, T1, the cleaner: turn to ask for a clean and switch the OP-1 off and on. Your data is then ready for stock or op1r, and Opus keeps a copy of what it changed. Install TE's firmware the same way you installed Opus.

      3.6Back to Opus 1

      No cleaner needed: install Opus 1 from its patcher and it starts on Opus 2's sounds, keeping every one. Its own settings, such as colours, start at their defaults.

      The bridge

      Coming from op1r or Hundekraft? The bridge runs their synth engines, effects and sequencers on Opus 2 as they are, with their own screens and pages, and the sounds you saved with them play. It's a download of its own, not part of the starter pack.

      An unstable alpha: expect it to break now and then. It lets you bring what you have, but Opus's own plugins run much better on Opus 2. They're made for its core (its CPU budget and measurements, its memory, settings and pages), while a bridged plugin runs through a layer that stands in for the firmware it was written for.

      4.1Bring your plugins

      1. Install Opus 2 as in 3.1. Your sounds, presets and tape stay, and so do the plugin files op1r or Hundekraft put on the OP-1.
      2. Download bridge.opmod and copy it into the disk's mods folder, next to the starter pack's.
      3. Plugin files you download later (.op1p, .knl) go into mods/bridge.
      4. On the mods page, push on the bridge's row: it lists every file it found, what loaded and why a file didn't.

      4.2What it runs

      op1r's synth engines, effects and sequencers (.op1p) and Hundekraft's (.knl), in the OP-1's engine, effect and sequencer lists. The sequencers (since bridge 0.8.0): op1r's chord, dots, euclid, grids, oracle and peal, Hundekraft's c64arp, dots, euclid, oracle and peal, on shift + the sequencer key, their patterns saved. Tested in the emulator with op1r 45's eight synths and two of its effects, and on the developer's OP-1 with Hundekraft synths, an op1r effect and the sequencers.

      4.3The download

      The bridge's settings page: two Hundekraft synths and an op1r effect loaded, a broken file refused

      bridge alpha

      file
      memory
      cpu
      the plugins it runs, measured like any other
      SHA-256

      4.4Not bridged yet

      LFOs (Hundekraft's quad) and the other features (chord and scale modes, midiseq), drum and sampler engines, and engines that play samples: they need their own firmware's core. Not every sound from another firmware will play.

      4.5Names and CPU

      A plugin whose name is taken, by one of Opus's own or by the same plugin from the other firmware, isn't loaded, and the bridge's list says so. The bridge's CPU on the mods page is the plugins it runs: a heavy synth in chords with heavy effects can leave the OP-1 short.

      4.6The way back

      Still the cleaner, bridge or not (3.5): it makes your data ready for stock or op1r.

      op1r is by popcorp and Hundekraft's firmware by Hundekraft. Every bridged plugin stays its author's work.

      Beta

      Opus 2 runs on the developer's own OP-1 every day, but a beta is where it meets everyone else's. It stays a beta until it has run long enough, on enough OP-1s, without trouble.

      5.1Found a bug?

      Report it on GitHub, with the core's build and the plugin list from the mods page, what you pressed and what happened. A photo of the screen helps.

      5.2Known issues

      With a colour theme, the dim edges of text in a colour other than green can look green on the OP-1's screen. TE's own screens show it too: it's the panel, not Opus. With USB plugged in, holding stop at power-on makes the logo take longer. In the bridge, an alpha: swapping effects between bridged plugins can stop the OP-1 as you leave the effect list, and a colour theme misses some shades on bridged plugins' pages (a plugin ported to Opus 2 takes the theme in full). Nothing else known.

      5.3Making plugins

      The plugin kit is on GitHub: guides and the full API reference, the SDK headers, the build tool, four example plugins (bitcrush, zoom, halloween and outatime) and instructions any AI agent can follow, all GPL-3.0. With it comes the core's developer mode (in the system menu, off by default); the emulator and the dev port's tools come after the beta. Plugin ideas are welcome in Discussions and on op-forums, and the mod registry keeps the names and numbers mods share.