seamstress is a Lua scripting environment for monome devices and OSC communication.
currently beta software.
requires liblo, sdl2, sdl2_ttf, rtmidi, readline and lua. on macOS do
brew install lua liblo readline rtmidi sdl2 sdl2_ttfbuilding from source requires the master build of zig.
download a binary from here and add it to your PATH.
currently the earliest zig supported is 0.11.0-dev.3859.
once zig 0.11 is released, seamstress will follow releases of zig, rather than the master.
to build, invoke
git submodule update --init --recursive
sudo zig build install -p /usr/local -Doptimize=ReleaseFastinvoke seamstress from the terminal.
Ctrl+C, 'quit' or closing the OS window exits.
by default seamstress looks for and runs a file called script.lua
in either the current directory or in ~/seamstress/.
this behavior can be overridden, see seamstress -h for details.
the lua API is documented here.
to regenerate docs, you'll need LDoc,
which requires Penlight.
with both installed, running ldoc . in the base directory of seamstress will
regenerate documentation.
seamstress is inspired by monome norns's matron, which was written by @catfact. norns was initiated by @tehn.