Troubleshooting

Stuck on something? Jump to the section that matches your symptom.

No sound

Check in this order:

1. The track’s OUT is not Off. Set it to All or a specific port.
2. The send channel matches the synth’s receive channel (1 to 16).
3. Mute / Solo state — if any track is soloed, the others are silent.
4. Transport is playing. Notes are not produced while stopped or paused.
5. OS-level MIDI routing — on macOS, the IAC driver is “Device is online”; on Windows, loopMIDI (or similar) is running and exposes a port.
6. For hardware: power, volume, receive mode (OMNI vs. specific channel).

For details, see Set up MIDI I/O.

Stuck note (sound won’t stop)

This happens when a NoteOff is dropped and the synth keeps sounding.

First thing to try: press Stop. On Pause / Stop / Seek / port-switch, skulpton sends CC123 (All Notes Off) and CC120 (All Sound Off) to all 16 channels on every open port. This silences most cases.

If sound continues:

• Power-cycle the synth (especially hardware)
• Switch the OUT port to something else and back (panic-off fires again on port switch)
• Check the synth’s receive channel

MIDI port not in the dropdown

skulpton enumerates MIDI ports once at launch.

• Added a virtual port (IAC / loopMIDI) afterwards? Restart the app.
• Plugged in a USB-MIDI device afterwards? Same — restart.
• macOS: in Audio MIDI Setup -> MIDI Studio, confirm IAC is “Device is online” and has at least one port.
• Windows: confirm loopMIDI (or similar) is running and exposes a port.

Drag-and-drop ignored

skulpton runs on WebKit (Tauri). Drops from the OS file manager directly onto the timeline are restricted; only drags from inside the app’s file browser are accepted.

• To bring a MIDI / .clp from outside, first open the destination folder in skulpton’s file browser, copy the file there using your OS file manager, then drag the item from the file browser into the timeline.
• If in-app D&D still does not respond, confirm the source is a file browser item and the format is .mid .midi .clp .js.

Cannot place notes in the piano roll

If the timeline tool is not Select, the piano roll behaves accordingly. Press 1 to switch back to Select.

• Confirm the piano roll has focus (key input is not captured by an editor element)
• If no clip is selected, the piano roll may be view-only. Double-click a clip to enter edit mode.

My code change does not take effect

For clip-internal Code (codingNoteEffect):

• Editing the Code tab triggers an automatic re-render.
• Editing a libs/codes/ file does not auto re-render open clips. To pick up the change:
  • Edit the clip’s Code by one character (re-render trigger), or
  • Toggle the lib OFF then ON in the file browser

See Coding Note Effect overview.

I shortened a clip — did I lose notes?

You did not. Resize, slice, and merge are all non-destructive. Shortening hides anything outside the new range from the timeline, but the data remains. Re-extending the clip brings the notes back.

Performance feels slow

• Reduce the number of tracks
• Reduce note density per clip
• For coding Note Effect: avoid huge loops; reduce clip length or stepsPerBeat
• Disable libs/codes you do not need

Settings disappeared

Preferences (theme, language, shortcuts) are stored in browser-localStorage-equivalent storage.

• They do not migrate across users or machines.
• They may be cleared by clean operations during development. Use Reset to defaults in Preferences to restore initial values.

Still stuck

Please file an issue on the repository. Including reproduction steps, your OS, the skulpton version, and any related MIDI hardware will speed up resolution.