Agentic DAW setup for the busy studio engineer.
OmaDAW is how you and an agent set up an Omarchy machine for low-latency
recording: realtime PipeWire, a dedicated Wine prefix and yabridge for
Windows VSTs, and routing for Bitwig, Reaper, and Ardour. You say what you
need. The agent reads AGENTS.md and the skills in skills/, then runs the
idempotent scripts in this repo. You stay in the session for the parts only
you can do: logins, licenses, and listening.
./omadaw # set up, then open the agent
./omadaw --profile studio --with-daw all --yes # set up only (idempotent)
./omadaw doctor # fast-forward this repo, then health check
./omadaw agent "set up for a USB interface at 128 frames with Reaper"./omadaw with no arguments runs the installer, then opens the Omarchy
default agent in this repo so you can keep going. ./omadaw agent "<goal>"
opens that agent directly. A goal is a sentence: install a plugin, fix a
silent DAW, bridge a new VST, or drop the quantum to 128. The agent reads
AGENTS.md, MEMORY.md, and the skills, so it does n
6B07
ot rediscover this
machine from scratch.
- Realtime:
realtime-privileges+rtkit, user in therealtimegroup. A reboot or a full login is required before realtime is actually active. - PipeWire profiles:
studio128 /balanced256 /safe512 frames at 48 kHz (config/pipewire/...). Switch live withbin/omadaw-route profile <name>. - Windows VSTs: dedicated
~/.wine-omadawprefix (not~/.wine) and yabridge.bin/omadaw-vst install ~/Downloads/SomePluginSetup.exe bin/omadaw-vst sync # discover new/updated plugins bin/omadaw-vst enable-watch # background auto-sync on new files bin/omadaw-vst doctor
- DAWs: Reaper and Ardour from the repos, Bitwig from the AUR (the agent
asks first). Backend and plugin-path notes live in
config/daw/. Launch withbin/omadaw-route launch <bitwig|reaper|ardour>. Patch withqpwgraph. - Rollback:
./omadaw --snapshot ...snapshots the system (snapper) and user state (~/.wine-omadaw, PipeWire config, shims) first. Restore withbin/omadaw-snapshot rollback-systemandrollback-user latest.
Move the library directory to a roomier disk and symlink it back, for example
mv ~/.wine-omadaw/drive_c/.../Toontrack /games/soundlibs/ && ln -s /games/soundlibs/Toontrack <original-path>. Wine follows the link, so the
C:\… paths keep working. Stop the apps that have those files open first.
AGENTS.md is the handbook the agent reads first: the map, Omarchy
conventions, and verification commands. MEMORY.md is this machine's
inventory and incidents (gitignored). Skills live in skills/omadaw-audio/
and skills/omadaw-vst/.
Issues and pull requests are welcome, from people and from agents. Open an issue for a quirk you hit and have not solved yet. Open a pull request when you have the fix.
The useful contribution is a setup quirk the next machine will hit. Write it into the matching skill once you have reproduced it:
- audio, routing, realtime, xruns →
skills/omadaw-audio/SKILL.md - Wine, yabridge, installers, vendor apps →
skills/omadaw-vst/SKILL.md
State the symptom, the cause, and the command that fixes it. Date it and name
the Wine or PipeWire version you saw. Native Access needing a
native-access:// handler and a pty, and Guitar Rig 5 crashing until
vcrun2013 replaces Wine's msvcr120.dll, are the shape to copy.
Leave this computer's inventory out of the skills and out of git. Interface
names, which products are installed, license files, and one-off project paths
belong in a local MEMORY.md. That file is gitignored.
Keep script changes small and shellcheck-clean. Run bash -n on anything
you edit under bin/ or omadaw.