ScratchBud User Manual

ScratchBud turns recorded samples or live incoming audio into a playable virtual record. Drag the vinyl to scratch by hand, let the motor play the buffer, automate the playhead with an LFO, shape the result with a resonant low-pass filter, and perform cuts with the crossfader.

ScratchBud is available as both a standalone iOS app and an AUv3 Music Effect. In the standalone app, Live means the device microphone. In the AUv3, Live means the audio track feeding the effect.

Table of Contents

  1. Quick Start
  2. Interface Overview
  3. Choosing an Audio Source
  4. The Vinyl and Waveform
  5. Play, Stop, and Cue
  6. Crossfader
  7. LFO Scratching
  8. Filter
  9. Live Recording
  10. Signal Flow
  11. MIDI Control
  12. Using the AUv3 Plugin
  13. Settings Reference
  14. AUv3 Automation Reference
  15. Tips and Starting Points
  16. Troubleshooting
  17. Links

Quick Start

  1. Choose Aaah or Fresh from Source for an immediate scratch sound.
  2. Move the Crossfader fully right to +1 so you hear only ScratchBud's processed output.
  3. Tap Play to start the record, or drag the vinyl vertically to scratch it by hand.
  4. Set a comfortable normal playback rate with Speed.
  5. For automatic motion, tap LFO, choose a waveform, set Rate, Amount, and Offset, then make sure Play is active.
  6. Use Cutoff and Reso to shape the scratch sound.

To scratch incoming audio instead, select Live. Grant microphone permission in the standalone app, or insert the AUv3 as a Music Effect on an audio track in your host.

Interface Overview

Control What it does
Vinyl and waveform Shows the current buffer and playhead. Drag vertically to scratch forward or backward.
Source Selects Live, Aaah, Fresh, or Load.
LFO Wave Selects Sine, Tri, Saw, or R Saw.
Speed Sets motor playback speed when the LFO is not controlling the playhead.
Rate Sets LFO frequency, or the tempo multiplier/divider when Sync is on.
Amount Sets how much of the buffer the LFO scans.
Offset Moves the LFO scan region around the buffer.
Cutoff Sets the low-pass filter cutoff.
Reso Sets filter resonance.
Crossfader Blends dry incoming audio on the left with ScratchBud's processed output on the right.
Play / Stop Starts or stops the virtual platter.
Cue Stores a cue while stopped or jumps to it while playing.
Rec Starts or stops capture in Live mode. It is hidden for sample sources.
LFO Enables or disables LFO playhead control.
Sync Switches the LFO between Hz and tempo-synced rates.
Settings icon Opens MIDI, crossfader, vinyl, recording, filter, tempo, and support options.

In portrait orientation, the vinyl sits above the controls. In landscape, it sits beside them; Horizontal position in Settings chooses the left or right side.

Choosing an Audio Source

Open Source and choose one of the following:

Imported stereo files remain stereo. Mono files are played through both output channels. ScratchBud adapts files to the current audio sample rate when necessary.

Selecting Aaah or Fresh clears the currently loaded custom sample from ScratchBud, so use Load again when you want to return to it. When you leave Live mode, the current live buffer is retained so it can be restored if you return during the same saved state or plugin session.

The Vinyl and Waveform

The circular display represents the entire loaded or recorded buffer. The waveform gives a visual overview, the needle shows the current playhead, and the cue marker shows the saved cue point.

Drag vertically anywhere on the vinyl:

Scratch speed follows the speed of your gesture rather than the length of the loaded file or the size of the screen. A longer file still requires more total dragging to travel across the whole waveform. Vinyl sensitivity changes the gesture response, while Release friction changes how quickly the record catches the motor after you let go.

The buffer wraps continuously at its ends. ScratchBud smooths abrupt playhead changes and reduces harsh aliasing during fast movement, but very resonant filtering or extreme flicks can still produce intentionally aggressive results.

Touching the vinyl temporarily takes control from the LFO. When you release it, motor or LFO motion resumes according to the active controls.

Play, Stop, and Cue

Play and Stop

Tap Play to start the virtual platter. The button changes to Stop while active. Without the LFO, the platter follows the Speed setting. With the LFO enabled, playing causes the LFO to scan the chosen region of the buffer.

Tap Stop to stop motor-driven and LFO-driven playback. You can still scratch manually while stopped. The record accelerates and decelerates with a short physical-style response rather than switching speed instantaneously.

Cue

The cue point is stored as a position within the current buffer. Loading a different source changes the audio under that position.

Crossfader

The crossfader blends two paths:

“Dry incoming audio” means the microphone or AUv3 host track, even when the vinyl source is Aaah, Fresh, or a loaded file. In the standalone app, the microphone is muted when a sample source is selected, so the far-left side may be silent in that situation.

The normal crossfader can be dragged freely. Settings also offers momentary hardware-style behaviors in which touching the crossfader jumps it to open, closed, or middle, and releasing returns it to a chosen default:

Behavior While touched On release
Normal Follows your drag Stays where released
Tap to open, middle default +1 0
Tap to open, closed default +1 -1
Tap to close, open default -1 +1
Tap to close, middle default -1 0
Tap to middle, closed default 0 -1
Tap to middle, open default 0 +1

The same momentary logic is available from a configurable MIDI note.

LFO Scratching

The LFO automatically moves the playhead through a portion of the buffer. Tap LFO to enable it; the button and the ring around the vinyl turn green. The ring shows the region selected by Amount and Offset.

The LFO controls the playhead only while Play is active and the vinyl is not being touched.

LFO controls

Waveforms

Tempo sync

Tap Sync to replace the Hz rate with one of these host/standalone tempo ratios:

1/16, 1/8, 1/4, 1/2, x1, x2, x4, x8, x16

At x1, the LFO completes one cycle per beat. The fractional settings are slower, up to one cycle every 16 beats; the multiplied settings are faster, up to 16 cycles per beat.

The standalone app uses the BPM in Settings, from 10 to 500 BPM and initially 120 BPM. The AUv3 follows the tempo supplied by the host.

Filter

Cutoff and Reso control a resonant low-pass filter on the processed vinyl path:

The filter does not alter the dry input side of the crossfader. Disable the complete tone-filter stage with Settings → Low Pass Filter → Enabled. ScratchBud's separate high-speed scratch smoothing remains active to control aliasing.

Live Recording

Live mode uses a continuously wrapping three-second stereo buffer. New incoming audio overwrites the oldest material, like a short loop of tape.

  1. Select Live.
  2. In the standalone app, allow microphone access. In the AUv3, send audio into the plugin's track.
  3. Make sure Rec is active; its label is red while recording.
  4. Let audio enter the buffer, then drag the vinyl or press Play to hear it through the processed path.
  5. Tap Rec again to stop or resume capture without leaving Live mode.

Recording is suspended while you hold and scratch the vinyl so the material under your hand is not overwritten. When you release, capture resumes if Rec is still active.

Record after the playhead determines where writing resumes after scratching:

Because the buffer is circular, recording longer than three seconds always replaces older audio.

Signal Flow

ScratchBud keeps the incoming and processed paths separate until the crossfader:

  1. The microphone or AUv3 track feeds the dry path and, in Live mode, the three-second recording buffer.
  2. The selected sample or live buffer is read at the moving vinyl playhead.
  3. Fast scratching receives speed-aware smoothing.
  4. The optional resonant low-pass filter shapes the vinyl path.
  5. Short declick crossfades smooth playback starts, stops, wraps, source changes, and LFO jumps.
  6. The crossfader blends dry input with processed vinyl audio.
  7. DC blocking and soft limiting protect the final stereo output.

The output has no intentional look-ahead latency. Host bypass sends the unprocessed input directly through the AUv3.

MIDI Control

ScratchBud uses one MIDI note as a momentary crossfader trigger.

Setup

  1. Open Settings → MIDI Settings.
  2. Set MIDI In Channel from 1 to 16. The default is channel 1.
  3. Set Crossfader trigger note from MIDI note 0 to 127. The default is C3 (60).
  4. In the standalone app, enable Virtual MIDI In or enable a listed hardware/app MIDI input.
  5. In an AUv3 host, route MIDI notes to the ScratchBud effect instance if the host supports MIDI-controlled audio effects.

A matching note-on moves the crossfader to the “while touched” position for the selected behavior. The matching note-off returns it to the behavior's default. Velocity is ignored. Notes on other channels or note numbers are ignored.

With Normal behavior, note-on moves the crossfader to +1 and note-off moves it to -1. This MIDI action does not prevent you from dragging the normal crossfader on screen.

The standalone app exposes a virtual input named ScratchBud In. Enabled physical MIDI input choices are remembered. ScratchBud does not generate musical notes or require a MIDI output, and there is no MIDI panic operation needed for note generation. If a missing note-off leaves the crossfader in its triggered position, send the note again with a proper note-off or move the crossfader manually.

Using the AUv3 Plugin

ScratchBud registers as a stereo AUv3 Music Effect named Cem Olcay: ScratchBud.

  1. Add ScratchBud to an audio track's effect slot in an AUv3 host.
  2. To scratch the host track itself, choose Live.
  3. To scratch Aaah, Fresh, or a loaded file over the track, choose that sample source and use the crossfader to blend it with the dry host input.
  4. For synced LFO motion, enable LFO, Sync, and Play, then start host playback so the host supplies tempo.
  5. Route a MIDI note to the effect if you want crossfader cuts from a controller or sequencer.

Host automation

The host can automate ScratchBud's parameter tree, including playhead position, scratch position, transport, source, crossfader, LFO, and filter controls. Automation is applied at its scheduled sample offset when the host supplies timestamped events.

For hand-style automation, write repeated Scratch Position values while the gesture is active. ScratchBud releases the virtual record after about 0.2 seconds of rendered audio without a new Scratch Position value.

State and presets

If a host restores a session before opening the plugin interface, allow a moment for larger saved sample buffers to be restored.

Settings Reference

Standalone-only sections

Setting Range or choices Purpose
BPM 10–500 Tempo used by the synced LFO in the standalone app.
Virtual MIDI In On / Off Creates or removes the ScratchBud In endpoint.
MIDI input list On / Off per source Connects available hardware or app MIDI inputs.

Shared standalone and AUv3 settings

Section Setting Choices / range Purpose
MIDI Settings MIDI In Channel 1–16 Channel accepted by the trigger note.
MIDI Settings Crossfader trigger note 0–127 Note-on/note-off used for momentary cuts.
Crossfader Behaviour Seven modes Chooses free dragging or a touch/release action pair.
Vinyl Release friction High, Normal, Low Controls how quickly the released record catches the platter or settles.
Vinyl Vinyl sensitivity Low, Normal, High Scales response to vertical scratch gestures.
Vinyl Speed fader range Narrow, Normal, Wide Sets the intended motor range: 0.5–2x, 0.25–4x, or 0.125–8x.
Vinyl Horizontal position Left Side, Right Side Chooses the vinyl side in landscape.
Live Recording Record after the playhead On / Off Chooses the resume point after scratching.
Low Pass Filter Enabled On / Off Enables the user-controlled cutoff/resonance filter.
Support Tutorial — Starts the in-app guided walkthrough.
Support Review, Other Apps, Feedback — Opens App Store or email support actions.

Crossfader Behaviour and vinyl Horizontal position are shared and retained across the standalone app and AUv3. Standalone MIDI input connections are also remembered. AUv3 project and preset state is managed by the host.

AUv3 Automation Reference

Host parameter Range / values Function
Input Source 0 Live, 1 Aaah, 2 Fresh, 3 Load Selects the current source. Load restores the custom sample already stored in state unless a new file is chosen in the UI.
Playhead Position 0–1 Seeks to an absolute normalized point in the buffer.
Scratch Position 0–1 Drives hand-style scratch position; refresh continuously during a gesture.
Crossfader -1–+1 Dry-to-processed blend.
Vinyl Speed 0.25–4x Motor speed exposed to the host.
Playing Off / On Stops or starts motor/LFO playback.
Recording Off / On Stops or starts capture in Live mode.
LFO Enabled Off / On Enables automatic playhead movement.
LFO Rate 0.01–10 Hz Free-running LFO frequency.
LFO Amount 0–100% Size of the scanned buffer region.
LFO Offset 0–100% Start position of the scanned region.
LFO Sync Off / On Selects free or tempo-synced rate.
LFO Sync Division 1/16 through x16 Indexed tempo ratio.
LFO Waveform Sine, Tri, Saw, R Saw LFO movement shape.
Filter Frequency 20–20,000 Hz Low-pass cutoff.
Filter Resonance 0.1–12 Q Low-pass resonance.

The on-screen Speed fader range can offer wider or narrower performance ranges, while the AUv3 host parameter itself advertises 0.25–4x.

Tips and Starting Points

Troubleshooting

No sound

Live mode records silence

LFO does not move the playhead

MIDI trigger does not move the crossfader

A custom file will not load

Cue jumps to an unexpected place

AUv3 is missing from the host

Settings or sounds were not restored