Important
Clara is evolving rapidly. While the audio engine, routing graph, and autosaving core are rock-solid, expect UI quirks and experimental behaviors in the patchbay toolbars.
- Report Every Bug: If you encounter crashes, graphical glitches, or broken controls, you must open a bug report with complete logs and system specs.
- Help Build Clara: We need developers, audio hackers, and maintainers. Read CONTRIBUTING.md and start contributing today.
- Support the Developer: A dollar goes a long way. I am a student working on my free hours to do this. My allowance doesn't really cut it and it is deeply appreciated if you would support through GitHub Sponsors or PayPal. Thank you so much!
Why Clara? • Key Features • Quick Start & Packages • Building from Source • Roadmap • Contributing • Ideas & Suggestions • Upstream Features
Clara (Carla Improved) is an enhanced fork of Carla by falkTX. It modernizes modular audio routing on Linux by delivering fluid canvas navigation, automatic session preservation, deep dual-view integration, and high-DPI visuals designed for audio engineers and electronic music performers.
Note
Early Alpha Status: Clara is in active, rapid development. Core audio routing, plugin hosting, session autosaving, and everyday workflows are fully functional and ready for daily use. Feedback and bug reports are welcome!
First, credit where it is due: Carla is the OG: a rock-solid, battle-tested modular plugin host by falkTX that has powered Linux audio for years. Clara does not replace that engine; it stands on Carla's shoulders, and everything you rely on (plugin hosting, drivers, stability) is still Carla underneath.
Clara is a frontend-first reinterpretation of that foundation, focused on visuals and quality-of-life. The engine is kept up to date with upstream, while the experience around it was reworked: the plugin scanner and loader got a pass, alongside general optimizations, some cleanup, and OpenGL enabled by default to drive the animations.
The goal is simple: an eye-candy patchbay that asks for fewer clicks.
- Arrange & align: auto-arrange, arrange in rows, multi-select with align, auto-repel when nodes overlap, and line nodes up before or after each other.
- Less clicking in the graph: direct bypass and switch buttons on the patchbay node, plus hiding I/O ports that are not in use.
- Make it yours: toggleable rounded node corners and a toggleable split-screen view (patchbay beside the rack, in lockstep).
If you already know Carla, Clara should feel familiar in all the right places and fresh everywhere you look.
Carla's rock-solid audio backend, supercharged with modern creative-suite ergonomics, intelligent graph layouts, and clean visual polish:

- Real-Time Color Sync & Gradient Cables
- One-click Catppuccin palette or custom color wheel: changing a color on any node instantly syncs across the canvas box, its rack module, and all connected cables.
- Connection cables render as smooth directional linear gradients, seamlessly interpolating from the source node's accent into the destination node's tone.
- Clean, Focused & Contemporary Aesthetic
- Stripped of retro clutter: enjoy 4x MSAA hardware acceleration, rounded card geometry, high-contrast category badges (
SYNTH,FX,HW,IN/OUT), and crystal-clear hinted typography. - Floating context-aware icon toolbars keep controls within reach while leaving your graph completely unobstructed.
- Stripped of retro clutter: enjoy 4x MSAA hardware acceleration, rounded card geometry, high-contrast category badges (
- Creative-Suite Selection & Navigation
- Photoshop & Blender Muscle Memory:
SpaceorHto glide across your infinite canvas,Vfor precise interaction, andQfor rubberband marquee. - Directional Marquee Selection: Drag left-to-right to select touched nodes; drag right-to-left for strict bounding box enclosure.
- Pro Selection Shortcuts:
Ctrl+A(Select All),Ctrl+D(Deselect All), andCtrl+Shift+I(Invert Selection). Ctrl+FFuzzy Search: Instantly spotlight and camera-jump to any plugin or port in seconds across complex multi-client setups.
- Photoshop & Blender Muscle Memory:
- Smart Auto-Arrange & Collision-Free Alignment
- Effortless cleanup: automatically untangle sprawling routing webs with repel-aware auto-arrange that respects node boundaries and prevents overlapping collisions.
- Align selected nodes horizontally or vertically with uniform spacing at the click of a button.
- Dual-View Power: Patchbay + Rack in Lockstep
- Graph routing meets knob tweaking: view the modular patchbay alongside the mini rack in a seamless side-by-side split.
- Bidirectional Focus Lock: Clicking any node in the patchbay instantly scrolls and focuses its rack panel, and vice versa.
- Zero-Anxiety Session Preservation
- Background rotating autosaves (
.autosaves/), modified dirty indicators (*), live status countdown timers, and safe-exit verification dialogs ensure you never lose a creative take.
- Background rotating autosaves (
- Live Dynamic Customization (Zero Restarts)
- Tailor Clara to your display on the fly with live responsive sliders for rack margins, slot padding, and layout width.
- Photoshop/Blender Modal Tools: Instant hotkeys (
VSelect/Move,H/SpacePan,QMarquee) with a floating tool overlay. - Canvas Node Quick Search (
Ctrl+F): Fuzzy search bar that automatically filters, highlights, and centers viewport onto target nodes. - Selection Ergonomics: Industry-standard shortcuts (
Ctrl+A,Ctrl+D,Ctrl+Shift+I) and multi-selection preservation across context menus. - Fluid & Crisp Rendering: Native 4x MSAA multisampling on OpenGL viewports with subpixel integer hinting for ultra-sharp port labels.
- Unified Catppuccin Colors: Automatic color-coding by audio role (
SYNTH,FX,EQ,DYN,UTIL,SOURCE,SINK,HW). - Dynamic Cable Gradients: Connection cables smoothly interpolate source and destination node colors via linear gradients.
- Configurable Cable Formulas: Choose between organic Bezier curves, straight/linear diagonals, or orthogonal right-angle routing.
- Rack & Graph Synchronization: Split dual-pane combining modular routing with parameter tweaking.
- Bidirectional Focus: Clicking any patchbay node instantly scrolls and highlights its corresponding rack module, and vice versa.
- Automatic Rotating Autosaves: Background rotating backups (
.autosaves/) with recursive directory guard. - Dirty State Tracking: Real-time modified indicator (
*) and status bar countdown timer until the next autosave snapshot. - Safe Exit Protection: Confirmation prompt (
Save,Discard,Cancel) when closing modified sessions.
- Structured Python Rich Console: Color-coded loglevels and categorical tags (
APP,ENGINE,PATCHBAY,BACKEND) with low-level C++stderrinterception. - Instant Reactive Settings: Real-time sliders for rack spacing, padding, and width without application restarts.
- Rich Startup Banner: Launching from a terminal renders a
richpanel readingClara vX.Y.Zthenbased on Carla version A.B.C, alongside the runtime and binary/resource paths;--versionshows the same banner. - Graceful Ctrl+C Handling: The terminal SIGINT prompt is a
richpanel where pressingEnterquits (default) andTkeeps Clara running in the system tray.
Pre-built binaries are provided for major Linux distributions:
| Distribution | Format | Quick Installation |
|---|---|---|
| Any Linux (x86_64) | AppImage | chmod +x Clara-*-x86_64.AppImage && ./Clara-*-x86_64.AppImage |
| Any Linux (Flatpak) | Flatpak | flatpak install --user Clara-*-x86_64.flatpak |
| Arch Linux | AUR / Pacman | paru -S clara-bin or clara-git (see aur/) |
| Ubuntu / Debian | .deb |
sudo dpkg -i clara-ubuntu-*.deb && sudo apt-get install -f |
| Fedora / RHEL | .rpm |
sudo dnf install clara-*.rpm |
| Void Linux | .tar.zst |
Extract to / (tar --zstd -xvf clara-void-*.tar.zst -C /) |
| Alpine Linux | .tar.zst |
Extract to / (tar --zstd -xvf clara-alpine-*.tar.zst -C /) |
| Nix / NixOS | Flake | nix run github:acropolis914/Clara |
The standalone AppImage bundles its own Python + PyQt6/Qt6, so it runs on modern distributions without installing anything. The Flatpak uses the
org.kde.Platformruntime. The primary binary and desktop entry are namedclara;carlais kept as a backwards-compatible symlink.
./build.sh# Compile backend & UI resources
make -j$(nproc)
# Run Clara directly from source tree
./bin/carlaRefer to installation.md for full distribution-specific build dependencies.
Active task tracking and architectural priorities are maintained in TODO.md.
Recently shipped:
- Rich CLI startup banner and a safe SIGINT exit prompt.
- Visual audio/MIDI signal activity animations along cables and active nodes.
- Infinite canvas with migration recentering for legacy projects.
- Standardized
argparseCLI integration withrichhelp output. - Release pipeline hardening: tag/version consistency guard and AUR publish fix.
- Patchbay focus fixes: the focused node title stays readable, and cables react to focus immediately.
- AUR packaging fixes:
clara-binbuilds and installs again, and packaging fixes can be published without a full release. - Patchbay toolbar feedback: enabled toggles are highlighted in the theme accent, and new cables are drawn instantly.
- Window lifecycle & tray fixes: plugin edit window close no longer shuts down engine, and minimize-to-tray handles Wayland compositors cleanly.
Next up:
- Shared ops layer for graph control (
getallnodes,connect,arrange,getgraph), as the base for every front-end. -
claractlCLI / IPC core for live graph control and scripting. - Mini DSP load history graph with side labels and hover tooltips.
- In-project session notes with rich Qt Markdown (
QTextDocument) preview. - Floating sidebar quick settings overlay with integrated search.
Tip
Help Shape the Future of Linux Modular Audio! Whether you're an experienced C++/Qt hacker, a Python developer, a DSP audio nerd, a UI/UX designer, or an everyday music producer finding edge-case bugs: we want your help.
Clara is evolving fast, and we are actively looking for:
- Core Developers & Co-Maintainers: Help refine the canvas architecture, Qt6 modernize legacy modules, and review PRs.
- UI/UX & Theme Designers: Polish vector icons, refine high-DPI skins, and elevate graph interaction ergonomics.
- Testers & Bug Hunters: Put large multi-client JACK/PipeWire routing setups through their paces and report crashes/regressions.
Check out our current backlog in TODO.md for open tasks rated by difficulty ([Diff: 1] to [Diff: 3]).
- Guided AI Usage is Permitted: Contributors are allowed to use AI coding agents and assistants, such as Google Antigravity / Gemini, Claude, or Copilot, to research, scaffold, refactor, and draft code.
- Explicit AI Disclosure Required: If AI was used in any part of creating a PR, you must explicitly state so in the PR description, noting the tools used and the prompts/intent.
- Rigorous Quality Review: AI-generated code will not be accepted without scrutiny. All PRs are extensively reviewed for architectural sanity, clean code standards, Qt compatibility, and stability. Contributors must test and take full ownership of their submitted code.
- Read CONTRIBUTING.md for build guides, coding standards, and PR submission checklist.
Clara retains complete support for all native Carla host capabilities:
- Plugin Formats: LADSPA, DSSI, LV2, VST2, VST3, CLAP, and AU plugins.
- Sound Banks: SF2/3 and SFZ sound bank playback.
- Drivers: Native ALSA, DirectSound, CoreAudio, PulseAudio, and JACK/PipeWire drivers.
- Automation & MIDI: Internal MIDI player, MIDI CC parameter automation, and OSC remote control.
Refer to the upstream Carla website for base engine documentation.
Clara stands on the shoulders of a great ecosystem:
- falkTX and the upstream Carla project — Clara's audio engine, plugin hosting core and OSC surface are built on Carla. Original author of the codebase.
- Lucide — the icon set used across the UI. ISC license, vendored via
scripts/fetch-lucide.sh. - Catppuccin — the pastel palettes behind the default themes (Macchiato, Mocha, Latte & friends).
- The plugin ecosystems that make a host worth using: the LSP plugin suite, sfizz, Cardinal, Dexed, Helm, u-he, and every LADSPA/LV2/VST/CLAP developer whose work loads inside Clara.
- Everyone who reports bugs, tests large routing setups, and hangs out in the issue tracker — an early-alpha project lives on your reports.