Luigit
repositories / dotfiles

dotfiles

bugabingas dorkfiles

owned by admin

quickshell/nuguland/.system/specs/NL-SPEC-5F4166AF-audio-popup/index.md

Raw
Rendered preview

id: NL-SPEC-5F4166AF type: spec title: Audio popup

Audio popup

Behavior

  • The popup presents lowercase output and input sections backed by current PipeWire devices.
  • Each device row shows a speaker or microphone state glyph, device name, volume slider, and percentage from 0% through 150%.
  • Muted rows show a muted glyph and reduced emphasis.
  • Default devices use selected card border and fill without an exposed accent sliver.
  • Clicking or dragging a slider changes volume; middle click toggles mute.
  • Selecting a device name makes it the default output or input.
  • Empty sections remain valid.
  • The bar chip keeps its audio label; microphone and camera activity shows as its activity mark, a mic or camera icon on the vertical bar, and microphone in use or camera in use in its tooltip and accessible name (owner decision 2026-11-14).

Constraints

  • PipeWire remains the authoritative audio boundary.
  • Volume is clamped to 0 through 1.5.
  • Missing names use a stable fallback; missing default devices produce no selected row.
  • Public IPC follows NL-SPEC-86A037A0; audio panel intents stay on the typed service.
  • State retains consumed sinks, sources, streams, default IDs, privacy, and action results.
  • State excludes backend narration and unused shader descriptions.
  • Existing stream routing remains available, but no new routing UI is required.

Acceptance

  • Pure tests cover volume boundaries, percentages, name precedence, mute and role state, privacy combinations, row shaping, glyphs, and ID lookup.
  • Pure audio tests and the isolated audio interaction suite pass.
  • Live checks confirm privacy, volume routes, sliders, mute, and default selection.
  • The popup uses shared controls and contains no audio card accent sliver.
---
id: NL-SPEC-5F4166AF
type: spec
title: Audio popup
---

# Audio popup

## Behavior

- The popup presents lowercase `output` and `input` sections backed by current PipeWire devices.
- Each device row shows a speaker or microphone state glyph, device name, volume slider, and percentage from 0% through 150%.
- Muted rows show a muted glyph and reduced emphasis.
- Default devices use selected card border and fill without an exposed accent sliver.
- Clicking or dragging a slider changes volume; middle click toggles mute.
- Selecting a device name makes it the default output or input.
- Empty sections remain valid.
- The bar chip keeps its `audio` label; microphone and camera activity shows as its activity mark, a mic or camera icon on the vertical bar, and `microphone in use` or `camera in use` in its tooltip and accessible name (owner decision 2026-11-14).

## Constraints

- PipeWire remains the authoritative audio boundary.
- Volume is clamped to 0 through 1.5.
- Missing names use a stable fallback; missing default devices produce no selected row.
- Public IPC follows `NL-SPEC-86A037A0`; audio panel intents stay on the typed service.
- State retains consumed sinks, sources, streams, default IDs, privacy, and action results.
- State excludes backend narration and unused shader descriptions.
- Existing stream routing remains available, but no new routing UI is required.

## Acceptance

- Pure tests cover volume boundaries, percentages, name precedence, mute and role state, privacy combinations, row shaping, glyphs, and ID lookup.
- Pure audio tests and the isolated audio interaction suite pass.
- Live checks confirm privacy, volume routes, sliders, mute, and default selection.
- The popup uses shared controls and contains no audio card accent sliver.