Degenerator Manager

Manage flash loops for the Degenerator Workshop Computer card

Add Loops

Drop audio files here

WAV, MP3, OGG, or FLAC — mono or stereo, any sample rate
Audio will be resampled to 48 kHz mono and u-law companded

Flash

Not loaded

Degenerator Manual

Overview

A layered audio looper for the Music Thing Modular Workshop Computer. Record a loop, then shape it by adding and removing material like clay on a spinning wheel. Nothing is ever the same twice. Inspired by William Basinski's The Disintegration Loops.

Managing Flash Loops

Uploading loops: Use the Manager tab to add audio files. Each file is resampled to 48 kHz mono and u-law companded (1 byte per sample). You can add up to 4 loops, each up to 5.0 seconds (240,000 samples). Drag to reorder. Click a loop name to rename it. Use the trim handles on the waveform to set start and end points.

Connecting your card: For all flash operations, the card must be in BOOTSEL (flash) mode. You can enter BOOTSEL mode in three ways:

  1. Auto-reset (easiest): Click "Flash to Device" or "Sync from Device" with the card plugged in normally. If the browser supports WebSerial, it will attempt to reset the card into BOOTSEL mode automatically.
  2. Enter Bootloader button: Click "Enter Bootloader" to send a 1200-baud reset signal via WebSerial. Wait 1-2 seconds, then use Flash/Sync.
  3. Manual BOOTSEL: Hold the white BOOTSEL button on the Pico while plugging in USB. The Pico appears as a USB drive. Then use Flash/Sync.

Browsers: Chrome or Edge required (WebUSB + WebSerial support). Firefox and Safari do not support these APIs.

Sync from Device: Click "Sync from Device" to read loop data back from a connected card. This reads the flash header and all loop data, populating the editor.

Saved Slots (On-Card)

The module stores and recalls up to 4 fixed flash slots (0-3) in SLOT mode (Z held down at boot). In SLOT mode: enter STORE_SLOT by moving Z down while Big Knob is near zero in MIX or DEGRADE. Turn Big Knob to choose a slot, then press Z down to write. In SELECT_SLOT, hold Z down and turn Big Knob to choose a slot, then release Z to load it.

Controls

ControlFunction
Big KnobMix level (MIX) / Rate of change (DEGRADE). Full left freezes state
Knob XHarmonic effects: Saturation → Filter Drift → Tape Hiss
Knob YDestructive effects: Oxide Shedding → Bit Crush → Bit Rot
Z SwitchDown = RECORD (YOLO) or slot modes (SLOT), Middle = MIX, Up = DEGRADE
Boot (Z Down)Held at boot → SLOT mode (flash features enabled)
Boot (Z not Down)Not held at boot → YOLO mode (instant-on, no flash features)

Z Switch Modes

PositionModeBig KnobXY
Down (YOLO)RECORDNot used
Down (SLOT)SELECT_SLOT / STORE_SLOTSelect slot 0-3
MiddleMIXMix level (quadratic)Shapes inputShapes input
UpDEGRADECommit rate (quadratic)Harmonic FXDestructive FX

Operating Modes

The module has two operating modes, chosen at boot:

  • YOLO mode (Z not held down at boot): instant-on. Buffer starts filled with silence, plays immediately in MIX/DEGRADE. Z Down always starts RECORD. No flash slot features. Pulse In 2 always resets the loop. LED 5 pulses slowly in MIX.
  • SLOT mode (Z held down at boot): flash save/load enabled. Enters SELECT_SLOT at boot. STORE_SLOT and SELECT_SLOT available. LED 5 is steady in MIX.

Slot Modes (SLOT mode only)

SELECT_SLOT: Hold Z down at boot, or trigger Pulse In 2 while Z is down. Big Knob selects slot 0-3. Release Z to load the selected slot and return to MIX/DEGRADE. If a slot is empty, the module enters RECORD.

STORE_SLOT: From MIX or DEGRADE, move Z down with Big Knob near zero. Big Knob selects slot 0-3. Press Z down to save. Move Z up to cancel back to DEGRADE. During save, audio is muted briefly while flash is written.

Knob Reference Tracking

When entering MIX or DEGRADE, the module records the Big Knob's current position. The effect only engages once you turn past this reference, preventing accidental changes if the knob is in a sensitive position.

For example: if Big Knob is at 75% when you flip to MIX, the mix level stays at zero until you turn past 75%. The reference updates whenever you cross it in either direction.

RECORD (Z down)

Audio input writes directly into the buffer, overwriting whatever was there. Recording runs until the buffer is full (~5.0s) or you flip Z away. When full, auto-switches to MIX. Big Knob has no effect during recording.

MIX (Z middle)

The loop plays back while audio input is mixed in on top. Big Knob controls input level using quadratic scaling (knob² >> 16) so the knob must be turned further before overdub becomes audible: full left = nothing added, full right = full level. X and Y knobs shape the incoming audio before mixing. MIX is additive: building up.

DEGRADE (Z up)

The loop plays back while effects eat into the buffer: readSample → X effects → Y effects → blend with original → write back. Big Knob controls commit rate using quadratic scaling (knob² >> 15): below ~1.2% (knob < 50) = bypass/no change, full right = near-instant transformation. DEGRADE is subtractive: carving away. It never grows back.

Knob X Zones

RangeEffectDescription
0–33%SaturationEven-harmonic warmth and soft compression
33–67%Filter DriftLowpass drifts down each pass, accumulating
67–100%Tape HissWhite/pink noise shaped by envelope follower

Knob Y Zones

RangeEffectDescription
0–33%Oxide SheddingDropouts that persist across passes
33–67%Bit CrushBit depth and sample rate reduction
67–100%Bit RotRandom single-bit flips, unpredictable glitches

Inputs / Outputs

PortFunction
Audio In 1Primary audio input (loop source in RECORD, overdub in MIX)
Audio In 2Secondary audio, mixes with Audio In 1 when connected
CV In 1Adds to Big Knob (bipolar)
CV In 2Adds to Y knob (bipolar)
Pulse In 1Record trigger (rising edge starts recording)
Pulse In 2Loop reset (YOLO) / enter SELECT_SLOT (SLOT, Z Down)
Audio Out 1Processed loop output
Audio Out 2Dry Audio In 1 monitor
CV Out 1Loop position (0V to ~+2V)
CV Out 2Output envelope
Pulse Out 1Loop boundary clock
Pulse Out 2Record complete pulse

Tips

  • Default (YOLO) mode: buffer starts with silence playing. Just patch audio in and turn Big Knob to start mixing.
  • Start with Big Knob at zero when recording, so nothing layers in when auto-switching to MIX.
  • Hold Z down at boot for SLOT mode with flash save/load features.
  • In DEGRADE, turn Big Knob all left to freeze the current state.
  • There is no undo. Every change is permanent. That's the point.