ArpBud 2 User Manual

ArpBud 2 is a MIDI arpeggiator. Hold or send it a group of MIDI notes, then use a step pattern to decide which held note is played on each beat, with per-step control over velocity, octave, gate, ratchet, randomisation, and probability.

Table of Contents

  1. Getting Started
  2. How the Arpeggiator Chooses Notes
  3. The Pattern Editor
  4. Step Modes
  5. Patterns, Rate, and Swing
  6. Standalone App
  7. MIDI Routing
  8. AUv3 Plug-in
  9. Settings
  10. Projects and Presets
  11. Tips
  12. Troubleshooting
  13. Links

Getting Started

  1. Create a new project, give it a name, and open it.
  2. In the standalone app, enable a MIDI input and a MIDI output in Settings. You can also enable the built-in sampler to hear the result immediately.
  3. Send or hold two or more notes on the configured MIDI input channel.
  4. Start transport with the play button in the standalone app, or start playback in your AUv3 host.
  5. Set the Note mode faders to choose the order in which held notes are played.

The default pattern has eight enabled steps. A pattern can have from zero to 1,000 steps; use the add, remove, or step-count controls at the end of the fader row to change its length.

How the Arpeggiator Chooses Notes

ArpBud sorts currently held input notes from low to high. In Note mode, each step stores an index into that sorted list: 1 means the lowest held note, 2 the next note, and so on. If a step asks for an index beyond the number of held notes, ArpBud uses the highest held note instead.

For example, with C4, C#4, D4, and D#4 held, a step sequence of 1, 3, 3, 2, 1, 4 produces C4, D4, D4, C#4, C4, D#4.

The Interval Index Count setting determines the number of selectable indexes (1–20). It does not limit how many notes you may hold.

The Pattern Editor

The horizontal fader row is the current pattern. Each column is one step.

Use the mode buttons at left to choose what the faders edit. Changing mode never erases the other values stored in a step.

Step Modes

Note

Selects the held-note index, numbered from 1. The available range follows Interval Index Count.

Velocity

Sets the outgoing MIDI note velocity from 0 to 127. New steps default to 90.

Octave

Transposes the selected note from -3 to +3 octaves. MIDI pitches are kept within the legal 0–127 range.

Gate

Sets how long the generated note is held as a percentage of its step duration. A value of TIE holds the note through the following step boundary.

Ratchet

Repeats the step 1 to 4 times within its normal duration. Each repeat uses the step’s note choice and other settings.

Random Order

Sets the chance that this step uses the global randomiser ranges instead of its own values. At 0% the step always uses its own settings; at 100% it always uses the enabled global randomisers.

Probability

Sets the chance that the step actually emits its note. At 0% it is always silent; at 100% it always plays when the step is enabled and a note is held.

Patterns, Rate, and Swing

Each project can contain multiple patterns. Tap a numbered pattern button to select it, or tap + to add a pattern. Long-press a pattern button to copy, paste, or delete it; a project always retains at least one pattern.

Rate is stored per pattern and determines the musical division between steps. Drag its knob for a continuous choice, or double-tap it to select an exact note value from the picker. Double-tap Swing to select an exact percentage. Swing offsets alternating steps; by default the even-numbered steps are delayed, but this can be changed in Settings.

Standalone App

The standalone app includes a play/stop button, a tempo control, Ableton Link support, MIDI-port management, and a built-in SoundFont sampler.

Press play to run the arpeggiator at the current tempo. In Settings, tempo can be set from 10 to 500 BPM. Ableton Link can share tempo and transport with other Link-enabled apps.

The sampler is optional. When enabled, it auditions ArpBud’s generated MIDI with its bundled piano SoundFont. Choose a sampler preset and set its volume from 0% to 100%; turn the sampler off when you only want external MIDI output.

MIDI Routing

ArpBud is a MIDI effect: connect a MIDI sender to ArpBud’s input and route ArpBud’s output to an instrument or another MIDI receiver.

In the standalone app, enable individual physical MIDI input/output ports, Bluetooth MIDI, and virtual ports in Settings. Its virtual ports are named ArpBud 2 In and ArpBud 2 Out.

AUv3 Plug-in

Load ArpBud 2 as a MIDI processor in an AUv3-capable host. Route a MIDI source into the plug-in and route its MIDI output, named ArpBud 2 Out, to a receiving instrument. The host transport provides playback state and tempo.

The plug-in exposes three automatable parameters:

AUv3 hosts save and restore the complete ArpBud project state, including patterns and settings. The supplied factory presets create blank 3-step, 4-step, 8-step, 16-step, and 32-step projects.

Settings

The shared settings screen includes:

The standalone app adds Tempo, Sampler, Ableton Link, MIDI port, Bluetooth MIDI, and MIDI Panic controls. The AUv3 plug-in shows only the settings that apply inside a host.

Projects and Presets

From the home screen, create a named project, open an existing one, or run the in-app tutorial. Standalone projects are saved when you leave the editor and are available from the Projects list. You can delete a project from that list.

In an AUv3 host, use your host’s preset and session controls to save or recall the plug-in state.

Tips

Troubleshooting

I hear no result

Confirm playback is running, hold or send notes on the configured input channel, and make sure the target pattern contains enabled steps. In the standalone app, enable an output destination or turn on the sampler. In an AUv3 host, confirm the host routes the plug-in’s MIDI output to an instrument.

The wrong notes are playing

ArpBud always sorts held notes low to high before applying Note indexes. Check the Note-mode faders, the notes currently held, and the Interval Index Count setting. An index higher than the number of held notes resolves to the highest held note.

Pattern CC does not switch patterns

Send the configured CC on the configured input channel with a value above zero. The value is the 1-based pattern number, so CC value 1 selects the first pattern. Create enough patterns for the values you plan to send.

Notes are stuck

Use MIDI Panic! in the standalone app. Also check that your controller sends note-offs on ArpBud’s configured input channel. Stopping standalone playback releases active local sampler notes; host transport stops also release scheduled generated notes.

The standalone app does not receive or send MIDI

Open the relevant input and output ports in Settings, including virtual or Bluetooth ports when required. Verify that the port connection and the channel settings agree with your controller and instrument.

Tempo or sync is unexpected

In standalone mode, check Tempo and Ableton Link. In an AUv3 host, start the host transport and verify the host tempo, since the plug-in follows the host transport context.