spa-acp-tool(1)

📦
version 1.6.8 · 12 versions
, in alpine 3.24, ubuntu stonking

💅 spa-acp-tool — the PipeWire ALSA profile debugging utility ✨

okay so bestie, you know how nothing in this world is more iconic than a man page with a cute handbook? yeah. this is spa-acp-tool from the PipeWire fam, and she's a whole debugging vibe. 🎀

🌸 SYNOPSIS 🌸

spa-acp-tool [OPTIONS] [COMMAND]

like, options first, command second, and honestly that's the whole plot 🫶

✨ DESCRIPTION ✨

okay so real talk: spa-acp-tool is a debug tool for exercising the ALSA card profile probing code — and the best part? it does it without running PipeWire at all. no daemon, no drama, just you and the probing code having a little one-on-one 😌

it's the tool you reach for when you're like "hmm why is my ALSA card profile acting up" — specifically, it may be used to debug problems where PipeWire has incorrectly functioning ALSA card profiles. the way that it just lets you poke at the thing in isolation is literally so helpful 💅

🦋 OPTIONS 🦋

  • -h | --help — show help. that's it, that's the option, she's simple and she slays 💖
  • -v | --verbose — increase verbosity by one level. yes queen, crank it, and if you want more you just pass it again 👑
  • -c NUMBER | --card NUMBER — select which card to probe. you're picking your main character here 🌟
  • -p | --properties — additional properties to pass to ACP, e.g. key=value .... — yes that's literally how it's written, trailing dots and all, no cap 🙈

🧚 COMMANDS 🧚

okay these are the commands you can type once you're inside — some have lil shortcuts, and the shortcuts are so cute. iykyk 💜

  • help | h — show available commands. when in doubt, ask for help, always 🌈
  • quit | q — quit. bye bestie, stay hydrated 🍓
  • card ID | c ID — probe card. go get 'em 🔥
  • info | i — list card info. the gossip, the lore ✨
  • list | l — list all objects
  • list-verbose | lv — list all data. everything. the full tea ☕
  • list-profiles [ID] | lpr [ID] — list profiles
  • set-profile ID | spr ID — activate a profile
  • list-ports [ID] | lp [ID] — list ports
  • set-port ID | sp ID — activate a port
  • list-devices [ID] | ld [ID] — list available devices
  • get-volume ID | gv ID — get volume from device
  • set-volume ID VOL | v ID VOL — set volume on device
  • inc-volume ID | v+ ID — increase volume on device. turn it up 🔊
  • dec-volume ID | v- ID — decrease volume on device. shhh 🤫
  • get-mute ID | gm ID — get mute state from device
  • set-mute ID VAL | sm ID VAL — set mute on device
  • toggle-mute ID | m ID — toggle mute on device. the flippiest of switches 🫶
ngl the [ID] in brackets means it's optional, and the ones without brackets really want their ID — read the synopsis line, she's not subtle 💀

👑 AUTHORS 👑

the PipeWire Developers made this, and they're iconic for it. you can find them at <https://gitlab.freedesktop.org/pipewire/pipewire/issues>, and PipeWire is available from <https://pipewire.org> 💖

🌟 SEE ALSO 🌟

  • pipewire(1) — go read her too, she's the whole ecosystem bestie 🌸

and that's the page, mwah 💋 — this icon is from PipeWire, version 1.6.8, and it lives in the General Commands Manual. go debug something gorgeous, ily, bye 🎀✨💅

📦 where this page comes from