# vizzzz The most featureful termiminal audio visualizer I'm aware of. `vizzzz` is a responsive terminal spectrum visualizer written in Rust with ratatui. On macOS and Windows, the default source is the main system output through ScreenCaptureKit or WASAPI loopback. On other platforms, and with `--source input`, it captures a microphone, audio interface, monitor source, or virtual loopback device through CPAL. ## Run ```sh cargo run --release ``` The native GPU frontend opens by default. To draw in the terminal instead: ```sh cargo run --release -- --frontend terminal ``` The window frontend uses Metal on macOS and Vulkan or OpenGL under Wayland on Linux. It is a native `winit` + `wgpu` application and does not embed a browser. The first macOS system-output launch may ask for Screen & System Audio Recording access. Grant access to the terminal under **System Settings > Privacy & Security > Screen & System Audio Recording**, restart the terminal, and launch again. ### Install with Nix Linux is distributed through the flake: ```sh nix run . nix profile install .#vizzzz ``` The installed package also provides a desktop entry that starts the native GPU frontend. ### Release artifacts Tangled CI runs formatting, lint, tests, and a release build for pushes and pull requests to `master`. Pushing an annotated `v*` tag builds and publishes an x86-64 Windows executable using `cargo-xwin`: ```sh git tag -a v0.1.0 -m "vizzzz 0.1.0" git push origin v0.1.0 ``` Artifact publishing requires an AT Protocol app password for the repository owner, stored as the `ATP_APP_PASSWORD` repository secret. Tangled's current Nixery and microVM engines are Linux-only, while this project's macOS capture backend requires Xcode, Swift, and Apple's SDK. A macOS host can produce the corresponding ad-hoc-signed `.app.zip` with: ```sh scripts/package-macos-app.sh ``` See `BUILDING.md` for complete bundle, signing, and notarization instructions. Notarized public macOS releases additionally require an Apple Developer signing identi…