LoopBud User Manual

LoopBud records incoming MIDI notes into repeating, bar-based patterns and plays them back through other MIDI instruments or its built-in sampler. Choose the loop length first, arm recording, and perform. You can overdub each pass, replace the loop on the next pass, focus playback on a single bar, change speed, build several patterns, and export the result as a Standard MIDI File.

LoopBud records MIDI note data—not microphone or instrument audio. In the standalone app, the built-in sampler lets you hear the MIDI immediately. You can also route the MIDI to another app, hardware instrument, or host instrument.

Table of Contents

  1. Quick Start
  2. How LoopBud Works
  3. Interface Overview
  4. Recording
  5. Loop Length and Bar Focus
  6. Piano Roll
  7. Undo and Redo
  8. Patterns
  9. Presets and Projects
  10. Clock and Tempo
  11. MIDI Routing and Control
  12. Built-in Sampler
  13. MIDI File Export
  14. AUv3 Plugin
  15. Settings Reference
  16. Tips
  17. Troubleshooting
  18. Links

Quick Start

  1. Open Settings and enable a source under MIDI In. Select the MIDI input channel used by your keyboard or controller.
  2. To hear LoopBud directly, leave Sampler enabled. Alternatively, enable a destination under MIDI Out and load an instrument there.
  3. Set the loop length. A new project starts with four bars. Tap Add Bar to add one bar, or long-press it to enter a total bar count.
  4. Tap Record to arm recording, then tap Play in the standalone app and perform on your MIDI controller.
  5. Leave Mode on New to replace the previous loop when you begin a new cycle, or select Add to overdub on every cycle.
  6. Tap Presets and save the current project when you want to keep it. The working project is not saved automatically.

How LoopBud Works

A LoopBud project contains one or more patterns. Each pattern has its own bar count and recorded notes. The project also stores its tempo, clock multiplier, record mode, selected pattern, and MIDI/piano-roll settings.

Each bar is four beats. LoopBud repeatedly plays the current pattern from its beginning to its end. Recording follows this same cycle. The project starts at 120 BPM with a four-bar pattern, New recording mode, 1x clock, 1/16 quantization enabled, and Align disabled.

The main musical path is:

MIDI input → channel filter → recording and live thru → loop playback → output channel → selected MIDI outputs / built-in sampler

Incoming notes are passed through while you play, even when Record is not armed. When Record is armed, those notes are also captured in the active loop range.

Interface Overview

Top controls

Control Purpose
Play Starts/stops the standalone transport. In the AUv3, it enables or mutes loop playback while the host controls transport.
Record Arms or disarms MIDI note recording.
Mode Switches between Add overdubbing and New replacement recording.
Align Moves the first note of a newly recorded cycle to the start of the active loop range.
Quantize Enables or disables a non-destructive nearest-grid projection for note starts. A dimmed icon means off.
Clock Selects 0.25x, 0.5x, 1x, 2x, or 4x loop speed.
Add Bar Tap to add one bar. Long-press to set the total bar count from 1 to 1000.

Center: piano roll

The piano roll shows note pitch vertically and time horizontally. Recorded notes appear as blocks, the moving line shows the playhead, and bar numbers run across the top. Pinch horizontally to change the displayed bar width, and scroll to navigate longer patterns or wider note ranges.

Bottom controls

Control Purpose
Patterns (CC#…) Selects a pattern. Tap + to create another pattern. The label shows the MIDI CC assigned to pattern selection.
Undo Steps back through the project history. While a recording pass is still pending, Undo cancels that pass. A dimmed button means there is nothing to undo. See Undo and Redo.
Redo Steps forward again after an Undo. A dimmed button means there is nothing to redo.
Clear Clears the focused bar, or the whole current pattern when no bar is focused.
Presets Opens factory loops and your saved projects.
Settings Opens tempo, routing, sampler, pattern, quantizer, piano-roll, export, and support options.

Recording

Arming and transport

Tap Record to arm recording. Recording happens while the transport runs and incoming MIDI notes arrive on the selected input channel. Disarming Record or stopping the transport closes held notes and commits the recording.

In the standalone app, Play operates the transport. With Ableton Link disabled, starting playback begins the pattern from the top. With Link enabled, playback joins the shared Link session position.

In an AUv3 host, the host owns the transport. Start the host transport, arm Record in LoopBud, then play into the plugin’s MIDI input.

Add mode

Add mode overdubs the notes from every pass onto the current pattern. Existing notes remain. If a new note overlaps an existing note of the same pitch, the new recording replaces the overlapping note rather than stacking two copies of the same pitch at the same time.

Use Add for layered performances: record a bass line, let the loop wrap, then add chords or percussion without erasing the earlier pass.

New mode

New mode is designed for replacing a take. After the loop wraps, the first incoming note of the new cycle clears the previous pattern and begins the replacement. The old take remains intact until you actually play that first note, so an empty cycle does not erase it.

Pattern mode

Pattern mode keeps the previous take and creates a new, empty pattern on the first incoming note after a loop wrap. The new pattern uses the same number of bars, becomes selected in the editor, and continues at the current loop position. Empty cycles do not create patterns.

Quantize

LoopBud always retains the source timing of new recordings. When Quantize is enabled, playback, the piano roll, and MIDI export project each note start to the nearest selected grid point at full strength. Set Quantization Level in Settings to:

Quantization changes note starts only; note durations remain unchanged. Turn Quantize off to play, display, and export the retained source timing again. Recordings made by older LoopBud versions may already contain permanently quantized positions and cannot recover timing that was never saved.

Align

Enable Align when you want the first performed note after a loop wrap to define the downbeat. LoopBud moves that first note to the start of the active loop range. Notes that arrive within the same quantization grid step follow it to the start; later notes retain their timing.

Align is useful when you want to begin playing naturally instead of timing the first note precisely against the playhead. It applies to each newly recorded cycle and works with either the entire pattern or a focused bar.

Loop Length and Bar Focus

Changing the number of bars

Each pattern keeps its own length. A newly added pattern starts at four bars.

Focusing one bar

Tap a bar number to focus it. The selected bar stays visible while the other bars are shaded, and playback and recording loop only that bar. Tap the focused bar again to return to the full pattern.

Clear affects only the focused bar. Recording, Quantize, and Align also use the focused bar as their active loop range. Selecting another pattern removes the bar focus.

Copying, pasting, and deleting bars

Long-press a bar number when no bar is focused to open Copy, Paste, and Delete:

Piano Roll

The piano roll is a performance display, not a note editor. You cannot drag, resize, create, or delete individual notes there. Use recording, Clear, Undo and Redo, bar operations, or another MIDI editor after export when you need to change the musical content.

The note headers react to incoming note-on and note-off messages. When recording begins, LoopBud scrolls to the first recorded pitch when that pitch is within the visible note range.

In Settings, choose the Lowest Key, Highest Key, and Key Order (High to Low or Low to High). The defaults cover MIDI notes 24–96 in High-to-Low order. Notes outside the displayed range can still pass through and be recorded; they simply do not get a visible piano-roll row until you expand the range.

Undo and Redo

LoopBud keeps one history for the whole project, so it covers every pattern. The history holds the last 20 steps. It stays when you select another pattern. Loading a preset starts a new history.

What is a step

These actions are one step each:

These actions are not steps: selecting a pattern, focusing a bar, Quantize, Align, Mode, Clock, and changes in Settings.

Undo

Tap Undo to go back one step. The piano roll and the pattern buttons update, and the pattern that the step changed is shown. If the step added or removed a pattern, that pattern list changes too. Playback continues from the same loop position with the restored notes.

If a recording pass is still pending, the first tap cancels it and brings back what was there before. In New mode that is the previous take. In Pattern mode the new pattern goes away. The next note you play starts the take again.

Redo

Tap Redo to go forward one step after an Undo. A new edit after an Undo removes the steps that Redo could have restored. Tapping Redo while a recording pass is pending cancels that pass first.

Patterns

Tap a numbered button to select a pattern. Tap + to add a new four-bar pattern. Pattern numbers shown in the app are one-based: Pattern 1 is the first pattern.

The Pattern change setting controls when a selected pattern begins:

Every pattern switch starts the selected pattern from its beginning. Long-press a pattern button for Copy, Paste, or Delete. Paste replaces the destination pattern, including its notes and bar count. A project always retains at least one pattern.

Presets and Projects

In LoopBud, presets are projects. Open Presets to:

The factory choices are 1BarLoop, 4BarLoop, 8BarLoop, 16BarLoop, 32BarLoop, and 64BarLoop. Each starts with one empty pattern of the named length.

User presets use iCloud-backed storage when available, allowing them to sync between devices signed in to the same iCloud account. Loading a preset replaces the working project and stops recording, but it does not start or stop the current transport.

Save deliberately: the working project is not automatically saved. Open Presets and save after recording or editing something you want to keep.

Clock and Tempo

Clock multiplier

The Clock menu changes the loop’s speed relative to the transport without changing its stored notes:

Setting Result
0.25x Quarter speed
0.5x Half speed
1x Normal speed
2x Double speed
4x Quadruple speed

Changing Clock preserves the current loop position as closely as possible. It affects playback phase and recording position, so confirm the Clock setting before recording precision parts.

In the standalone app, set Tempo from 10 to 500 BPM. The default is 120 BPM. Open Ableton Link in Settings to join or configure a Link session. When Link is active, LoopBud follows the shared session tempo and position.

In the AUv3, tempo and transport come from the host. The host’s tempo updates the LoopBud project while the plugin is running.

MIDI Routing and Control

Standalone MIDI ports

Under MIDI In, enable any connected source that should feed LoopBud. Virtual MIDI In exposes LoopBud In to other apps. Under MIDI Out, enable destinations that should receive live-thru and loop playback. Virtual MIDI Out exposes LoopBud Out.

Use MIDI Bluetooth to connect compatible Bluetooth MIDI devices. Available Core MIDI port names update when the system MIDI setup changes.

Channels

MIDI Input Channel and MIDI Output Channel range from 1 to 16 and default to channel 1.

Pattern selection by MIDI CC

Set Patterns CC# from 0 to 127; the default is CC 10. Send that controller on LoopBud’s selected input channel:

Value 0 is ignored, and values without a matching pattern have no effect. The Pattern change setting still determines whether the change is immediate or waits for the new cycle.

Other CC messages and pitch bend pass through to the MIDI output. LoopBud uses one MIDI cable/bus for its loop engine; the AUv3 output is named LoopBud Out.

Stuck notes

Tap MIDI Panic in the standalone Settings screen to stop notes held by LoopBud, the MIDI port manager, and the built-in sampler. Clear also silences currently sounding loop notes before the edited sequence continues.

Built-in Sampler

The standalone app includes a SoundFont sampler for immediate monitoring. Its settings are remembered between launches:

The sampler is independent of external MIDI output. You can hear the sampler and send MIDI to another destination at the same time. If the sampler asset is temporarily unavailable, LoopBud continues as a MIDI looper without built-in sound.

MIDI File Export

Open Settings → Export MIDI. Select Pattern Number, then choose:

LoopBud creates a .mid Standard MIDI File containing the recorded note pitches, positions, durations, velocities, project tempo, project name, and selected MIDI output channel. The merged export is a single continuous track; it does not layer all patterns at the same start time. The iOS share sheet lets you save or send the file.

AUv3 Plugin

Load LoopBudAUv3 as a MIDI-capable AUv3 in a compatible host, route a MIDI source into it, and route LoopBud Out to an instrument. The AUv3 shares the main LoopBud editor, patterns, recording tools, Settings, presets, and MIDI export workflow.

Important AUv3 behavior:

Automatable AU parameters

Parameter Values / behavior
Pattern 1–100 selects a one-based pattern; 0 makes no selection.
Play Button Off/On loop playback state.
Record Button Off/On recording state.
Clear Button A value above 0 triggers Clear, then resets.
Undo Button A value above 0 triggers Undo when available, then resets.
Redo Button A value above 0 triggers Redo when available, then resets.
Focused Bar 0 selects the full pattern; 1–1000 focuses a one-based bar when it exists.
Record Mode 1 = Add, 2 = New, 3 = Pattern.
Clock Speed 1 = 0.25x, 2 = 0.5x, 3 = 1x, 4 = 2x, 5 = 4x.

For reliable automation, use steady state values for Play and Record, and momentary positive values for Clear, Undo, and Redo.

Settings Reference

Section Setting Range / choices Default
Tempo Tempo 10–500 BPM 120 BPM
Sampler Sampler Off / On On
Sampler Sampler Volume 0–100% 100%
Sampler Sampler Preset Available SoundFont presets First available preset
Ableton Link Ableton Link Link session settings Disabled
MIDI In Virtual MIDI In / device ports Off / On Off
MIDI Out Virtual MIDI Out / device ports Off / On Off
MIDI Channel MIDI Bluetooth Opens Bluetooth MIDI setup —
MIDI Channel MIDI Panic Stops all sounding notes —
MIDI Settings Patterns CC# 0–127 10
MIDI Settings MIDI Input Channel 1–16 1
MIDI Settings MIDI Output Channel 1–16 1
Patterns Pattern change Immediately / On the new cycle Immediately
Quantizer Settings Quantization Level 1/64, 1/32, 1/16, 1/8 1/16
Piano Roll Lowest Key MIDI note 0–127 24
Piano Roll Highest Key MIDI note 0–127 96
Piano Roll Key Order High to Low / Low to High High to Low

The standalone-only sections—Tempo, Sampler, Ableton Link, physical/virtual MIDI ports, Bluetooth MIDI, and MIDI Panic—do not appear in the AUv3 Settings screen because the host supplies those responsibilities.

Tips

Troubleshooting

I hear no sound

LoopBud records MIDI, not audio. In the standalone app, confirm Sampler is enabled and its volume is up, or enable a destination under MIDI Out. In a host, route LoopBud Out to an instrument; a MIDI effect does not make sound by itself. Also confirm Play/host transport is running for loop playback.

Incoming notes do not appear or record

Enable the correct source under MIDI In, check that the controller and MIDI Input Channel match, arm Record, and run the transport. Expand the piano-roll key range if the notes sound but are not visible. In an AUv3 host, verify that MIDI is routed into LoopBud.

The loop plays, but an external instrument is silent

Enable the correct output under MIDI Out and match the destination to LoopBud’s MIDI Output Channel. For inter-app routing, enable Virtual MIDI Out and choose LoopBud Out in the destination app. In an AUv3 host, connect the plugin’s MIDI output to the instrument track.

A note is stuck

Open Settings and tap MIDI Panic in the standalone app. You can also stop the transport. In a host, stop playback and use the host’s MIDI panic/all-notes-off command if needed.

Recording erased my earlier loop

The record mode is New. Switch Mode to Add before the next pass when you want to overdub. In New mode, the first note after the loop wraps clears the previous take.

Quantize or Align seems ineffective

Confirm the toolbar icon is active rather than dimmed. Quantize uses the level selected in Settings and affects playback, the piano roll, and MIDI export without overwriting new recordings. Align takes effect on the first note of a newly recorded cycle; unlike Quantize, Align intentionally changes the recorded cycle's starting position.

Undo or Redo is dimmed

Undo is dimmed when there is no earlier step and no pending recording pass. Redo is dimmed when you have not undone anything, or when you made a new edit after an Undo. Selecting a pattern, Quantize, Align, Mode, Clock, and Settings are not history steps. Loading a preset starts a new history.

Only one bar repeats

A bar is focused. Tap its bar number again to return to the whole pattern. Selecting a different pattern also removes the focus.

A pattern change waits or happens too soon

Check Settings → Patterns → Pattern change. Choose Immediately for an immediate restart from the selected pattern’s top, or On the new cycle to wait for the current loop boundary.

A saved project is missing or changes were lost

The live project is not auto-saved. Save it from Presets. For iCloud sync, confirm iCloud Drive is available and allow time for the preset to appear on another device.

The AUv3 does not appear in my host

Confirm the host supports MIDI AUv3 effects and rescan or restart the host after installing LoopBud. Some hosts list MIDI effects separately from audio instruments and audio effects.

Tempo or playback position differs from expectation

In standalone mode, check Tempo, Clock, and Ableton Link. With Link enabled, LoopBud joins the shared session. In AUv3 mode, the host supplies tempo and transport; check the host loop/locate position and LoopBud’s Clock multiplier.

MIDI export contains the wrong material

For Export Pattern, verify the displayed Pattern Number. Merge All Patterns and Export concatenates patterns in order. Export uses the project tempo and current MIDI output channel.