eqtui 0.1.3

Terminal-native(TUI) audio effects processor for PipeWire
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103

// Copyright (C) 2026 SiputBiru <radityamahatma23@gmail.com>
// SPDX-License-Identifier: GPL-2.0-only

use std::process::Command;

/// Outcome of one pw-link invocation.
#[derive(Debug)]
enum LinkOutcome {
    Ok,     // link created/removed
    Benign, // already in the desired state (idempotent no-op)
    Failed, // genuine failure
}

fn run_pw_link(args: &[&str]) -> LinkOutcome {
    let output = match Command::new("pw-link").args(args).output() {
        Ok(o) => o,
        Err(e) => {
            tracing::error!("failed to execute pw-link: {e}");
            return LinkOutcome::Failed;
        }
    };

    if output.status.success() {
        tracing::info!(args = ?args, "pw-link success");
        return LinkOutcome::Ok;
    }

    let stderr = String::from_utf8_lossy(&output.stderr);

    if stderr.contains("File exists") || stderr.contains("No such file") {
        tracing::debug!(args = ?args, "pw-link idempotent no-op");
        return LinkOutcome::Benign; // already linked / already unlinked
    }

    tracing::error!("pw-link failed: {}", stderr.trim());
    LinkOutcome::Failed
}

pub(crate) fn create_monitor_links(out_node_id: u32, in_node_id: u32) {
    for (out_port, in_port) in &[("monitor_FL", "input_FL"), ("monitor_FR", "input_FR")] {
        run_pw_link(&[
            &format!("{out_node_id}:{out_port}"),
            &format!("{in_node_id}:{in_port}"),
        ]);
    }
}

/// Create `PipeWire` links from the DSP filter's output ports to a target
/// device's playback ports using `pw-link`. Returns false if any leg failed.
pub(crate) fn create_device_output_links(filter_id: u32, device_id: u32) -> bool {
    let mut ok = true;
    for (out_port, in_port) in [("output_FL", "playback_FL"), ("output_FR", "playback_FR")] {
        // no short-circuit: attempt BOTH legs so state stays symmetric
        ok &= !matches!(
            run_pw_link(&[
                &format!("{filter_id}:{out_port}"),
                &format!("{device_id}:{in_port}"),
            ]),
            LinkOutcome::Failed
        );
    }
    ok
}

/// Remove `PipeWire` links between the DSP filter's output ports and a
/// target device's playback ports using `pw-link -d`. Returns false if any
/// leg failed.
pub(crate) fn remove_device_output_links(filter_id: u32, device_id: u32) -> bool {
    let mut ok = true;
    for (out_port, in_port) in [("output_FL", "playback_FL"), ("output_FR", "playback_FR")] {
        ok &= !matches!(
            run_pw_link(&[
                "-d",
                &format!("{filter_id}:{out_port}"),
                &format!("{device_id}:{in_port}"),
            ]),
            LinkOutcome::Failed
        );
    }
    ok
}

/// Check whether any `PipeWire` link routes audio INTO the null sink's
/// `playback_FL` or `playback_FR` ports.
///
/// Returns `Some(true)` if a source is connected, `Some(false)` if no source
/// is present, and `None` if `pw-link -I` itself failed (e.g. not installed,
/// `PipeWire` down).
pub(crate) fn check_null_sink_input_source(null_sink_id: u32) -> Option<bool> {
    let output = match Command::new("pw-link").arg("-I").output() {
        Ok(o) => o,
        Err(e) => {
            tracing::warn!(%e, "pw-link -I failed — cannot check null sink input source");
            return None;
        }
    };

    let text = String::from_utf8_lossy(&output.stdout);
    Some(text.lines().any(|line| {
        line.contains(&format!("-> {null_sink_id}:playback_FL"))
            || line.contains(&format!("-> {null_sink_id}:playback_FR"))
    }))
}