feat(audio-switcher): support input ports

[blackbartblues]

Plugin

• Id: blackbartblues/audio-switcher
• New plugin
• Update to an existing plugin (version bumped in plugin.toml)

What it does

Adds first-class support for audio input ports. Audio Switcher now shows the active hardware port (for example, an internal or headset microphone), lets users select an available port from the panel, and includes available ports when cycling inputs.

This fixes the behavior described in #239. The plugin version is bumped from 0.4.0 to 0.5.0.

External dependencies

• pactl: enumerates audio sources and ports, selects the active source port, changes defaults, and moves recording/playback streams.
• bluetoothctl: discovers, connects, and disconnects Bluetooth audio devices.
• sleep: implements the short retry delay while waiting for Bluetooth audio endpoints.

The new input-port behavior does not add an external dependency.

Testing

• lua audio-switcher/tests/input_ports_test.lua

• python3 .github/workflows/scripts/validate-plugins.py — 74 manifests validated

• python3 -m unittest discover -s .github/workflows/scripts -p 'test_*.py' — 56 tests passed

• noctalia plugins lint audio-switcher — 0 errors, 0 warnings

• all translation JSON files checked with jq

• Tested on Niri

• Tested on Hyprland

• Tested on Sway

• Tested on another compositor:

• Noctalia version tested against: Runtime test pending; implementation rebased onto community-plugins main at f5bd62e

• Plugin API level: 15

Screenshots / Videos

The existing panel screenshot is available in audio-switcher/screenshots/panel.webp. A screenshot showing the new input-port selector is pending before the draft is marked ready for review.

Checklist

• The directory name matches the part of id after the / in plugin.toml exactly.
• It ships plugin.toml, README.md, thumbnail.webp, and translations/en.json.
• README.md follows the README template, documents every entry id and dependency, and includes exact panel IPC commands and launcher prefixes where applicable.
• I created thumbnail.webp with the thumbnail generator.
• version follows semver and is bumped in this PR; plugin_api is the oldest API level this plugin requires.
• Every non-English translation in this PR uses a locale supported by Noctalia core, and I can read, write, and understand that language well enough to review and maintain it (no unreviewed machine/LLM translations).
• I did not edit catalog.toml; CI generates it.
• This PR touches exactly one plugin directory.

Code review attestation

Plugins run as trusted, unsandboxed Luau in the user's session. Confirm:

• The code is readable and not obfuscated, minified, or generated.
• It does not download and execute remote code.
• Every network call, filesystem write, and spawned process is something the description above accounts for.
• I have the right to publish this code under the license declared in plugin.toml.