Skip to content

About

Euclidian drum machine card for MusicThingModular Workshop system

Topics

Resources

Stars

2 stars

Watchers

1 watching

Forks

Repository files navigation

Compulidian

A mutating Euclidean drum machine for the Music Thing Workshop Computer, with sample playback, CV control and clocking.

Beta firmware, updated 17 November 2026. Please report issues through the project page.

Get started

Choose the firmware for your card:

Connect the card to your computer and open the Compulidian web manager in a Web MIDI-capable browser such as Chrome. Use it to choose or edit sample banks and change settings.

What it does

  • Generates around 16 independent Euclidean drum patterns, with phrase changes and a variation fill on the last bar of each four-bar phrase.
  • Plays the built-in 808 kit or user sample banks through Audio Out 1. Audio Out 2 outputs a 16th-note clock gate; four pulse/CV outputs provide drum gates.
  • Main and X control the density of two track groups, with CV1 and CV2 modulation. Audio In 1 controls shuffle; Audio In 2 controls sample pitch.
  • Syncs to its internal tempo, USB MIDI clock, or CV clock on firmware that supports CV clock input.

Performance controls

Control Action
Main + CV1 First group of drum patterns: density
X + CV2 Second group of drum patterns: density
Y Internal tempo, 30-180 BPM
Switch UP (hold) Locks the pattern seed; fills and density changes continue
Switch DOWN Mutes new notes; can be configured for sample-bank selection
Audio In 1 / 2 Shuffle / sample pitch
Pulse In 1 / 2 CV clock reset / clock, when supported by the firmware

Use the web manager

Connect over USB, open the web manager, and choose a Playing bank to change the sound. Use Edit bank to edit one of the user banks. Settings apply live; use Save settings to keep them after reboot. Bank edits and sample tags have their own save actions.

On 16 MB firmware, you can also hold Switch DOWN while powering on to choose a bank and set the switch role without the web manager. Playback continues during setup.

Serial connection commands

You can connect via serial (e.g. using Putty or Arduino Serial Monitor) to send commands and receive feedback from the Compulidian:-

Available commands:
Parameter debug commands:
  I            - stream parameter input info to console
  d i <index>  - toggle debug on a parameter input
Sample player commands:
  s            - toggle sample interpolation on/off
  c            - toggle calculate mode between main loop and audio worker
  v            - toggle volume on/off
Seqlib commands:
  f            - toggle fills on/off
  state        - dump controls, clock, pattern and held-note state
  clock-state  - dump BPM, pulse/reset counts, queue losses and strict clock state
Kit bank commands:
  b            - print bank detection status
  B <slot>     - switch to bank slot <slot>
  l            - list track patterns and assigned voice samples
  lx           - list track patterns and assigned voice samples (extended)
  p <pattern>  - trigger named pattern
  X            - send sysex config to host
  y            - dump saveloadlib settings tree
  Y            - dump sample store status
Clock commands:
  play         - start the clock
  stop         - stop the clock
  clock-internal       - set clock mode to internal
  clock-external-cv    - set clock mode to external CV
  clock-external-cv-ppqn <1|2|4|8|12|16|24> - set live CV PPQN (currently 1)
  transitions       - (debug) show pulse input transitions
  clock-external-usb   - set clock mode to external USB host
  V            - dump version/build information
  help         - show this help message

More information

See README-MORE.md for detailed bank setup, clock and RESET options, web-manager workflows, diagnostics, serial commands, and build instructions. Hardware and driver notes are in ComputerCard-notes.md.

Known issue: ADC readings can fluctuate, most noticeably as sample-pitch variation. Feedback and collaboration are welcome.

About

Euclidian drum machine card for MusicThingModular Workshop system

Topics

Resources

Stars

2 stars

Watchers

1 watching

Forks

Releases

Packages

Contributors

Languages