ponymix(1)

💅 ponymix(1) — User Commands 💅

okay bestie, welcome to the ponymix(1) manual page, aka the cli volume control for PulseAudio that's lowkey iconic. She does volume, balance, mutes, cards, profiles, streams… the whole vibe. Let's go 💖

🌸 NAME 🌸

ponymix — cli volume control for PulseAudio. periodt.

✨ SYNOPSIS ✨

ponymix [options] operation [args]

🦋 DESCRIPTION 🦋

ponymix is a command line volume control for PulseAudio, letting you perform many operations on both device and application sinks and source. (yes bestie, sinks and source, that's the wording, we don't make the rules 💅)

🎀 OPTIONS 🎀

• -c, --card CARD — specify a card. By default, the card associated with the specified device is used. Cards can be specified by name or numeric index.
• -d, --device DEVICE — specify a device other than the default. Devices can be specified by name or numeric index.
• --max-volume VALUE — override the maximum volume ponymix will allow. This is baked in to be 100 using the increase and decrease methods, and 150 via set-volume.
• -N, --notify — create a libnotify notification for volume change events instead of printing the new volume to standard output. Requires compile time support for libnotify. Without support, this flag is a no-op.
• -t, --devtype TYPE — specify a device type to examine, usually in conjunction with the --device flag. TYPE must be one of sink, source, sink-input, or source-output.
• --sink — alias to --devtype sink.
• --output — alias to --devtype sink.
• --source — alias to --devtype source.
• --input — alias to --devtype source.
• --source-output — alias to --devtype source-output.
• --sink-input — alias to --devtype sink-input.
• --short — generate output for list commands in a parseable format. This only applies to the list, list-cards, and list-profiles commands.

👑 OPERATIONS 👑

🧚 Generic Commands 🧚

• help — display the usage and exit.

🔥 Device Commands 🔥

These commands are specific to devices. Not all devices will support all the listed commands.

• list — list all available devices. This can be filtered using the --devtype flag.
• defaults — display the default sink and source. This is the default command if none is specified.
• set-default — set a sink or source by name or numeric index as the default. The new default should be passed using the --device flag.
• get-volume — get the volume of a device.
• set-volume VALUE — set the volume of a device. VALUE is an integer between 0 and 150.
• get-balance — get the balance of a device.
• set-balance VALUE — set the balance of a device. VALUE is an integer from -100 (all left) to 100 (all right).
• adj-balance VALUE — adjust balance by the integer increment VALUE. The resulting balance has the same bounds as those set by set-balance. The end-of-options indicator (--) is required when passing a negative increment.

bestie pls note: that -- is not optional when your increment is negative, okay? it's giving "end-of-options indicator required" 💀

• increase VALUE — increase the volume percentage of a device or application by integer VALUE. Increasing the volume in this way is capped at 100.
• decrease VALUE — decrease the volume percentage of a device by the integer VALUE. Decreasing the volume in this way is capped at 0.
• mute, unmute, toggle — mute, unmute, or toggle the mute status of a device.
• is-muted — check if a device is muted. ponymix will exit zero if muted, and non-zero otherwise.
• is-available — check if a device is available. This usually applies to headphone jacks, but not all devices will support this check. ponymix will exit zero if the port is definitively available, and non-zero if unavailable or unknown.

🌈 Application Commands 🌈

These commands are specific to devices which refer to streams of applications. For these commands, sink and source are synonymous with sink-input and source-output, respectively.

• move DEVICE — move a device's stream to the given device, specified using the --devtype and --device flags. Note that a source output can only be moved to another source, and a sink input can only be moved to another sink. The type of the target device will be inferred using this logic.
• kill — kill a device's stream, specified using the --device and --devtype flags. This only applies to sink-inputs and source-outputs.

🍓 Card Commands 🍓

These commands are specific to cards.

• list-cards — list all available cards.
• list-profiles — list profiles for a card.
• set-profile — set the specified profile for a card.

💜 AUTHORS 💜

• Dave Reisner <dreisner@archlinux.org>
• Simon Gomizelj <simongmzlj@gmail.com>

⭐ SEE ALSO ⭐

• pulseaudio(1)

---

okay bestie, that's the whole manual page 🫶 this was ponymix(1), source/version ponymix, dated 2013-01-02 — slay and goodbye 💖✨