pamix(1)

✨ PAMIX ✨

okay bestie, sit down, we're talking about pamix from the pamix man page (section 1). she's a pavucontrol-inspired, ncurses-based pulseaudio mixer, and she's literally the moment. 💖

---

🌸 NAME 🌸

pamix — a pavucontrol inspired ncurses based pulseaudio mixer

---

🎀 DESCRIPTION 🎀

PAmix is a pavucontrol inspired ncurses based pulseaudio mixer. that's the whole vibe. it mixes your pulseaudio, in a terminal, with ncurses energy. iconic behavior tbh. 💅

---

🦋 CONFIGURATION 🦋

pamix gets configured through a file called pamix.conf that lives inside $XDG_CONFIG_HOME — or in $HOME/.config if $XDG_CONFIG_HOME isn't set. so like, she knows where home is. 🏠✨

---

💜 COMMANDS 💜

PAmix conf files support the following commands, no cap:

• bind

---

🔑 bind 🔑

SYNOPSIS:

bind KEYNAME MIXER-COMMAND [ARGUMENT]

bind is how you glue a keyname to a mixer-command. some mixer-commands need an argument, some don't, so like... read the room. and yes, you can bind one single keyname to multiple mixer-commands. she's polyamorous with keybinds. slay. 🫶

---

👑 PAMIX-COMMANDS 👑

Pamix-Commands get bound to keys using the bind command, and they're what you use to actually interact with pamix. here's the full roster of what's currently supported — every single one, we're not skipping anybody:

---

🚪 quit

quit makes PAmix exit. it takes no arguments. bye bestie 👋

---

📑 select-tab

select-tab selects one of these tabs:

• Output Devices
• Input Devices
• Playback
• Recording
• Cards

select-tab takes the number of the tab you want, starting at 0, in the exact order listed above. so 0 is Output Devices, 1 is Input Devices, etc. counting is hard, we know, but you got this. 🔢

---

⏭️ select-next and select-prev

these two get the optional argument channel. if you hand them channel, they select the next and previous channels. if you don't give them an argument, they select the next and previous entry in the displayed tab. same energy, different target. 🌈

---

🔊 set-volume

this one takes a targetvalue as an argument, in the form of a double.

depending on whether channels are locked or not, this command sets the volume of the selected entry/channel to that targetvalue you passed in.

Example: bind 0 set-volume 1.0 — this sets the volume to 100%. full send. 🔥

---

➕ add-volume

this one takes a deltavalue as an argument, in the form of a double. and yes, the deltavalue can be negative.

Example: bind h add-volume -0.05 — this reduces the volume by 5%. math girlies rise up. 📉

---

🔄 cycle-next and cycle-prev

these change the device or port of the currently selected entry. they take no arguments at all. just vibes. ✨

---

🔒 toggle-lock

toggles whether channels should be locked together for the currently selected entry. takes no arguments. keep your channels close but your lock state closer. 🔐

---

🔇 toggle-mute

toggles whether the currently selected entry is muted. also takes no arguments. silence is golden, sometimes. 🤫

---

🌟 DEFAULT CONFIGURATION 🌟

here's the stock keybinding situation, out of the box, no setup needed:

• F1 — show Playback tab
• F2 — show Recording tab
• F3 — show Output devices tab
• F4 — show Input devices tab
• F5 — show Cards tab
• 0-9 — set volume to percentage (10%-100%)
• j/down — select next channel or entry
• k/up — select previous channel or entry
• h/left — decrease volume
• l/right — increase volume
• c — un/lock channels
• s/S — select next/previous device/port

ngl bestie, that's the whole default setup. memorize it, or don't, live your truth. 🧚

---

and that's a wrap! this lil masterpiece is version V, dated 27 Nov 2024 — go forth and mix, main character. 💖🎀🦋✨👑