# Bespoke Synth Reference

## overview video

Here is a video detailing basic usage of Bespoke, including a bunch of less-obvious shortcuts and workflow features.

There are some things in this video that are slightly out of date (I should make a new video!), but there is still plenty of useful information in there.

## basics

Navigation * space bar + move mouse to pan, or right-click drag in empty space * space bar + mousewheel/trackpad-scroll to zoom, or scroll in empty space * if you get lost, press ~ to bring up the console, type "home", and press enter to reset to the initial position and zoom * if you have enabled the minimap in the settings, you can click on the minimap to directly go to a location -at the bottom of the minimap you can click on 9 bookmark buttons -hold shift while clicking will store your current location into that bookmark button -use shift+[num] to go to the specified bookmark Creating Modules * drag items out of the top bar menus OR * right-click and select from the popup menu OR * right-click and start typing the name of the module you want, then drag it out of the popup menu OR * hold the first letter of a module and drag them out of the popup menu OR * drag a cable into space and spawn a connecting module from the popup * to delete a module, lasso select + backspace OR use the triangle menu and choose "delete module" * to duplicate a module, hold alt/option and drag from the title bar Patching * drag the circle from the bottom of a module to the target OR click the circle then click the target to patch * drag a cable and press backspace to unpatch * hold shift while grabbing a patch cable circle to split * hold shift while releasing a patch cable on a target to insert * while holding shift, drag a module by the title bar and touch its circle to another module, or the mouse pointer to another module's circle, to quick patch UI Controls * click or drag a slider to adjust its value * hold shift to fine-tune * while hovered: -use mousewheel/trackpad-scroll to adjust (shift to fine-tune) -type a value into a slider (such as 1.5) and press enter -type an expression into a slider (such as 1/16 or +=10) and press enter -press up or down to increase the value by 1 (hold shift for .01) -press [ or ] to halve or double the value -press \ to reset to the initial value * hold alt/option and drag to adjust slew amount (smoothing) * right click a slider to add an LFO -click and drag a green modulated slider vertically to adjust the modulation min, and horizontally to adjust the modulation max * hold ctrl/command and click the lower or upper half of a slider to adjust that slider's minimum or maximum value, to give it increased or reduced range (warning! increasing range can lead to unpredictable behavior in some cases) * press tab to cycle through controls on a module * press ctrl/command+arrows to navigate around controls on a module Saving * "write audio" button: write the last 30 minutes of audio to the /data/recordings folder, perfect for making sure you don't miss any cool moments * "save state" button: save the current layout to a file. shortcut: ctrl-s * "load state" button: load previously saved layouts. shortcut: ctrl-l Key Commands * ctrl/command-'s': save * ctrl/command-'l': load * shift-'p': pause audio processing. this will stop all audio output. press shift-'p' again to resume * F2: toggle displaying all ADSR controls as sliders * F3: pins or unpin a module so that it stays where it is regardless of the viewports position. only works when not group selecting modules. Musical durations notation Some modules have an interval control with options like "2", "1n", "2nt" or "4nd" denoting musical durations. * bare numbers are a number of measures - "2" is two measures long - "3" is three measures long - etc. * n options are the length of an nth note - "1n" is a whole note or one measure long (this would be the same as "1" if that appeared in the options) - "2n" is a half note long or two beats - "4n" is a quarter note long or one beat - "8n" is an eigth note long or 0.5 beats - etc. - the number of beats in a measure is determined by the "timesigtop" control in the transport module * nt options are the length of a triplet nth note or 2/3 the length of an nth note - "4nt" is a triplet quarter note long or 0.6666... beats - "8nt" is a triplet eigth note long or 0.3333... beats - etc. * nd options are the length of a dotted nth note or 3/2 the length of an nth note - "4nd" is a dotted quarter note long or 1.5 beats - "8nd" is a dotted eigth note long or 0.75 beats - etc. * "free" denotes a freely adjustable duration and there will be a slider control elsewhere on the module to set it

## instruments

circlesequencer polyrhythmic sequencer that displays a loop as a circle
length*: number of steps in this ring
note*: pitch to use for this ring
offset*: timing offset for this ring
dotsequencer polyphonic note sequencer with adjustable note length and velocity. click and drag horizontally to adjust length. click and drag vertically to adjust the velocity. hover and use the arrow keys to move dots. hover and use the mouse wheel to tweak dot lengths.
clear: clear the contents of the dot grid
cols: number of columns
dotgrid: the dot grid
double: double the length of this sequence
interval: rate to play notes at
notemode: which set of pitches should the rows represent?
octave: octave of the bottom pitch of this sequence
row offset: amount to offset the mapping of row to pitch
rows: number of rows
drumsequencer step sequencer intended for drums. hold shift when dragging on the grid to adjust step velocity, or hover over a step and press the up and down arrow keys to adjust velocity.
<: shift whole pattern one step earlier
>: shift whole pattern one step later
clear: clear sequence
column: current column, to use for visualizing the step on a midi controller
grid: patch a grid in here from a "midicontroller" module
measures: length of the sequence in measures
metastep: patch a grid in here from a "midicontroller" module to control the "meta step". I forget what this does. oops.
offset*: shift row forward/backward in time. try making your snares a little early, your hats a little late, etc.
offsets: show "offsets" sliders
r amt: the chance that each step will change when being randomized. low values will only change a small amount of the sequence, high values will replace more of the sequence.
r den: density of the randomizer output. the higher this is, the busier the random output will be.
r lock*: lock this row so it doesn't get randomized
random*: randomize this row
randomize: randomize the sequence
repeat: repeat input notes at this rate
rowpitch*: output pitch for this row
step: length of each step
vel: velocity to use when setting a step
velocity: patch a grid in here from a "midicontroller" module to control the velocity
velocitytype: velocity to use when setting a step
yoff: vertical offset for grid controller's view of the pattern
accepts: pulses notes
euclideansequencer euclidean sequencer displays a loop as a circle. the notes are calculated using the euclidean rhythm algorithm.
clear: clear all steps, onsets, rotation and offset in all rings
note: randomize notes in all rings
note chance: what is the chance a note gets changed
note*: pitch to use for this ring
o *: in what range is offset created
oct*: in what octave range are notes created
offset: randomize offset in all rings
offset chance: what is the chance that an offset gets changed
offset*: timing offset for this ring
ons *: in what range are onsets created
onset chance: what is the chance that an onset gets changed
onsets: randomize onsets in all rings
onsets*: number of onsets in this ring
random: randomize all steps, onsets and rotation in all rings
random*: randomize steps, onsets and rotation in this ring
rot chance: what is the chance that rotation gets changed
rot hi: in what range is rotation created
rot lo: in what range is rotation created
rotation: randomize rotation in all rings
rotation*: rotation of this ring
step chance: what is the chance a step gets changed
steps: randomize steps in all rings
steps*: number of steps in this ring
stp*: in what range are steps created
fouronthefloor sends note 0 every beat, to trigger a kick drum
two: sends note only every two beats
gridkeyboard grid-based keyboard, intended primarily for 64-pad grid controllers
arrangement: what style of layout should we use?
ch.latch: latch chord button presses
grid: patch a grid in here from a "midicontroller" module
latch: latch key presses, so you press once to play a note, and press again to release a note
layout: keyboard style
octave: base octave
p.root: for chorder, make root note always play
keyboarddisplay displays input notes on a keyboard, and allows you to click the keyboard to create notes
accepts: notes
m185sequencer sequencer using the unique paradigm of the m185 or intellijel metropolis
gate*: behavior for each row: "repeat" plays every step, "once" plays just the first step, "hold" holds across all steps, "rest" plays no steps
interval: interval per step
pitch*: pitch to use for this row
pulses*: number of steps this row should last
reset step: resets counter to first step
accepts: pulses
midicontroller get midi input from external devices. to get a nice display in the "layout" view, create a .json file with the same name as your controller to describe your controller's layout, and place it in your "data/controllers" directory. look at the other files in that directory for examples.
x : delete this connection
14bit: is this a 14-bit midi control, with this control as the LSB and the control 32 less than this as the MSB?
add: add a mapping manually
bind (hold shift): when this is enabled, you can map a midi input to a UI control by hovering over a UI control, holding shift, and then using desired midi input
blink: when the targeted control is enabled, send alternating on/off messages, to blink the associated LED
channel: which channel to pay attention to
control: pitch or control to refer to
controller: midi device to use
controltype: how this control should modify the target. -slider: set the value interpolated between "midi off" and "midi on" to the slider's value -set: set the specified value directly when this button is pressed -release: set the specified value directly when this button is released -toggle: toggle the control's value to on/off when this button is pressed -direct: set the control to the literal midi input value
copy: duplicate this connection
feedback: which cc or note should we send the feedback to?
increment: when "controltype" is "set" or "release", the targeted control is incremented by this amount (and the "value" field is ignored). when "controltype" is "slider", the targeted control is changed by this amount in the direction the control was changed (this setting is useful for "infinite encoders")
layout: which layout file should we use for this controller? these can be created in your Documents/BespokeSynth/controllers folder.
mappingdisplay: which mapping view to see
messagetype: type of midi message
midi off: the lower end of the midi range. send this value when the targeted control is off. if "scale" is enabled, this also controls the lower end of the slider range, and you can set midi off to be higher than midi on to reverse a slider's direction.
midi on: the upper end of the midi range. send this value when the targeted control is on. if "scale" is enabled, this also controls the upper end of the slider range, and you can set midi off to be higher than midi on to reverse a slider's direction.
monome: which monome should we use?
osc input port: port to use for osccontroller input
page: select which page of midi controls to use. each page acts like an independent midi controller, so you can use pages to allow one midi controller to switch between controlling many things
pageless: should this connection work across all pages of the midicontroller?
path: path to the control that should be affected. you can also enter "hover" here, to affect whichever control the mouse is hovering over.
scale: should the output of this midi slider be scaled between "midi off" and "midi on"?
twoway: should we send feedback to the controller? (to control the LEDs associated with the button/knob)
value: the value to set
notecanvas looping note roll
canvas: canvas of notes. canvas controls: -shift-click to add a note -hold shift and drag a note to duplicate -hold alt to drag a note without snapping -hold ctrl while dragging to snap to an interval -hold shift and scroll to zoom -hold alt and grab empty space to move slide the canvas view -hold ctrl and grab empty space to zoom the canvas view
clear: delete all elements
delete: delete highlighted elements
drag mode: direction that elements can be dragged
free rec: enable record mode, and extend canvas if we reach the end
interval: interval to quantize to
load midi: import canvas contents from a midi file
loadtrack: which track number to import when using "load midi"
measures: loop length
play: play notes on canvas
quantize: quantize selected notes to interval
rec: record input notes to canvas
save midi: export canvas contents to a midi file
scrollh: horizontal scrollbar
scrollv: vertical scrollbar
show chord intervals: show brackets to indicate chord relationships
timeline: control loop points
view rows: number of visible rows
accepts: notes
notechain trigger a note, followed by a pulse to trigger another note after a delay
duration: duration of note, in measures
next: interval until sending pulse
pitch: pitch to play
trigger: play note for this chain node
velocity: velocity for note
accepts: pulses
notecounter advance through pitches sequentially. useful for driving the "notesequencer" or "drumsequencer" modules.
*: generate a new random seed
<: go to previous seed
>: go to next seed
beat length: length over which the random sequence should deterministically repeat
div: measure division, when using "div" as the interval
interval: rate to advance
length: length of the sequence
random: output random pitches within the range, rather than sequential
seed: number that determines the random sequence
start: pitch at the start of the sequence
sync: if the output pitch should be synchronized to the global transport
accepts: pulses
notecreator create a one-off note
duration: note length when "trigger" button is used
on: turn on to start note, turn off to end note
pitch: output note pitch
trigger: press to trigger note for specified duration
velocity: note velocity
accepts: pulses
notelooper note loop recorder with overdubbing and replacement functionality
canvas: canvas of recorded notes
clear: clear pattern
del/mute: if "write" is enabled, erase notes as the playhead passes over them. otherwise, just mute them.
load*: restore pattern
num bars: set loop length in measures
store*: save pattern
write: should input should be recorded?
accepts: notes
notesequencer looping sequence of notes at an interval. pair with a "pulser" module for more interesting step control. hold "shift" to adjust step length.
<: shift the sequence to the left
>: shift the sequence to the right
clear: clear all steps
grid: patch a grid in here from a "midicontroller" module
interval: note length
len: randomize the length of each step's note.
len*: length for this column
length: length that the sequence below should play. the overall grid length can be changed by adjusting "gridsteps" in the triangle menu.
loop reset: when sequence loops, reset to here instead. send a "downbeat"-style message from a pulser to restart the sequence from the first step.
notemode: which set of pitches should the rows represent?
octave: octave of the bottom pitch of this sequence
pitch: randomize pitches in the sequence. hold shift to constrain the randomization to only pick roots and fifths.
rand len chance: when clicking the random length button, what is the chance that a step gets changed?
rand len range: when clicking the random length button, how much will the length change?
rand pitch chance: when clicking the random pitch button, what is the chance that a step gets changed?
rand pitch variety: how many different random pitches should we generate?
rand vel chance: when clicking the random velocity button, what is the chance that a step gets changed?
rand vel density: when clicking the random velocity button, what are the chances that a step should have a note?
random: randomize pitch, length, and velocity of all steps.
tone*: pitch for this column
vel: randomize the velocity of each step's note.
vel*: velocity for this column
x offset: x offset of attached grid controller
y offset: y offset of attached grid controller
accepts: pulses notes
notesinger output a note based on a detected pitch
oct: octave to adjust output pitch by
accepts: audio
playsequencer drum sequencer that allows you to punch in to record and overdub steps, inspired by the pulsar-23 drum machine
grid: patch a grid in here from a "midicontroller" module
interval: the step size
link columns: if the mute/delete control should be shared across the entire column
load*: load the sequence stored in this slot
measures: the loop length
mute/delete*: if write is disabled, mute this row. if write is enabled, clear the steps as the playhead passes them
note repeat: if held notes should repeat every step
store*: store the current sequence to this slot
write: if the current input should be written to the sequence. this will also delete steps if mute/delete is enabled for this row
accepts: notes
polyrhythms looping sequence with lines on different divisions
length*: number of steps for this line
note*: pitch to use for this line
randomnote play a note at a given interval with a random chance
interval: the note length
offset: the amount of time to offset playback within the interval
pitch: the pitch to use
probability: the chance that a note will play each interval
skip: after a note plays, don't play a note the next n-1 times that it would have played
velocity: the velocity to use
slidersequencer trigger notes along a continuous timeline
division: rate to progress
note*: pitch for this element
playing*: is this element playing?
time*: time to trigger this element
vel*: velocity of this element

## note effects

arpeggiator arpeggiates held notes. there are several vestigial features in this module that should be cleaned up.
interval: arpeggiation rate
octaves: how many octaves to step through
step: direction and distance to step through arpeggiation. a value of zero is "pingpong".
accepts: notes
capo shifts incoming notes by semitones
capo: number of semitones to shift
diatonic: should we keep transposed notes in the scale?
retrigger: immediately replay current notes when changing the capo amount
accepts: notes
chorddisplayer display which chord is playing, in the context of the current scale
accepts: notes
chorder takes an incoming pitch and plays additional notes to form chords
chord: chord presets
diatonic: should the grid be chromatic, or locked to the scale only?
inversion: inversion presets
accepts: notes
chordholder keeps any notes pressed at the same time sustaining, until new notes are pressed
pulse to play: when enabled, input notes aren't played immediately, but instead wait for an input pulse before playing
stop: stop notes from playing
accepts: pulses notes
gridnotedisplayer use with a gridkeyboard to display currently playing notes, to visualize chords, arpeggiation, etc.
accepts: notes
midicc outputs midi control change messages to route to a "midioutput" module
control: CC control number
value: outputs a CC value when this changes
accepts: notes
midioutput send midi to an external destination, such as hardware or other software
controller: where to send midi to
accepts: notes
modulationvizualizer display MPE modulation values for notes
accepts: notes
modwheel adds an expression value to a note
modwheel: expression level
accepts: notes
modwheeltopressure swaps expression input to midi pressure in the output
accepts: notes
modwheeltovibrato convert note mod wheel input rhythmic pitch bend
vibinterval: rate of vibrato
vibrato: amount of pitch bend
accepts: notes
mpesmoother smooth out MPE parameters
modwheel: amount to smooth incoming modwheel
pitch: amount to smooth incoming pitchbend
pressure: amount to smooth incoming pressure
accepts: notes
mpetweaker adjust incoming MPE modulation values
modwheel mult: amount to multiply incoming modwheel
modwheel offset: amount to offset incoming modwheel
pitchbend mult: amount to multiply incoming pitchbend
pitchbend offset: amount to offset incoming pitchbend
pressure mult: amount to multiply incoming pressure
pressure offset: amount to offset incoming pressure
accepts: notes
notechance randomly allow notes through
*: generate a new random seed
<: go to previous seed
>: go to next seed
beat length: restart the deterministic random sequence at this interval
chance: probability that a note is allowed
deterministic: allow for randomness to be repeated over an interval
seed: number that determines the random sequence
accepts: notes
notedelayer delay input notes by a specified amount
delay: amount of time to delay, in measures
accepts: notes
notedisplayer show input note info
accepts: notes
noteduration sets the length a note will play, ignoring the note-off message
duration: length of the note in measures
accepts: notes
noteecho output incoming notes at specified delays
delay *: amount of time to delay this output, in measures
accepts: notes
noteexpression control where notes are routed based upon evaluated expressions. the variable "p" represents pitch, and "v" represents velocity
expression*: expression to evaluate for this cable. example expression to route notes with pitch greater than 80 and velocity less than 60: "p > 80 && v < 60"
accepts: notes
notefilter only allow a certain pitches through
accepts: notes
noteflusher send a note-off for all notes
flush: click to flush notes
accepts: notes
notegate allow or disallow notes to pass through
open: if notes are allowed to pass
accepts: notes
notehocket sends notes to random destinations
*: generate a new random seed
<: go to previous seed
>: go to next seed
beat length: restart the deterministic random sequence at this interval
seed: number that determines the random sequence
weight *: chance that note goes to this destination
accepts: notes
notehumanizer add randomness to timing and velocity
time: amount of timing randomness, in milliseconds.
velocity: amount of velocity randomness
accepts: notes
notelatch use note on messages to toggle notes on and off
accepts: notes
noteoctaver transpose a note by octaves
octave: number of octaves to raise or lower
retrigger: immediately replay current notes when changing the transpose amount
accepts: notes
notepanalternator sets a note's pan, alternating between two values, for the internal synths that support panned notes
one: pan position, .5 is centered
two: pan position, .5 is centered
accepts: notes
notepanner sets a note's pan, for the internal synths that support panned notes
pan: pan position, .5 is centered
accepts: notes
notepanrandom sets a note's pan to random values, for the internal synths that support panned notes
center: center pan position
spread: amount of randomness
accepts: notes
noterangefilter only allows notes through within a certain pitch range
max: maximum pitch allowed
min: minimum pitch allowed
wrap: instead of rejecting notes outside of this range, should we wrap them to the range instead?
accepts: notes
noteratchet rapidly repeat an input note over a duration
duration: total length of time repeats should last
skip first: don't replay input note. this allows you to more easily separate the initial note from the ratcheted notes.
subdivision: length of each repeat
accepts: notes
noterouter allows you to control where notes are routed to using a UI control. to add destinations to the list, patch them as a target
route: the noterouter's destination module
accepts: notes
notesorter separate notes by pitch. any unmapped pitches go through the standard outlet.
pitch *: pitch to use for this outlet
accepts: notes
notestepper output notes through a round robin of patch cables, to create sequential variety
length: length of the sequence
reset: reset to the start
accepts: notes
notestream view a stream of notes as they're played
reset: reset the pitch range
accepts: notes
notestrummer send a chord into this, and move a slider to strum each note of the chord
strum: move the slider past each note to strum it
accepts: notes
notetable map a pitch (starting from zero) to a scale pitch
clear: clear grid
grid: patch a grid in here from a "midicontroller" module
length: the number of pitches
notemode: which set of pitches should the rows represent?
octave: octave of the bottom pitch of this sequence
rand pitch chance: when clicking the random pitch button, what is the chance that a step gets changed?
rand pitch range: when clicking the random pitch button, how far will the pitch change?
random pitch: randomize pitches in the sequence. hold shift to constrain the randomization to only pick roots and fifths.
tone*: pitch for this column
x offset: x offset of attached grid controller
y offset: y offset of attached grid controller
accepts: notes
notewrap wrap an input pitch to stay within a desired range
min: bottom of pitch range
range: number of semitones before wrapping back down to min pitch
accepts: notes
pitchbender add pitch bend to notes
bend: bend amount, in semitones
accepts: notes
pitchdive use pitchbend to settle into an input pitch from a starting offset
start: semitone offset to start from
time: time in milliseconds to ramp from pitch offset into input pitch
accepts: notes
pitchpanner add pan modulation to notes based upon input pitch, so low pitches are panned in one direction and high pitches are panned in another
left: pitch that represents full left pan
right: pitch that represents full right pan
accepts: notes
pitchremap remap input pitches to different output pitches
from*: pitch to change
to*: desired pitch
accepts: notes
pitchsetter set an incoming note to use a specified pitch
pitch: the pitch to use
accepts: notes
portamento only allows one note to play at a time, and uses pitch bend to glide between notes
glide: time to glide, in milliseconds
mode: always: always glide to new notes retrigger held: bend to notes if the prior note is held, and retrigger bend held: bend to notes if the prior note is held, without retriggering
accepts: notes
pressure add pressure modulation to notes
pressure: pressure amount
accepts: notes
pressuretomodwheel takes midi pressure modulation input and changes it to modwheel modulation
accepts: notes
pressuretovibrato takes midi pressure modulation input and changes it to vibrato, using pitch bend
vibinterval: vibrato speed
vibrato: amount of vibrato
accepts: notes
previousnote when receiving a note on, output the prior note on that we received
accepts: notes
quantizer delay inputs until the next quantization interval
quantize: the quantization interval
repeat: when holding a note, should we repeat it every interval?
accepts: pulses notes
rhythmsequencer repeats held input notes, to turn a sustained note into a rhythm
action *: action for this step. on = play note, hold = sustain note, off = no note
degree *: scale degree offset for this step
interval: rate to play notes at
len act: length of the action column
len deg: length of the scale degree offset column
len oct: length of the octave offset column
len vel: length of the velocity column
length: length of the sequence
link lengths: should there be one global length, or a length for each column?
octave *: octave offset for this step
vel *: velocity for this step
accepts: pulses notes
scaledegree transpose input based on current scale
degree: amount to transpose
diatonic: should we keep transposed notes in the scale?
retrigger: immediately replay current notes when changing the transpose amount
accepts: notes
scaledetect detect which scales fit a collection of entered notes. the last played pitch is used as the root.
matches: matching scales for this root
reset: reset the input collection of notes
accepts: notes
sustainpedal keeps input notes sustaining
sustain: should we hold the input notes?
accepts: notes
transposefrom transpose input from a specified root to the root of the current scale. the primary usage of this would be to allow you to play a keyboard in C, but it gets transposed to the current scale.
retrigger: immediately replay current notes when changing the transpose root or the scale
root: root to transpose from
accepts: notes
unstablemodwheel mutate MPE slide with perlin noise
amount: amount of mutation
noise: fast-later mutation rate
warble: slow-layer mutation rate
accepts: notes
unstablepitch mutate MPE pitchbend with perlin noise
amount: amount of mutation
noise: fast-later mutation rate
warble: slow-layer mutation rate
accepts: notes
unstablepressure mutate MPE pressure with perlin noise
amount: amount of mutation
noise: fast-later mutation rate
warble: slow-layer mutation rate
accepts: notes
velocitycurve adjust velocity based upon a curve mapping
accepts: notes
velocityscaler scale a note's velocity to be higher or lower
scale: amount to multiply velocity by
accepts: notes
velocitysetter set a note's velocity to this value
rand: randomness to reduce output velocity by
vel: velocity to use
accepts: notes
velocitystepsequencer adjusts the velocity of incoming notes based upon a sequence
downbeat: should we reset the sequence every downbeat?
interval: speed to advance sequence
len: length of sequence
vel*: velocity for this step
accepts: notes
velocitytochance use a note's velocity to determine the chance that the note plays
*: generate a new random seed
<: go to previous seed
>: go to next seed
beat length: restart the deterministic random sequence at this interval
full velocity: set velocity to full for notes that pass through
seed: number that determines the random sequence
accepts: notes
vibrato add rhythmic oscillating pitch bend to notes
vibinterval: speed of pitch bend oscillation
vibrato: amount of pitch bend to add
accepts: notes
voicesetter set a specific Voice channel index for a note
voice index: current set voice channel index
accepts: notes
volcabeatscontrol outputs MIDI data to control various aspects of the KORG volca beats drum machine
accepts: notes
whitekeys remap the white keys that correspond to the C major scale to instead play the current global scale
accepts: notes

## synths

beats multi-loop player, for mixing sample layers together
bars*: how many measures long are the samples in this slot?
delete *: remove the current sample from the list
double*: enable this to play at double speed
filter*: layer filter. negative values bring in a low pass, positive values bring in a high pass.
pan*: layer panorama
selector*: which sample should we play in this slot? drag samples onto here to add them to this slot.
volume*: layer volume
drumplayer sample player intended for drum playback
aud: scroll to audition samples in the current pad's head category, or a directory last dropped onto a pad
edit: show pads for editing
envelope *: should we apply a volume envelope to the sample?
envelopedisplay *A: envelope attack
envelopedisplay *D: envelope decay
envelopedisplay *R: envelope release
envelopedisplay *S: envelope sustain
full vel: always play drum hits at full velocity
grab *: grab this sample
grid: patch a grid in here from a "midicontroller" module
hitcategory*: folder to choose from, when clicking the "random" button. these folders are found in the data/drums/hits/ directory
linkid *: if linkid is not -1, silence any other sample with a matching linkid (useful for linking open and closed hats)
mono: force output to mono
next *: choose the next sample from the selected hitcategory
pan *: stereo pan position of sample
prev *: choose the previous sample from the selected hitcategory
quantize: quantize input to this interval
random *: choose a random sample from the selected hitcategory
repeat: if quantizing, should held notes repeat at that interval?
shuffle: random is samples, speeds, and pans
single out *: should the sample have its own individual output?
single voice: only play a single drum hit at once, choking all others out (as if they all shared the same linkid)
speed: global sample speed multiplier
speed *: speed of sample
speed rnd: global sample speed randomization amount
start *: start offset percentage of sample
test *: play this sample
view ms *: envelope view length in milliseconds
vol: the output volume
vol *: volume of sample
widen *: stereo delay of sample to create width
accepts: notes
drumsynth oscillator+noise drum synth
cutoffmax*: filter start cutoff frequency
cutoffmin*: filter end cutoff frequency
edit: display parameters for each hit
freqmax*: oscillator start frequency
freqmin*: oscillator end frequency
noise*: noise volume
oversampling: oversampling amount. increases sound quality, but also increases cpu usage.
q*: filter resonance
type*: oscillator type
vol: the output volume
vol*: oscillator volume
accepts: notes
fmsynth polyphonic fm synthesis
harmratio: harmonic ratio of first-order modulator to input pitch
harmratio2: harmonic ratio of second-order modulator to input pitch
mod: amount to modulate first-order modulator
mod2: amount to modulate second-order modulator
phase0: phase offset for base oscillator
phase1: phase offset for first-order modulator
phase2: phase offset for second-order modulator
tweak: multiplier to harmonic ratio for first-order modulator
tweak2: multiplier to harmonic ratio for second-order modulator
vol: the output volume
accepts: notes
karplusstrong polyphonic plucked string physical modeling synth
feedback: amount of feedback for resonance
filter: amount to filter resonance
invert: should the feedback invert?
lite cpu: only recalculate some parameters once per buffer, to reduce CPU load. can make pitch bends and rapid modulation sound worse in some scenarios.
pitchtone: adjust how pitch influences filter amount. a value of zero gives even filtering across the entire pitch range, higher values filter high pitches less, low values filter low pitches less.
source type: audio to use for excitation
vel2env: how much velocity should affect excitation attack time
vel2vol: how much velocity should affect voice volume
vol: output volume
x att: fade in time for excitation audio
x dec: fade out time for excitation audio
x freq: frequency of excitation audio
accepts: notes audio
metronome beeps to the beat
vol: metronome volume
oscillator polyphonic enveloped oscillator. modulations (with MPE support): modwheel closes filter further (if filter is enabled), pressure decreases detune amount
adsr len: view length of ADSR controls
detune: when unison is 1, detunes oscillator by this amount. when unison is 2, one oscillator is tuned normally and the other is detuned by this amount. when unison is >2, oscillators are randomly detuned within this range.
envA: volume envelope attack
envD: volume envelope decay
envR: volume envelope release
envS: volume envelope sustain
envfilterA: filter envelope attack
envfilterD: filter envelope decay
envfilterR: filter envelope release
envfilterS: filter envelope sustain
fmax: frequency cutoff of lowpass filter at the max of the envelope. set this slider to the max to disable the filter
fmin: frequency cutoff of lowpass filter at the min of the envelope
lite cpu: only recalculate some parameters once per buffer, to reduce CPU load. can make pitch bends and rapid modulation sound worse in some scenarios.
mult: multiply frequency of incoming pitch
osc: oscillator type
phase: phase offset of oscillator, and phase offset between unison voices. useful to patch into with a very fast modulator, to achieve phase modulation.
pw: pulse width (or shape for non-square waves)
q: resonance of lowpass filter
shuffle: stretches and squeezes every other cycle of the waveform
soften: soften edges of square and saw waveforms
syncf: frequency to reset the phase, when "syncmode" is set to "freq"
syncmode: turns on sync mode, to reset the phase at a specified frequency
syncratio: ratio of oscillator frequency to reset the phase, when "syncmode" is set to "ratio"
unison: how many oscillators to play for one note
vel2env: how much should the input velocity affect the speed of the volume and filter envelopes?
vel2vol: how much should the input velocity affect the output volume?
vol: this oscillator's volume
width: controls how voices are panned with unison is greater than 1
accepts: notes
samplecanvas sample arranging view
canvas: canvas of samples. drag and drop samples onto here. canvas controls: -hold shift and drag a sample to duplicate -hold alt to drag a sample without snapping -hold ctrl while dragging to snap to an interval -hold shift and scroll to zoom -hold alt and grab empty space to move slide the canvas view -hold ctrl and grab empty space to zoom the canvas view
clear: delete all elements
delete: delete highlighted elements
drag mode: direction that elements can be dragged
interval: grid subdivision interval
measures: length of canvas in measures
scrollh: horizontal scrollbar
scrollv: vertical scrollbar
timeline: control loop points
view rows: number of visible rows
sampleplayer sample playback with triggerable cue points, clip extraction, and youtube search/download functionality. resize this module larger to access additional features. if you have a youtube URL in your clipboard, a button will appear to allow you to download the audio.
16: auto-slice 16 slices
32: auto-slice 32 slices
4: auto-slice 4 slices
8: auto-slice 8 slices
append to rec: when recording, append to the previous recording, rather than clearing the sample first
attack: speed at which gate blends open
click sets cue: when true, clicking on the waveform will set the start position of the current cue
cue len: length in seconds of the current cue. a value of zero will play to the end of the sample.
cue speed: playback speed of the current cue
cue start: start point in seconds of the current cue
cue stop: stop playing this cue if a note-off is received
cuepoint: sets the current cue to edit
grabhovered: grab a sample of this cue to drop onto another module
load: show a file chooser to load a sample
loop: wrap playhead to beginning when it reaches end
pause: pause playing and leave playhead where it is
play: start playing from the current playhead
play cue: play the current cue
playhovered: play this cue
record: record audio input into our sample buffer. clears the current sample.
record as clips: when recording, only record when there is enough input to open the gate, and mark up each recorded segment with cue points
release: speed at which gate blends closed
save: save this sample to a file
searchresult*: click to download this youtube search result. downloading long videos may take a while.
select played: when true, any cue point played via incoming notes will become the current cue
show grid: show a quarter note grid (when zoomed in far enough)
speed: current playback speed
stop: stop playing and reset playhead
threshold: volume threshold to open up the gate for recording
trim: discard all audio outside the current zoom range
volume: output gain
youtube: download the audio of the youtube URL currently on your clipboard
yt:: search youtube for this string
accepts: pulses notes audio
sampler very basic polyphonic pitched sample player and recorder. send audio in, and use note input to play the recorded audio.
env: volume envelope
envA: volume envelope attack
envD: volume envelope decay
envR: volume envelope release
envS: volume envelope sustain
passthrough: should input audio pass through as we're recording?
pitch: should we attempt pitch-correct the audio?
rec: enable to clear the current recording, and record new audio once the input threshold is reached
thresh: when recording is enabled, exceed this threshold with input audio to begin recording
vol: output volume
accepts: notes audio
seaofgrain granular synth, playable with sliders or MPE input
display length: amount of sample to view
gain *: volume of this voice
keyboard base pitch: midi pitch that represents the start of the sample
keyboard num pitches: amount of pitches to assign across the sample
len ms *: length of each grain in milliseconds
load: load a sample file
octaves *: should we add octaves and fifths?
offset: where to start view of the sample
overlap *: number of overlapping grains
pan *: stereo panorama of grain placement
pos *: position of this voice within the sample
pos r *: randomization of grain start point
record: record input as the granular buffer, to use seaofgrain a live granular delay
spacing r*: randomization of time between grains
speed *: speed of grain playback
speed r *: randomization of grain speed
volume: output volume
width *: stereo width of grain placement
accepts: notes audio
signalgenerator basic oscillator signal. send a note into it to set the frequency, and send a pulse to reset the phase.
detune: amount to detune from specified frequency
freq: signal frequency
freq mode: what mode should we use for input notes? "instant" changes to the input note's frequency instantly, "ramp" ramps to the frequency over time, and "slider" allows you to use a slider to interpolate between the last two input notes
mult: multiplier for frequency
osc: oscillator type
phase: phase offset
pw: pulse width (or shape for non-square waves)
ramp: amount of time to ramp to input frequency
shuffle: stretches and squeezes every other cycle of the waveform
slider: slider to interpolate between last two input pitches
soften: soften edges of square and saw waveforms
syncf: frequency to reset the phase, when "syncmode" is set to "freq"
syncmode: turns on sync mode, to reset the phase at a specified frequency
syncratio: ratio of oscillator frequency to reset the phase, when "syncmode" is set to "ratio"
vol: output volume
accepts: pulses notes

## audio effects

audiometer sets a slider to an audio level's volume. useful to map a midi display value to.
level: the input audio level. hook this up to an LED-display midi control to see the value displayed on your controller.
accepts: audio
audiorouter selector for switching where audio is routed to. connect to targets to add them to the list.
route: audio destination
accepts: audio
audiosplitter send an audio signal to multiple destinations
accepts: audio
buffershuffler use notes to play back slices of a constantly-recording live input buffer. input notes trigger slices, with the pitch mapping to slice index. you can also click with a mouse to trigger slices.
fourtet: use a textural trick I saw four tet illustrate in a video once: slice the audio into chunks, and for each chunk it at double speed followed by playing it in reverse at double speed. this slider adjusts the mix between the original audio and this "fourtetified" audio.
fourtetslices: chunk size to use for "fourtet" effect
freeze input: retain the current buffer, without writing in new input
grid: patch a grid in here from a "midicontroller" module
interval: slice size
num bars: number of bars to capture
playback style: how to play clicked slices. or, with input notes, velocity range determines playback style.
accepts: notes audio
dcoffset add a constant offset to an audio signal
offset: amount of offset to add
accepts: audio
effectchain container to hold a list of effects, applied in series. the effects can be easily reordered with the < and > buttons, and deleted with the x button. hold shift to expose a x button for all effects.
<: move this effect to earlier in the chain
>: move this effect to later in the chain
effect: select which effect to add
exit effect: on push2, back effect control out to the main effectchain controls
mix*: wet/dry slider for this effect
spawn: spawn the currently highlighted effect
volume: output gain
x: delete this effect
accepts: audio
eq multi-band equalizer, to adjust output levels at frequency ranges
enabled*: enable this band?
f*: frequency cutoff for this band
g*: gain for this band
q*: resonance for this band
type*: what type of filter should this band use
accepts: audio
feedback feed delayed audio back into earlier in the signal chain. use the "feedback out" connector for sending the audio back up the chain, and the primary output connector for sending the resulting audio forward. using feedback can often lead to extreme and difficult-to-control results!
limit: clip the feedback audio to this range, to avoid issues with feedback blowing out too intensely.
accepts: audio
fftvocoder FFT-based vocoder
carrier: carrier signal gain
cut: how many bass partials to remove
dry/wet: how much original input vs vocoded signal to output
fric thresh: fricative detection sensitivity, to switch between using the carrier signal and white noise for vocoding
input: input signal gain
phase off: how much we should offset the phase of the carrier signal's partials
volume: output gain
whisper: how much the carrier signal partial's phases should be randomized, which affects how whispery the output sound is
accepts: audio
freqdelay delay effect with delay length based upon input notes
dry/wet: how much of the effect to apply
accepts: notes audio
gain adjusts volume of audio signal
gain: amount to adjust signal. a value of 1 will cause no change to the signal.
accepts: audio
input get audio from input source, like a microphone
ch: which channel (or channels, if you want stereo) to use
accepts: audio
inverter multiply a signal by -1. enables some pretty interesting effects when used with sends, to subtract out parts of signals when recombined.
accepts: audio
lissajous draw input audio as a lissajous curve. turn off "autocorrelation" in the module's triangle menu to use stereo channels to show stereo width.
scale: visual scale of lissajous image
accepts: audio
looper loop input audio. use with a "looperrecorder" for full functionality.
m : take the contents of this looper and merge it into another. click this button on the merge source, then on the merge target.
.5x: make loop play at half speed
2x: make loop play at double speed
apply: shift the contents of the looper so the current offset is the start of the buffer
auto: should pitch shift auto-adjust as the transport tempo adjusts?
b: bake current volume into waveform
capture: when the next loop begins, record input for the duration of the loop
clear: clear the loop audio
commit: commit the current looperrecorder buffer to this loop
copy: take the contents of this looper and copy it onto another. click this button on the copy source, then on the copy target.
decay: amount to lower volume each loop
extend: make loop twice as long
fourtet: use a textural trick I saw four tet illustrate in a video once: slice the audio into chunks, and for each chunk it at double speed followed by playing it in reverse at double speed. this slider adjusts the mix between the original audio and this "fourtetified" audio.
fourtetslices: chunk size to use for "fourtet" effect
mute: silence this looper
num bars: loop length in measures
offset: amount to offset looper's playhead from transport position
passthrough: should we pass incoming audio through to the output? turn off to mute incoming audio.
pitch: amount to pitch shift looper output
resample for tempo: this button appears when the current global tempo no longer matches the tempo that the buffer was recorded at. click this to resample the buffer to match the new tempo.
save: save this loop to a wav file
scr: allow loop to be scratched by adjusting "scrspd"
scrspd: playback speed, used with "scr" is enabled. modulate quickly for a vinyl-like scratching effect.
swap: swap the contents of this looper and with another. click this button on two loopers to swap them.
undo: undo last loop commit
volume: output volume
write: write input audio to loop buffer
accepts: notes audio
looperrecorder command center to manage recording into multiple loopers, and allow retroactive loop capture (i.e., always-on recording)
.5tempo: halve global transport tempo, while keeping connected loopers sounding the same
1: capture the last measure to the currently-targeted looper
2: capture the last 2 measures to the currently-targeted looper
2xtempo: double global transport tempo, while keeping connected loopers sounding the same
4: capture the last 4 measures to the currently-targeted looper
8: capture the last 8 measures to the currently-targeted looper
auto-advance: automatically advance to the next looper when committing
cancel free rec: if "free rec" is enabled, cancel recording without setting the loop length
clear: clear the recorded buffer
free rec: enable to start recording a loop with no predetermined length. disable to end recording, adjust global transport to match the loop length, and switch the recorder's mode to "loop"
length: length in measures to use when connected loopers use the "commit" button
mode: recorder mode: use "record" to record input and allow it to be committed to buffers when you're ready to loop, use "overdub" to record input and play the loop at our specified length, and use "loop" to play the current loop without adding input
orig speed: reset looper to tempo that loops were recorded at
resample: resample all connected loopers to new tempo
resample & set key: snap tempo to nearest value that matches a key (based upon the current key and the tempo change), resample all connected loopers to that new tempo, and change global scale to the new key
snap to pitch: snap tempo to nearest value that matches a key
target: looper to commit audio to when using the on-buffer capture buttons to the left
write*: writes to this looper, with a loop length matching the nearest power of 2 (1, 2, 4, 8, etc) of how long this checkbox was enabled
accepts: audio
looperrewriter rewrites the contents of a looper with received input, to help you resample your own loops. attach the grey dot to a "looper" module. the ideal way to use this module is to hook the "looper" directly up to a "send", hook the leftmost outlet of the "send" up to your effects processing (like an "effectchain"), hook the effect processing up to this "rewriter", and then also connect the rightmost outlet of the "send" up to this "rewriter"
go: rewrite the connected looper, and if that looper is connected to a send, set that send to output only to the right outlet
new loop: start recording a dynamic loop length. press "go" when you want to rewrite it to the looper. this will also change bespoke's global tempo to match this new loop, so it's quite powerful and scary! click it again to cancel.
accepts: audio
multitapdelay delay with multiple tap points
delay *: tap delay time, in milliseconds
display length: length of buffer display, in seconds
dry: how much dry signal to allow through
feedback *: how much delayed audio from this tap should feed back in to the input
gain *: tap delay amount
pan *: stereo pan for this tap
accepts: notes audio
output route audio in here to send it to an output channel (your speakers or audio interface)
ch: channel (or channels, if you want stereo) to send audio to
accepts: audio
panner pan audio left and right. also, converts a mono input to a stereo output.
pan: amount to send signal to the left and right channels. a value of 0 is centered.
widen: delay a channel by this many samples. results in a pan-like effect where the sound seems to come from from a direction.
accepts: audio
ringmodulator modulate a signal's amplitude at a frequency
dry/wet: how much of the original audio to use vs modulated audio
freq: frequency to use. can also be set by patching a note input into this module.
glide: how long an input note should take to glide to the desired frequency
volume: volume output
accepts: notes audio
samplergrid record input onto pads, and play back the pads. intended to be used with an 64-pad grid controller.
clear: when enabled, clears any pressed grid squares
duplicate: what enabled, duplicates last pressed sample onto any pressed grid squares
edit: enable controls to adjust recorded sample for last pressed grid square
end: sample end
grid: patch a grid in here from a "midicontroller" module
passthrough: should the incoming audio pass through to the output?
start: sample start
vol: the output volume
accepts: notes audio
send duplicate a signal and send it to a second destination
amount: amount to send out the right-side cable
crossfade: when true, output of the left-side cable is reduced as "amount" increases
accepts: audio
signalclamp clamps an audio signal's value within a range
max: maximum output value
min: minimum output value
accepts: audio
spectrum display audio signal's spectral data
accepts: audio
splitter splits a stereo signal into two mono signals, or duplicates a mono signal
accepts: audio
stutter captures and stutters input
16th: 16th note stutter
32nd: 32nd note stutter
64th: 64th note stutter
8th: 8th note stutter
dotted eighth: stutter on a dotted eighth interval
double speed: stutter at double speed, high pitched
free: stutter with the settings specified by the following sliders
free length: length in seconds for "free" stutter mode
free speed: rate for "free" stutter mode
grid: patch a grid in here from a "midicontroller" module
half note: half note stutter
half speed: stutter at half speed, low pitched
quarter: quarter note stutter
ramp in: stutter with speed climbing up from zero to one
ramp out: stutter with speed quickly falling to zero
reverse: reversed half note stutter
triplets: stutter on a triplet interval
tumble down: decelerating stutter
tumble up: accelerating stutter
accepts: notes audio
vocoder frequency band-based vocoder. this must be paired with a "vocodercarrier" module. voice should be routed into this module, and a synth should be patched into the vocodercarrier.
bands: how many frequency bands to use
carrier: carrier signal gain
f base: frequency for lowest band
f range: frequency range to highest band
input: input signal gain
max band: volume limit for each frequency band
mix: how much original input vs vocoded signal to output
q: resonance of the bands
ring: how long it should take the bands to "cool down"
spacing: how frequency bands should be spaced
volume: output gain
accepts: audio
vocodercarrier connect to "vocoder" or "fftvocoder" modules. send the synth audio into this module, and the voice audio into the vocoder module.
accepts: audio
waveformviewer waveform display
draw gain: adjust waveform display scale
freq: frequency to sync display to. gets automatically set if you patch a note input into this module
length: number of samples to capture
accepts: notes audio
waveshaper waveshaping with expressions
a: variable to use in expressions
b: variable to use in expressions
c: variable to use in expressions
d: variable to use in expressions
e: variable to use in expressions
rescale: rescales input before feeding it into expression
y=: waveshaping expression. try something like "x+sin(x*pi*a)". available variables: a,b,c,d,e = the sliders below. t = time. x1,x2,y1,y2 = biquad state storage.
accepts: audio

## modulators

accum accumulate a value over time
value: output value
velocity: amount to accumulate
add outputs the result of value 1 plus value 2. value 1 and value 2 are intended to be patch targets for modulators.
value 1: value to sum
value 2: value to sum
addcentered outputs the result of value 1 plus value 2, multiplied by range 2. optimized for using to modulation value 1 by range 2 at a frequency. value 1 or value 2 are intended to be patch targets for modulators.
range 2: modulation amount
value 1: center value
value 2: modulation value
audiotocv use an audio signal to modulate a control. allow for audio-rate modulation, to achieve effects such as FM.
gain: multiply incoming audio
max: maximum output value
min: minimum output value
accepts: audio
controlrecorder record and play back changes made to a control
clear: clear the recording
length: the interval to quantize to
quantize: should we quantize playback to a specified rhythmic interval?
record: should we be recording input? playback starts after the recording is complete
speed: speed up or slow down playback
controlsequencer modulate a control step-wise at an interval
interval: rate to advance
length: length of the sequence
random: randomize sequence values
record: record targeted value to steps
step *: value for this step
accepts: pulses notes
curve remap an input over its range with a curve. double-click on the curve to add points, right click on points to remove them, drag on lines to bend them.
input: input value (intended as a modulation target)
curvelooper modulate a value over time with a looping curve
length: length of the loop
randomize: create a random curve
dataprovider provides modulation values normally not easily accessible.
interval: the interval to measure
realtime: if enabled this module will work on the audio thread which is more accurate but also more resource intense
set: click here to send the value (or, send a pulse to this module for the same result)
type: the type of value to provide
accepts: pulses
envelope modulate a value with a triggered envelope
adsr: envelope view
adsrA: envelope attack
adsrD: envelope decay
adsrR: envelope release
adsrS: envelope sustain
advanced: switch to advanced envelope editor (allows for a more complicated envelope than just an ADSR). double-click on an advanced envelope line to add stages, right click on points to remove them, drag on lines to bend them.
has sustain: should this envelope have a sustain stage?
high: output high value
length: length of envelope display
low: output low value
max sustain: what's the maximum length of the sustain, in milliseconds? a value of -1 indicates no maximum
sustain stage: which step of the envelope should have the sustain?
use velocity: should envelope output be scaled by input velocity?
accepts: pulses notes
expression shape modulation with a text-based mathematical expression
a: variable to use in expressions
b: variable to use in expressions
c: variable to use in expressions
d: variable to use in expressions
e: variable to use in expressions
input: input to use as x variable
y=: expression to modify input. try something like "x+sin(x*pi*a)". available variables: a,b,c,d,e = the sliders below. t = time.
fubble draw on an X/Y pad and replay the drawing to modulate values. based on a concept proposed by olivia jack
clear: clear the drawing
length: the interval to quantize to
mutate amount: amount to affect drawing by perlin noise field
mutate noise: rate to move through perlin noise field
mutate warp: scale of perlin noise field
quantize: should we quantize playback to a specified rhythmic interval?
reseed: jump to a different location in the perlin noise field
speed: speed up or slow down playback
gravity make a modulation value rise and fall with physics
drag: the resistance force to apply opposite the velocity
gravity: the gravitational force to apply downwards
kick: click to apply kick force (or, pulse this module for the same result)
kick amt: the amount of upward force to apply when kicking
accepts: pulses
gridsliders use a grid controller to control multiple sliders
direction: should the grid display the sliders vertically, or horizontally?
grid: patch a grid in here from a "midicontroller" module
leveltocv output a modulation value based on the level of incoming audio
attack: rise to the input level at this rate
gain: multiply the input audio by this value
max: output when level is one
min: output when level is zero
release: decay from the input level at this rate
accepts: audio
lfo modulates a slider with a low-frequency oscillator
bias: bias the waveform towards the low or high point
enable: turn on/off modulation
free rate: rate of oscillator running in non-clock-synced time
high: output value at waveform's high point
interval: length of oscillation period
length: proportion of time that should be spent on the waveform cycle
lite cpu: only recalculate some parameters once per buffer, to reduce CPU load. can sound worse in some scenarios, especially with rapid modulation.
low: output value at waveform's low point
offset: phase offset, to make oscillation earlier/later
osc: type of oscillation waveform
pin: make LFO window remain visible
shuffle: adjust the waveoform to have a fast and slow cycle
soften: smooth out the hard edges of square and saw waveforms
spread: spread the waveform out to be closer to the low and high points
macroslider take a value and send scaled versions of that value to multiple destinations
end*: the output value at the top of the input's range
input: the input value. intended to be a modulation patch target.
start*: the output value at the bottom of the input's range
modwheeltocv take a note's modwheel value and convert it to a modulation value
max: output for modwheel value 127
min: output for modwheel value 0
accepts: notes
mult outputs the result of value 1 multiplier by value 2. value 1 and value 2 are intended to be patch targets for modulators.
notetofreq takes an input note, and outputs that note's frequency in hertz
accepts: notes
notetoms takes an input note, and outputs the period of that note's frequency in milliseconds. useful for setting delay lines to create specific pitches.
accepts: notes
pitchtocv take a note's pitch and convert it to a modulation value
max: output for pitch 127
min: output for pitch 0
accepts: notes
pitchtospeed convert an input pitch to a speed ratio. you could use this to control a sample's playback speed and make it playable with a keyboard.
ref freq: the output is the input frequency divided by this number
accepts: notes
pitchtovalue output midi pitch value
accepts: notes
pressuretocv take a note's pressure and convert it to a modulation value
max: output for pressure 127
min: output for pressure 0
accepts: notes
ramper blend a control to a specified value over a specified time
length: length of time to blend over
start: begin blending (or, send a pulse to this module for the same result)
target: the value to arrive at when the ramp is over
accepts: pulses
smoother outputs a smoothed value of the input
input: set a value to smooth, patch a modulator into here
smooth: amount of smoothing to apply
subtract outputs the result of value 2 subtracted from value 1. value 1 and value 2 are intended to be patch targets for modulators.
valuesetter set a specified value on a targeted control
set: click here to send the value (or, send a pulse to this module for the same result)
slider: value to set
value: value to set
accepts: pulses
velocitytocv take a note's velocity and convert it to a modulation value
0 at note off: output zero when note is released
max: output for velocity 127
min: output for velocity 0
accepts: notes
vinylcontrol modulator which outputs a speed value based upon control vinyl input audio. provide it with a stereo signal from control vinyl (like you'd use to control serato) patched in from an "input" module.
control: enable/disable transport control. when you enable it, it will use the current speed as the reference speed (so, the output will output a value of 1 until you change the vinyl's speed)
accepts: audio

## pulse

audiotopulse sends a pulse when the audio level surpasses a specified threshold
release: the cooldown time for the audio signal before a pulse can be triggered again
threshold: send a pulse when the signal hits this threshold
accepts: audio
boundstopulse sends a pulse when its input slider hits its max or min limit
input: the slider to check bounds on
notetopulse trigger a pulse whenever a note is received
accepts: notes
pulsebutton trigger a pulse with a button press
pulse: trigger a pulse
pulsechance randomly allow pulses through, based on chance
*: generate a new random seed
<: go to previous seed
>: go to next seed
chance: chance that pulses are allowed through
deterministic: allow for randomness to be repeated over an interval
seed: number that determines the random sequence. send reset pulses to restart the deterministic random sequence.
accepts: pulses
pulsedelayer delay pulses
delay: time to delay, in fractions of a measure
accepts: pulses
pulsedisplayer see what flags are on pulses
accepts: pulses
pulseflag set properties on pulses
flag: property to add
replace: if disabled, the above flag is appended to the pulse's flags. if enabled, the pulse's flags are replaced by the above flag.
accepts: pulses
pulsegate control if pulses are allowed through
allow: can pulses pass through?
accepts: pulses
pulsehocket sends pulses to randomized destinations
*: generate a new random seed
<: go to previous seed
>: go to next seed
seed: number that determines the random sequence. send reset pulses to restart the deterministic random sequence.
weight *: chance that pulse goes to this destination
accepts: pulses
pulselimit limit the number of pulses allowed to pass through
limit: limit number of pulses to pass through
reset: reset the counter of seen pulses
accepts: pulses
pulser send pulse messages at an interval
div: measure division, when using "div" as the interval
interval: rate to send pulses
offset: pulse time offset, in fractions of the interval
random: tell pulsed modules to randomize their position
reset: length of sequence before sending reset pulse
restart: restart timer on "free" counter
t: pulse interval in milliseconds
timemode: when to send downbeat pulses, or set to "free" for pulses not locked to the transport
pulserouter allows you to control where pulses are routed to using a UI control. to add destinations to the list, patch them as a target
route: the pulserouter's destination module
accepts: pulses
pulsesequence defines a looping sequence of pulses
- : advance the sequence backwards
+: advance the sequence forward
<: shift sequence to the left
>: shift sequence to the right
interval: length of each step within the sequence
length: length of the sequence
pulse: when enabled will send out pulses as per sequence when advancing with the buttons
accepts: pulses
pulsetrain defines a list of pulses to execute, once pulsed
interval: length of each step within the sequence
length: length of the sequence
accepts: pulses

## effect chain

basiceq simple multiband EQ
even: reset EQ
accepts: audio
biquad filter using biquad formula
F: frequency cutoff
G: gain
Q: resonance
type: filter type
accepts: audio
bitcrush reduce sample resolution and sample rate for lo-fi effects
crush: sample resolution reduction
downsamp: sample rate reduction
accepts: audio
butterworth filter using the butterworth formula
F: frequency cutoff
Q: resonance
accepts: audio
compressor try to keep volume at a certain level
attack: speed to apply gain reduction
drive: rescale input to affect how much compression affects it
lookahead: how much time to "look ahead" to adjust the compression envelope. this necessarily introduces a delay into your output, which could be compensated for by running sequencers slightly early.
mix: amount of compression. lower this value for a "parallel compression" effect. you should use this mix slider instead of the effectchain's mix slider, to compensate for lookahead.
output: makeup gain, to increase volume
ratio: how much gain reduction to apply when the single passes the threshold
release: speed to remove gain reduction
threshold: threshold where gain should start to be reduced
accepts: audio
dcremover high pass filter with a 10hz cutoff to remove DC offset, to keep signal from drifting away from zero
accepts: audio
delay echoing delay
amount: amount of delay that returns
delay: delay in milliseconds
dry: should the dry signal pass through, or just the delayed signal?
feedback: should the output audio feed back into the delay?
input: should we accept input into the delay?
interval: sets delay length to a musical duration
invert: should the delayed audio have its signal inverted? this can give a different sound, and also cancel out DC offset to prevent it from accumulating with feedback.
short: shortcut to shrink the range of the delay slider, to allow for audible-rate delays and comb filter sounds
accepts: audio
distortion waveshaping distortion
center input: remove dc offset from input signal to distort in a more controlled way
clip: cutoff point of distortion, lower values result in more extreme distortion
fuzz: push input signal off-center to distort asymmetrically
preamp: signal gain before feeding into distortion
type: style of distortion to apply
accepts: audio
freeverb reverb using the "freeverb" algorithm
damp: high frequency attenuation; a value of zero means all frequencies decay at the same rate, while higher settings will result in a faster decay of the high frequency range
dry: amount of untouched signal
room size: controls the length of the reverb, a higher value means longer reverb
wet: amount of reverb signal
width: stereo width of reverb
accepts: audio
gainstage control volume within an effectchain
gain: volume multiplier
accepts: audio
gate only allow signal in when it's above a certain threshold. useful to eliminate line noise, or just as an effect.
attack: speed at which gate blends open
release: speed at which gate blends closed
threshold: volume threshold to open up the gate
accepts: audio
granulator granulate live input
autocapture: freeze input at this interval
dry: amount of dry signal to allow through
frz: freeze the current recorded buffer
g oct: should we add octaves and fifths?
len ms: length of each grain in milliseconds
overlap: number of overlapping grains
pos: playback position within the buffer
pos r: randomization of grain start point
spa r: randomization of time between grains
spd r: randomization of grain speed
speed: speed of grain playback
width: stereo width of grain placement
accepts: audio
muter mute an incoming signal
ms: ramp time to mute/unmute signal
pass: when true, the signal is allowed through
accepts: audio
noisify multiply input signal by white noise
amount: amount of noise to apply
width: how frequently a new noise sample should be chosen
accepts: audio
pitchshift shifts a signal's pitch
ratio: amount to pitchshift by (a value of 1 indicates no shift)
ratioselector: shortcuts to useful pitch ratios
accepts: audio
pumper dip the volume of a signal rhythmically, to emulate a "pumping sidechain" effect
amount: amount to lower volume
attack: how sharply the volume drops
curve: how the volume returns
interval: the rate to pump
length: length of pump
accepts: audio
tremolo modulate signal's volume rhythmically
amount: amount to lower volume
duty: pulse width of LFO
interval: speed of LFO
offset: offsets LFO phase
osc: LFO oscillator type
accepts: audio

## other

abletonlink synchronizes transport with software and devices that support ableton link
offset ms: offset in milliseconds to tweak synchronization
reset next downbeat: resets measure count on the next downbeat, to help synchronize to desired phase in session
clockin reads in clock pulses from external midi devices to control bespoke's transport
device: device to receive from
rounding: precision to round incoming tempo data
smoothing: how much to smooth incoming tempo
start offset ms: offset in milliseconds to tweak synchronization between bespoke and gear
clockout sends out clock pulses to synchronize external midi devices
device: device to target
multiplier: tempo multiplier for how the gear should respond to the signals
send start: send a signal to reset the gear to the start of its sequence
comment a box to display some text, to explain a section of a patch
comment: type text here
eventcanvas schedule values to set over time
canvas: canvas of events. canvas controls: -shift-click to add an event -hold shift and drag an event to duplicate -hold alt to drag an event without snapping -hold ctrl while dragging to snap to an interval -hold shift and scroll to zoom -hold alt and grab empty space to move slide the canvas view -hold ctrl and grab empty space to zoom the canvas view
clear: delete all elements
delete: delete highlighted elements
drag mode: direction that elements can be dragged
interval: grid for snapping events to
measures: length of loop
quantize: quantizes events to grid
record: record connected values as they change
scrollh: horizontal scrollbar
timeline: control loop points
view rows: number of visible rows
globalcontrols interface controls, intended to allow you to use midi controllers to navigate the canvas. controlling these sliders directly with the mouse is not recommended.
background b: amount of blue in background color
background g: amount of green in background color
background r: amount of red in background color
cable alpha: opacity of the cables
corner radius: how round bespoke's rectangles are
lissajous b: amount of blue in background lissajous curve
lissajous g: amount of green in background lissajous curve
lissajous r: amount of red in background lissajous curve
scroll x: emulate horizontal mouse scrolling
scroll y: emulate vertical mouse scrolling
x pos: horizontal panning position
y pos: vertical panning position
zoom: zoom level
grid generic grid, to be used by "script" module, to assist in writing scripts that use grid-based midi controllers
grid: patch a grid in here, from a "midicontroller" module
momentary: should clicks be treated as momentary inputs?
accepts: notes
groupcontrol connect to several checkboxes, and control them all with one checkbox
group enabled: controls the connected checkboxes
label A module to display a label, helpful in marking what is where in large patches
color: The color of the label
font: The font of the label
label: The label that will be displayed
showcontrols: Hide and show the controls to modify the label
size: The font size of the label
loopergranulator use with a "looper" module to play the contents with granular synthesis
freeze: stop advancing looper time
len ms: length of each grain in milliseconds
loop pos: playback position within loop
octaves: should we add octaves and fifths?
on: use granular synthesis for looper playback
overlap: number of overlapping grains
pos rand: randomization of grain start point
spacing rand: randomization of time between grains
speed: speed of grain playback
speed rand: randomization of grain speed
width: stereo width of grain placement
multitrackrecorder record several synchronized tracks of audio, to write to disk for mixing in an external DAW
add track: add an additional track
bounce: write the tracks to your recordings directory
clear: clear the audio in the tracks
record: record input to the tracks
notetoggle turn a control on or off depending on if there are any input notes
accepts: notes
oscoutput send OSC messages when slider values change or when notes are received
label*: label to send slider value. the message will be sent in the format /bespoke/[label] [value]
note out address: label to send input notes. the message will be sent in the format /bespoke/[label] [pitch] [velocity]
osc out address: destination to send OSC messages to
osc out port: port to send OSC messages to
slider*: sends a value to the address. try patching a modulator into this, such as a leveltocv module to send audio levels.
accepts: notes
prefab create a collection of modules that can be loaded from the "prefabs" menu. drag and drop modules onto here to add them to the prefab. drag the grey cable to any modules you want to remove from the prefab.
disband: free all modules from this prefab
load: load a .pfb
save: save as a .pfb file
push2control use an ableton push 2 to control bespoke's interface
radiosequencer sequence to only enable one value at a time. patch it to the "enabled" checkbox on several modules to only enable one module at a time. works well in conjunction with "groupcontrol" module.
grid: patch a grid in here from a "midicontroller" module
interval: rate to advance
length: length of sequence
accepts: pulses notes
samplebrowser browse your system for samples. drag samples from here to your desired targets (sampleplayer, drumplayer, seaofgrain, etc)
< : previous page
> : next page
savestateloader loads other savestate files (and unloads the current savestate). the number of buttons can be adjusted in the triangle menu.
load *: loads specified savestate file. shift-click to choose a new file.
scale controls the global scale used by various modules
PPO: pitches per octave
intonation: which method to use to tune the scale
load KBM: load KBM file to determine keyboard mapping
load SCL: load SCL file to determine scale
note: the pitch that maps to the frequency defined in "tuning"
root: root note of the scale
scale: which set of notes to use
tuning: what frequency does the pitch defined in "note" represent?
script python scripting for livecoding notes and module control
?: show scripting reference
a: variable for the script to use, can be modulation by other sources. access via me.get("a")
b: variable for the script to use, can be modulation by other sources. access via me.get("b")
c: variable for the script to use, can be modulation by other sources. access via me.get("c")
code: write code here. press ctrl-R to execute the code, or ctrl-shift-R to just execute the current block.
d: variable for the script to use, can be modulation by other sources. access via me.get("d")
load: load selected script
loadscript: choose a script from here, then press "load"
run: click here to execute the code, or press ctrl-R
save as: save the current script
stop: cancel any events scheduled by this script
style: choose a text theme, from script_styles.json
accepts: pulses notes
scriptstatus shows everything in the current python scope, for debugging
reset all: resets scope variables
selector radio button control to only enable one value at a time. patch it to the "enabled" checkbox on several modules to only enable one module at a time. works well in conjunction with "groupcontrol" module.
selector: which value should be set to 1
accepts: notes
snapshots save and restore sets of values. connect the grey circle to modules to affect all controls on that module. connect the purple circle to a control to affect only that control. shift-click on the grid to store a snapshot to that square, and click on a grid square to load that snapshot. alt/option-click to delete a snapshot, and ctrl/command-click to rename a snapshot.
add: snapshot the currently connected controls to the next available snapshot slot
blend: length of time in milliseconds over which to blend snapshot values
delete: when clicking/selecting a snapshot, delete that slot (alternately: hold the alt/option key)
random: randomize connected controls
snapshot: jump to a snapshot
snapshot label: assign a label to this snapshot
store: when clicking/selecting a snapshot, store into that slot (alternately: hold the shift key)
accepts: notes
songbuilder large-scale organizer to arrange settings into scenes and then sequence them. this is bespoke's "song mode"
activate first scene on stop: when stopping, activate the first scene. it is recommended that you use the first scene as an "off" scene, and have it disable all song elements.
add target: add a targeted control for scenes to affect
bars*: length in bars that this scene should play for
change quantize: when a change should happen after pressing the play button on a scene. "switch" changes immediately, and "jump" changes immediately and also resets the global transport.
checkbox*: value to use for target in this scene
color*: color to theme this target
context*: options for this scene
contextmenu*: options for this step
dropdown*: value to use for target in this scene
go*: play this scene
loop: enable a loop within the sequence
loop end: loop step index that the loop ends
loop start: loop step index to start the loop on
move left: move this target left in the scene
move right: move this target right in the scene
name*: name of this scene
pause: hold the sequence on the current scene
play: play the sequence
play from*: play sequence from this step
scene*: name of scene for this step
stop: stop the sequence
type: change the control display type for this target
use sequencer: show scene sequencer
value*: value to use for target in this scene
accepts: pulses notes
timelinecontrol control global transport position
dock: should we dock this module to the UI layer?
length: length of timeline display, in measures
loop: should we have a looping section?
loop end: measure end of loop
loop start: measure start of loop
measure: current position. click to jump around.
reset: reset to beginning
timerdisplay displays a timer to indicate how long a patch has been running
reset: reset timer to zero
transport controls tempo and current time position
+ : increase tempo by one
- : decrease tempo by one
< : nudge current time backward
> : nudge current time forward
play/pause: stop all audio processing (shift-p)
reset: reset timeline to zero
swing: where the halfway point of musical time within the swing interval should fall. a value of .5 represents no swing.
swing interval: interval over which to apply swing
tempo: global tempo, in beats per minute
timesigbottom: time signature bottom value
timesigtop: time signature top value
valuestream displays a control's value over time. connect the cable to a UI control to see how it is changing.
speed: how quickly display should scroll