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
| parameter | values | default | |
|---|---|---|---|
| path | a file | required | file |
folder
Every file in a folder of the workspace.
- out
files: gives anything
| parameter | values | default | |
|---|---|---|---|
| path | a folder | required | folder |
| recursive | flag | false | include subfolders |
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
| parameter | values | default | |
|---|---|---|---|
| model | copista-mini · copista-micro | copista-mini | copista-mini: 28.7M parameters; five to thirty seconds a page; copista-micro: 1.9M parameters; a few seconds a page |
| pages | together · each | together | page images |
| partBook | flag | false | a 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
| parameter | values | default | |
|---|---|---|---|
| meter | may change · steady | may change | time 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
| parameter | values | default | |
|---|---|---|---|
| straighten | flag | false | snaps each note to the nearest sixteenth or triplet; a dehumanize step after does this better |
| click | flag | false | a 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
| parameter | values | default | |
|---|---|---|---|
| straighten | flag | false | snaps each note to the nearest sixteenth or triplet; a dehumanize step after does this better |
| click | flag | false | a 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
| parameter | values | default | |
|---|---|---|---|
| chordSymbols | flag | false | one 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
| parameter | values | default | |
|---|---|---|---|
| folder | a folder | none | folder |
| ifExists | rename · replace · skip | rename | if 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
| parameter | values | default | |
|---|---|---|---|
| path | a new path | required | folder |
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
| parameter | values | default | |
|---|---|---|---|
| from | files or folders | required | what |
| into | a folder | none | into folder |
| as | a new path | none | new path |
| ifExists | fail · rename · replace | fail | if 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
| parameter | values | default | |
|---|---|---|---|
| from | files or folders | required | what |
| into | a folder | none | into folder |
| as | a new path | none | new path |
| ifExists | rename · fail · replace | rename | if 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
| parameter | values | default | |
|---|---|---|---|
| paths | files or folders | required | what |
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
| parameter | values | default | |
|---|---|---|---|
| from | files or folders | required | what |
| as | a new path | required | archive |
| ifExists | rename · fail · replace | rename | if 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
| parameter | values | default | |
|---|---|---|---|
| into | a folder | none | left empty, each archive is unpacked beside itself |