wehub/stemdeckapp--stemdeck
1
0
Fork 0
Code Issues Pull Requests Actions Deployments Models Agent Notes Packages Projects Releases Wiki Activity

chore: import upstream snapshot with attribution
CI / lint (push) Has been cancelled
Details
CI / js-syntax (push) Successful in 10m24s
Details
CI / deps-audit (push) Has been cancelled
Details
CI / test (push) Failing after 24m55s
Details
CI / sast-bandit (push) Failing after 11m13s
Details
CI / trivy (push) Failing after 9m32s
Details
Docker Publish / build-and-push (push) Failing after 34m3s
Details

Browse Source
This commit is contained in:
wehub-resource-sync
2026-07-13 12:32:09 +08:00
commit 8f10353f0c
135 changed files with 37786 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files
packaging/linux/README-LINUX.txt
+77
View File
@@ -0,0 +1,77 @@
StemDeck Linux Portable Alpha
=============================
This comes in two variants. Pick one:
- StemDeck-Linux-x64.tar.gz CPU-only (smaller; runs anywhere)
- StemDeck-Linux-x64.NVIDIA.tar.gz NVIDIA/CUDA (larger; much faster on an
NVIDIA GPU, falls back to CPU if no GPU)
Run
---
1. Extract the tarball, e.g.:
tar -xzf StemDeck-Linux-x64.tar.gz
2. Install the runtime prerequisites (see below).
3. Run the launcher:
cd StemDeck-Linux-x64 # or StemDeck-Linux-x64.NVIDIA
./StemDeck
4. Let first-run setup prepare local runtime assets.
Prerequisites
-------------
This portable package bundles its own Python runtime (torch + demucs), and
StemDeck downloads FFmpeg automatically on first launch (or uses a system
`ffmpeg` if one is already on your PATH). The only system libraries you need
are your distro's WebKitGTK + GTK, which the desktop shell links against.
Debian / Ubuntu:
sudo apt update
sudo apt install libwebkit2gtk-4.1-0 libgtk-3-0
Fedora:
sudo dnf install webkit2gtk4.1 gtk3
Arch:
sudo pacman -S webkit2gtk-4.1 gtk3
NVIDIA variant
--------------
To use the GPU you need a working NVIDIA driver on the host such that
`nvidia-smi` runs and reports your GPU.
Check your driver:
nvidia-smi
On first launch, the NVIDIA build detects your GPU and downloads the matching
CUDA-enabled PyTorch (a few GB) into your data directory — so the first run
needs an internet connection and some disk space. You do NOT need a separate
CUDA toolkit install, only the driver.
If no usable GPU is detected, the NVIDIA build still runs and falls back to CPU.
If you do not have an NVIDIA GPU, use the CPU-only tarball instead — it skips
the CUDA download entirely.
Notes
-----
- This is a portable folder, not a system package. No .desktop entry, service,
or package-manager integration is created.
- User data lives under $XDG_DATA_HOME/stemdeck (or ~/.local/share/stemdeck).
- Your stem library is written to ~/Documents/StemDeck/.
- Demucs model weights download from the backend on first use into the data
directory under models/.
Troubleshooting
---------------
- "./StemDeck: error while loading shared libraries" — install the WebKitGTK
and GTK packages listed above.
- A job failing immediately with an FFmpeg error — first-run setup downloads
FFmpeg automatically; check internet access and retry, or install a system
`ffmpeg` so `ffmpeg -version` works in your shell.
- If setup fails, check internet access and retry.
- Inspect logs under the data directory's logs/ folder.
- Deleting the data directory forces first-run setup to recreate runtime state.
packaging/linux/THIRD_PARTY_NOTICES.txt
+78
View File
@@ -0,0 +1,78 @@
THIRD-PARTY NOTICES
===================
StemDeck includes third-party open-source software. Each component is
copyrighted by its respective authors and distributed under its own license.
This starter notice is not a substitute for the full license inventory that
must be generated from the final packaged Python runtime before a public
release.
Bundled Components
------------------
Python
License: Python Software Foundation License
Website: https://www.python.org/
Tauri
License: MIT or Apache-2.0, depending on component
Website: https://tauri.app/
FastAPI
License: MIT
Website: https://fastapi.tiangolo.com/
Uvicorn
License: BSD
Website: https://www.uvicorn.org/
yt-dlp
License: Unlicense
Website: https://github.com/yt-dlp/yt-dlp
Demucs
License: MIT
Website: https://github.com/facebookresearch/demucs
PyTorch / Torch
License: BSD-style
Website: https://pytorch.org/
torchaudio
License: BSD-style
Website: https://pytorch.org/audio/
librosa
License: ISC
Website: https://librosa.org/
pyloudnorm
License: MIT
Website: https://github.com/csteinmetz1/pyloudnorm
soundfile
License: BSD
Website: https://github.com/bastibe/python-soundfile
System Requirements (Not Bundled)
---------------------------------
FFmpeg is not bundled in the Linux package. On first launch StemDeck downloads a
static FFmpeg build into your user data directory (or uses a system `ffmpeg`
already on your PATH). The download is fetched directly from the upstream
provider, not redistributed by StemDeck. FFmpeg may be distributed under LGPL or
GPL terms depending on how the build was compiled.
WebKitGTK and GTK shared libraries are provided by your Linux distribution and
are not bundled. They are distributed under LGPL terms.
Demucs model weights are not bundled. They are downloaded during first use.
StemDeck should display the model source and license/usage terms before or
during download.
Disclaimer
----------
This notice file is not legal advice. Before public release, verify the exact
licenses of every bundled package and generated binary artifact.
packaging/macos/README-macOS.txt
+31
View File
@@ -0,0 +1,31 @@
StemDeck for macOS
==================
Install:
1. Open the StemDeck DMG.
2. Drag StemDeck.app to Applications.
3. Open StemDeck from Applications.
First launch:
- StemDeck is a thin native app. It downloads a pinned, checksummed StemDeck
runtime pack on first launch.
- The runtime installs to:
~/Library/Application Support/StemDeck/runtime
- FFmpeg and ffprobe install to:
~/Library/Application Support/StemDeck/ffmpeg
- Demucs model weights download on first use and are cached under:
~/Library/Application Support/StemDeck/models
Uninstall:
1. Delete /Applications/StemDeck.app.
2. To remove runtime files, jobs, caches, models, and logs, delete:
~/Library/Application Support/StemDeck
Notes:
- Internet access is required for first-run setup.
- Public releases should be signed and notarized.
- Unsigned local builds are for development and internal testing only.
packaging/macos/THIRD_PARTY_NOTICES.txt
+20
View File
@@ -0,0 +1,20 @@
THIRD-PARTY NOTICES
===================
StemDeck for macOS uses a thin Tauri app plus a downloaded runtime pack.
Bundled in StemDeck.app:
- Tauri v2
- The system WebKit WebView provided by macOS
Downloaded during first-run setup:
- StemDeck runtime pack containing Python and Python package dependencies
- FFmpeg and ffprobe
- Demucs model weights
The runtime pack includes its own dependency inventory under
runtime/licenses/pip-list.json. Before public release, generate and include
full license texts for every packaged dependency and verify the exact FFmpeg
build license/provenance.
packaging/macos/dmg-background.svg
+32
View File
@@ -0,0 +1,32 @@
<svg xmlns="http://www.w3.org/2000/svg" width="660" height="400" viewBox="0 0 660 400">
<defs>
<linearGradient id="bg" x1="0" y1="0" x2="1" y2="1">
<stop offset="0" stop-color="#15222a"/>
<stop offset="0.55" stop-color="#071017"/>
<stop offset="1" stop-color="#141c22"/>
</linearGradient>
<radialGradient id="glow" cx="50%" cy="40%" r="55%">
<stop offset="0" stop-color="#f2b53f" stop-opacity="0.24"/>
<stop offset="0.48" stop-color="#2f8fb5" stop-opacity="0.10"/>
<stop offset="1" stop-color="#071017" stop-opacity="0"/>
</radialGradient>
<filter id="soft" x="-20%" y="-20%" width="140%" height="140%">
<feGaussianBlur stdDeviation="12"/>
</filter>
</defs>
<rect width="660" height="400" rx="0" fill="url(#bg)"/>
<rect width="660" height="400" fill="url(#glow)"/>
<g opacity="0.16" filter="url(#soft)">
<path d="M0 296 C 92 260, 146 328, 230 292 S 390 255, 474 296 S 602 335, 660 286" fill="none" stroke="#f0b33d" stroke-width="18"/>
<path d="M0 322 C 84 288, 156 350, 240 318 S 386 282, 478 320 S 594 352, 660 316" fill="none" stroke="#4aa7c7" stroke-width="12"/>
</g>
<g opacity="0.28">
<line x1="330" y1="122" x2="330" y2="242" stroke="#ffffff" stroke-width="1"/>
<path d="M300 196 L330 226 L360 196" fill="none" stroke="#ffffff" stroke-width="3" stroke-linecap="round" stroke-linejoin="round"/>
</g>
<text x="330" y="322" text-anchor="middle" font-family="-apple-system, BlinkMacSystemFont, Helvetica, Arial, sans-serif" font-size="16" font-weight="600" fill="#dce5e8">Drag StemDeck to Applications</text>
</svg>
Side by Side

After

Width:  |  Height:  |  Size: 1.6 KiB

packaging/windows/README-WINDOWS.txt
+25
View File
@@ -0,0 +1,25 @@
StemDeck Windows Portable Alpha
===============================
Run
---
1. Extract the zip folder.
2. Double-click StemDeck.exe.
3. Let first-run setup prepare local runtime assets.
Notes
-----
- This is a portable folder, not an installer.
- No Start Menu shortcut, service, or registry integration is created.
- Generated files stay under data/.
- FFmpeg is downloaded during first-run setup into data/ffmpeg/.
- Demucs model weights are downloaded by the backend on first use into data/models/.
Troubleshooting
---------------
- If setup fails, check internet access and retry.
- If a job fails, inspect data/jobs/ and data/logs/ when logs are added.
- Deleting data/ forces first-run setup to recreate runtime state.
packaging/windows/THIRD_PARTY_NOTICES.txt
+74
View File
@@ -0,0 +1,74 @@
THIRD-PARTY NOTICES
===================
StemDeck includes third-party open-source software. Each component is
copyrighted by its respective authors and distributed under its own license.
This starter notice is not a substitute for the full license inventory that
must be generated from the final packaged Python runtime before a public
release.
Bundled Components
------------------
Python
License: Python Software Foundation License
Website: https://www.python.org/
Tauri
License: MIT or Apache-2.0, depending on component
Website: https://tauri.app/
FastAPI
License: MIT
Website: https://fastapi.tiangolo.com/
Uvicorn
License: BSD
Website: https://www.uvicorn.org/
yt-dlp
License: Unlicense
Website: https://github.com/yt-dlp/yt-dlp
Demucs
License: MIT
Website: https://github.com/facebookresearch/demucs
PyTorch / Torch
License: BSD-style
Website: https://pytorch.org/
torchaudio
License: BSD-style
Website: https://pytorch.org/audio/
librosa
License: ISC
Website: https://librosa.org/
pyloudnorm
License: MIT
Website: https://github.com/csteinmetz1/pyloudnorm
soundfile
License: BSD
Website: https://github.com/bastibe/python-soundfile
Downloaded During First-Run Setup
---------------------------------
FFmpeg binaries are not bundled in the StemDeck alpha zip. They are downloaded
during first-run setup. FFmpeg builds may be distributed under LGPL or GPL
terms depending on how they are compiled. StemDeck should display the selected
FFmpeg build source and license before or during download.
Demucs model weights are not bundled in the StemDeck alpha zip. They are
downloaded during first use. StemDeck should display the model source and
license/usage terms before or during download.
Disclaimer
----------
This notice file is not legal advice. Before public release, verify the exact
licenses of every bundled package and generated binary artifact.