Ein CLAP-Audio-Plugin mit nih-plug und einer libcosmic-GUI, die über IPC (Unix Domain Sockets) kommuniziert.
Dieses Projekt besteht aus drei Crates:
- common: Gemeinsame Typen für die IPC-Kommunikation
- plugin: Das CLAP-Plugin (nih-plug) mit Audio-Processing
- gui: Die libcosmic-GUI-Anwendung
┌─────────────────┐ Unix Socket ┌─────────────────┐
│ DAW / Host │ │ libcosmic GUI │
│ │ │ (Wayland) │
│ ┌───────────┐ │ │ │
│ │ CLAP │ │◄──────────────────►│ - Slider │
│ │ Plugin │ │ PluginCommand │ - Metering │
│ │ (nih-plug)│ │ PluginResponse │ - State │
│ └───────────┘ │ │ │
│ ▲ │ └─────────────────┘
│ │ │
│ process() │
│ Audio │
└─────────────────┘
- Prozess-Trennung: Ein GUI-Crash reißt nicht die DAW mit
- Wayland-Native: libcosmic kann ohne Kompromisse rendern
- Keine Dependency-Konflikte: Plugin und GUI haben getrennte Abhängigkeiten
- Multi-Instance: Jede Plugin-Instanz bekommt ihren eigenen Socket
- Rust Nightly (für einige libcosmic Features)
- CLAP-SDK (wird von nih-plug mitgebracht)
- Wayland-Bibliotheken
# Gesamtes Workspace bauen
cargo build --release
# Nur das Plugin (CLAP)
cargo build --release -p cosmic-clap-plugin --features clap
# Nur die GUI
cargo build --release -p cosmic-clap-gui
# Standalone-Version (zum Testen ohne DAW)
cargo build --release -p cosmic-clap-plugin --features standaloneDas Plugin muss in den CLAP-Plugin-Pfad kopiert werden:
# Üblicher Pfad unter Linux
mkdir -p ~/.clap
cp target/release/libcosmic_clap_plugin.clap ~/.clap/Die GUI wird automatisch vom Plugin gestartet. Stelle sicher, dass sich die Binary im selben Verzeichnis wie das Plugin befindet oder im PATH liegt.
- Lade das Plugin in deiner DAW (Bitwig, Reaper, etc.)
- Klicke auf den Editor-Button der DAW
- Die libcosmic-GUI öffnet sich als separates Fenster
- Bewege den Gain-Slider, um den Sound zu ändern
- Das Metering zeigt den aktuellen Pegel an
Die Kommunikation erfolgt über binäre Serialisierung mit bincode:
// GUI → Plugin
enum PluginCommand {
SetGain(f32),
RequestState,
}
// Plugin → GUI
enum PluginResponse {
MeterUpdate(f32),
CurrentState { gain: f32 },
}Jede Plugin-Instanz erhält einen eindeutigen Socket-Pfad:
/tmp/cosmic_clap_<uuid>.sock
Der Socket wird beim Schließen des Plugins automatisch gelöscht.
- Prüfe, ob
cosmic-clap-guiim PATH oder neben dem Plugin liegt - Schau in die Logs der DAW für Fehlermeldungen
- Prüfe, ob der Socket existiert:
ls /tmp/cosmic_clap_*.sock - Teste die Verbindung:
nc -U /tmp/cosmic_clap_<uuid>.sock
- Die GUI muss mit dem Plugin verbunden sein
- Prüfe, ob die Subscription in der GUI läuft
MIT