Nightingale Karaoke
Install, build, or configure the Nightingale Rust/Bevy karaoke app with Demucs, WhisperX, stem separation, profiles, and troubleshooting.
Overview
Nightingale Karaoke is an agent skill for the Build phase that helps you install, configure, and troubleshoot the Nightingale Rust karaoke app with Demucs, WhisperX, and automated ML bootstrap.
Install
npx skills add https://github.com/aradotso/trending-skills --skill nightingale-karaokeWhat is this skill?
- Self-contained ML karaoke stack: UVR Karaoke or Demucs stem separation, WhisperX word-level lyrics, pitch scoring, profi
- First-launch bootstrap bundles ffmpeg, Python, PyTorch, and models automatically
- Pre-built release binaries plus Rust 1.85+ (edition 2024) source build path with Linux dev library list
- macOS quarantine fix documented: xattr -cr Nightingale.app
- Trigger phrases cover build, library setup, profile config, and troubleshooting
- Rust 1.85+ (edition 2024) required for source builds
- First-launch auto-bootstrap for ffmpeg, Python, PyTorch, and ML models
Adoption & trust: 1.2k installs on skills.sh; 31 GitHub stars; 2/3 security scanners passed (skills.sh audits).
What problem does it solve?
You want offline karaoke with separated stems and scored vocals but wiring Bevy, Demucs, WhisperX, and ffmpeg by hand is fragile and platform-specific.
Who is it for?
Solo builders and hobbyists comfortable with Rust tooling who want a self-hosted karaoke rig from local audio files.
Skip if: Teams needing a hosted SaaS karaoke API, mobile-only wrappers without desktop builds, or environments that cannot download large ML models and Python runtimes.
When should I use this skill?
When user mentions nightingale karaoke, Rust Bevy karaoke, Demucs/Whisper stem pipelines, ML karaoke from audio files, profiles, or troubleshooting Nightingale setup.
What do I get? / Deliverables
You run Nightingale with a scanned music library, working stem separation and lyrics sync, plus guidance for profiles, scoring, and common setup failures on your OS.
- Running Nightingale binary or built from-source app
- Configured music library with separation and lyrics pipeline
- Platform-specific setup notes (e.g. macOS quarantine removal)
Recommended Skills
Journey fit
Nightingale is a product you assemble, bootstrap, and wire to local ML pipelines—core Build work with heavy toolchain integration. Skill centers on ffmpeg, Python/PyTorch, model download, and audio ML hooks—integration of external runtimes into the Bevy application.
How it compares
Project-specific Nightingale operator skill—not a generic Bevy game-dev or Spotify integration skill.
Common Questions / FAQ
Who is nightingale-karaoke for?
Developers and power users building a local karaoke setup with Rust Nightingale, especially when you need Demucs/WhisperX pipeline help and first-launch bootstrap steps.
When should I use nightingale-karaoke?
During Build integrations when downloading releases, compiling from source, configuring karaoke profiles, or fixing Nightingale setup on macOS or Linux.
Is nightingale-karaoke safe to install?
The app auto-downloads heavyweight ML dependencies; review the Security Audits panel on this page and only run binaries from trusted release sources you verify.
SKILL.md
READMESKILL.md - Nightingale Karaoke
# Nightingale Karaoke Skill > Skill by [ara.so](https://ara.so) — Daily 2026 Skills collection. Nightingale is a self-contained, ML-powered karaoke application written in Rust (Bevy engine). It scans a local music folder, separates vocals from instrumentals (UVR Karaoke model or Demucs), transcribes lyrics with word-level timestamps (WhisperX), and plays back with synchronized highlighting, real-time pitch scoring, player profiles, and GPU shader / video backgrounds. Everything — ffmpeg, Python, PyTorch, ML models — is bootstrapped automatically on first launch. --- ## Installation ### Pre-built Binary (Recommended) Download the latest release from the [Releases page](https://github.com/rzru/nightingale/releases) for your platform and run it. **macOS only** — remove quarantine after extracting: ```bash xattr -cr Nightingale.app ``` ### Build from Source **Prerequisites:** - Rust 1.85+ (edition 2024) - Linux additionally needs: `libasound2-dev libudev-dev libwayland-dev libxkbcommon-dev` ```bash git clone https://github.com/rzru/nightingale cd nightingale # Development build cargo build --release # Run directly ./target/release/nightingale ``` ### Release Packaging ```bash # Linux / macOS scripts/make-release.sh # Windows (PowerShell) powershell -ExecutionPolicy Bypass -File scripts/make-release.ps1 ``` Outputs a `.tar.gz` (Linux/macOS) or `.zip` (Windows) ready for distribution. --- ## First Launch / Bootstrap On first run, Nightingale downloads and configures: - `ffmpeg` binary - `uv` (Python package manager) - Python 3.10 via uv - PyTorch + WhisperX + audio-separator in a virtual environment - UVR Karaoke ONNX model and WhisperX `large-v3` model This takes **2–10 minutes** depending on network speed. A progress screen is shown in-app. To force re-bootstrap at any time: ```bash ./nightingale --setup ``` Bootstrap completion is marked by `~/.nightingale/vendor/.ready`. --- ## CLI Flags | Flag | Description | |---|---| | `--setup` | Force re-run of the first-launch bootstrap (re-downloads vendor deps) | --- ## Keyboard & Gamepad Controls ### Navigation | Action | Keyboard | Gamepad | |---|---|---| | Move | Arrow keys | D-pad / Left stick | | Confirm | Enter | A (South) | | Back | Escape | B (East) / Start | | Switch panel | Tab | — | | Search | Type to filter | — | ### Playback | Action | Keyboard | Gamepad | |---|---|---| | Pause / Resume | Space | Start | | Exit to menu | Escape | B (East) | | Toggle guide vocals | G | — | | Guide volume up/down | + / - | — | | Cycle background | T | — | | Cycle video flavor | F | — | | Toggle microphone | M | — | | Next microphone | N | — | | Toggle fullscreen | F11 | — | --- ## Configuration ### Main Config Located at `~/.nightingale/config.json`. Edit directly or via in-app settings. ```json { "music_folder": "/home/user/Music", "separator": "uvr", "guide_vocal_volume": 0.3, "background_theme": "plasma", "video_flavor": "nature", "default_profile": "Alice" } ``` **`separator` options:** `"uvr"` (default, preserves backing vocals) | `"demucs"` **`background_theme` options:** `"plasma"`, `"aurora"`, `"waves"`, `"nebula"`, `"starfield"`, `"video"`, `"source_video"` **`video_flavor` options:** `"nature"`, `"underwater"`, `"space"`, `"city"`, `"countryside"` ### Profiles Located at `~/.nightingale/profiles.json`: ```json { "profiles": [ { "name": "Alice", "scores": { "blake3_hash_of_song": { "stars": 4, "score": 87250,