File browser

The Files panel on the left side of the screen is the file browser. Use it to import MIDI files and saved clips (.clp) into the timeline, or to manage JavaScript libraries used by the coding Note Effect.

Four kinds of sections

The panel can show up to four sections.

Section	Location	Purpose
Factory libs/codes	Bundled with the app (read-only)	Built-in libraries
App libs/codes	{appData}/libs/codes/	Your own JS, shared across all projects
Project libs/codes	libs/codes/ next to the project file	Your own JS, scoped to this project only
User-added folder	Any folder on your filesystem	Place for MIDI / .clp / etc.

App / Project libs/codes start out empty. The Project libs folder itself is not created until you press the Create button.

Add a user folder

Click the + button to the right of the Files header, then pick any folder in the OS file picker. Use it to keep MIDI files and .clp clips.

You can add multiple folders. The list is stored locally on the device.

Drop a MIDI file onto the timeline

1. Find a .mid / .midi file inside a user folder
2. Drag and drop it onto the timeline
3. A new clip is created at the drop position (track x beat) and all notes from the MIDI file are imported

On macOS, MIDI file import works even if you have not enabled the IAC driver in Audio MIDI Setup. (Playback to a synth still requires MIDI I/O setup.)

Paste a .clp (saved clip)

Useful when you want to reuse a clip from another project.

1. Drag and drop the .clp file onto the timeline
2. Notes, CC, code, and the rendered cache are all imported together

How to make a .clp: right-click a clip on the timeline and choose “Export clip” (or similar menu).

I want to drop directly from the OS file manager

Tauri’s WKWebView restricts non-text drag-drop from outside the app, so dropping directly from the OS onto the timeline does not work.

Workaround:

1. Add a folder via the file browser (User folder)
2. In your OS file manager, copy the MIDI / .clp into that folder
3. Drag the item from the file browser to the timeline

libs/codes — your own JS libraries

Factor out functions used by the coding Note Effect into separate files and share them across multiple clips.

Create

Click the + button to the right of the App libs / Project libs section header, type a name, and press Enter. The .js extension is optional (added automatically). An empty file is created and the editor modal opens.

Edit

Click any .js file to open the editor modal.

Key	Action
Cmd/Ctrl + S	Save
Esc	Close (asks for confirmation if unsaved)

Factory libs are read-only.

ON / OFF — toggle

Use the checkbox next to a .js file to toggle whether it is loaded.

• ON — added to this project’s loadedLibs and prepended to your user code when the coding Note Effect runs. Write export function add() and you can call add() directly from clip code.
• OFF — removed from loadedLibs (the file itself is not deleted).

Section	Scope
App libs ON	Available across every project (auto-loaded when you open a project)
Project libs ON	This project only
Factory libs OFF	Disabled individually (all ON by default)

My change does not show up after saving

Saving a library refreshes the file browser, but clips that are already open are not re-rendered automatically. To pick up the change:

• Edit the clip’s Code by a single character (re-render trigger)
• Or toggle the lib OFF then ON in the file browser

See Troubleshooting for more.

Refreshing the list

If you add, rename, or delete files outside skulpton (e.g. in your OS file manager), the file browser will reload after a short cache window. To refresh immediately, collapse and expand the section, or click another folder to move focus.

Related

• Coding Note Effect overview — how to use libs/codes from a clip
• Troubleshooting — drag-and-drop and code-refresh pitfalls