StemDeck

StemDeck

Docker app from StemDeckApp's Repository

StemDeck splits any song into isolated stems (vocals, drums, bass, guitar, piano, other) and plays them back in a DAW-style multitrack player.

Requirements

Optional: install the Unraid "Nvidia Driver" plugin and set Extra Parameters to --runtime=nvidia for GPU acceleration. Runs on CPU without a GPU.
Overview
StemDeck splits any song into isolated stems (vocals, drums, bass, guitar, piano, other) and plays them back in a DAW-style multitrack player. Paste a YouTube URL or upload a file, get separated tracks you can mute, solo, loop, slow down, and pitch-shift for practice and transcription. Powered by Demucs. Data: processed tracks and downloads live under /app/jobs; Demucs model weights and the torch cache live under /cache. Map both to persistent appdata paths so nothing re-downloads on update. The library is persistent and user-managed on Unraid (STEMDECK_PERSIST_LIBRARY=1 is set by default); tracks are never auto-deleted. GPU (optional): install the Unraid "Nvidia Driver" plugin, then set Extra Parameters to --runtime=nvidia and keep NVIDIA_VISIBLE_DEVICES / NVIDIA_DRIVER_CAPABILITIES. StemDeck auto-detects CUDA and uses it, processing several times faster. Without a GPU it runs on CPU with no extra configuration. Note: very new Blackwell cards (RTX 50 series) may fall back to CPU until a newer CUDA build ships. AMD GPU (optional, community-tested): change the Repository to ghcr.io/stemdeckapp/stemdeck:rocm and set Extra Parameters to --device /dev/kfd --device /dev/dri. The host needs the amdgpu driver loaded (/dev/kfd must exist); the ROCm runtime is in the image. Cards the ROCm build of PyTorch has no kernels for run on CPU.

Drop in a song. Get every instrument on its own track. Practice with them.
Runs on your own computer: no account, no subscription, and your audio is not uploaded.

Download, free Latest release

Download  ·  What you can do  ·  Honest comparison  ·  We Recommend  ·  For developers

The StemDeck studio: a song split into vocals, drums, bass, guitar, piano and other, each on its own lane

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. Sing along in Karaoke, or film yourself playing along in Performance. Drop in an audio file or paste a YouTube or SoundCloud link. Separation runs on your own machine, and StemDeck does not upload your audio.

A separation tool, not a downloader. StemDeck is for processing audio you have the right to use. What you import, the stems made from it, and the takes you record, are saved in your library folder on the machine that runs StemDeck; StemDeck does not upload or share them. See the Disclaimer.

Download

Each link downloads the latest release. Release notes · Every version

Platform NVIDIA, AMD (Linux) or Apple Silicon Everything else
 Windows NVIDIA GPU No NVIDIA GPU
 macOS Apple Silicon (M1 and later) Intel Mac
 Linux NVIDIA or AMD GPU No NVIDIA or AMD GPU

 Docker / Unraid: ghcr.io/stemdeckapp/stemdeck:latest. It runs on the CPU as it is; add --runtime=nvidia to use an NVIDIA GPU. For an AMD GPU (community-tested), use the :rocm tag with --device /dev/kfd --device /dev/dri. On Unraid, search "StemDeck" in Apps.

What's new in 0.21.0
  • Four modes: Practice, Advanced, Karaoke and Performance, all in one Mode menu.
  • Karaoke. The lyrics fill the window and light up as the song plays, with the voice off and a queue of songs.
  • Performance. Film yourself playing along, review the take, trim it and export an MP4.
  • Each mode keeps its own stems and its own saved mix of a song.
  • Advanced gains an EQ on every lane, a Master with a loudness target, recording tracks and video tracks.
  • A redesigned Settings, with a section list and a search box.
  • A GPU video encoder for Performance exports, with an automatic fall-back to the CPU.
  • Safer by default: a guard against requests from other websites, auto-delete that skips favorites, songs with takes or versions, and songs still being worked on, and a library that survives one bad record.
  • Imports: a Detect lyrics switch, and Try again on an import that failed.

All of it, with credits to the people who reported each problem, is in the release notes.

Installing, per platform

Windows and Linux. Unzip, then run StemDeck.exe (Windows) or StemDeck (Linux). No installer and nothing else to install. Put the folder somewhere you can write to, such as C:\StemDeck: a portable StemDeck keeps its runtime, models and settings, and on Windows your songs by default, in a data folder beside it, so it cannot run from Program Files. The first launch downloads FFmpeg and the separation model, and on an NVIDIA card (or, on Linux, an AMD card ROCm supports, such as the RX 7000 and RX 9000 series) sets up GPU support; later launches start in seconds.

macOS. Open the DMG and drag StemDeck to Applications. StemDeck is not code-signed yet, so clear the quarantine flag once, or macOS will say the app is damaged:

xattr -dr com.apple.quarantine /Applications/StemDeck.app

The first launch downloads the runtime and the model. Apple Silicon separates on its built-in GPU.

Docker and Unraid. See Build from source for the docker run line, GPU passthrough and the Unraid volume mapping.

Updates. The desktop app tells you when a new version is out. On Windows and Linux it usually installs the update for you. A version that changes the Python packages StemDeck runs on is a full download instead, and 0.21.0 is one: about 300 MB on Windows and 420 MB on Linux, once. On Windows, unzip it over your current StemDeck folder. The zip has no files inside data, so your songs, models and settings there stay as they are. A portable StemDeck no longer opens a library in Documents\StemDeck\jobs on its own: if yours is there, choose that folder once in Settings, StemData location. Unzipped into a new folder, StemDeck starts with default settings, without the songs from the old data folder, and downloads FFmpeg and the model again. On macOS, download the new DMG.

What you can do

Modes

Pick one from Mode in the left rail. Each mode keeps its own choice of stems and its own saved mix of a song, so a change in one does not follow you into another.

  • Practice: stems, mixer, speed, key, click and loop, without recording, EQ or the master.
  • Advanced: everything, with recording tracks, take folders, an EQ on every lane, the master and video.
  • Karaoke: the lyrics fill the window and light up word by word as the song plays. Switch the voice and the backing vocals on or off, and drag songs from the library into a queue.
  • Performance: film yourself playing along to the song, then export the video.

Split any song

  • 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 (not on Intel Macs).
  • Files or links: MP3, WAV, FLAC, OGG, Opus, M4A and MP4, or a YouTube or SoundCloud link.
  • Search without leaving the app: YouTube songs and playlists, and SoundCloud, with a preview.
  • Pick only what you need before you extract.
  • Choose the lanes in each mode with Stems: the stems you pick get their own lane, the rest play together in Original. Nothing is separated again.
  • Whole YouTube playlists go into an import queue and run one after another.

Practice with it

  • 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, any beats per bar and groupings such as 3+2+2.
  • Fix the beat grid when the click drifts: move, add or remove beats and mark the bar lines.

Film yourself playing

In Performance mode:

  • Your camera and your input: pick a camera, or none, and your microphone or audio interface input.
  • Say what you play with I play, and that part is taken out of the backing track you hear and out of the video.
  • Review the take in step with the song, and trim its start and end on the Take Timeline.
  • Export to MP4 at 720p or 1080p, at 24, 30 or 60 fps. StemDeck uses your graphics card when its encoder passes a short test on your computer, and the CPU otherwise. Settings > Export has a Video encoder choice and a Test encoders button.
  • The video stays on your computer. Uploading and live streaming are not part of this release.

Know the song

  • Key, tempo and loudness, found for you.
  • Sections such as verse, chorus and solo, detected for you (experimental) or marked by hand.
  • Synced lyrics from LRCLIB, with timing you can fix by tapping along. With an NVIDIA GPU, or an AMD one on Linux, StemDeck can also write them down from the vocals when none are found.
  • Song and artist details from MusicBrainz, Wikipedia and, optionally, Discogs.

Keep and share

  • Export what you hear as one file, every part as a .zip, only the looped part, or, when the song came with a video, a video with the original picture. Add the click or a count-in if you like.
  • Drag a stem or a loop from the desktop app straight into your other music software.
  • A library with colored folders, tags you can search by (#tag), favorites, and a Trash that only deletes when you empty it.

It explains itself

Click Guide in the left rail and point at anything. Every button, lane control and number says what it does, in plain words, and so do the Mode menu and the options in Settings. While Guide is on, clicks explain instead of acting, so nothing happens by accident.

Settings has a list of sections on the left and a search box, and most changes save as soon as you make them.

On your phone too

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.

Windows, Linux and macOS  ·  Docker and Unraid  ·  11 languages
English · Deutsch · Español · Français · Bahasa Indonesia · 日本語 · 한국어 · Polski · Português (Brasil) · Português (Portugal) · 简体中文

Honest comparison

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.

StemDeck Moises, LALAL.AI and similar
Price Free and open source Usually freemium, with credits or a subscription for regular use
Where it runs On your own machine Usually in the cloud, so your audio is uploaded
Account None Usually required
Internet For links, the first model download, update checks, and song details and lyrics Usually needed to process audio
Privacy Your audio is not uploaded; song names are looked up for details and lyrics Processed on their servers, under their own retention policy
Separation model Demucs htdemucs_6s, open source from Meta Their own models, which may give better results
Stems 6, plus lead and backing vocals Varies; some offer more instruments
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 Varies by service and plan
Phone Your phone opens StemDeck over your own Wi-Fi; no app store app Some offer mobile 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.

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 · Apple Music
Artists & Creators Analog4Lyfe Analog gear specialist @analog4lyfe
Artists & Creators Dead röses Cork-based punk rock band @dead_rosesband
Artists & Creators Joao Gaspar Producer, film scorer, touring/session musician @jay_glaspar
Artists & Creators Killah Trakz Industry Secret Villain and Media Influencer @killahtrakz · Spotify · Apple Music
Artists & Creators More Notes Less Talk Gear-focused creative project with a raw, tape-recorded identity @morenoteslesstalk
Artists & Creators NIHIL Modern alternative metal from Argentina. Fueled by emotionally charged vocals, anger and emptiness @somosnihil · Spotify
Instrument Builders & Repair Dlima Guitars Custom guitars and basses @dlimaguitars
Instrument Builders & Repair Kris Luthier Instrument repair and restoration @krisluthier
Instrument Builders & Repair Lisbon Guitar Works Handmade guitars in Lisbon dlimaguitars.com
Media & Community Not Another Audio Podcast Audio, music and tech industry podcast by working professionals Libsyn
Media & Community r/bass Bass-player community r/Bass
Media & Community slashCAM Camera, video, and post-production media @slashcam.de
Music & Karaoke Technology Beltr Local, subscription-free karaoke software beltr.app
Music & Karaoke Technology Seratone TV-based karaoke system seratone.audio
Music Gear Empress Effects Boutique effects pedals empresseffects.com
Music Gear Thomann Large music-equipment retailer @thomann.music
Writers & Storytellers Alexandre Borges Portuguese writer, screenwriter, and cultural commentator Books & author profile

Star history

Star History Chart

For developers

Page What it covers
Build from source The macOS app, a web server on any platform, Docker and Unraid
Configuration Environment variables, and serving other devices over https
HTTP API The endpoints the web app uses
Troubleshooting Common problems, and what lives where on disk
Model licenses Where each machine-learning model's license comes from
Built with

StemDeck is built on Python 3.12 managed via uv, with a FastAPI backend serving REST and Server-Sent Events. Stem separation uses 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, trained as part of the Ultimate Vocal Remover project by Anjok07. YouTube audio is fetched via yt-dlp; transcoding and mixing use FFmpeg. BPM detection and key analysis run on librosa; loudness measurement uses pyloudnorm (ITU-R BS.1770). The macOS and Windows desktop shells are Tauri v2 (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 <canvas> using min/max sample rendering.

Thanks to the creators and maintainers of all the open-source libraries that make StemDeck possible.

Disclaimer

StemDeck is a local audio stem separation tool intended for personal study, research, and experimentation. It is not a downloading service. Audio you import, the stems made from it, and the takes you record, are saved only in the library folder on the machine that runs StemDeck, and StemDeck does not upload, share or redistribute them. To find song details and lyrics it sends the song's name to the services named in its Settings and, only if you add an AcoustID key, an audio fingerprint; it does not send the audio itself.

YouTube and SoundCloud link support is provided via yt-dlp as a convenience. Automated downloading may violate YouTube's Terms of Service. You, the user, are solely responsible for ensuring you have the right to process any audio you submit, complying with the terms of service of any site you download from, and respecting the copyright of the material you work with.

You are also responsible for following the licenses of the underlying tools this project depends on (yt-dlp, Demucs, FFmpeg, PyTorch, and others listed in pyproject.toml).

The author(s) of StemDeck provide this software "as is", without warranty of any kind, and accept no responsibility or liability for how it is used.

License

StemDeck is free software under the GNU Affero General Public License v3.0 only (AGPL-3.0-only). You may use, study, change and share it. If you change it and let other people use your version over a network, the AGPL asks you to offer them its source code too; the About dialog links to the source for that reason.

Releases up to and including 0.20.0 were published under Apache-2.0, and copies received under those terms keep them.

Every download ships StemDeck's own LICENSE.txt, a THIRD_PARTY_NOTICES.txt and a licenses/ folder. licenses/INDEX.txt lists each packaged Python dependency with its version and license, and each one's full license text sits beside it. That inventory is generated from the packaged interpreter at build time, so it describes what actually shipped rather than what was expected to.

FFmpeg is a GPL build. StemDeck downloads it and runs it as a separate executable, so it does not change StemDeck's own license, and THIRD_PARTY_NOTICES.txt carries the written offer of source for the exact build your platform receives.

Community

Questions, ideas and show-and-tell are all welcome.

Contributing

Issues, feature suggestions and pull requests are welcome. See the open issues for what is planned, and Build from source to run it yourself.

If you would like to support the time I put into StemDeck, a Donate button shows in the app's left rail as soon as donating is set up. Donating is optional: StemDeck stays free, with every feature, for everyone.

Categories

Related apps

Links

Details

Repository
ghcr.io/stemdeckapp/stemdeck:0.21.0
Last Updated2026-11-22
First Seen2026-07-11

Runtime arguments

Web UI
http://[IP]:[PORT:8000]/
Network
bridge
Shell
sh
Privileged
false

Template configuration

WebUI PortPorttcp

HTTP port for the StemDeck web player.

Target
8000
Default
8000
Value
8000
Jobs / LibraryPathrw

Processed tracks, stems, and downloaded audio. Persistent, user-managed library.

Target
/app/jobs
Default
/mnt/user/appdata/stemdeck/jobs
Value
/mnt/user/appdata/stemdeck/jobs
Cache (models)Pathrw

Demucs model weights (~170 MB) and the torch cache. Persist so they survive updates.

Target
/cache
Default
/mnt/user/appdata/stemdeck/cache
Value
/mnt/user/appdata/stemdeck/cache
Persistent libraryVariable

Keep 1 so processed tracks are never auto-deleted (recommended on Unraid). Set 0 to re-enable the 24h cleanup sweep.

Target
STEMDECK_PERSIST_LIBRARY
Default
1
Value
1
Max track length (seconds)Variable

Reject sources longer than this. Default 1200 (20 min).

Target
STEMDECK_MAX_DURATION_SEC
Default
1200
Value
1200
Max concurrent jobsVariable

How many separations may be queued/running at once (1-50).

Target
STEMDECK_MAX_PENDING_JOBS
Default
3
Value
3
Stem storage formatVariable

How new songs' stems are stored: mp3 (smaller, lossy, the default when empty) or wav (lossless, about ten times larger). Songs already in the library keep their format. A choice saved in Settings wins over this.

Target
STEMDECK_STEM_FORMAT
Stem MP3 bitrate (kbps)Variable

Bitrate of MP3 stems: 128 (the default when empty), 192 or 256. Only used when the storage format is mp3.

Target
STEMDECK_STEM_MP3_KBPS
Free memory when idle (minutes)Variable

Minutes with no separation or analysis running before the separation models are unloaded from memory: 10 when empty, 0 keeps them loaded. The next track loads them again and starts a few seconds later. A value saved in Settings wins over this.

Target
STEMDECK_IDLE_UNLOAD_MINUTES
PUIDVariable

User ID the app runs as. Unraid's default is 99 (nobody), so files written to appdata are owned correctly.

Default
99
Value
99
PGIDVariable

Group ID the app runs as. Unraid's default is 100 (users).

Default
100
Value
100
NVIDIA GPUsVariable

GPU(s) exposed to the container. Requires the Unraid Nvidia Driver plugin and Extra Parameters set to --runtime=nvidia. Use 'all' or a specific GPU UUID.

Target
NVIDIA_VISIBLE_DEVICES
Default
all
Value
all
NVIDIA driver capabilitiesVariable

Driver features exposed to the container. Leave as 'all' for CUDA compute.

Target
NVIDIA_DRIVER_CAPABILITIES
Default
all
Value
all