add input-remapper-switcher script and readme

2026-07-12 01:04:29 -04:00
parent ba428d591c
commit 2eced0627e
4 changed files with 299 additions and 0 deletions
@@ -0,0 +1,36 @@
+# audio_toggle.sh
+
+Switch PulseAudio/PipeWire audio output sinks.
+
+## Usage
+
+```bash
+./audio_toggle.sh [OPTION]
+```
+
+## Options
+
+| Flag | Description |
+|------|-------------|
+| *(no args)* | Switch to the next available sink |
+| `--to <pattern>` | Switch to a sink whose name matches `<pattern>` (case-insensitive) |
+| `--prev`, `--previous` | Switch back to the previously active sink |
+| `--list` | List all available sinks with descriptions |
+| `--current` | Show the current default sink |
+| `--move-streams` | Also move existing audio streams to the new sink |
+| `--help`, `-h` | Show help message |
+
+## Examples
+
+```bash
+audio_toggle.sh                    # next sink
+audio_toggle.sh --to hdmi          # switch to HDMI sink
+audio_toggle.sh --prev             # back to previous sink
+audio_toggle.sh --list             # see what's available
+```
+
+## Notes
+
+- Sinks named `easyeffects` are automatically filtered out.
+- The previous sink is stored in `~/.cache/audio-toggle-prev-sink`.
+- Streams are not moved by default; use `--move-streams` to relocate them.