Soniare
We would like to use cookies to help us advertise

Beat DJ Commands

This is a comprehensive resource with all the commands but for learning the basics checkout the guide page and try using the `ai` command inside Beat DJ to ask for help with commands like `ai how do I load a sound?`

Category – global

Record <action>

Keywords: record, rec

Description: Record audio output

Access Level: pro

ArgumentDescriptionRangeDefaultTypeOptions
<action>how you want to recordstartstring
  • start
  • stop
  • fromTo – from a point on the timeline to another point
  • for – for a number of minutes & seconds

MicRecord <action>

Keywords: micRecord, inputRecord, input, inRec, mic

Description: Record your computers input or microphone

Access Level: pro

ArgumentDescriptionRangeDefaultTypeOptions
<action>start or stopstartstring
  • start
  • stop

AbletonLink

Keywords: abletonLink, aLink

Description: Toggle Ableton Link

Access Level: pro

Play

Keywords: play, pla, pl, p

Description: Plays from beginning

InfoBox <enable>

Keywords: infoBox, info, toolTip, tipBox, tip

Description: Enable tool tip info box

ArgumentDescriptionRangeDefaultTypeOptions
<enable>Enable or disableybool
  • yes
  • no

UnitDisplay <unit>

Keywords: unitDisplay, units, unit

Description: Change how units are displayed on the interface

ArgumentDescriptionRangeDefaultTypeOptions
<unit>Unit to displaysstring
  • s – 16th notes (default)
  • e – 8th notes
  • q – quarter notes
  • h – half notes
  • b – bars
  • p – phrases

WindowSize <length> <updateUnits>

Keywords: windowSize, timelineSize, timeSignature, timeSig, window

Description: Timeline window size

ArgumentDescriptionRangeDefaultTypeOptions
<length>the size of the window in 16th notes. Helps for using different time signatures.64string
  • 24 – 3/8 - Quick waltz or scherzo
  • 40 – 5/8 - Shortened quintuple, irregular grouping
  • 48 – 3/4 & 6/8 - Waltz or compound duple feel
  • 56 – 7/8 - Shortened septuple, irregular grouping
  • 64 – 4/4 (default) - Common time, standard
  • 72 – 9/8 - Triple compound meter
  • 80 – 5/4 - Quintuple meter, asymmetrical feel
  • 96 – 6/4 & 12/8 - Slow compound or extended simple
  • 112 – 7/4 - Septuple meter, asymmetrical feel
<updateUnits>Update bar/phrase length to match the new time signature?ybool
  • y – yes, update
  • n – no, keep the same bar/phrase length

Loop <startPoint> <endPoint>

Keywords: loop, loo, lo

Description: Loop

ArgumentDescriptionRangeDefaultTypeOptions
<startPoint>Start point in musical time, -1 to turn off0-2147483647-1musical time
<endPoint>End point in musical time, -1 to turn off0-2147483647-1musical time

Jump <distance>

Keywords: jump, jum, ju

Description: Jump

ArgumentDescriptionRangeDefaultTypeOptions
<distance>Distance to jump in musical time-2147483647-21474836471musical time

GlitchLoop <probability>

Keywords: glitchLoop, gLoop

Description: GlitchLoop

ArgumentDescriptionRangeDefaultTypeOptions
<probability>Probability of glitching on next playback 0-90-99float

Stop

Keywords: stop, sto, st

Description: Stops playback

LoadProject <projectName>

Keywords: loadProject, load

Description: Load a project

Access Level: pro

ArgumentDescriptionRangeDefaultTypeOptions
<projectName>Name in Projects folder or a folder pathstring

SaveProject <projectName>

Keywords: saveProject, save

Description: Save the project

Access Level: pro

ArgumentDescriptionRangeDefaultTypeOptions
<projectName>Name of the project string

ScrollSensitivity <sensitivity> <decelerationRate>

Keywords: scrollSensitivity, scroll, sensitivity

Description: Change the scroll sensitivity and deceleration rate of the CLI and sound list

ArgumentDescriptionRangeDefaultTypeOptions
<sensitivity>Sensitivity of the scroll. Default is 9. Max is 128.0-1289float
<decelerationRate>The deceleration rate is the speed reduction per second. A value of 0.5 halves the speed each second. Default is 0.120-10.12float

OpenFiles

Keywords: openFiles, files, fil

Description: Open file location where all files are exported

TtsPitch <pitch> <transitionTime>

Keywords: setTtsPitch, ttsPitch, ttsPit, ttsp

Description: Change the pitch and speed with multiplier

ArgumentDescriptionRangeDefaultTypeOptions
<pitch>Pitch multiplier from 0.0625 to 16. 1 is normal pitch.0.0625-16 inclusive1float
<transitionTime>Transition time in musical time0-21474836470musical time

TtsVolume <volume> <transitionTime>

Keywords: setTtsVolume, ttsVolume, ttsVol, ttsv

Description: Change the volume of the text to speech voice

ArgumentDescriptionRangeDefaultTypeOptions
<volume>Volume from 0 to 90-9 inclusive6float
<transitionTime>Transition time in musical time0-21474836470musical time

BPM <newBPM> <speed>

Keywords: bpm, tempo

Description: Set the BPM (beats per minute) aka tempo

ArgumentDescriptionRangeDefaultTypeOptions
<newBPM>The new beats per minuterstring
  • 127.5 – enter a custom bpm
  • u – up to closest harmonic bpm of 120bpm
  • d – down to closest harmonic 120bpm
  • r – random harmonic of 120bpm
<speed>transition time in seconds:0-21474836470float

TTS <wordsToSpeak>

Keywords: textToSpeech, speak, talk, tts

Description: Text to speech

Access Level: pro

ArgumentDescriptionRangeDefaultTypeOptions
<wordsToSpeak>Type whatever you want to say.string

SetTTSVoice <voice>

Keywords: setTTSVoice, setVoice, ttsVoice

Description: Set TTS voice

Access Level: pro

ArgumentDescriptionRangeDefaultTypeOptions
<voice>The voice you want for TTSamystring
  • en-us-amy-low – Amy, english low quality
  • en-us-amy-medium – Amy, english medium quality
  • en-us-arctic-medium – Arctic, english medium quality
  • – run command to see all 119 piper voices with other languages

Scale <action>

Keywords: scale, sca, sc

Description: Set scale

ArgumentDescriptionRangeDefaultTypeOptions
<action>What you want to do with the scalerstring
  • p – Play current scale
  • s – Stop playing scale
  • j – New just intonation scale
  • e – New equal division (edo) scale
  • r – Random just intonation scale
  • re – Random EDO scale
  • ch – Play chord
  • m – Manually set ratios
  • scl – Import a scale from an SCL file
  • exp – Export the scale as an SCL/KBM pair of files
  • pri – Print the scale ratios and frequencies

Find

Keywords: find, fin, fi

Description: Select currently playing sounds

Video <video> <action>

Keywords: video, vid

Description: Display and control videos

Access Level: pro

ArgumentDescriptionRangeDefaultTypeOptions
<video>Video to modifyint
  • -1 – All videos
  • 0 – Video 0
  • 1 – Video 1
  • 2 – Video 2
<action>Action to applystring
  • s – show
  • h – hide
  • l – load
  • bg – send to background
  • fg – send to foreground
  • bgm – background mode
  • d – dimensions
  • dp – dimensions preset
  • t – transparency

Guide <level>

Keywords: guide

Description: A guide to walk you through how to use Beat DJ

ArgumentDescriptionRangeDefaultTypeOptions
<level>Experience level0-21474836470int
  • 0 – get started
  • 1 – basics
  • 2 – editing
  • 3 – effects & live performance
  • 4 – exporting & more
  • 5 – song structure
  • 6 – synthesis
  • 7 – advanced editing
  • 8 – visuals
  • 9 – automation

Effects <rack> <effect>

Keywords: effects, eff, fx

Description: Apply effects to effects racks

ArgumentDescriptionRangeDefaultTypeOptions
<rack>Rack to apply effects toint
  • -1 – All racks
  • 0 – Rack 0
  • 1 – Rack 1
  • 2 – Rack 2
  • 3 – Rack 3
  • 4 – Rack 4
  • 5 – Rack 5
<effect>Effect to applystring
  • vol – volume
  • dis – distortion
  • fla – flange
  • ech – echo
  • cho – chorus
  • rev – reverb
  • lpf – lowpass
  • hpf – highpass
  • res – reset effects
  • sav – save rack preset
  • loa – load rack preset
  • pri – print effects values that are active

History <numCommands>

Keywords: history, hist, his

Description: View the last 32 commands or specify a number to view

ArgumentDescriptionRangeDefaultTypeOptions
<numCommands>Number of commands to view0-214748364732int

HistorySearch <searchTerm>

Keywords: searchHistory, historySearch, pastSearch, search, hse

Description: Search command history

ArgumentDescriptionRangeDefaultTypeOptions
<searchTerm>Search termstring

SyncBPM

Keywords: syncBPM, sync

Description: Sync BPM with other instruments by hitting enter at the right time. Not great but could work :)

SetSourceFolder <folderPath>

Keywords: setSourceFolder, sampleSource, sampleSrc, src

Description: Set the folder Beat DJ will pull sounds from

ArgumentDescriptionRangeDefaultTypeOptions
<folderPath>Full path or shortcode to the folderstring
  • music – your music folder
  • desktop – your desktop folder
  • downloads – your downloads folder
  • bdj – Beat DJ folder
  • bdj_downloads – Beat DJ downloads folder
  • mic – Beat DJ microphone recordings folder

SetSoundBankFolder <folder>

Keywords: setSoundBankFolder, soundBank, bank

Description: Set the sound bank folder to load bdjwav files from

ArgumentDescriptionRangeDefaultTypeOptions
<folder>Folder to load bdjwav files fromstring

Log <action>

Keywords: log

Description: Log

Access Level: pro

ArgumentDescriptionRangeDefaultTypeOptions
<action>Action to logstring
  • c – copy log to clipboard
  • e – export log to file

PlayFrom <index>

Keywords: playFrom, pf

Description: Play from a specific 16th note

ArgumentDescriptionRangeDefaultTypeOptions
<index>Index to play from0-2147483647int

PlayBar <index>

Keywords: playFromBar, playBar, pb

Description: Play from a specific bar

ArgumentDescriptionRangeDefaultTypeOptions
<index>Index to play from0-2147483647int

Quit

Keywords: quit, exit

Description: Quit the app

Tonic <frequency> <speed>

Keywords: tonic

Description: Set the tonic frequency which will change the bpm to be a multiple of the frequency.

ArgumentDescriptionRangeDefaultTypeOptions
<frequency>Tonic frequencyfloat
  • 512 – Hertz
  • m60 – Midi number
  • c4 – Note name
<speed>Transition time in seconds0-21474836470float

DefaultHumanize <amount>

Keywords: defaultHumanize, defHum, defHu

Description: Sets default humanize amount that will randomly vary the play position of a sound within (val/9)*64th Note negative to positive.

ArgumentDescriptionRangeDefaultTypeOptions
<amount>Amount to humanize0-9 inclusive2float

Select <selection>

Keywords: select, sel

Description: Select which sounds to edit. Mostly informational like a help command - not commonly used.

ArgumentDescriptionRangeDefaultTypeOptions
<selection>Selectionstring
  • 0 – The oldest sound
  • kick – Sounds with kick in the name
  • clap,hat – Sounds with clap or hat in the name
  • i*kick,bass – Everything except the kick and bass (inverted)
  • bass – Sounds with bass in the name
  • l – Low frequency sounds
  • m – Mid frequency sounds
  • h – High frequency sounds
  • i*h – Everything except high frequency sounds (inverted)
  • 0,perc,h – Sound 0, sounds with perc in the name and high frequency sounds
  • r – Random sounds
  • 3r – Selects 30% of sounds randomly
  • 6r – Selects 60% of sounds randomly
  • 9r – Selects 90% of sounds randomly
  • a – All sounds
  • 1-4 – Sounds 1 through 4 (range selection)
  • 0-2,snare – Sounds 0 through 2 and sounds with snare in the name
  • 0,2,4,8 – Sounds 0,2,4,8 (specific selection)
  • -1 – The newest sound
  • -2 – The second newest sound
  • r1 – Sounds on rack 1
  • r2 – Sounds on rack 2
  • ev – Even numbered sounds
  • od – Odd numbered sounds
  • t:drum – Sounds of type drum
  • t:synth – Sounds of type synth

ZoomOut

Keywords: zoomOut, zou, zo

Description: Zoom out

ZoomIn

Keywords: zoomIn, zin, zi

Description: Zoom in

New

Keywords: new

Description: See whats new in the latest version

Category – edit

MergeChops

Keywords: mergeChops, mc

Description: Merge all chops into one

Update

Keywords: update

Description: Opens download page

Change <attribute> <every>

Keywords: change, cha

Description: Change a sound every so often. Mostly non-destructive. Most changes do not accumulate, they replace each other.

ArgumentDescriptionRangeDefaultTypeOptions
<attribute>Attribute to change. Most changes do not accumulate, they replace each other. Mel and Swap accumulate. g, p, and r are exclusive and can not overlap but they can overlap with other changes.pstring
  • g – groove changes - either dyn, ve, or tra
  • p – non-destructive presets - either dyn, ve, tra, rol, or rev
  • r – random - all possible changes
  • mel – melody
  • dyn – dynamics
  • ve – volume envelope
  • tra – transient
  • rol – roll
  • rev – reverse
  • swa – swap
  • n – none - removes all changes
<every>How often to change. Use 'n' to disable.0-21474836472pmusical time

SaveToBank

Keywords: saveToBank, saveFile, stb, sb, sf

Description: Save the sound to a file in the SoundBank folder

Access Level: pro

Modify <search> <dynamicDryWetMix>

Keywords: modifiers, modifier, modify, mod, m

Description: Modify sounds with C# script effects.

ArgumentDescriptionRangeDefaultTypeOptions
<search>Keyword to search for a script effectstring
<dynamicDryWetMix>Dry/Wet mix of the effectpstring
  • 9 – full wet
  • 0 – full dry
  • p – human-ish pattern
  • r – random
  • a – ascending wetness
  • d – descending wetness
  • 90 – wet dry
  • 09 – dry wet
  • 900 – wet dry dry
  • 931 – wet quiet almost_dry
  • 369 – quiet mid wet
  • 3084760 – crazy
  • adrp – combine presets to form larger patterns
  • ddac – use c to continue the previous preset
  • 0 – reset all to dry

VolumeEnvelope <envelope>

Keywords: volumeEnvelope, volEnv, ven, ve

Description: Apply a volume envelope on each chop

ArgumentDescriptionRangeDefaultTypeOptions
<envelope>Volume envelope to applypstring
  • a – ascending
  • d – descending
  • r – random
  • p – pattern
  • 90 – fade out
  • 09 – fade in
  • 900 – fade out fast
  • 090 – fade to max volume and fade out
  • 909 – max to silent to max
  • 9150 – down to almost silent then up to half then down
  • 1934803 – crazy
  • adrp – combine presets to form larger patterns
  • ddac – use c to continue the previous preset
  • 9 – reset

Roll <count>

Keywords: roll, rol

Description: Apply a roll on each chop. A roll is a quick repetition of the chop.

ArgumentDescriptionRangeDefaultTypeOptions
<count>Number of repetitions for each chop. Examples:rstring
  • a – ascending
  • a2 – ascending powers of 2
  • d – descending
  • d2 – descending powers of 2
  • r – random - high numbers
  • p – pattern - random low numbers
  • adrp – combine presets to form larger patterns. a2 & d2 not supported.
  • ddac – use c to continue the previous preset
  • 2 – repeat twice on every chop
  • 2.5 – repeats 2 & a half times
  • 2,3,4 – 2 then 3 then 4
  • 32,24,16,12,8,6,4,2,1 – glitchy
  • 1 – reset

SetEffectsRack <effectsRackIndex>

Keywords: setEffectsRack, effectsRack, fxRac, rack, rac

Description: Set effects rack

ArgumentDescriptionRangeDefaultTypeOptions
<effectsRackIndex>Index of the effects rack to set0-5 inclusive0int

Continue

Keywords: continue, con, co, c

Description: Duplicates the sound and moves it after the original. Fast way to add variation.

Move <position> <speed>

Keywords: move, mov, mv

Description: Move sound from heaphones to speakers and vice versa

Access Level: pro

ArgumentDescriptionRangeDefaultTypeOptions
<position>Position from headphones (-1) to speakers (1)1float
  • 1 – speakers
  • 0 – staging area
  • -1 – headphones
<speed>Speed to move to destination in musical time0-21474836474musical time

Delete <areYouSure>

Keywords: delete, del, d

Description: Delete selected sounds

ArgumentDescriptionRangeDefaultTypeOptions
<areYouSure>Are you sure you want to delete?nbool
  • y – yes, delete sounds
  • n – no

DeleteAfterSpan

Keywords: deleteAfterSpan, das

Description: Delete sound after span

RemoveClicks <clickThreshold> <numSamplesToCrossfade>

Keywords: removeClicks, unclick, unc

Description: Remove clicks from a sound

ArgumentDescriptionRangeDefaultTypeOptions
<clickThreshold>Volume difference to consider a click0-10.2float
<numSamplesToCrossfade>Number of samples to crossfade at click points0-21474836478int

Align

Keywords: align, ali

Description: Align a sound to the time signature. Makes it more standard.

Reset

Keywords: reset, res

Description: Reset the sound back to normal. Removes non-destructive edits like dynamics, roll, reverse, transient, volume envelope, change, and evolutions.

Extend

Keywords: extend, ext, ex, e

Description: Double the loop length

Shrink

Keywords: shrink, shr

Description: Halve the loop length

Volume <volume> <speed>

Keywords: setVolume, volume, vol, vo, v

Description: Change the volume

ArgumentDescriptionRangeDefaultTypeOptions
<volume>Volume from 0 to 90-9 inclusive6float
<speed>Speed to change volume in musical time0-21474836470musical time

Lock <shouldLock>

Keywords: lock, loc

Description: Lock sound. Disables destructive operations like delete, shuffle, pitch, etc.

ArgumentDescriptionRangeDefaultTypeOptions
<shouldLock>Should locknbool
  • y – yes/lock
  • n – no/unlock

Pitch <pitch> <transitionTime>

Keywords: setPitch, pitch, pit, pi

Description: Change the pitch and speed with multiplier. Does not effect loop length but it changes the length of playback.

ArgumentDescriptionRangeDefaultTypeOptions
<pitch>Pitch multiplier from 0.0625 to 16. 1 is normal pitch.0.0625-16 inclusive1float
<transitionTime>Transition time in musical time0-21474836470musical time

PrintProperties

Keywords: printProperties, printProp, print, edit, pri

Description: Prints all properties of the current sound and its chops to the log. This includes pitch, pan, human feel, and all chop details like pitch ratios, roll amounts, envelopes, and more.

Egg <length> <width> <pointiness>

Keywords: egg, wonk, wonky

Description: Add an egg shape / wonkiness to the loop

ArgumentDescriptionRangeDefaultTypeOptions
<length>Length of the egg in musical time. -1 to turn off.4-21474836473musical time
<width>Width of the egg from 0 to 90-9 inclusive3float
<pointiness>Pointiness of the egg from 0 to 90-9 inclusive3float

Swing <swing>

Keywords: swing, swi

Description: Add swing to a loop. 50 is centered. Under 50 is reverse swing. Overrides egg.

ArgumentDescriptionRangeDefaultTypeOptions
<swing>Amount of swing from 5 to 95 percent. 50 is none.5-95 inclusive66.666float

SwingRatio <numerator> <denominator>

Keywords: swingRatio, swr

Description: Add swing to a loop using a ratio. 1/2 is centered. Less than 1/2 is reverse swing. Max is 95%. Min is 5%. Overrides egg.

ArgumentDescriptionRangeDefaultTypeOptions
<numerator>Numerator of the ratio-2147483647-21474836471float
<denominator>Denominator of the ratio1-21474836472float

Humanize <amount>

Keywords: humanize, hum, hu

Description: Humanize the playback position. Adds a random offset to the playback position.

ArgumentDescriptionRangeDefaultTypeOptions
<amount>Amount to humanize0-9 inclusive1float

Grow <numChops>

Keywords: grow, gro

Description: Grow the loop by adding random chops to the end

ArgumentDescriptionRangeDefaultTypeOptions
<numChops>Number of chops to append (can be negative to shrink)1int

GrowFront <numChops>

Keywords: growFront, growF, grf

Description: Grow the front of the loop by adding random chops to the front

ArgumentDescriptionRangeDefaultTypeOptions
<numChops>Number of chops to prepend (can be negative to shrink)1int

Transient <pattern>

Keywords: transient, tran, tra

Description: Transient fullness. Beat DJ does automatic 0 crossing detection and gain compensation so it won't lose power or sound clicky.

ArgumentDescriptionRangeDefaultTypeOptions
<pattern>Transient patternpstring
  • p – human-ish pattern
  • r – random
  • a – ascending
  • d – descending
  • 73 – medium mild
  • 931 – full mild tiny
  • 3.3 – decimals are supported
  • 7.5,4,3.1 – comma separated decimals are supported
  • adrp – combine presets to form larger patterns
  • ddac – use c to continue the previous preset
  • 9 – reset all chops to max fullness

Rotate <numChops>

Keywords: rotate, rot, ro

Description: Rotate chops in the loop

ArgumentDescriptionRangeDefaultTypeOptions
<numChops>Number of chops to rotate (can be negative to go other way)1int

Dynamics <pattern>

Keywords: dynamics, dyn

Description: Add volume differences to each segment of the loop. Options are: p (will choose a random pattern), r (totally random), a (ascending), d (descending), 9093045 (custom and repeats), 9 (max volume on all)

ArgumentDescriptionRangeDefaultTypeOptions
<pattern>Dynamics patternpstring
  • p – human-ish pattern
  • r – random
  • a – ascending
  • d – descending
  • 90 – loud silent
  • 09 – silent loud
  • 900 – loud silent silent
  • 931 – loud quiet almost_silent
  • 369 – quiet mid loud
  • 3084760 – crazy
  • adrp – combine presets to form larger patterns
  • ddac – use c to continue the previous preset
  • 9 – reset all to max volume

Melody <pattern>

Keywords: melody, mel, me

Description: Change the melody of the loop. Options are: p (random human sounding pattern), r (random within octave), 0,3,4,33,42 (custom notes - pattern repeats)

ArgumentDescriptionRangeDefaultTypeOptions
<pattern>Melodic patternpstring
  • p – human-ish pattern
  • r – random
  • a – scale ascending
  • d – scale descending
  • adrp – combine presets to form larger patterns
  • ddac – use c to continue the previous preset
  • 0,3,4,7,8,11 – custom scale (can be greater than # of divisions for higher octaves)

MelodyShift <shift>

Keywords: melodyShift, melShift, melShi, msh

Description: Ability to shift the melody up or down by a scale degree.

ArgumentDescriptionRangeDefaultTypeOptions
<shift>Shift amount in scale degrees. Can be negative.-128 to 128int

Guitar <stringNum> <frets>

Keywords: guitar, guit, gui

Description: Enter guitar string numbers and fret numbers to play a melody. Pitches will get snapped to the Beat DJ scale so it won't sound quite like a guitar. To get exact guitar pitches change your scale to 12EDO with command `sc e 12 a` and set your tonic to E with command `tonic e0`

ArgumentDescriptionRangeDefaultTypeOptions
<stringNum>Guitar string number0-5int
  • 5 – high e string
  • 4 – B string
  • 3 – G string
  • 2 – D string
  • 1 – A string
  • 0 – low E string
<frets>Fret numbers comma separatedstring

LoopLength <length>

Keywords: loopLength, length, len, le

Description: Set the loop length

ArgumentDescriptionRangeDefaultTypeOptions
<length>Length of loop2-2147483647musical time

LoopLengthAdd <amount>

Keywords: loopLengthAdd, lengthAdd, lenAdd, la

Description: Add or subtract from the loop length, use negative number to subtract

ArgumentDescriptionRangeDefaultTypeOptions
<amount>Amount to add or subtract2-2147483647musical time

LoopIndex <index>

Keywords: loopIndex, index, ind, in

Description: Set the loop index

ArgumentDescriptionRangeDefaultTypeOptions
<index>Index in 16th notes. Must be smaller than loop length.0-loopLengthmusical time

Shuffle <probability>

Keywords: shuffle, shu

Description: Randomly shuffles the chops in the loop. If there is only one chop then first it will fill the loop with chops, then shuffle.

ArgumentDescriptionRangeDefaultTypeOptions
<probability>Probability of segments being on 0-90-95float

Bundle <length>

Keywords: bundle, bun, bu

Description: Bundles the chops into a new length

ArgumentDescriptionRangeDefaultTypeOptions
<length>Length of the new bundle2-2147483647musical time

Pan <panPosition> <speed>

Keywords: stereoPan, pan

Description: Pan sound in stereo field

ArgumentDescriptionRangeDefaultTypeOptions
<panPosition>Pan position from -1 to 1rfloat
  • r – semi-random (keeps lower frequencies near center)
  • -1 – left
  • -0.5 – half left
  • 0 – center
  • 0.5 – half right
  • 1 – right
<speed>Speed to change pan in musical time0-21474836470musical time

Shift <amount>

Keywords: shift, shi

Description: Shifts the loop index by the amount. Negative number shifts backwards.

ArgumentDescriptionRangeDefaultTypeOptions
<amount>Amount to shift-2147483647-21474836471musical time

Solo

Keywords: solo, sol, so

Description: Solo sounds

Mute <shouldMute>

Keywords: mute, mut, mu

Description: Mute sounds

ArgumentDescriptionRangeDefaultTypeOptions
<shouldMute>Should muteybool
  • y – yes/mute
  • n – no/unmute

Glitch <probability>

Keywords: glitch, gli, gl

Description: Shuffles the loop after each play through depending on the probability. Use `gli 0` to turn off.

ArgumentDescriptionRangeDefaultTypeOptions
<probability>Probability of glitching on next playback 0-90-97float

Granulate

Keywords: granulate, gra, gr

Description: Repeats the start of random chops by random amounts. Like a stutter effect.

Open

Keywords: openFilePath, open, ope, op

Description: Open sample file path locations for selected sounds

Export <type> <directory> <fileName> <normalize>

Keywords: export, exp

Description: Export sounds as wav file loops

Access Level: pro

ArgumentDescriptionRangeDefaultTypeOptions
<type>Export joined or separatejstring
  • j – export sounds joined into one wav file
  • s – export sounds as separate wav files
<directory>Directory to export to. Not a full file path. Only exports to the directory where the app is running.bpm_scalestring
<fileName>File namestring
<normalize>Normalize the exported soundybool
  • y – yes/normalize
  • n – no/don't normalize

DeleteFromDisk

Keywords: deleteFromDisk, deleteFromHardDrive, delHard, delDisk

Description: Delete sound from hard drive

SetName <name>

Keywords: setName, name, tag, nam, na, t

Description: Set the name of the sound

ArgumentDescriptionRangeDefaultTypeOptions
<name>Name of the soundstring

AddSuffix <suffix>

Keywords: addSuffix, suffix, suf

Description: Add a suffix to the sound name

ArgumentDescriptionRangeDefaultTypeOptions
<suffix>Suffix to add to the sound namestring

AddPrefix <prefix>

Keywords: addPrefix, prefix, pre

Description: Add a prefix to the sound name

ArgumentDescriptionRangeDefaultTypeOptions
<prefix>Prefix to add to the sound namestring

Duplicate

Keywords: duplicate, copy, dup, du

Description: Duplicate/copy the sound

Separate

Keywords: separate, sep

Description: Separate the chops into their own sounds

Join

Keywords: join, joi

Description: Join the chops into one sound

Octave <octave>

Keywords: octave, oct, oc

Description: Octave

ArgumentDescriptionRangeDefaultTypeOptions
<octave>Enter new octave from -6 to 6. It sets directly and is not additive.-6 to 6 inclusive0int

Arrangement <unit> <pattern>

Keywords: arrangement, arrange, arr, ar

Description: Create looping arrangements at any unit level. Arrangements combine to form larger patterns. Arrangements function like a mask and only determine when sounds are allowed to trigger but they don't modify the length or position of sounds.

ArgumentDescriptionRangeDefaultTypeOptions
<unit>Unit of arrangementpstring
  • p – phrase
  • b – bar
  • h – half note
  • q – quarter note
  • e – eighth note
  • s – 16th note
  • 3 – use a specific size in 16th notes
  • r – random unit - will reset all first
  • n – none/reset
<pattern>A pattern of off and on made of x and -xstring
  • x- – 1 unit on, 1 unit off
  • -x – 1 unit off, 1 unit on
  • xx-- – 2 units on, 2 units off
  • ---x--xx – 3 units off, 1 unit on, 2 units off, 2 units on
  • r – random pattern with random length
  • r4 – random pattern of length 4
  • r8 – random pattern of length 8 etc

Span <start> <end> <length>

Keywords: span, spa

Description: Set span - the sound will play every length bars from start to end. Length should be greater than or equal to end.

ArgumentDescriptionRangeDefaultTypeOptions
<start>Start time (-1 to clear span)-1 to 2147483647musical time
<end>End time1-2147483647musical time
<length>Length of the span1-2147483647musical time

SpanBar <start> <end> <length>

Keywords: spanBar, spb

Description: Set span in length of bars - the sound will play every length bars from start to end. Length should be greater than or equal to end.

ArgumentDescriptionRangeDefaultTypeOptions
<start>Start time in bars (-1 to clear span)-1 to 2147483647int
<end>End time in bars1-2147483647int
<length>Length of the span in bars1-2147483647int

SpanPhrase <start> <end> <length>

Keywords: spanPhrase, spp

Description: Set span in length of phrases - the sound will play every length bars from start to end. Length should be greater than or equal to end.

ArgumentDescriptionRangeDefaultTypeOptions
<start>Start time in phrases (-1 to clear span)-1 to 2147483647int
<end>End time in phrases1-2147483647int
<length>Length of the span in phrases1-2147483647int

Pattern <chopSize> <numChops> <pattern>

Keywords: pattern, pat, pa

Description: Apply a pattern to the sample chops

ArgumentDescriptionRangeDefaultTypeOptions
<chopSize>Size of each chop in 16th notes1-21474836471int
<numChops>Number of chops1-214748364716int
<pattern>Binary pattern to applypstring
  • 1 – All on
  • 10 – On Off
  • 01 – Off On
  • 101 – On Off On

Reverse <chopSelection>

Keywords: reverse, rev, re

Description: Reverse chosen chops in the audio

ArgumentDescriptionRangeDefaultTypeOptions
<chopSelection>Selection of the chops to reversestring
  • a – All chops
  • r – Random chops
  • 1-4 – Chops 1 through 4
  • 0,2,4,7 – Chops 0,2,4,7
  • 101 – Binary pattern
  • n – None

Up <amount>

Keywords: up

Description: Move sound up in the list

Access Level: pro

ArgumentDescriptionRangeDefaultTypeOptions
<amount>Amount to move1-21474836471int

Down <amount>

Keywords: down, do

Description: Move sound down in the list

Access Level: pro

ArgumentDescriptionRangeDefaultTypeOptions
<amount>Amount to move1-21474836471int

MicroTimingOffset <amount>

Keywords: microTimingOffset, microTiming, mto, mt

Description: Micro timing offset up to a 32nd note

ArgumentDescriptionRangeDefaultTypeOptions
<amount>Amount to offset-9 to 91float

CueVolume <volume>

Keywords: cueVolume, cueVol, cue

Description: Set cue volume for the headphones

ArgumentDescriptionRangeDefaultTypeOptions
<volume>Volume for the headphones0-99float
Category – visual

Screenshot <captureOnlyCertainElements>

Keywords: screenshot, capture

Description: Take a screenshot of Beat DJ

ArgumentDescriptionRangeDefaultTypeOptions
<captureOnlyCertainElements>Do you want to choose which layers to include in the screenshot?nobool
  • yes
  • no

ScreenSize <width> <height>

Keywords: screenSize, windowSize

Description: Set the screen/window size of Beat DJ

ArgumentDescriptionRangeDefaultTypeOptions
<width>Width of the screen1-2147483647int
<height>Height of the screen1-2147483647int

VizPoly <search> <readFromFile>

Keywords: polygonVisualizer, vizPoly, vip

Description: Selects a 2d polygon visualizer

ArgumentDescriptionRangeDefaultTypeOptions
<search>Keyword to search for a polygon visualizer. Enter 'n' to turn off.string
<readFromFile>Read the file for new changes? Say yes if you have changed the file.nbool
  • y – yes (read from file)
  • n – no (read from cache)

BackgroundColor <color> <opacity>

Keywords: backgroundColor, bgColor, color, bgc, bg

Description: Set background color and opacity

Access Level: pro

ArgumentDescriptionRangeDefaultTypeOptions
<color>Color by name or in hex formathex,red,green,blue,white,black,yellow,cyan,magenta,grey,clearblackstring
<opacity>Opacity from 0-90-9 inclusivefloat

Transparency <object> <transparency>

Keywords: transparency

Description: Set transparency of objects

ArgumentDescriptionRangeDefaultTypeOptions
<object>Object to set transparencystring
<transparency>Transparency from 0-90-9 inclusivefloat

BackgroundImage <action>

Keywords: backgroundImage, bgImage, image, bgImg, img

Description: Set background image

Access Level: pro

ArgumentDescriptionRangeDefaultTypeOptions
<action>Choose what to do with the background imagestring
  • path – load an image from a path
  • r – random image you have chosen before
  • sel – select an image you have used before
  • ai – generate an image with Eden AI
  • dir – load all image paths from folder/directory into beat dj
  • none – remove image

ImageTile <pixelsPerUnitMultiplier>

Keywords: imgTile, tile

Description: Image tile

Access Level: pro

ArgumentDescriptionRangeDefaultTypeOptions
<pixelsPerUnitMultiplier>Multiplier for pixels per unit. Enter zero to remove image tiling.0-21474836472float

Sky <realtime> <hour> <dayCycleInMinutes>

Keywords: sky

Description: Set sky parameters realtime, hour, dayCycleInMinutes

Access Level: pro

ArgumentDescriptionRangeDefaultTypeOptions
<realtime>Realtime true or false, y/ny/n t/f on/off true/falseybool
<hour>Hour from 0-230-23 inclusive12int
<dayCycleInMinutes>Day cycle length in minutes0-214748364730int

AdjustScreen <uiScaleMode>

Keywords: adjustScreen, resolution, screen

Description: Adjust the screen resolution

ArgumentDescriptionRangeDefaultTypeOptions
<uiScaleMode>Scaling mode of user interfacestring
  • p – pixel scale mode
  • f – fit screen scale mode

Font <size> <color>

Keywords: font

Description: Set font size and color

ArgumentDescriptionRangeDefaultTypeOptions
<size>Font size1-256int
<color>Font colorhtml name or hexlimestring

Dancer <action>

Keywords: dancer

Description: Create 3D virtual dancers that dance to the music

Access Level: pro

ArgumentDescriptionRangeDefaultTypeOptions
<action>What you want to do with the dancer(s)cstring
  • c – create
  • d – delete the last dancer
  • da – delete all

Theme <theme>

Keywords: theme, the, th

Description: Set the theme of the interface

Access Level: pro

ArgumentDescriptionRangeDefaultTypeOptions
<theme>Theme to setstring
  • colorblind1 – colorblind friendly 1
  • colorblind2 – colorblind friendly 2
  • default
  • nessy – pink theme
  • dragon – black and red
  • swamp – dark green
  • goop – mostly grayscale
  • soul – blue yellow
  • hana – dark sunset colors
  • joey – purple and green
  • guava – colors like the fruit
  • venus – brownish haze with neon accents
  • c – Create your own
  • cr – Create random

ThemeAccessibility <theme>

Keywords: themeAccessibility, themeA

Description: Essential color themes for accessibility

ArgumentDescriptionRangeDefaultTypeOptions
<theme>Theme to setstring
  • colorblind1 – colorblind friendly 1
  • colorblind2 – colorblind friendly 2
  • soniare – sky option
  • default – same as colorblind1
Category – create

Splitter <search>

Keywords: splitter, spl, s

Description: Create new instrument of type Splitter which is the default instrument in Beat DJ.

ArgumentDescriptionRangeDefaultTypeOptions
<search>Keyword to search for, or a file path, or a directorystring

Swap <search>

Keywords: swap, swa

Description: Swap selected sounds with a new sound. Pass a search term to change the sound type or leave empty to keep the same sound type.

ArgumentDescriptionRangeDefaultTypeOptions
<search>Keyword to search forstring

LoadFromBank <search>

Keywords: loadFromBank, loadFile, lfb, lb, lf

Description: Load a file from SoundBank folder

Access Level: pro

ArgumentDescriptionRangeDefaultTypeOptions
<search>Keyword to search forstring

Generate <search> <pitchIndex> <octave> <length>

Keywords: generate, gen, g

Description: Generates a sound from scratch using synthesis which becomes a Splitter with one chop.

ArgumentDescriptionRangeDefaultTypeOptions
<search>Keyword to search generation functionsstring
<pitchIndex>Pitch index in the scale0-2147483647rint
<octave>Octave of the pitchrint
<length>Length you want the sound to be in 16th notes-1musical time

CloudSplitter <search>

Keywords: cloudSplitter, splitterCloud, sCloud, cs

Description: Create new instrument of type Splitter by loading a sample from the Soniare cloud.

ArgumentDescriptionRangeDefaultTypeOptions
<search>Keyword to search for in cloud librarystring

PrecisionSplitter <precision> <search>

Keywords: precisionSplitter, ps

Description: Create new instrument of type Splitter with a precision variable. Higher number makes longer chops.

ArgumentDescriptionRangeDefaultTypeOptions
<precision>Precision of the splitter. Higher number makes longer chops.-9 to 90float
<search>Keyword to search for, or a file path, or a directorystring
Category – utility

Calculator <expression>

Keywords: calculator, calculate, calc, cal

Description: Calculate a math expression. You can also do it without the command

ArgumentDescriptionRangeDefaultTypeOptions
<expression>Math expression to calculatestring

GetOneshots <filePath> <volumeThreshold> <minLength>

Keywords: getOneshots, oneshots, shots

Description: Create oneshots from an audio file

Access Level: pro

ArgumentDescriptionRangeDefaultTypeOptions
<filePath>Path to the audio filestring
<volumeThreshold>Threshold for oneshots0-1float
<minLength>Minimum length per oneshot in seconds0-2147483647float

GetOneshotsDir <dirPath> <volumeThreshold> <minLength>

Keywords: shotsDir

Description: Create oneshots from a directory of wav files

Access Level: pro

ArgumentDescriptionRangeDefaultTypeOptions
<dirPath>Path to the audio filesstring
<volumeThreshold>Threshold for oneshots0-1float
<minLength>Minimum length per oneshot in seconds0-2147483647float

OpenInFinder <filePath>

Keywords: openInFinder, openInExplorer, finder, explorer, found

Description: Open file path

ArgumentDescriptionRangeDefaultTypeOptions
<filePath>Path to the filestring
Category – automation

EvolveMode <mode>

Keywords: evolveMode, evoMode, evm, em

Description: Evolve mode. This controls how sounds synchronize. Together mode is default.

ArgumentDescriptionRangeDefaultTypeOptions
<mode>Mode to settstring
  • t – together - for harmony and grooves
  • s – solo - make the sound independent

AIHelp <message>

Keywords: aiHelp, aih, ai

Description: How can I help?

ArgumentDescriptionRangeDefaultTypeOptions
<message>Messagestring

AIProgrammer <scriptType> <prompt> <similarTo>

Keywords: aiProgrammer, aiCoder, aiCode, aiDev, aip

Description: What would you like to create?

Access Level: pro

ArgumentDescriptionRangeDefaultTypeOptions
<scriptType>Which type of Beat DJ script would you like to create?string
  • g – generator - synthesis script for generating a new type of sound
  • m – modifier - effects script for modifying existing sounds
  • vip – vizpoly - a polygon visualizer script (~30% success rate, can cause crashes)
<prompt>Describe what you want to create in detailstring
<similarTo>Recommended! Include a search term to another script you want to take inspiration from. For example squarewave, distortion, or rectanglestring

ScriptTest <scriptType> <scriptName> <actionAfterTest>

Keywords: scriptTest

Description: Script test. A function to test and delete Beat DJ scripts.

Access Level: pro

ArgumentDescriptionRangeDefaultTypeOptions
<scriptType>Type of script to teststring
  • g – generator - synthesis script for generating a new type of sound
  • m – modifier - effects script for modifying existing sounds
  • vip – vizpoly - a polygon visualizer script (low-success rate)
<scriptName>Name of the script to teststring
<actionAfterTest>what to do with the script after testingastring
  • a – accept, it's good and works great
  • r – rename
  • d – delete, it's bad or does nothing
  • o – open file location, manual edits might be overwritten unless you change the file name to something unique

RunAI

Keywords: runAI, run

Description: Run all recent AI suggested commands

Schedule <command> <start> <repeatLength> <probability> <end>

Keywords: schedule, sched, sch

Description: Schedule a command to run at a specific 16th note and optionally repeat

ArgumentDescriptionRangeDefaultTypeOptions
<command>Command to runstring
<start>Start time0-2147483647int
<repeatLength>Repeat every so many. Zero for no repeat.0-2147483647int
<probability>Probability of running the command 0-90-9float
<end>Cancel time. Enter zero to run indefinitely.0-2147483647int

ScheduleOnce <command> <when>

Keywords: scheduleOnce, schedOnce, scho, sco

Description: Schedule a command to run once

ArgumentDescriptionRangeDefaultTypeOptions
<command>Command to runstring
<when>Execution time in musical time0-2147483647int

ManageScheduled <action>

Keywords: manageScheduled, mngSch, msch

Description: Manage scheduled commands

ArgumentDescriptionRangeDefaultTypeOptions
<action>What you want to do with the scheduled commandsstring
  • l – List all scheduled commands
  • h – Hide scheduled command output
  • s – Show scheduled command output
  • e – Edit a scheduled command by id
  • d – Delete a scheduled command by id
  • da – Delete all scheduled commands

Shortcuts <action>

Keywords: shortcuts, short

Description: Manage keyboard shortcuts

ArgumentDescriptionRangeDefaultTypeOptions
<action>What you want to do with the shortcutsstring
  • l – List all shortcuts
  • c – Create or change a shortcut
  • d – Delete a shortcut
  • y – yes - enable
  • n – no - disable
  • f – Load shortcuts after editing file directly
  • da – Delete all shortcuts

Combos <action>

Keywords: combo

Description: Combos are like command replacements. E.g. create a techno combo like techno=s kick; s hat; s clap ... combos can contain other combos.

ArgumentDescriptionRangeDefaultTypeOptions
<action>What you want to do with the combosstring
  • l – List all combos
  • c – Create or change a combo
  • d – Delete a combo
  • f – Load combos after editing file directly
  • da – Delete all combos
Category – troubleshoot

ResetOutput

Keywords: resetOutput

Description: Reset output in case sound is not working. Useful if sounds stop playing from an output source changing.

ResetInterface

Keywords: resetInterface, resetUI

Description: Reset interface preferences to default.

Feedback <message>

Keywords: support, feedback, fback, bug

Description: Send us feedback and ask questions

ArgumentDescriptionRangeDefaultTypeOptions
<message>Enter your feedback and questions, we will email you back ASAP if it is urgentstring

OutputInvert

Keywords: outputInvert, channelsInvert, invertOutput, invertChannels

Description: Inverse channels when working with live performance mode. Only works if you are using 4 channels.

Category – account

SignUp <email> <password>

Keywords: signUp, su

Description: Sign up

ArgumentDescriptionRangeDefaultTypeOptions
<email>Emailstring
<password>Passwordstring

SignIn <email> <password>

Keywords: signIn, si

Description: Sign in

ArgumentDescriptionRangeDefaultTypeOptions
<email>Emailstring
<password>Passwordstring

SignOut

Keywords: signOut

Description: Sign out

Profile <displayName> <website> <profilePicture>

Keywords: profile

Description: Profile

ArgumentDescriptionRangeDefaultTypeOptions
<displayName>What is your artist name? (only one per account)string
<website>What is your website or social media link?string
<profilePicture>Path to your profile picture (jpg/png) or enter to skip for nowstring

Subscription <action>

Keywords: subscription, upgrade, sub, pro

Description: Manage Beat DJ pro subscription

ArgumentDescriptionRangeDefaultTypeOptions
<action>What you want to dostring
  • start – run this to load checkout page for subscription (cheapest)
  • 4life – or run this to load checkout page for 1 time purchase
  • enable – run this after paying to enable pro features
  • manage – renew, change payment method or cancel
  • learn – run this to see pro features

Affiliates

Keywords: affiliates, aff

Description: Visit our affiliates webpage to start earning a 30% commission by sharing Beat DJ.

Cloud <action>

Keywords: cloud, clo, cl

Description: Manage cloud files

Access Level: pro

ArgumentDescriptionRangeDefaultTypeOptions
<action>What you want to do with the cloudstring
  • l – List all your files
  • dl_all – Download all your files
  • dl_bpm – Download all your files with a specific BPM
  • dl_tag – Download all your files with a specific tag
  • dl_id – Download a specific file by id
  • delete_all – Delete all your files from the cloud
  • delete_bpm – Delete all your files with a specific BPM
  • delete_tag – Delete all your files with a specific tag
  • delete_id – Delete a specific file by id

Discord

Keywords: discord

Description: Open our discord server. Come ask questions, and share your music!

Merch

Keywords: merch

Description: Open our merch website. Get some cool Beat DJ gear!

YouTube

Keywords: youtube

Description: Open our YouTube channel for tutorials and music.

Category – multiplayer

MultiplayerMessage <message>

Keywords: multiplayerMessage, multMsg, mpm, mm

Description: Send a message to the multiplayer room

ArgumentDescriptionRangeDefaultTypeOptions
<message>Message to sendstring

MultiplayerCommand <command>

Keywords: multiplayerCommand, multCmd, mpc

Description: Send a multiplayer command

ArgumentDescriptionRangeDefaultTypeOptions
<command>Command to sendstring

Room <action>

Keywords: multiplayer, room

Description: Room

ArgumentDescriptionRangeDefaultTypeOptions
<action>Action to takestring
  • c – create
  • l – list
  • j – join
  • le – leave
  • d – delete