andrewfader / blokkily

# Blokkily
Blokkily is an experimental pattern-based DAW. You can edit the same pattern in
a tracker, piano roll or step grid, then arrange patterns across multiple
tracks. It supports CLAP and VST3 plugins, SoundFont instruments and built-in
samplers. CLAP support is required in every build.
**Watch a short video** (with
sound) of an agent building a funky chiptune in Blokkily over
MCP, using the YANES and
FUZZBOI CLAP synths.
The screenshot comes from the `bdd_session_everything` verification session.
It shows an eight-track arrangement with a tempo ramp and warped and recorded
audio clips, the step grid, tracker and piano roll, the sampler, the plugin
browser and the mixer, with the composition assistant's prompt bar above the
editors.
## Download
Each release
carries packages built and tested by CI:
- **Linux:** `blokkily- -Linux.tar.gz` (or `.tar.xz`), built on Arch
 Linux. It expects Qt 6, FluidSynth, RtAudio, RtMidi, JACK, libsndfile,
 libsamplerate and Rubber Band from the system.
- **Windows:** `blokkily- -Windows-x64-setup.exe`, an installer with a
 Start-menu entry and an uninstaller, or `blokkily- -Windows-x64.zip`
 to unzip anywhere and run `bin\blokkily.exe`.
- **macOS:** `blokkily- -macOS-arm64.dmg` for Apple Silicon, or
 `blokkily- -macOS-x86_64.dmg` for Intel Macs, each a self-contained
 `Blokkily.app`. It is signed ad hoc, not notarized, so macOS blocks the first
 launch. Either Control-click the app and choose Open, or run
 `xattr -dr com.apple.quarantine /Applications/Blokkily.app`.
`SHA256SUMS` lists every package's checksum.
To make a self-contained Linux package, `packaging/appimage/build-appimage.sh`
turns a Release build into an AppImage, and
`packaging/flatpak/dev.blokkily.Blokkily.json` builds a Flatpak with
`flatpak-builder`. See usage.
Plugin editors work in every package. CI opens the suite's test CLAP and VST3
editors, and the editors of a real third-party synth (Dexed), in a real window
on macOS and Windows and reads their pixels back. Retina and high-DPI scaling
have not been checked there yet.
## Build and run
You need CMake 3.25+, Qt 6.5+ with its Linguist tools (`qt6-tools`), plus FluidSynth, RtAudio, RtMidi, libsndfile,
libsamplerate and Rubber Band 4 (found through pkg-config), and on Linux
libjack (JACK or PipeWire's JACK). JUCE and the CLAP
headers are vendored under `third_party/`, so clone with `--recursive`.
The verification tests need a SoundFont. CMake looks for `basic.sf2`,
`TimGM6mb.sf2` or `FluidR3_GM.sf2` in `/usr/share/fweelin`,
`/usr/share/sounds/sf2` and `/usr/share/soundfonts`; otherwise pass
`-DBLOKKILY_TEST_SF2=/path/to/bank.sf2`. They also need `ffmpeg` on `PATH`
to check the scope video export, and configuring fails without it.
 [code] 
`./build/blokkily_cli` runs the headless scheduler demo.
Linux is the primary platform. macOS builds with Homebrew's Qt and libraries,
and Windows builds with MSVC, vcpkg and the official Qt binaries. The CI
workflows in `.github/workflows/` (`platforms.yml`