From 80307a86d069b918a9218d6813d74dab7c255606 Mon Sep 17 00:00:00 2001
From: Thales <>
Date: Mon, 5 Oct 2026 09:55:50 +0100
Subject: [PATCH 1/6] docs(readme): a README that matches 0.20, with the
developer material in docs/
The README's features and comparison described StemDeck as it was in May,
and parts were wrong: no pitch shift, lyrics or click track, one job at a
time, nothing on a phone, extract the Windows zip anywhere.
- Download comes first: the same one-file-per-setup table as the release
notes, Linux and Docker/Unraid included, and install notes per platform
that match the release (the quarantine flag on macOS, a writable folder
for the Windows portable build).
- What you can do, grouped as a musician uses it: split, practise, know
the song, keep and share, Guide, and the phone, with new screenshots
from the current UI. Every line was checked against the code.
- The Honest Comparison is corrected and keeps its honest tone.
- Build from source, configuration, the HTTP API, troubleshooting and the
disk layout move to docs/, word for word, except the disk layout, which
described the job list as in-memory and swept after 24 hours.
522 lines become 310. No em dashes.
Closes #767
---
README.md | 544 +++++++++++------------------------
docs/api.md | 19 ++
docs/build-from-source.md | 141 +++++++++
docs/configuration.md | 94 ++++++
docs/troubleshooting.md | 40 +++
imgs/screenshot/guide.png | Bin 0 -> 73035 bytes
imgs/screenshot/phone.png | Bin 0 -> 100221 bytes
imgs/screenshot/practice.png | Bin 0 -> 22718 bytes
imgs/screenshot/stemdeck.png | Bin 1913608 -> 141396 bytes
9 files changed, 460 insertions(+), 378 deletions(-)
create mode 100644 docs/api.md
create mode 100644 docs/build-from-source.md
create mode 100644 docs/configuration.md
create mode 100644 docs/troubleshooting.md
create mode 100644 imgs/screenshot/guide.png
create mode 100644 imgs/screenshot/phone.png
create mode 100644 imgs/screenshot/practice.png
diff --git a/README.md b/README.md
index f69f0ccc..2dc06248 100644
--- a/README.md
+++ b/README.md
@@ -2,7 +2,6 @@
-**Free, local stem separation. No account. No upload. No subscription.**
@@ -28,443 +27,246 @@
-Drop in an MP3, WAV, FLAC, OGG/Opus, MP4, or M4A file, or paste a YouTube URL, and StemDeck splits the audio into up to six stems (vocals, drums, bass, guitar, piano, other). Play them back in a DAW-style multitrack mixer: mute, solo, balance levels, zoom the waveform, loop a region, and export individual stems or a custom mix. Everything runs locally on your own machine.
+
+ Drop in a song. Get every instrument on its own track. Practise with them.
+ Runs on your own computer: no account, no upload, no subscription.
+
-> **What is this?** StemDeck is a stem separation tool, not a downloader. Its main job is processing audio you already own: drag an MP3, WAV, FLAC, OGG, or M4A onto the import bar and go. YouTube support is a convenience for content you have the right to process. StemDeck does not store, cache, or redistribute any downloaded content. Everything happens locally and nothing leaves your machine.
+
-> StemDeck is a free, open alternative to cloud stem-splitters like Moises and LALAL.AI: no account, no quota, no uploads, no subscription. If you want stems for personal study and prefer to keep things local and free, StemDeck has you covered. If you need the polish, a mobile app, or deeper musician tooling, the commercial products are a better fit.
+
+
+
-
+StemDeck splits a song into up to six stems, vocals, drums, bass, guitar, piano and other, and opens them in a studio where you can mute, solo, slow down, loop, change the key and play along with a click. Drop in an audio file or paste a YouTube or SoundCloud link. Everything runs on your machine; nothing is uploaded.
-
-## Star History
-
-
-
-
-
-
-
-
-
-## We Recommend
-
-StemDeck is free and **does not accept any money, sponsorship, or funding** from anyone listed below. I share these makers and artists and communities purely for the joy of pointing you toward wonderful people doing beautiful work. Go meet them ❤️
-
-| Category | Name | What they do | Link |
-|---|---|---|---|
-| Artists & Creators | Adrianna Claro | Soul and Contemporary R&B Singer, Songwriter and Composer | [Spotify](https://open.spotify.com/album/10fZ48iJhIe3lWcXSMUlFG) · [Apple Music](https://music.apple.com/us/album/happy/1592026727?i=1592026728) |
-| Artists & Creators | Analog4Lyfe | Analog gear specialist | [@analog4lyfe](https://www.instagram.com/analog4lyfe) |
-| Artists & Creators | Dead röses | Cork-based punk rock band | [@dead_rosesband](https://www.instagram.com/dead_rosesband) |
-| Artists & Creators | Joao Gaspar | Producer, film scorer, touring/session musician | [@jay_glaspar](https://www.instagram.com/jay_glaspar) |
-| Artists & Creators | Killah Trakz | Industry Secret Villain and Media Influencer | [@killahtrakz](https://www.instagram.com/killahtrakz/) · [Spotify](https://open.spotify.com/artist/6nePYOqT4E7D4C48twPtKk) · [Apple Music](https://music.apple.com/us/artist/killah-trakz/371296633) |
-| Artists & Creators | More Notes Less Talk | Gear-focused creative project with a raw, tape-recorded identity | [@morenoteslesstalk](https://www.youtube.com/@morenoteslesstalk) |
-| Artists & Creators | NIHIL | Modern alternative metal from Argentina. Fueled by emotionally charged vocals, anger and emptiness | [@somosnihil](https://www.instagram.com/somosnihil/) · [Spotify](https://open.spotify.com/artist/1OeKplJxFNM6JHrWeo2SaV) |
-| Instrument Builders & Repair | Dlima Guitars | Custom guitars and basses | [@dlimaguitars](https://www.instagram.com/dlimaguitars) |
-| Instrument Builders & Repair | Kris Luthier | Instrument repair and restoration | [@krisluthier](https://www.instagram.com/krisluthier) |
-| Instrument Builders & Repair | Lisbon Guitar Works | Handmade guitars in Lisbon | [dlimaguitars.com](https://dlimaguitars.com) |
-| Media & Community | Not Another Audio Podcast | Audio, music and tech industry podcast by working professionals | [Libsyn](https://directory.libsyn.com/shows/view/id/20f5a1e3-6fea-4d41-8cdf-451ce6fc6cda) |
-| Media & Community | r/bass | Bass-player community | [r/Bass](https://www.reddit.com/r/Bass) |
-| Media & Community | slashCAM | Camera, video, and post-production media | [@slashcam.de](https://www.instagram.com/slashcam.de) |
-| Music & Karaoke Technology | Beltr | Local, subscription-free karaoke software | [beltr.app](https://beltr.app/) |
-| Music & Karaoke Technology | Seratone | TV-based karaoke system | [seratone.audio](https://seratone.audio/) |
-| Music Gear | Empress Effects | Boutique effects pedals | [empresseffects.com](https://empresseffects.com) |
-| Music Gear | Thomann | Large music-equipment retailer | [@thomann.music](https://www.instagram.com/thomann.music) |
-| Writers & Storytellers | Alexandre Borges | Portuguese writer, screenwriter, and cultural commentator | [Books & author profile](https://www.instagram.com/alexgram_b/) |
-
-
----
-
-## Features
-
-**6-stem separation** via Demucs `htdemucs_6s`, with auto-detection of the best Torch device (CUDA on NVIDIA, MPS on Apple Silicon, CPU fallback).
-
-**YouTube and local file import.** Paste a YouTube URL or drop an MP3, WAV, FLAC, OGG/Opus, MP4, or M4A directly onto the import bar.
-
-**DAW-style waveform editor** with min/max sample rendering across all stems, shared normalization, zoom in/out/Fit, loop drag on the ruler, gold playhead overlay, and stem-aligned lanes.
-
-**Stem subset extraction.** Click stem chips to choose which stems to keep. Clicking from "all selected" snaps to "only this one"; subsequent clicks add or remove.
-
-**"Original" backing track.** When you pick a subset, a 7th lane contains the complement (full song minus selected stems), perfect for A/B reference without doubling.
-
-**Downloadable selected mix.** A single `mix.wav` of just your selected stems, summed via ffmpeg amix.
-
-**Per-stem mixer** with volume fader, mute, solo, and "monitor" (solo-only) per stem. State syncs between the preview mixer and the stems sidebar.
-
-**Live VU meters** per stem. Post-gain RMS via Web Audio analysers with peak hold and slow falloff.
-
-**Song analysis** including BPM (librosa beat tracker), key, scale, and confidence (Albrecht-Shanahan profiles), integrated LUFS (BS.1770), and sample peak in dBFS.
-
-**Cancellable jobs.** Cancel mid-pipeline and the runner terminates the active subprocess immediately, deletes the partial job dir, and returns to ready.
-
-**Library panel** with folder-based track organisation, drag-and-drop, search, and trash.
-
----
-
-## Honest Comparison
-
-StemDeck is not trying to compete with commercial stem-separation products. It covers the core use case well and stops there. This table exists so you can make an informed choice rather than discover the gaps after the fact.
-
-| | StemDeck | Moises / LALAL.AI / similar |
-|---|---|---|
-| **Price** | Free, forever | Freemium; credits or subscription required for regular use |
-| **Hosting** | Runs entirely on your machine | Cloud; audio must be uploaded to their servers |
-| **Account / login** | None | Required |
-| **Internet required** | Only for YouTube download and first model fetch (~170 MB, cached after) | Always; no offline use |
-| **Privacy** | Audio never leaves your machine | Audio is uploaded and processed on third-party servers |
-| **Data retention** | You control it; delete anytime | Governed by their privacy policy and retention period |
-| **Stem model** | Demucs `htdemucs_6s` (open source, Meta AI) | Proprietary models, regularly updated, generally higher quality |
-| **Stem count** | 6 (vocals, drums, bass, guitar, piano, other) | Up to 10 depending on service and plan |
-| **Input formats** | YouTube URL, MP3, WAV, FLAC, OGG/Opus, MP4, M4A | MP3, WAV, FLAC, M4A, and more depending on service |
-| **Processing speed** | Depends on your hardware; fast with a GPU, slow on CPU only | Fast regardless of your hardware (runs on their servers) |
-| **Batch processing** | One job at a time | Yes, on paid plans |
-| **Mobile app** | No | iOS and Android |
-| **Extra features** | No (no pitch shift, chord detection, lyrics, click track, BPM tap) | Yes, varies by product |
-| **Polish** | Functional, hobby-grade UI | Polished, production-grade apps |
-| **Source code** | Open source, forkable, self-hostable | Closed source |
-
-If you need speed, quality, mobile access, or the extra musician tooling, the commercial products are worth the money. If you want stems for personal study, prefer to keep audio private, or just want something that runs locally with no strings attached, StemDeck is enough.
+> **A separation tool, not a downloader.** StemDeck is for processing audio you have the right to use. Link support is a convenience; StemDeck does not store, cache or redistribute downloaded content. See the [Disclaimer](#disclaimer).
---
## Download
-Pre-built installers and zips are attached to each [GitHub Release](https://github.com/stemdeckapp/stemdeck/releases).
-
-**macOS**
-
-| DMG | GPU | Chip |
-|---|---|---|
-| `StemDeck-macOS-arm64.dmg` | Apple Silicon (MPS) | M1 and later |
-| `StemDeck-macOS-x64.dmg` | CPU only | Intel |
+Every release has a [download page](https://github.com/stemdeckapp/stemdeck/releases/latest) with one file per setup. Pick **one**.
-Open the DMG, drag StemDeck to Applications, and launch it. On first launch the setup screen downloads the Python runtime (~500 MB), FFmpeg, and the Demucs model (~170 MB). Subsequent launches skip setup and start in seconds. No Python or system dependencies required.
-
-macOS may show a Gatekeeper prompt on first open — right-click the app and choose Open to bypass it.
-
-**Windows**
-
-| Zip | GPU | Approx. size |
-|---|---|---|
-| `StemDeck-Windows-x64.zip` | CPU only | ~700 MB |
-| `StemDeck-Windows-x64.NVIDIA.zip` | NVIDIA CUDA | ~1.6 GB |
-
-Extract the zip anywhere, run `StemDeck.exe`. FFmpeg, the Demucs model, config, and logs live in a `data/` folder next to `StemDeck.exe`, not in AppData; move or copy the whole extracted folder anywhere and it keeps working. On first launch the app verifies the bundled Python runtime and downloads FFmpeg and the Demucs model (~170 MB) into that folder. Subsequent launches skip this and start in seconds. Everything is self-contained; no Python or system dependencies required. Your job/library data stays in its usual location (`~/Documents/StemDeck` by default) and is relocatable anytime from Settings → StemData location.
-
----
+| Your setup | Download |
+|---|---|
+| **Windows**, NVIDIA GPU | `StemDeck-Windows-x64.NVIDIA.zip` |
+| **Windows**, no NVIDIA GPU | `StemDeck-Windows-x64.zip` |
+| **Linux**, NVIDIA GPU | `StemDeck-Linux-x64.NVIDIA.tar.gz` |
+| **Linux**, no NVIDIA GPU | `StemDeck-Linux-x64.tar.gz` |
+| **macOS**, Apple Silicon (M1 and later) | `StemDeck-macOS-arm64.dmg` |
+| **macOS**, Intel | `StemDeck-macOS-x64.dmg` |
+| **Docker / Unraid** | `ghcr.io/stemdeckapp/stemdeck` (Unraid: search "StemDeck" in Apps) |
-## Technologies
-
-
-
-
-
-
+
+Installing, per platform
-StemDeck is built on **[Python 3.12](https://python.org)** managed via **[uv](https://github.com/astral-sh/uv)**, with a **[FastAPI](https://fastapi.tiangolo.com)** backend serving REST and Server-Sent Events. Stem separation uses **[Demucs](https://github.com/facebookresearch/demucs)** (`htdemucs_6s`), Meta AI's open-source 6-stem neural network. The optional on-demand lead/backing vocal split runs the UVR-MDX-NET Karaoke 2 model via **[audio-separator](https://github.com/nomadkaraoke/python-audio-separator)**, trained as part of the **[Ultimate Vocal Remover](https://github.com/Anjok07/ultimatevocalremovergui)** project by Anjok07. YouTube audio is fetched via **[yt-dlp](https://github.com/yt-dlp/yt-dlp)**; transcoding and mixing use **[FFmpeg](https://ffmpeg.org)**. BPM detection and key analysis run on **[librosa](https://librosa.org)**; loudness measurement uses **[pyloudnorm](https://github.com/csteinmetz1/pyloudnorm)** (ITU-R BS.1770). The macOS and Windows desktop shells are **[Tauri v2](https://tauri.app)** (Rust/WKWebView on macOS, Rust/WebView2 on Windows). The frontend is vanilla JS with the Web Audio API, no framework and no build step; waveforms are rendered on `
---
-### Web Server (macOS / Linux / Windows with Python 3.12+)
+## What you can do
-#### Prerequisites
-
-Python 3.12 or newer, `ffmpeg` on your PATH, and [uv](https://github.com/astral-sh/uv). Around 170 MB of free disk for the Demucs model, which downloads automatically on first run.
-
-Optional, for song identification with an AcoustID key: an FFmpeg built with chromaprint (Debian and Ubuntu's `ffmpeg` is), or Chromaprint's `fpcalc` on your PATH (`brew install chromaprint`, `apt install libchromaprint-tools`, or your distro's `chromaprint` package). `./run.sh setup` installs it when your FFmpeg needs it. Without either, songs are identified by their tags only.
-
-#### macOS / Linux (one-shot)
-
-```sh
-git clone https://github.com/stemdeckapp/stemdeck stemdeck && cd stemdeck
-./run.sh setup # installs ffmpeg + uv, runs uv sync
-./run.sh start
-```
+
+
+
-Open .
+### Split any song
-`setup` uses Homebrew on macOS and `apt-get` on Debian/Ubuntu. For other Linux distros, install `ffmpeg` and [uv](https://github.com/astral-sh/uv) manually, then run `uv sync` followed by `./run.sh start`.
+- **Up to six stems** with Meta's open Demucs model: vocals, drums, bass, guitar, piano and other.
+- **Lead and backing vocals** as separate lanes, on demand.
+- **Files or links:** MP3, WAV, FLAC, OGG, Opus, M4A and MP4, or a YouTube or SoundCloud link.
+- **Pick only what you need** before you extract.
+- **Whole playlists** go into an import queue and run one after another.
-#### Windows (PowerShell)
+
+
-Install prerequisites:
-- [uv](https://docs.astral.sh/uv/getting-started/installation/) — `winget install astral-sh.uv`
-- [ffmpeg](https://ffmpeg.org/download.html) — `winget install Gyan.FFmpeg` (or Chocolatey: `choco install ffmpeg`)
+### Practise with it
-```powershell
-git clone https://github.com/stemdeckapp/stemdeck stemdeck; cd stemdeck
-uv sync
-uv run uvicorn app.main:app --host 127.0.0.1 --port 8000 --timeout-graceful-shutdown 5
-```
+- **Mute or solo** any part, and set each one's volume.
+- **Slow it down** to half speed, or anywhere from 0.50x to 0.99x, without changing the pitch.
+- **Loop the hard part**, by dragging across the waveform.
+- **Change the key**, of the whole song or of one part.
+- **Play with a click** that follows the song, with a count-in.
-Open .
+
+
+
+
+
+
+
-> `run.sh` is macOS/Linux only. On Windows use the PowerShell commands above, or run inside WSL.
+### Know the song
-**NVIDIA GPU (CUDA):** install the CUDA-enabled torch build before starting:
+- **Key, tempo, loudness and structure,** found for you.
+- **Synced lyrics** from LRCLIB, or written down from the vocals when none are found.
+- **Song and artist details** from MusicBrainz, Wikipedia and, optionally, Discogs.
-```powershell
-uv pip install torch torchvision torchaudio --index-url https://download.pytorch.org/whl/cu124
-$env:STEMDECK_DEMUCS_DEVICE = "cuda"
-uv run uvicorn app.main:app --host 127.0.0.1 --port 8000 --timeout-graceful-shutdown 5
-```
+
+
----
+### Keep and share
-#### Manual (any platform)
+- **Export** what you hear as one file, every part as a `.zip`, only the looped part, or a video with the original picture.
+- **Drag a stem or a loop** straight into your other music software.
+- **A library** with folders, tags, favourites and a Trash that only deletes when you empty it.
-```sh
-git clone https://github.com/stemdeckapp/stemdeck stemdeck && cd stemdeck
-uv sync
-uv run uvicorn app.main:app --reload --timeout-graceful-shutdown 5
-```
+
+
+
-> `--timeout-graceful-shutdown` bounds how long uvicorn waits for open
-> connections when you stop it. StemDeck keeps a long-lived SSE stream open
-> for the import queue while a browser tab is on the app, so without it
-> Ctrl-C waits for that stream instead of exiting.
+### It explains itself
-#### Docker
+
+
+
+
-```sh
-docker compose -f build/docker-compose.yml up --build
-```
+Click **Guide** in the left rail and point at anything. Every button, lane control and number on the screen says what it does, in plain words. While Guide is on, clicks explain instead of acting, so nothing happens by accident.
-Stems land in `./jobs/` on the host. Demucs weights are cached in a named volume so they don't re-download on rebuild. Note: no GPU passthrough on macOS Docker.
+
+
+
-A prebuilt image is published to GHCR. Tags: `edge` (rolling, rebuilt on every merge to main), `latest` (newest stable release), and `X.Y.Z` (pinned to a release).
+### On your phone too
-```sh
-docker run -d --name stemdeck -p 8000:8000 \
- -v /path/to/jobs:/app/jobs \
- -v /path/to/cache:/cache \
- -e STEMDECK_PERSIST_LIBRARY=1 \
- ghcr.io/stemdeckapp/stemdeck:edge
-```
+
+
+
+
-On a Linux host with an NVIDIA GPU (driver + NVIDIA Container Toolkit installed), add `--runtime=nvidia -e NVIDIA_VISIBLE_DEVICES=all` and StemDeck auto-detects CUDA. The image already bundles CUDA-enabled torch, so no separate CUDA install is needed.
+Turn on **Make StemDeck available on your network** in Settings and scan the QR code. Your phone opens your library and mixer over your own Wi-Fi, with speed and key controls. No app store, no cloud.
-#### Unraid
+**Desktop app for Windows, Linux and macOS, a Docker image and an Unraid template, and 11 languages:** English, Deutsch, Español, Français, Bahasa Indonesia, 日本語, 한국어, Polski, Português (Brasil), Português (Portugal) and 简体中文.
-StemDeck is available in Unraid Community Applications: open **Apps**, search "StemDeck", and install. Map the two volumes to persistent appdata paths:
+
+
+
-- `/app/jobs` -> `/mnt/user/appdata/stemdeck/jobs` (library + stems)
-- `/cache` -> `/mnt/user/appdata/stemdeck/cache` (model weights)
+
+Keyboard shortcuts
-The library is persistent by default (`STEMDECK_PERSIST_LIBRARY=1`), so tracks are never auto-deleted. For GPU acceleration, install the **Nvidia Driver** plugin, then set the container's Extra Parameters to `--runtime=nvidia` (the `NVIDIA_VISIBLE_DEVICES` and `NVIDIA_DRIVER_CAPABILITIES` variables are already in the template). CPU-only works with no extra configuration.
+
-#### `run.sh` control script
+| Key | Does |
+|---|---|
+| `Space` | Play or pause |
+| `[` and `]` | Jump back or forward 5 seconds |
+| `L` | Loop on or off |
+| `I` and `O` | Set the loop start or end at the playhead, while looping |
+| `K` | Click track on or off |
-```sh
-./run.sh setup # one-shot: install ffmpeg + uv, then uv sync
-./run.sh start # boots uvicorn in the background
-./run.sh stop # graceful shutdown
-./run.sh restart # stop + start
-./run.sh status # is it running?
-```
+
---
-## How to Use
+## Honest comparison
-1. On the import bar, click stem chips to choose which stems to extract (defaults to all 6).
-2. Paste a YouTube URL **or** drop an audio file (MP3, WAV, FLAC, OGG, MP4, M4A), then click **Process**.
-3. Wait through `Uploading...` / `Downloading...` → `Analyzing...` → `Separating...` → `Mixing tracks...`.
-4. When done, the studio dashboard appears. If you picked a subset, the first lane is **Original** (full song minus your selection); the rest are your isolated stems.
-5. Mix: **Play/Pause/Stop** controls the master transport. **M** mutes a stem, **S** solos it (additive; multiple solos stay audible), **Monitor** solos only that stem and clears others. The volume fader moves 1:1 with drag; double-click resets to 0 dB; `Shift+wheel` gives coarse adjustment and plain wheel gives fine. The **Reset**, **Mute**, and **Solo** toolbar buttons act on all stems at once.
-6. Drag on the ruler to define a loop region; click `Loop` to enable. Use `+` / `-` / `Fit` or `Ctrl/Cmd+wheel` to zoom.
-7. **Download Mix** in the footer gives you a WAV of your selected stems summed together.
+StemDeck is not trying to beat the commercial stem-separation services. It covers the core well and stops there. This table is here so you can choose knowingly rather than find the gaps later.
-**Keyboard shortcuts:** `Space` play/pause · `[` seek -5s · `]` seek +5s · `L` loop · `I` loop in · `O` loop out
+| | StemDeck | Moises, LALAL.AI and similar |
+|---|---|---|
+| **Price** | Free, for good | Freemium; credits or a subscription for regular use |
+| **Where it runs** | On your own machine | In the cloud; your audio is uploaded |
+| **Account** | None | Required |
+| **Internet** | Only for links and the first model download | Always |
+| **Privacy** | Your audio never leaves your machine | Processed on their servers, under their retention policy |
+| **Separation model** | Demucs `htdemucs_6s`, open source from Meta | Proprietary, updated often, generally higher quality |
+| **Stems** | 6, plus lead and backing vocals | Up to 10, depending on the service and plan |
+| **Speed** | Depends on your hardware: fast on a GPU, slow on a CPU | Fast on any hardware |
+| **Many songs at once** | An import queue and whole playlists, run one after another | Yes, on paid plans |
+| **Phone** | Your phone opens StemDeck over your own Wi-Fi; no app store app | iOS and Android apps |
+| **Practice tools** | Speed, key change, loops, click track with count-in, synced lyrics; no chord detection | Varies by product; often chords and more |
+| **Polish** | A one-person open-source project | Polished, production-grade apps |
+| **Source code** | Open source, forkable, self-hostable | Closed |
+
+If you need the best quality, speed on any machine, or a store-bought phone app, the commercial products are worth the money. If you want stems for practice and study, keep your audio private, and like software with no strings attached, StemDeck is enough.
---
-## Configuration
+## We Recommend
-| Variable | Default | Purpose |
-|---|---|---|
-| `STEMDECK_DEMUCS_DEVICE` | auto | Force Torch device: `cuda`, `mps`, or `cpu`. |
-| `STEMDECK_DEMUCS_MODEL` | `htdemucs_6s` | Demucs model name. |
-| `STEMDECK_JOBS_DIR` | `./jobs` | Where job directories land. |
-| `STEMDECK_DATA_DIR` | (none) | Portable mode root; sets all sub-dirs below to live inside it. |
-| `STEMDECK_CACHE_DIR` | `/cache` | Torch model cache directory. |
-| `STEMDECK_DOWNLOADS_DIR` | `/downloads` | yt-dlp download scratch space. |
-| `STEMDECK_MODELS_DIR` | `/models` | Demucs model weights directory. |
-| `STEMDECK_LOGS_DIR` | `/logs` | Log file output directory. |
-| `STEMDECK_FFMPEG_DIR` | (none) | Directory containing a bundled ffmpeg binary. |
-| `STEMDECK_FFMPEG` | `ffmpeg` | Path to the ffmpeg executable. |
-| `STEMDECK_FFPROBE` | `ffprobe` | Path to the ffprobe executable. |
-| `STEMDECK_FPCALC` | `fpcalc` | Path to Chromaprint's fpcalc, used for song fingerprinting when FFmpeg has no chromaprint muxer. |
-| `STEMDECK_MAX_DURATION_SEC` | `1200` | Reject audio longer than this (seconds). |
-| `STEMDECK_JOB_TTL_SECONDS` | `86400` | How long to keep job dirs on disk. |
-| `STEMDECK_MAX_PENDING_JOBS` | `3` | Max queued jobs before returning 503. |
-| `STEMDECK_TIMEOUT_FFMPEG` | `300` | ffmpeg subprocess timeout (seconds). |
-| `STEMDECK_TIMEOUT_ANALYZE` | `120` | Audio analysis timeout (seconds). |
-| `STEMDECK_TIMEOUT_DEMUCS_STALL` | `1800` | Kill Demucs if no output for this many seconds. |
-| `STEMDECK_SSL_CERT` | (none) | PEM certificate; set with the key below to serve https directly. |
-| `STEMDECK_SSL_KEY` | (none) | PEM private key for the certificate above. |
-| `STEMDECK_HTTPS_PORT` | (none) | Serve https on this port *in addition* to the main listener. Set by the desktop app; see below. |
-
-`run.sh` also reads: `HOST` (default `127.0.0.1`), `PORT` (default `8765`), `RELOAD=1` (enable uvicorn auto-reload for development), `FOREGROUND=1` (run in foreground instead of backgrounding).
-
-### Serving other devices: why https is not optional
-
-Transpose is built on `AudioWorklet`, and browsers grant that only to a
-**secure context**. `https://` and `localhost` qualify. A plain
-`http://192.168.1.20:8000` does not, so a phone reaching StemDeck over plain
-http gets working playback and a key control that cannot do anything. There is
-no fallback worth shipping: driving the same DSP from a `ScriptProcessorNode`
-measured around 5% of the audio missing, because that node type drops buffers
-on its own at every size.
-
-So a server that other devices will use terminates TLS, one of three ways:
-
-1. **A reverse proxy** (SWAG, Nginx Proxy Manager, Traefik, Caddy). The usual
- self-hosted shape, and the best one if you already run it. StemDeck reads
- `X-Forwarded-Proto` and the RFC 7239 `Forwarded` header, so an https browser
- over a plain-http upstream hop is recognised as secure and served normally.
-2. **StemDeck itself**, by pointing `STEMDECK_SSL_CERT` and `STEMDECK_SSL_KEY`
- at a certificate and key. uvicorn serves them directly; no extra package is
- installed for this.
-3. **A private overlay network** such as Tailscale, whose addresses are already
- https.
-
-Reaching a plaintext non-local origin with none of those in place is refused
-with a 403 that explains this, rather than served as an app that is quietly
-half-broken. Loopback is always served, so turning this on can never lock the
-host out of its own server.
-
-### The desktop app runs two listeners
-
-The desktop app does the same thing without being configured, because it has
-two audiences that need opposite things.
-
-- **Plain http on `127.0.0.1`** for its own window. Loopback is already a
- secure context, so nothing is lost, and it is the only scheme that works: a
- self-signed certificate would raise a warning page the app window has no way
- to click through.
-- **https on the LAN**, port 8443 by default, for phones and other computers.
- This is the address Settings shows and the QR code points at.
-
-Both listeners serve the same process, so there is one library, one queue and
-one Demucs worker either way.
-
-The certificate is generated on your own machine the first time you enable
-network access, and lives in `/certs/` beside `jobs/` and
-`settings.json`. Nothing is shipped in the download: a certificate in the
-release would publish its private key to everyone who downloaded it, which is
-worse than plain http because it looks secure. It is regenerated automatically
-when your machine's addresses change or the certificate is close to expiring.
-
-Because it is signed by nobody, **your phone will show a "your connection is
-not private" warning the first time**. Tap Advanced, then Continue. Once per
-device, per computer. Settings says so, in red, next to the toggle.
+StemDeck is free and **does not accept any money, sponsorship, or funding** from anyone listed below. I share these makers and artists and communities purely for the joy of pointing you toward wonderful people doing beautiful work. Go meet them ❤️
+| Category | Name | What they do | Link |
+|---|---|---|---|
+| Artists & Creators | Adrianna Claro | Soul and Contemporary R&B Singer, Songwriter and Composer | [Spotify](https://open.spotify.com/album/10fZ48iJhIe3lWcXSMUlFG) · [Apple Music](https://music.apple.com/us/album/happy/1592026727?i=1592026728) |
+| Artists & Creators | Analog4Lyfe | Analog gear specialist | [@analog4lyfe](https://www.instagram.com/analog4lyfe) |
+| Artists & Creators | Dead röses | Cork-based punk rock band | [@dead_rosesband](https://www.instagram.com/dead_rosesband) |
+| Artists & Creators | Joao Gaspar | Producer, film scorer, touring/session musician | [@jay_glaspar](https://www.instagram.com/jay_glaspar) |
+| Artists & Creators | Killah Trakz | Industry Secret Villain and Media Influencer | [@killahtrakz](https://www.instagram.com/killahtrakz/) · [Spotify](https://open.spotify.com/artist/6nePYOqT4E7D4C48twPtKk) · [Apple Music](https://music.apple.com/us/artist/killah-trakz/371296633) |
+| Artists & Creators | More Notes Less Talk | Gear-focused creative project with a raw, tape-recorded identity | [@morenoteslesstalk](https://www.youtube.com/@morenoteslesstalk) |
+| Artists & Creators | NIHIL | Modern alternative metal from Argentina. Fueled by emotionally charged vocals, anger and emptiness | [@somosnihil](https://www.instagram.com/somosnihil/) · [Spotify](https://open.spotify.com/artist/1OeKplJxFNM6JHrWeo2SaV) |
+| Instrument Builders & Repair | Dlima Guitars | Custom guitars and basses | [@dlimaguitars](https://www.instagram.com/dlimaguitars) |
+| Instrument Builders & Repair | Kris Luthier | Instrument repair and restoration | [@krisluthier](https://www.instagram.com/krisluthier) |
+| Instrument Builders & Repair | Lisbon Guitar Works | Handmade guitars in Lisbon | [dlimaguitars.com](https://dlimaguitars.com) |
+| Media & Community | Not Another Audio Podcast | Audio, music and tech industry podcast by working professionals | [Libsyn](https://directory.libsyn.com/shows/view/id/20f5a1e3-6fea-4d41-8cdf-451ce6fc6cda) |
+| Media & Community | r/bass | Bass-player community | [r/Bass](https://www.reddit.com/r/Bass) |
+| Media & Community | slashCAM | Camera, video, and post-production media | [@slashcam.de](https://www.instagram.com/slashcam.de) |
+| Music & Karaoke Technology | Beltr | Local, subscription-free karaoke software | [beltr.app](https://beltr.app/) |
+| Music & Karaoke Technology | Seratone | TV-based karaoke system | [seratone.audio](https://seratone.audio/) |
+| Music Gear | Empress Effects | Boutique effects pedals | [empresseffects.com](https://empresseffects.com) |
+| Music Gear | Thomann | Large music-equipment retailer | [@thomann.music](https://www.instagram.com/thomann.music) |
+| Writers & Storytellers | Alexandre Borges | Portuguese writer, screenwriter, and cultural commentator | [Books & author profile](https://www.instagram.com/alexgram_b/) |
---
-## API
+## Star History
-| Method | Path | Purpose |
-|---|---|---|
-| GET | `/api/health` | Server health and version info |
-| POST | `/api/jobs` | JSON `{url, stems?}` or multipart `file + stems` → `{job_id}` |
-| GET | `/api/jobs` | List completed (library) jobs |
-| GET | `/api/jobs/{id}` | Job state snapshot |
-| GET | `/api/jobs/{id}/events` | SSE stream of job state |
-| POST | `/api/jobs/{id}/cancel` | Terminate active subprocess and cancel job |
-| PATCH | `/api/jobs/{id}/sections` | Save waveform section markers for a job |
-| GET | `/api/jobs/{id}/stems/{name}.wav` | Stream a single stem WAV file |
-| GET | `/api/jobs/{id}/stems/{name}.mp3` | Transcode and stream a stem as MP3 |
-| GET | `/api/jobs/{id}/video.mp4` | Mux the current mix with the source video (MP4 upload or YouTube) into an MP4 |
-| DELETE | `/api/jobs/{id}` | Remove job dir from disk (terminal jobs only) |
+
+
+
+
+
+
+
---
-## Troubleshooting
-
-**`ffmpeg: command not found`:** install ffmpeg and restart with `./run.sh restart`.
+## For developers
-**`WARNING: [youtube] No supported JavaScript runtime`:** install deno (`brew install deno` on macOS) and restart. Downloads still work without it but may pick suboptimal formats.
-
-**First separation is very slow:** Demucs downloads `htdemucs_6s` weights (~170 MB) on first run; cached afterwards.
-
-**Demucs runs on CPU only:** check the startup log for `device=mps` or `device=cuda`. If you see `cpu`, your torch install may be CPU-only.
-
-**Transpose is greyed out on another machine:** the pitch stage is built on `AudioWorklet`, which browsers only expose on a *secure context*. `https://` and `localhost` count. A plain `http://192.168.x.x` does not, so a client opening StemDeck over the network is never given the API and transpose cannot work there. Changing the speed still works on such a client, but it resamples instead, so the key moves with it.
-
-Three ways to get a secure context, in order of least effort:
-
-- **Tunnel to localhost.** On the client: `ssh -N -L 8000:localhost:8000 user@host`, then open `http://localhost:8000`. The origin is now localhost, so everything works, including transpose.
-- **Tailscale Serve.** `tailscale serve 8000` on the host publishes StemDeck on your tailnet over real HTTPS with a genuine certificate, no warnings and nothing to install on the client beyond Tailscale itself. Note the plain Tailscale IP (`100.x.y.z`) is *not* a secure context; it has to go through `serve`.
-- **Any HTTPS reverse proxy** in front of StemDeck: Caddy, nginx, or a tunnel like Cloudflare Tunnel.
-
-**Page reloaded mid-job:** the job keeps running server-side. Wait for it to finish, then resubmit.
+| | |
+|---|---|
+| **[Build from source](docs/build-from-source.md)** | The macOS app, a web server on any platform, Docker and Unraid |
+| **[Configuration](docs/configuration.md)** | Environment variables, and serving other devices over https |
+| **[HTTP API](docs/api.md)** | The endpoints the web app uses |
+| **[Troubleshooting](docs/troubleshooting.md)** | Common problems, and what lives where on disk |
+| **[Model licences](docs/models.md)** | Where each machine-learning model's licence comes from |
-**`./run.sh: Permission denied`:** run `chmod +x run.sh`.
+
+Built with
----
+
-## Layout on Disk
+StemDeck is built on **[Python 3.12](https://python.org)** managed via **[uv](https://github.com/astral-sh/uv)**, with a **[FastAPI](https://fastapi.tiangolo.com)** backend serving REST and Server-Sent Events. Stem separation uses **[Demucs](https://github.com/facebookresearch/demucs)** (`htdemucs_6s`), Meta AI's open-source 6-stem neural network. The optional on-demand lead/backing vocal split runs the UVR-MDX-NET Karaoke 2 model via **[audio-separator](https://github.com/nomadkaraoke/python-audio-separator)**, trained as part of the **[Ultimate Vocal Remover](https://github.com/Anjok07/ultimatevocalremovergui)** project by Anjok07. YouTube audio is fetched via **[yt-dlp](https://github.com/yt-dlp/yt-dlp)**; transcoding and mixing use **[FFmpeg](https://ffmpeg.org)**. BPM detection and key analysis run on **[librosa](https://librosa.org)**; loudness measurement uses **[pyloudnorm](https://github.com/csteinmetz1/pyloudnorm)** (ITU-R BS.1770). The macOS and Windows desktop shells are **[Tauri v2](https://tauri.app)** (Rust/WKWebView on macOS, Rust/WebView2 on Windows). The frontend is vanilla JS with the Web Audio API, no framework and no build step; waveforms are rendered on `
---
@@ -503,20 +305,6 @@ FFmpeg is a GPL build. StemDeck downloads it and runs it as a separate executabl
---
-## Environment Variables
-
-These are for development and testing. Release builds only recognize the variables marked "release".
-
-| Variable | Platform | Scope | Description |
-|---|---|---|---|
-| `STEMDECK_DATA_DIR` | all | release | Override the user data directory (default: platform-standard location) |
-| `STEMDECK_ROOT` | all | release | Override the app root directory (default: derived from executable path) |
-| `STEMDECK_PYTHON` | all | **debug builds only** | Override the Python executable path |
-| `STEMDECK_FFMPEG_URL` | Windows, macOS | release | Override the FFmpeg download URL |
-| `STEMDECK_FFPROBE_URL` | macOS | release | Override the ffprobe download URL |
-
----
-
## Contributing
Issues, feature suggestions, and pull requests are welcome. See open issues for what's planned.
diff --git a/docs/api.md b/docs/api.md
new file mode 100644
index 00000000..d78010b6
--- /dev/null
+++ b/docs/api.md
@@ -0,0 +1,19 @@
+# HTTP API
+
+[Back to the README](../README.md)
+
+The endpoints the web app itself uses. They are not a stable public interface and can change between releases.
+
+| Method | Path | Purpose |
+|---|---|---|
+| GET | `/api/health` | Server health and version info |
+| POST | `/api/jobs` | JSON `{url, stems?}` or multipart `file + stems` → `{job_id}` |
+| GET | `/api/jobs` | List completed (library) jobs |
+| GET | `/api/jobs/{id}` | Job state snapshot |
+| GET | `/api/jobs/{id}/events` | SSE stream of job state |
+| POST | `/api/jobs/{id}/cancel` | Terminate active subprocess and cancel job |
+| PATCH | `/api/jobs/{id}/sections` | Save waveform section markers for a job |
+| GET | `/api/jobs/{id}/stems/{name}.wav` | Stream a single stem WAV file |
+| GET | `/api/jobs/{id}/stems/{name}.mp3` | Transcode and stream a stem as MP3 |
+| GET | `/api/jobs/{id}/video.mp4` | Mux the current mix with the source video (MP4 upload or YouTube) into an MP4 |
+| DELETE | `/api/jobs/{id}` | Remove job dir from disk (terminal jobs only) |
diff --git a/docs/build-from-source.md b/docs/build-from-source.md
new file mode 100644
index 00000000..b790f008
--- /dev/null
+++ b/docs/build-from-source.md
@@ -0,0 +1,141 @@
+# Build from source
+
+[Back to the README](../README.md)
+
+Every way to run StemDeck from this repository: the macOS app, a web server on any platform, Docker and Unraid.
+
+### macOS Native App
+
+Requires Rust, Node.js, and Python 3.12. Builds a self-contained `.app` that downloads its own runtime on first launch.
+
+```sh
+# First time only: add the cross-compilation targets
+rustup target add aarch64-apple-darwin # Apple Silicon
+rustup target add x86_64-apple-darwin # Intel
+
+# Build Apple Silicon
+ARCH=arm64 scripts/macos/make-runtime-pack.sh
+ARCH=arm64 scripts/macos/make-app.sh
+ARCH=arm64 scripts/macos/make-dmg.sh
+
+# Build Intel (requires Rosetta 2 and an x86_64 Python)
+ARCH=x64 scripts/macos/make-runtime-pack.sh
+ARCH=x64 scripts/macos/make-app.sh
+ARCH=x64 scripts/macos/make-dmg.sh
+```
+
+The `.app` lands at `desktop/src-tauri/target//release/bundle/macos/StemDeck.app`. The DMG lands at `.build/macos-dist/StemDeck-macOS-.dmg`.
+
+To run a fresh build directly without the DMG:
+
+```sh
+open desktop/src-tauri/target/aarch64-apple-darwin/release/bundle/macos/StemDeck.app
+```
+
+If macOS blocks the app with a Gatekeeper prompt, run:
+
+```sh
+xattr -dr com.apple.quarantine desktop/src-tauri/target/aarch64-apple-darwin/release/bundle/macos/StemDeck.app
+```
+
+> **Note:** To test a clean first-launch during development, you can wipe previous app data first: `rm -rf ~/Library/Application\ Support/StemDeck`. Don't do this on a real install.
+
+---
+
+### Web Server (macOS / Linux / Windows with Python 3.12+)
+
+#### Prerequisites
+
+Python 3.12 or newer, `ffmpeg` on your PATH, and [uv](https://github.com/astral-sh/uv). Around 170 MB of free disk for the Demucs model, which downloads automatically on first run.
+
+Optional, for song identification with an AcoustID key: an FFmpeg built with chromaprint (Debian and Ubuntu's `ffmpeg` is), or Chromaprint's `fpcalc` on your PATH (`brew install chromaprint`, `apt install libchromaprint-tools`, or your distro's `chromaprint` package). `./run.sh setup` installs it when your FFmpeg needs it. Without either, songs are identified by their tags only.
+
+#### macOS / Linux (one-shot)
+
+```sh
+git clone https://github.com/stemdeckapp/stemdeck stemdeck && cd stemdeck
+./run.sh setup # installs ffmpeg + uv, runs uv sync
+./run.sh start
+```
+
+Open .
+
+`setup` uses Homebrew on macOS and `apt-get` on Debian/Ubuntu. For other Linux distros, install `ffmpeg` and [uv](https://github.com/astral-sh/uv) manually, then run `uv sync` followed by `./run.sh start`.
+
+#### Windows (PowerShell)
+
+Install prerequisites:
+- [uv](https://docs.astral.sh/uv/getting-started/installation/): `winget install astral-sh.uv`
+- [ffmpeg](https://ffmpeg.org/download.html): `winget install Gyan.FFmpeg` (or Chocolatey: `choco install ffmpeg`)
+
+```powershell
+git clone https://github.com/stemdeckapp/stemdeck stemdeck; cd stemdeck
+uv sync
+uv run uvicorn app.main:app --host 127.0.0.1 --port 8000 --timeout-graceful-shutdown 5
+```
+
+Open .
+
+> `run.sh` is macOS/Linux only. On Windows use the PowerShell commands above, or run inside WSL.
+
+**NVIDIA GPU (CUDA):** install the CUDA-enabled torch build before starting:
+
+```powershell
+uv pip install torch torchvision torchaudio --index-url https://download.pytorch.org/whl/cu124
+$env:STEMDECK_DEMUCS_DEVICE = "cuda"
+uv run uvicorn app.main:app --host 127.0.0.1 --port 8000 --timeout-graceful-shutdown 5
+```
+
+---
+
+#### Manual (any platform)
+
+```sh
+git clone https://github.com/stemdeckapp/stemdeck stemdeck && cd stemdeck
+uv sync
+uv run uvicorn app.main:app --reload --timeout-graceful-shutdown 5
+```
+
+> `--timeout-graceful-shutdown` bounds how long uvicorn waits for open
+> connections when you stop it. StemDeck keeps a long-lived SSE stream open
+> for the import queue while a browser tab is on the app, so without it
+> Ctrl-C waits for that stream instead of exiting.
+
+#### Docker
+
+```sh
+docker compose -f build/docker-compose.yml up --build
+```
+
+Stems land in `./jobs/` on the host. Demucs weights are cached in a named volume so they don't re-download on rebuild. Note: no GPU passthrough on macOS Docker.
+
+A prebuilt image is published to GHCR. Tags: `edge` (rolling, rebuilt on every merge to main), `latest` (newest stable release), and `X.Y.Z` (pinned to a release).
+
+```sh
+docker run -d --name stemdeck -p 8000:8000 \
+ -v /path/to/jobs:/app/jobs \
+ -v /path/to/cache:/cache \
+ -e STEMDECK_PERSIST_LIBRARY=1 \
+ ghcr.io/stemdeckapp/stemdeck:edge
+```
+
+On a Linux host with an NVIDIA GPU (driver + NVIDIA Container Toolkit installed), add `--runtime=nvidia -e NVIDIA_VISIBLE_DEVICES=all` and StemDeck auto-detects CUDA. The image already bundles CUDA-enabled torch, so no separate CUDA install is needed.
+
+#### Unraid
+
+StemDeck is available in Unraid Community Applications: open **Apps**, search "StemDeck", and install. Map the two volumes to persistent appdata paths:
+
+- `/app/jobs` -> `/mnt/user/appdata/stemdeck/jobs` (library + stems)
+- `/cache` -> `/mnt/user/appdata/stemdeck/cache` (model weights)
+
+The library is persistent by default (`STEMDECK_PERSIST_LIBRARY=1`), so tracks are never auto-deleted. For GPU acceleration, install the **Nvidia Driver** plugin, then set the container's Extra Parameters to `--runtime=nvidia` (the `NVIDIA_VISIBLE_DEVICES` and `NVIDIA_DRIVER_CAPABILITIES` variables are already in the template). CPU-only works with no extra configuration.
+
+#### `run.sh` control script
+
+```sh
+./run.sh setup # one-shot: install ffmpeg + uv, then uv sync
+./run.sh start # boots uvicorn in the background
+./run.sh stop # graceful shutdown
+./run.sh restart # stop + start
+./run.sh status # is it running?
+```
diff --git a/docs/configuration.md b/docs/configuration.md
new file mode 100644
index 00000000..914b0f86
--- /dev/null
+++ b/docs/configuration.md
@@ -0,0 +1,94 @@
+# Configuration
+
+[Back to the README](../README.md)
+
+| Variable | Default | Purpose |
+|---|---|---|
+| `STEMDECK_DEMUCS_DEVICE` | auto | Force Torch device: `cuda`, `mps`, or `cpu`. |
+| `STEMDECK_DEMUCS_MODEL` | `htdemucs_6s` | Demucs model name. |
+| `STEMDECK_JOBS_DIR` | `./jobs` | Where job directories land. |
+| `STEMDECK_DATA_DIR` | (none) | Portable mode root; sets all sub-dirs below to live inside it. |
+| `STEMDECK_CACHE_DIR` | `/cache` | Torch model cache directory. |
+| `STEMDECK_DOWNLOADS_DIR` | `/downloads` | yt-dlp download scratch space. |
+| `STEMDECK_MODELS_DIR` | `/models` | Demucs model weights directory. |
+| `STEMDECK_LOGS_DIR` | `/logs` | Log file output directory. |
+| `STEMDECK_FFMPEG_DIR` | (none) | Directory containing a bundled ffmpeg binary. |
+| `STEMDECK_FFMPEG` | `ffmpeg` | Path to the ffmpeg executable. |
+| `STEMDECK_FFPROBE` | `ffprobe` | Path to the ffprobe executable. |
+| `STEMDECK_FPCALC` | `fpcalc` | Path to Chromaprint's fpcalc, used for song fingerprinting when FFmpeg has no chromaprint muxer. |
+| `STEMDECK_MAX_DURATION_SEC` | `1200` | Reject audio longer than this (seconds). |
+| `STEMDECK_JOB_TTL_SECONDS` | `86400` | How long to keep job dirs on disk. |
+| `STEMDECK_MAX_PENDING_JOBS` | `3` | Max queued jobs before returning 503. |
+| `STEMDECK_TIMEOUT_FFMPEG` | `300` | ffmpeg subprocess timeout (seconds). |
+| `STEMDECK_TIMEOUT_ANALYZE` | `120` | Audio analysis timeout (seconds). |
+| `STEMDECK_TIMEOUT_DEMUCS_STALL` | `1800` | Kill Demucs if no output for this many seconds. |
+| `STEMDECK_SSL_CERT` | (none) | PEM certificate; set with the key below to serve https directly. |
+| `STEMDECK_SSL_KEY` | (none) | PEM private key for the certificate above. |
+| `STEMDECK_HTTPS_PORT` | (none) | Serve https on this port *in addition* to the main listener. Set by the desktop app; see below. |
+
+`run.sh` also reads: `HOST` (default `127.0.0.1`), `PORT` (default `8765`), `RELOAD=1` (enable uvicorn auto-reload for development), `FOREGROUND=1` (run in foreground instead of backgrounding).
+
+### Serving other devices: why https is not optional
+
+Transpose is built on `AudioWorklet`, and browsers grant that only to a
+**secure context**. `https://` and `localhost` qualify. A plain
+`http://192.168.1.20:8000` does not, so a phone reaching StemDeck over plain
+http gets working playback and a key control that cannot do anything. There is
+no fallback worth shipping: driving the same DSP from a `ScriptProcessorNode`
+measured around 5% of the audio missing, because that node type drops buffers
+on its own at every size.
+
+So a server that other devices will use terminates TLS, one of three ways:
+
+1. **A reverse proxy** (SWAG, Nginx Proxy Manager, Traefik, Caddy). The usual
+ self-hosted shape, and the best one if you already run it. StemDeck reads
+ `X-Forwarded-Proto` and the RFC 7239 `Forwarded` header, so an https browser
+ over a plain-http upstream hop is recognised as secure and served normally.
+2. **StemDeck itself**, by pointing `STEMDECK_SSL_CERT` and `STEMDECK_SSL_KEY`
+ at a certificate and key. uvicorn serves them directly; no extra package is
+ installed for this.
+3. **A private overlay network** such as Tailscale, whose addresses are already
+ https.
+
+Reaching a plaintext non-local origin with none of those in place is refused
+with a 403 that explains this, rather than served as an app that is quietly
+half-broken. Loopback is always served, so turning this on can never lock the
+host out of its own server.
+
+### The desktop app runs two listeners
+
+The desktop app does the same thing without being configured, because it has
+two audiences that need opposite things.
+
+- **Plain http on `127.0.0.1`** for its own window. Loopback is already a
+ secure context, so nothing is lost, and it is the only scheme that works: a
+ self-signed certificate would raise a warning page the app window has no way
+ to click through.
+- **https on the LAN**, port 8443 by default, for phones and other computers.
+ This is the address Settings shows and the QR code points at.
+
+Both listeners serve the same process, so there is one library, one queue and
+one Demucs worker either way.
+
+The certificate is generated on your own machine the first time you enable
+network access, and lives in `/certs/` beside `jobs/` and
+`settings.json`. Nothing is shipped in the download: a certificate in the
+release would publish its private key to everyone who downloaded it, which is
+worse than plain http because it looks secure. It is regenerated automatically
+when your machine's addresses change or the certificate is close to expiring.
+
+Because it is signed by nobody, **your phone will show a "your connection is
+not private" warning the first time**. Tap Advanced, then Continue. Once per
+device, per computer. Settings says so, in red, next to the toggle.
+
+## Environment variables for the desktop app
+
+These are for development and testing. Release builds only recognize the variables marked "release".
+
+| Variable | Platform | Scope | Description |
+|---|---|---|---|
+| `STEMDECK_DATA_DIR` | all | release | Override the user data directory (default: platform-standard location) |
+| `STEMDECK_ROOT` | all | release | Override the app root directory (default: derived from executable path) |
+| `STEMDECK_PYTHON` | all | **debug builds only** | Override the Python executable path |
+| `STEMDECK_FFMPEG_URL` | Windows, macOS | release | Override the FFmpeg download URL |
+| `STEMDECK_FFPROBE_URL` | macOS | release | Override the ffprobe download URL |
diff --git a/docs/troubleshooting.md b/docs/troubleshooting.md
new file mode 100644
index 00000000..5f8af38c
--- /dev/null
+++ b/docs/troubleshooting.md
@@ -0,0 +1,40 @@
+# Troubleshooting
+
+[Back to the README](../README.md)
+
+**`ffmpeg: command not found`:** install ffmpeg and restart with `./run.sh restart`.
+
+**`WARNING: [youtube] No supported JavaScript runtime`:** install deno (`brew install deno` on macOS) and restart. Downloads still work without it but may pick suboptimal formats.
+
+**First separation is very slow:** Demucs downloads `htdemucs_6s` weights (~170 MB) on first run; cached afterwards.
+
+**Demucs runs on CPU only:** check the startup log for `device=mps` or `device=cuda`. If you see `cpu`, your torch install may be CPU-only.
+
+**Transpose is greyed out on another machine:** the pitch stage is built on `AudioWorklet`, which browsers only expose on a *secure context*. `https://` and `localhost` count. A plain `http://192.168.x.x` does not, so a client opening StemDeck over the network is never given the API and transpose cannot work there. Changing the speed still works on such a client, but it resamples instead, so the key moves with it.
+
+Three ways to get a secure context, in order of least effort:
+
+- **Tunnel to localhost.** On the client: `ssh -N -L 8000:localhost:8000 user@host`, then open `http://localhost:8000`. The origin is now localhost, so everything works, including transpose.
+- **Tailscale Serve.** `tailscale serve 8000` on the host publishes StemDeck on your tailnet over real HTTPS with a genuine certificate, no warnings and nothing to install on the client beyond Tailscale itself. Note the plain Tailscale IP (`100.x.y.z`) is *not* a secure context; it has to go through `serve`.
+- **Any HTTPS reverse proxy** in front of StemDeck: Caddy, nginx, or a tunnel like Cloudflare Tunnel.
+
+**Page reloaded mid-job:** the job keeps running server-side. Wait for it to finish, then resubmit.
+
+**`./run.sh: Permission denied`:** run `chmod +x run.sh`.
+
+## Layout on disk
+
+```
+jobs//
+└── stems/
+ ├── vocals.wav # the 6 Demucs stems (always present)
+ ├── drums.wav
+ ├── bass.wav
+ ├── guitar.wav
+ ├── piano.wav
+ ├── other.wav
+ ├── original.wav # sum of un-selected stems (subset only)
+ └── mix.wav # ffmpeg amix of selected stems (subset only)
+```
+
+The library itself is one file, `jobs/registry.json`, so it survives a restart. A song's folder is only removed when you empty the Trash, or by the opt-in **Automatically delete finished tracks** setting, which is off unless you turn it on.
diff --git a/imgs/screenshot/guide.png b/imgs/screenshot/guide.png
new file mode 100644
index 0000000000000000000000000000000000000000..b83bacc6da578138358b24b47ecadee53ac3876a
GIT binary patch
literal 73035
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
-**Free, local stem separation. No account. No upload. No subscription.**
@@ -28,443 +27,246 @@
+
- 
- 
-
