Skip to content

About

nh_plug CLAP plugin with Cosmic Gui (libcosmic).

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

3 Commits

Folders and files

Repository files navigation

Cosmic CLAP

Ein CLAP-Audio-Plugin mit nih-plug und einer libcosmic-GUI, die über IPC (Unix Domain Sockets) kommuniziert.

Architektur

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          │
└─────────────────┘

Vorteile dieser Architektur

  1. Prozess-Trennung: Ein GUI-Crash reißt nicht die DAW mit
  2. Wayland-Native: libcosmic kann ohne Kompromisse rendern
  3. Keine Dependency-Konflikte: Plugin und GUI haben getrennte Abhängigkeiten
  4. Multi-Instance: Jede Plugin-Instanz bekommt ihren eigenen Socket

Build

Voraussetzungen

  • Rust Nightly (für einige libcosmic Features)
  • CLAP-SDK (wird von nih-plug mitgebracht)
  • Wayland-Bibliotheken

Kompilieren

# 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 standalone

Installation

CLAP-Plugin

Das Plugin muss in den CLAP-Plugin-Pfad kopiert werden:

# Üblicher Pfad unter Linux
mkdir -p ~/.clap
cp target/release/libcosmic_clap_plugin.clap ~/.clap/

GUI

Die GUI wird automatisch vom Plugin gestartet. Stelle sicher, dass sich die Binary im selben Verzeichnis wie das Plugin befindet oder im PATH liegt.

Verwendung

  1. Lade das Plugin in deiner DAW (Bitwig, Reaper, etc.)
  2. Klicke auf den Editor-Button der DAW
  3. Die libcosmic-GUI öffnet sich als separates Fenster
  4. Bewege den Gain-Slider, um den Sound zu ändern
  5. Das Metering zeigt den aktuellen Pegel an

IPC-Protokoll

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 },
}

Socket-Pfad

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.

Fehlerbehebung

GUI startet nicht

  • Prüfe, ob cosmic-clap-gui im PATH oder neben dem Plugin liegt
  • Schau in die Logs der DAW für Fehlermeldungen

Keine Audio-Änderung

  • Prüfe, ob der Socket existiert: ls /tmp/cosmic_clap_*.sock
  • Teste die Verbindung: nc -U /tmp/cosmic_clap_<uuid>.sock

Metering aktualisiert nicht

  • Die GUI muss mit dem Plugin verbunden sein
  • Prüfe, ob die Subscription in der GUI läuft

Lizenz

MIT

cosmic-clap

cosmic-clap

About

nh_plug CLAP plugin with Cosmic Gui (libcosmic).

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages