# 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.