Reports whether Bosca Ceoil Blue is running, plus its version, the current song's summary, and playback and export state. Doesn't start the app.

Starts Bosca Ceoil Blue. Other tools do this on demand, so it's only needed to choose the mode or to open the window before working.

Closes Bosca Ceoil Blue.

Captures the app's window as an image, to check what the user is seeing. Not available without a window.

Shows something in the app's window: selects a pattern for the note grid, selects an instrument, or switches views.

Replaces the open song with a new one, optionally built in one go from settings, instruments, patterns and an arrangement. This is the quickest way to write a song. Without instruments and patterns, you get the app's default: one Grand Piano, and one empty pattern on bar 0.

Opens a .ceol song file.

Replaces the open song with one imported from a MIDI file. Bosca is a step sequencer, so complex timing may not survive.

Saves the song as a .ceol file. Songs aren't saved automatically.

Exports the song as audio or music data: wav (rendered audio), mid (MIDI), mml (SiON MML) or xm (FastTracker). A WAV renders at about playback speed or slower, so a long one returns state "rendering"; follow it up with export_status. A finished WAV reports its duration, peak and RMS, to help catch silent or clipped results.

Reports how the current or most recent WAV export is going. The song can't be edited while it renders.

Returns the whole song: settings, instruments, patterns with their notes, and the arrangement. Notes are in the same form the editing tools take.

Changes song settings. Takes effect immediately, even during playback.

Lists the app's voices (over 300), to pick from when adding an instrument. Filter them, since the full list is long.

Lists the items of a drumkit voice. In a drumkit pattern, each 'note' is one of these items instead of a pitch.

Adds an instrument to the song. A song can have 16.

Changes an instrument's voice or settings. Every pattern using it changes too. Switching a pattern's instrument to a drumkit drops notes that have no matching item.

Removes an instrument. Later instruments move down one index, and patterns using it switch to instrument 0.

Adds a pattern and returns its index. It won't play until the arrangement uses it. Notes are absolute pitches, so the key and scale don't move them; they must fit that key and scale.

Edits a pattern's notes, key, scale, instrument or filter automation, as one undo step. Changing the key transposes its notes, like the app does. Changing the scale removes notes that don't fit it.

Copies a pattern to a new index, as a starting point for a variation.

Removes a pattern and clears it from the arrangement. Later patterns move down one index.

Places patterns on the timeline. Each bar plays up to 8 patterns at once, on separate channels. Writes whole bars starting at at_bar, leaving other bars alone. Unless a loop is given, the loop then covers the whole song.

Plays the song through the user's speakers, looping until stopped. The AI tool can't hear it, so use this when the user wants to listen.

Pauses playback, keeping the position.

Stops playback and goes back to the start of the loop.

Undoes the last edit, made by the user or by a tool. The app keeps 40 steps. Opening or creating a song clears them.

Redoes the last undone edit.