NCPAMIXER(1)

📦 version 1.3.11, in nixos 26.05, nixpkgs unstable

🎧 NCPAMIXER(1) — the ncurses PulseAudio Mixer 💅

okay so real talk: this is ncpamixer, an ncurses mixer for PulseAudio that's inspired by pavucontrol. yes bestie, terminal-based volume sliders. it's giving main character energy and honestly? iconic.

✨ NAME ✨

ncpamixer — an ncurses mixer for PulseAudio inspired by pavucontrol. that's the whole vibe 🫶

🌸 SYNOPSIS 🌸

ncpamixer [-v] [-h] [-c CONFIG_FILE] [-t TAB]

💖 DESCRIPTION 💖

An ncurses mixer for PulseAudio inspired by pavucontrol. literally what it says on the tin, no cap. 🎀

⭐ Options ⭐

  • -v, --version — prints version info. cute little "who am i" moment 💫
  • -h, --help — prints this help screen. the "help me help you" flag 🙈
  • -c, --config=CONFIG_FILE — sets a custom location for the config. you wanna keep your settings somewhere else? go off 👑
  • -t, --tab=TAB — opens straight onto the given tab. the choices are: (p)layback (that's the default, btw), (r)ecording, (o)utput, (i)nput, and (c)onfiguration. pick your starter tab ✨

🦋 CONFIG 🦋

Your configuration gets created on first run — like, first launch and boom, it exists. 💅

If $XDG_CONFIG_HOME is defined then it will be created at $XDG_CONFIG_HOME/ncpamixer.conf. otherwise it goes to $HOME/.ncpamixer.conf. iykyk 🌈

🎀 Default bindings 🎀

here's the whole keymap, bestie, nothing skipped:

  • switch → tab — cycle through sinks, outputs, profile and ports 🔄
  • select → enter — select option in dropdowns
  • quit → escape — quit
  • quit → q — quit (two ways to leave, we love options)
  • dropdown → c — open dropdown for selecting sinks, outputs, profile and ports
  • mute → m — mute selected item 🤫
  • set_default → d — set default sink/source
  • volume_up → l — increase volume on selected item 📈
  • volume_down → h — decrease volume on selected item 📉
  • volume_up → arrow right — increase volume on selected item
  • volume_down → arrow left — decrease volume on selected item
  • move_up → k — move up
  • move_down → j — move down
  • move_up → arrow up — move up
  • move_down → arrow down — move down
  • page_up → page up — previous page in dropdown
  • page_down → page down — next page in dropdown
  • tab_next → L — next tab
  • tab_prev → H — previous tab
  • tab_playback → F1 — jump to playback tab
  • tab_recording → F2 — jump to recording tab
  • tab_output → F3 — jump to output tab
  • tab_input → F4 — jump to input tab
  • tab_config → F5 — jump to configuration tab
  • move_last → G — move to last item
  • move_first → g — move to first item
  • set_volume_0 → 0 — set volume to 0%
  • set_volume_10 → 1 — set volume to 10%
  • set_volume_20 → 2 — set volume to 20%
  • set_volume_30 → 3 — set volume to 30%
  • set_volume_40 → 4 — set volume to 40%
  • set_volume_50 → 5 — set volume to 50%
  • set_volume_60 → 6 — set volume to 60%
  • set_volume_70 → 7 — set volume to 70%
  • set_volume_80 → 8 — set volume to 80%
  • set_volume_90 → 9 — set volume to 90%
  • help → ? — pop up help screen with keycodes 💀 (yes the key is literally ?)
  • set_volume_100 → Unbound — set volume to 100%
  • toggle_static → Unbound — toggle barmode static/none static
ngl, the volume jump keys are 0–9 for 0%–100% in tens, and set_volume_100 is Unbound by default, so if you want full send you gotta bind it yourself 🫶

😭 BUGS 😭

See GitHub Issues: https://github.com/fulhax/ncpamixer/issues — that's the spot, fr fr 🐛

👑 AUTHOR 👑

https://github.com/c0r73x and contributors — legends, all of them 💜

okay that's the whole page, bestie! this doc is Version 1.3.5 of ncpamixer, straight from the NCPAMIXER(1) manual page. go mix some audio, slay, periodt 🎚️✨🌸

📦 where this page comes from