StemDeck：ローカル完結の高性能音声分離ソフトウェア

概要

StemDeck は、MP3、WAV、FLAC、OGG/Opus、MP4、M4A ファイルをドロップするか、YouTube の URL を貼り付けるだけで、音声データを最大 **6 つのステム（音軌）**に分離するソフトウェアです。

• DAW 風のマルチトラックミキサーとして再生可能
• ミュート、ソロ、レベルバランス調整、波形ズーム、ループ設定など多様な機能搭載
• すべてがお客様のローカルマシン上で処理されるため、プライバシーが守られます

StemDeck とは何か？

StemDeck は音声分離ツールであり、ダウンロードサービスではありません。お客様が既に所有している音声を加工することを目的としています。

主な特徴

• 即座の開始: インポートバーにファイルをドラッグ＆ドロップするだけで使用可能。
• YouTube サポート: お客様が処理する権利を持つコンテンツに対してのみ利用可能です（保存・キャッシュ・配布は行いません）。
• ローカル完結: 情報は外部へ流出せず、すべてお客様のマシン上で完結します。

対抗馬との違い

Moises や LALAL.AI などのクラウド系ツールの無料なオープンソース的な代替案です。

• ✅ アカウント登録不要
• ✅ クォータ制限なし
• ✅ アップロード不要（プライバシー保護）
• ✅ サブスクリプション不要

注意: 高品質な仕上げ、モバイルアプリ、またはプロフェッショナル向け機能を求める場合は、商用製品を検討してください。StemDeck は個人の学習用としてステムを必要とする方、ローカルで無料で動作することを好まれる方に最適です。

推奨事項

StemDeck は無料で提供されており、開発者らは金銭やスポンサーシップを受け取っていません。以下のメーカーやコミュニティをご紹介することは、素晴らしい作品を創り出している方々との出会いを楽しんでいただくためです。

機能紹介

• 6 ステム分離: Demucs

  htdemucs_6s

  を使用。最適な Torch デバイスを自動検出（NVIDIA/CUDA、Apple Silicon/MPS、フォールバック CPU）。
• 柔軟なインポート: YouTube URL、MP3、WAV、FLAC、OGG/Opus、MP4、M4A 対応。
• DAW 風の波形エディタ: 最小/最大サンプルレンダリング、ノーマライゼーション、ズーム、ループドラッグ、ゴールドプレイヤーヘッダーなどに対応。
• ステムサブセット抽出: チップをクリックして選択可能。「すべて選択」から単一選択へ切り替え可能（追加/削除対応）。
• 「オリジナル」伴奏トラック: 補集合（選ばれたステムを除いた全体の曲）を 7 つ目のレーンとして表示し、A/B 比較に最適。
• 選択されたミックスのダウンロード:

  ffmpeg

  の

  amix

  を使用し、単一の

  mix.wav

  で出力可能。
• 個別のステム用ミキサー: ボリュームフェイダー、ミュート、ソロ、モニタモード（ソロ専用）対応。
• ライブ VU メーター: Web Audio ANALYZER を使用し、RMS、ピークホールド、スローファロフ機能付き。
• 楽曲分析: BPM (

  librosa

  ), キー、スケール、信頼度、統合 LUFS, サンプルピークなど。
• 中断可能なジョブ: パイプラインの途中でキャンセル可能。
• ライブラリーパネル: トラック整理、ドラッグ＆ドロップ、検索、ゴミ箱機能付き。

【正直な比較表】StemDeck vs 商用製品 (Moises/LALAL.AI など)

スピード、品質、モバイルアクセスが必要な場合は商用製品が適していますが、個人の学習用として音声を秘密に保ちたい、あるいはローカルで縛りがないものを求めるのであれば StemDeck で十分です。

ダウンロードとインストール

事前構築されたインストーラーは GitHub Release に添付されています。

macOS

起動手順:

1. DMG を開き、StemDeck を Applications にドラッグ。
2. 初回起動時はセットアップ画面が表示され、Python ランタイム（約 500 MB）、FFmpeg、Demucs モデル（約 170 MB）を自動ダウンロードします。
3. その後は数秒で起動可能です。
4. Gatekeeper プロンプトが出た場合は、アプリを右クリックして「開く」を選択してください。

Windows

起動手順:

1. ZIP ファイルを展開し、

   StemDeck.exe

   を実行。
2. データ（FFmpeg, Demucs モデルなど）は

   data/

   フォルダに格納されます。フォルダ全体を移動・コピーしても動作します。
3. Python やシステム依存ライブラリは不要です（自立型）。

技術スタック

• Python: 3.12 (

  uv

  で管理)。FastAPI バックエンド、Vanilla JS フロントエンド。
• 音声分離: Demucs (

  htdemucs_6s

  )、オプションの UVR-MDX-NET Karaoke 2 (

  audio-separator

  )。
• 処理:

  yt-dlp

  (YouTube 取得)、FFmpeg (トランスコード・ミックス)、

  librosa

  (BPM/キー分析)、

  pyloudnorm

  (音量測定)。
• デスクトップシェル: Tauri v2 (Rust/WKWebView)。
• 波形描画: Web Audio API、HTML5

  <canvas>

  。

ソースからのビルド

macOS ネイティブアプリ（自作）

Rust、Node.js、Python 3.12 が必要です。自立型の

.app

# 初めてのみ — クロスコンパイルターゲットを追加
rustup target add aarch64-apple-darwin   # Apple Silicon
rustup target add x86_64-apple-darwin    # Intel

# Apple Silicon ビルド
ARCH=arm64 scripts/macos/make-runtime-pack.sh
ARCH=arm64 scripts/macos/make-app.sh
ARCH=arm64 scripts/macos/make-dmg.sh

# Intel ビルド（Rosetta 2 と 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

Gatekeeper 回避:

xattr -dr com.apple.quarantine desktop/src-tauri/target/aarch64-apple-darwin/release/bundle/macos/StemDeck.app

Web サーバー構築

要件：Python 3.12+,

ffmpeg

uv

macOS / Linux（ワンショット）

git clone https://github.com/stemdeckapp/stemdeck stemdeck && cd stemdeck
./run.sh setup     # ffmpeg + uv をインストールし、uv sync を実行
./run.sh start

※

setup

Windows（PowerShell）

# 要件のインストール
uv — winget install astral-sh.uv
ffmpeg — winget install Gyan.FFmpeg (または choco install ffmpeg)

git clone https://github.com/stemdeckapp/stemdeck stemdeck; cd stemdeck
uv sync

# CUDA 環境の場合（NVIDIA GPU）
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

手動（どのプラットフォームでも）

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

は、ブラウザタブが開かれている間 SSE ストリームを保持するため必須です。このフラグなしでは Ctrl-C で終了しない場合があります。

Docker

docker compose -f build/docker-compose.yml up --build

※

./jobs/

事前構築イメージ（ghcr.io/stemdeckapp/stemdeck:edge） NVIDIA GPU ホストの場合：

docker run -d --name stemdeck -p 8000:8000 \
  -v /path/to/jobs:/app/jobs \
  -v /path/to/cache:/cache \
  -e STEMDECK_PERSIST_LIBRARY=1 \
  --runtime=nvidia -e NVIDIA_VISIBLE_DEVICES=all \
  ghcr.io/stemdeckapp/stemdeck:edge

Unraid

Unraid Community Applications で利用可能です。2 つのボリュームをマッピングします：

• /app/jobs

  ->

  /mnt/user/appdata/stemdeck/jobs

  （ライブラリー＋ステム）

• /cache

  ->

  /mnt/user/appdata/stemdeck/cache

  （モデルウェイト）

GPU 加速には Nvidia Driver プラグインと

--runtime=nvidia

使い方

1. インポート: YouTube URL または音声ファイルをドロップし、「Process」をクリック。
2. 抽出待ち: アップロード → 解析 → 分離 → ミックスの各段階でプログレスが表示されます。
3. ダッシュボード表示:完了するとスタジオビューが開きます。
   • レーン構成:

     Original

     （選択外）、そして選択したステム（ボーカル、ドラムなど）。
   • ミックス: Play/Pause/Stop コントロールでマスタートランスポートを制御します。

     • M

       : ミュート

     • S

       : ソロ（加算的；複数同時ソロ可）
     • Monitor モード: そのステムのみソロ化し他をクリア。
   • フェイダー: ドラッグ操作、ダブルクリックでリセット、Shift キー＋ホイールで粗い調整。
4. ループ設定: メーター上でドラッグして領域を選択し、「Loop」をクリック。
5. ショートカット:

   • Space

     : 再生/一時停止

   • [

     /

     ]

     : 5 秒さかのぼり／先送り

   • L

     : ループ切り替え

   • I

     /

     O

     : ループイン／アウト

設定変数

STEMDECK_DEMUCS_DEVICE

STEMDECK_JOBS_DIR

STEMDECK_DATA_DIR

STEMDECK_CACHE_DIR

<data>/cache

STEMDECK_MAX_DURATION_SEC

STEMDECK_JOB_TTL_SECONDS

run.sh コントロール:

• ./run.sh setup

  : ファイルと依存関係をインストール。

• ./run.sh start

  : バックグラウンド起動。

• ./run.sh stop/restart/status

  : システム制御。

API

REST API と Server-Sent Events (SSE) を提供します。

/api/health

/api/jobs

/api/jobs

/api/jobs/{id}

/api/jobs/{id}/events

/api/jobs/{id}/cancel

/api/jobs/{id}/sections

/api/jobs/{id}/stems/{name}.wav/mp3

/api/jobs/{id}/video.mp4

/api/jobs/{id}

トラブルシューティング

• ffmpeg: command not found

  :

  ffmpeg

  をインストールし、

  ./run.sh restart

  で再起動してください。

• WARNING: [youtube] No supported JavaScript runtime

  :

  deno

  をインストール（macOS:

  brew install deno

  ）して再起動してください。
• 初回分離が遅すぎる: 約 170 MB の Demucs モデルウェイトが初回にダウンロードされます。その後はキャッシュされ、高速化します。
• Demucs が CPU 専用で動作: ログに

  device=mps

  または

  cuda

  が表示されていない場合は、CPU 専用インストールの可能性を確認してください。
• ページリロード後ジョブの停止: サーバー側で実行が続行されますが、完了を待ち、再提出してください。
• Permission denied: Linux/Mac で

  chmod +x run.sh

  を実行してください。

ディスク上の配置

jobs/<job_id>/
└── stems/
    ├── vocals.wav      # ボーカル
    ├── drums.wav       # ドラム
    ├── bass.wav        # ベース
    ├── guitar.wav      # ギター
    ├── piano.wav       # ピアノ
    ├── other.wav       # その他
    ├── original.wav    # 選択外合計（サブセット時）
    └── mix.wav         # 選択済み合計（サブセット時）

サーバー再起動時、ジョブリストはリセットされますがファイルは残ります。TTL（デフォルト 24 時間）後に古いディレクトリが自動削除されます。

免責事項

StemDeck は個人的な学習、研究、実験を目的としたローカル音声ステム分離ツールです。ダウンロードサービスではありません。すべての処理はユーザー自身のマシンで行われ、情報は外部へ送信されません。

YouTube URL サポートは yt-dlp を介して利便性のために提供されていますが、自動的なダウンロードは YouTube の利用規約に違反する可能性があります。著作権の尊重と利用規約の遵守はすべてユーザーの責任です。また、依存するツールのライセンス（yt-dlp, Demucs, FFmpeg, PyTorch など）に従うこともお客様の責任となります。

開発者は本ソフトウェアを現状有姿として提供し、いかなる保証も付与せず、使用方法に対する一切の責任または損害賠償を負いません。

コミュニティ

開発とコントリビューティング

問題報告、機能提案、およびプルリクエストをお待ちしております。計画されている内容についてはオープンな issue をご確認ください。