# audivane/dsp architecture

> Architecture diagram of the GitHub repository audivane/dsp, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-16). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/audivane/dsp
- Repository: https://github.com/audivane/dsp

## Overview

Audivane DSP is a Linux system-wide audio processor with a Tauri desktop control app, a background daemon, and a CLI. The main workflow is to configure EQ, convolution, upsampling, output, and routing in the app; changes cross the daemon’s IPC control plane, which manages the audio engine and PipeWire/ALSA integration. The README documents the user-facing capabilities; source excerpts and the source index establish only some internal calls, so uncertain runtime links are omitted or marked unverified.

Main entry points: [`app/src/App.tsx`](https://github.com/audivane/dsp/blob/main/app/src/App.tsx) (Desktop app), [`crates/io-pw/src/engine_driver.rs`](https://github.com/audivane/dsp/blob/main/crates/io-pw/src/engine_driver.rs) (PipeWire driver), [`crates/cli/src/main.rs`](https://github.com/audivane/dsp/blob/main/crates/cli/src/main.rs) (avdsp CLI), [`crates/daemon/src/engine/mod.rs`](https://github.com/audivane/dsp/blob/main/crates/daemon/src/engine/mod.rs) (Engine coordinator)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_desktop["Desktop control"]
  node_app["Desktop app<br/>[App.tsx]"]
  node_app_state["App state<br/>[store.ts]"]
  node_api_transport["API transport<br/>[transport.ts]"]
  node_tauri["Tauri shell<br/>[app.rs]"]
  node_daemon_client["Socket client<br/>[client.rs]"]
  node_eq_ui["EQ editor<br/>[EqView.tsx]"]
  node_conv_ui["Convolution view"]
  node_upsampling_ui["Upsampling view<br/>[UpsamplingView.tsx]"]
  node_routing_ui["Routing view<br/>[RoutingView.tsx]"]
  node_monitor_ui["Monitoring UI<br/>[StatusBar.tsx]"]
end

subgraph group_control["Daemon control plane"]
  node_protocol["IPC protocol<br/>[ipc.rs]"]
  node_service["Request dispatcher<br/>[service.rs]"]
  node_config["Engine config<br/>[config.rs]"]
  node_graph["Audio graph<br/>[graph.rs]"]
end

subgraph group_audio["Audio engine"]
  node_daemon_engine["Engine coordinator<br/>[mod.rs]"]
  node_processor["Audio processor<br/>[processor.rs]"]
  node_spectrum["Spectrum analysis<br/>[spectrum.rs]"]
  node_pw_driver["PipeWire driver<br/>[engine_driver.rs]"]
  node_pw_clock["DAC clocking<br/>[clock.rs]"]
  node_rate_arbiter["Rate arbiter<br/>[rate_arbiter.rs]"]
  node_alsa_pcm["ALSA PCM<br/>[pcm.rs]"]
end

subgraph group_dsp["Signal processing"]
  node_dsp_chain["DSP chain<br/>[chain.rs]"]
  node_resampler["Resampler<br/>[resample.rs]"]
  node_minphase["Minimum phase<br/>[minphase.rs]"]
end

subgraph group_tools["CLI tools"]
  node_cli["avdsp CLI<br/>[main.rs]"]
  node_cli_ctl["Daemon control CLI<br/>[ctl.rs]"]
  node_cli_profile["Profile tools<br/>[profile.rs]"]
  node_cli_process["WAV processing<br/>[process.rs]"]
end

node_user(("Listener"))
node_external_audio(("Audio applications"))
node_dac(("DAC"))

node_user -->|"configures"| node_app
node_app -->|"renders"| node_eq_ui
node_app -->|"renders"| node_conv_ui
node_app -->|"renders"| node_upsampling_ui
node_app -->|"renders"| node_routing_ui
node_app -->|"renders"| node_monitor_ui
node_app -->|"reads state"| node_app_state
node_app_state -->|"sends intents"| node_api_transport
node_api_transport -.->|"invokes"| node_tauri
node_tauri -->|"uses client"| node_daemon_client
node_daemon_client -->|"exchanges RPC"| node_protocol
node_cli -->|"dispatches"| node_cli_ctl
node_cli -->|"dispatches"| node_cli_profile
node_cli -->|"dispatches"| node_cli_process
node_cli_ctl -->|"sends calls"| node_protocol
node_protocol -.->|"routes requests"| node_service
node_service -->|"uses config"| node_config
node_service -->|"acts on graph"| node_graph
node_daemon_engine -->|"coordinates"| node_processor
node_daemon_engine -->|"uses analysis"| node_spectrum
node_processor -->|"uses analysis"| node_spectrum
node_pw_driver -->|"uses clock"| node_pw_clock
node_pw_driver -->|"arbitrates rates"| node_rate_arbiter
node_pw_driver -.->|"drives DAC"| node_alsa_pcm
node_daemon_engine -.->|"drives PipeWire"| node_pw_driver
node_processor -.->|"processes audio"| node_dsp_chain
node_dsp_chain -.->|"upsamples"| node_resampler
node_resampler -->|"designs filters"| node_minphase
node_external_audio -.->|"provides streams"| node_pw_driver
node_pw_driver -.->|"outputs audio"| node_dac
node_user -->|"runs commands"| node_cli

click node_app "https://github.com/audivane/dsp/blob/main/app/src/App.tsx"
click node_app_state "https://github.com/audivane/dsp/blob/main/app/src/store/store.ts"
click node_api_transport "https://github.com/audivane/dsp/blob/main/app/src/api/transport.ts"
click node_tauri "https://github.com/audivane/dsp/blob/main/app/src-tauri/src/app.rs"
click node_daemon_client "https://github.com/audivane/dsp/blob/main/app/src-tauri/src/client.rs"
click node_eq_ui "https://github.com/audivane/dsp/blob/main/app/src/views/EqView.tsx"
click node_conv_ui "https://github.com/audivane/dsp/blob/main/app/src/views/ConvolutionView.tsx"
click node_upsampling_ui "https://github.com/audivane/dsp/blob/main/app/src/views/UpsamplingView.tsx"
click node_routing_ui "https://github.com/audivane/dsp/blob/main/app/src/views/RoutingView.tsx"
click node_monitor_ui "https://github.com/audivane/dsp/blob/main/app/src/components/StatusBar.tsx"
click node_protocol "https://github.com/audivane/dsp/blob/main/crates/protocol/src/ipc.rs"
click node_service "https://github.com/audivane/dsp/blob/main/crates/daemon/src/control/service.rs"
click node_config "https://github.com/audivane/dsp/blob/main/crates/daemon/src/control/config.rs"
click node_graph "https://github.com/audivane/dsp/blob/main/crates/daemon/src/control/graph.rs"
click node_daemon_engine "https://github.com/audivane/dsp/blob/main/crates/daemon/src/engine/mod.rs"
click node_processor "https://github.com/audivane/dsp/blob/main/crates/daemon/src/engine/processor.rs"
click node_spectrum "https://github.com/audivane/dsp/blob/main/crates/daemon/src/engine/spectrum.rs"
click node_pw_driver "https://github.com/audivane/dsp/blob/main/crates/io-pw/src/engine_driver.rs"
click node_pw_clock "https://github.com/audivane/dsp/blob/main/crates/io-pw/src/clock.rs"
click node_rate_arbiter "https://github.com/audivane/dsp/blob/main/crates/io-pw/src/rate_arbiter.rs"
click node_alsa_pcm "https://github.com/audivane/dsp/blob/main/crates/io-alsa/src/pcm.rs"
click node_dsp_chain "https://github.com/audivane/dsp/blob/main/crates/dsp-core/src/chain.rs"
click node_resampler "https://github.com/audivane/dsp/blob/main/crates/dsp-core/src/resample.rs"
click node_minphase "https://github.com/audivane/dsp/blob/main/crates/dsp-core/src/minphase.rs"
click node_cli "https://github.com/audivane/dsp/blob/main/crates/cli/src/main.rs"
click node_cli_ctl "https://github.com/audivane/dsp/blob/main/crates/cli/src/ctl.rs"
click node_cli_profile "https://github.com/audivane/dsp/blob/main/crates/cli/src/profile.rs"
click node_cli_process "https://github.com/audivane/dsp/blob/main/crates/cli/src/process.rs"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_app,node_app_state,node_api_transport,node_tauri,node_daemon_client,node_eq_ui,node_conv_ui,node_upsampling_ui,node_routing_ui,node_monitor_ui toneBlue
class node_protocol,node_service,node_config,node_graph toneAmber
class node_daemon_engine,node_processor,node_spectrum,node_pw_driver,node_pw_clock,node_rate_arbiter,node_alsa_pcm toneMint
class node_dsp_chain,node_resampler,node_minphase toneRose
class node_cli,node_cli_ctl,node_cli_profile,node_cli_process,node_user,node_external_audio,node_dac toneIndigo
```

## Components

### Desktop control

- [Desktop app](https://github.com/audivane/dsp/blob/main/app/src/App.tsx): `app/src/App.tsx`
- [App state](https://github.com/audivane/dsp/blob/main/app/src/store/store.ts): `app/src/store/store.ts`
- [API transport](https://github.com/audivane/dsp/blob/main/app/src/api/transport.ts): `app/src/api/transport.ts`
- [Tauri shell](https://github.com/audivane/dsp/blob/main/app/src-tauri/src/app.rs): `app/src-tauri/src/app.rs`
- [Socket client](https://github.com/audivane/dsp/blob/main/app/src-tauri/src/client.rs): `app/src-tauri/src/client.rs`
- [EQ editor](https://github.com/audivane/dsp/blob/main/app/src/views/EqView.tsx): `app/src/views/EqView.tsx`
- [Convolution view](https://github.com/audivane/dsp/blob/main/app/src/views/ConvolutionView.tsx): `app/src/views/ConvolutionView.tsx`
- [Upsampling view](https://github.com/audivane/dsp/blob/main/app/src/views/UpsamplingView.tsx): `app/src/views/UpsamplingView.tsx`
- [Routing view](https://github.com/audivane/dsp/blob/main/app/src/views/RoutingView.tsx): `app/src/views/RoutingView.tsx`
- [Monitoring UI](https://github.com/audivane/dsp/blob/main/app/src/components/StatusBar.tsx): `app/src/components/StatusBar.tsx`

### Daemon control plane

- [IPC protocol](https://github.com/audivane/dsp/blob/main/crates/protocol/src/ipc.rs): `crates/protocol/src/ipc.rs`
- [Request dispatcher](https://github.com/audivane/dsp/blob/main/crates/daemon/src/control/service.rs): `crates/daemon/src/control/service.rs`
- [Engine config](https://github.com/audivane/dsp/blob/main/crates/daemon/src/control/config.rs): `crates/daemon/src/control/config.rs`
- [Audio graph](https://github.com/audivane/dsp/blob/main/crates/daemon/src/control/graph.rs): `crates/daemon/src/control/graph.rs`

### Audio engine

- [Engine coordinator](https://github.com/audivane/dsp/blob/main/crates/daemon/src/engine/mod.rs): `crates/daemon/src/engine/mod.rs`
- [Audio processor](https://github.com/audivane/dsp/blob/main/crates/daemon/src/engine/processor.rs): `crates/daemon/src/engine/processor.rs`
- [Spectrum analysis](https://github.com/audivane/dsp/blob/main/crates/daemon/src/engine/spectrum.rs): `crates/daemon/src/engine/spectrum.rs`
- [PipeWire driver](https://github.com/audivane/dsp/blob/main/crates/io-pw/src/engine_driver.rs): `crates/io-pw/src/engine_driver.rs`
- [DAC clocking](https://github.com/audivane/dsp/blob/main/crates/io-pw/src/clock.rs): `crates/io-pw/src/clock.rs`
- [Rate arbiter](https://github.com/audivane/dsp/blob/main/crates/io-pw/src/rate_arbiter.rs): `crates/io-pw/src/rate_arbiter.rs`
- [ALSA PCM](https://github.com/audivane/dsp/blob/main/crates/io-alsa/src/pcm.rs): `crates/io-alsa/src/pcm.rs`

### Signal processing

- [DSP chain](https://github.com/audivane/dsp/blob/main/crates/dsp-core/src/chain.rs): `crates/dsp-core/src/chain.rs`
- [Resampler](https://github.com/audivane/dsp/blob/main/crates/dsp-core/src/resample.rs): `crates/dsp-core/src/resample.rs`
- [Minimum phase](https://github.com/audivane/dsp/blob/main/crates/dsp-core/src/minphase.rs): `crates/dsp-core/src/minphase.rs`

### CLI tools

- [avdsp CLI](https://github.com/audivane/dsp/blob/main/crates/cli/src/main.rs): `crates/cli/src/main.rs`
- [Daemon control CLI](https://github.com/audivane/dsp/blob/main/crates/cli/src/ctl.rs): `crates/cli/src/ctl.rs`
- [Profile tools](https://github.com/audivane/dsp/blob/main/crates/cli/src/profile.rs): `crates/cli/src/profile.rs`
- [WAV processing](https://github.com/audivane/dsp/blob/main/crates/cli/src/process.rs): `crates/cli/src/process.rs`

### Other components

- **Listener**
- **Audio applications**
- **DAC**

## Connections

- Listener → Desktop app: configures (evidence: `README.md`)
- Desktop app → EQ editor: renders (evidence: `app/src/App.tsx`)
- Desktop app → Convolution view: renders (evidence: `app/src/App.tsx`)
- Desktop app → Upsampling view: renders (evidence: `app/src/App.tsx`)
- Desktop app → Routing view: renders (evidence: `app/src/App.tsx`)
- Desktop app → Monitoring UI: renders (evidence: `app/src/App.tsx`)
- Desktop app → App state: reads state (evidence: `app/src/App.tsx`)
- App state → API transport: sends intents (evidence: `app/src/store/store.ts`)
- API transport → Tauri shell: invokes
- Tauri shell → Socket client: uses client (evidence: `app/src-tauri/src/app.rs`)
- Socket client → IPC protocol: exchanges RPC (evidence: `app/src-tauri/src/client.rs`)
- avdsp CLI → Daemon control CLI: dispatches (evidence: `crates/cli/src/main.rs`)
- avdsp CLI → Profile tools: dispatches (evidence: `crates/cli/src/main.rs`)
- avdsp CLI → WAV processing: dispatches (evidence: `crates/cli/src/main.rs`)
- Daemon control CLI → IPC protocol: sends calls (evidence: `crates/cli/src/ctl.rs`)
- IPC protocol → Request dispatcher: routes requests
- Request dispatcher → Engine config: uses config (evidence: `crates/daemon/src/control/service.rs`)
- Request dispatcher → Audio graph: acts on graph (evidence: `crates/daemon/src/control/service.rs`)
- Engine coordinator → Audio processor: coordinates (evidence: `crates/daemon/src/engine/mod.rs`)
- Engine coordinator → Spectrum analysis: uses analysis (evidence: `crates/daemon/src/engine/mod.rs`)
- Audio processor → Spectrum analysis: uses analysis (evidence: `crates/daemon/src/engine/processor.rs`)
- PipeWire driver → DAC clocking: uses clock (evidence: `crates/io-pw/src/engine_driver.rs`)
- PipeWire driver → Rate arbiter: arbitrates rates (evidence: `crates/io-pw/src/engine_driver.rs`)
- PipeWire driver → ALSA PCM: drives DAC
- Engine coordinator → PipeWire driver: drives PipeWire
- Audio processor → DSP chain: processes audio
- DSP chain → Resampler: upsamples
- Resampler → Minimum phase: designs filters (evidence: `crates/dsp-core/src/resample.rs`)
- Audio applications → PipeWire driver: provides streams
- PipeWire driver → DAC: outputs audio
- Listener → avdsp CLI: runs commands (evidence: `crates/cli/src/main.rs`)
