kobimusic

workspace

← learn

nodes

every kind of node: its ports, and its parameters

This page is generated from the workspace's own registry, so it is what the builder, the API and an agent are all offered. GET /api/v1/nodes returns the same as JSON. The flow format says how nodes are joined.

input

What the run is started with: the file that was right-clicked, files dropped on the page, or the parts of an API request.

  • out files: gives anything

file

One file of the workspace.

  • out file: gives anything
parametervaluesdefault
patha filerequiredfile

folder

Every file in a folder of the workspace.

  • out files: gives anything
parametervaluesdefault
patha folderrequiredfolder
recursiveflagfalseinclude subfolders

audio-to-midi

Transcribes a recording into MIDI: the notes it hears, each given to one of ten families of instrument — and, unless told not to, the recording's own beats and bars under them.

  • in audio: takes audio
  • out midi: gives midi
parametervaluesdefault
modeldettato-microdettato-micro6M parameters; about eight seconds for four minutes of audio
beatAlignflagtrueputs the notes on the recording's own beats and bars, so the MIDI has its tempo and time signature
dehumanizeflagfalsethen cleans up the rhythm, as a person would write it: runs even, chords together

sheet-to-score

Reads sheet music, made for real scans (old editions included) and some handwritten scores, from a PDF or images of its pages, into sheet music that can be edited and played.

  • in sheets: takes pdf or image
  • out score: gives score
parametervaluesdefault
modelcopista-mini · copista-microcopista-minicopista-mini: 28.7M parameters; five to thirty seconds a page; copista-micro: 1.9M parameters; a few seconds a page
pagestogether · eachtogetherpage images
partBookflagfalsea part-book

find-beats

Finds the beats, bars and time signatures of a recording or a MIDI file, and writes them as a beat map.

  • in music: takes audio or midi
  • out beats: gives beatmap
parametervaluesdefault
metermay change · steadymay changetime signature

fit-to-beats

Re-times a MIDI file onto a beat map on the same timeline — its recording's — so it has that music's bars and tempo.

  • in midi: takes midi
  • in beats: takes beatmap
  • out midi: gives midi
parametervaluesdefault
straightenflagfalsesnaps each note to the nearest sixteenth or triplet; a dehumanize step after does this better
clickflagfalsea woodblock on every beat, on a track of its own

beat-align

Puts a MIDI file on its own beats: finds them from its notes, and re-times it so it has the music's bars and tempo.

  • in midi: takes midi
  • out midi: gives midi
parametervaluesdefault
straightenflagfalsesnaps each note to the nearest sixteenth or triplet; a dehumanize step after does this better
clickflagfalsea woodblock on every beat, on a track of its own

dehumanize

Cleans up the rhythm of a MIDI file already on its beats: the notes as a person would write them — runs even, chords together, grace notes kept.

  • in midi: takes midi
  • out midi: gives midi

midi-to-sheet

Engraves a MIDI file as sheet music that can be read, printed, edited and played.

  • in midi: takes midi
  • out score: gives score
parametervaluesdefault
chordSymbolsflagfalseone chord over each bar where the harmony changes; experimental

score-to-midi

Turns sheet music into a MIDI file: the notes as they are written, to hear, to look at as a piano roll, or to open in a sequencer.

  • in score: takes score
  • out midi: gives midi

save

Saves what reaches it: into a folder, or, given none, beside the file each result came from (at the top of your files, if it came from none).

  • in files: takes anything
  • out saved: gives anything
parametervaluesdefault
foldera foldernonefolder
ifExistsrename · replace · skiprenameif the name is taken

returns

Hands what reaches it back to whoever started the run: the response to an API request.

  • in value: takes anything

mkdir

Makes a folder, and any folders above it that are missing.

  • in after: a gate, which runs after what is joined to it
  • out done: gives anything
parametervaluesdefault
patha new pathrequiredfolder

move

Moves files or folders into a folder, or renames one.

  • in after: a gate, which runs after what is joined to it
  • out done: gives anything
parametervaluesdefault
fromfiles or foldersrequiredwhat
intoa foldernoneinto folder
asa new pathnonenew path
ifExistsfail · rename · replacefailif the name is taken

copy

Copies files or folders into a folder, or copies one under a new name.

  • in after: a gate, which runs after what is joined to it
  • out done: gives anything
parametervaluesdefault
fromfiles or foldersrequiredwhat
intoa foldernoneinto folder
asa new pathnonenew path
ifExistsrename · fail · replacerenameif the name is taken

delete

Deletes files, or folders and everything in them.

  • in after: a gate, which runs after what is joined to it
  • out done: gives anything
parametervaluesdefault
pathsfiles or foldersrequiredwhat

zip

Packs files and folders into one .zip archive, to send or to keep.

  • in after: a gate, which runs after what is joined to it
  • out done: gives anything
parametervaluesdefault
fromfiles or foldersrequiredwhat
asa new pathrequiredarchive
ifExistsrename · fail · replacerenameif the name is taken

unzip

Unpacks each .zip archive into a folder of its own, and sends on every file that was in it.

  • in archive: takes archive
  • out files: gives anything
parametervaluesdefault
intoa foldernoneleft empty, each archive is unpacked beside itself