HomeDocsInstallation

Installation

Get Soundie running on your machine in under a minute.

Windows

Windows 10 / 11 — x64

Download and run the NSIS installer. WebView2 is bundled automatically — no extra setup needed.

Download for Windows →
terminal
bash
1# Download Soundie-Setup.exe from /download, then run it.
2# Or run it silently:
3Soundie-Setup.exe /S
4
5# Coming soon — winget
6winget install Soundie

Linux

Ubuntu, Debian, Fedora, RHEL — x64

Choose the package format for your distro. Both packages are built from the same binary.

Download for Linux →
terminal
bash
1# Debian / Ubuntu (.deb)
2sudo dpkg -i Soundie_1.class="token-number">2.1_amd64.deb
3sudo apt-get install -f # fix any missing deps
4
5# Fedora / RHEL (.rpm)
6sudo rpm -i Soundie-class="token-number">1.2.class="token-number">1-class="token-number">1.x86_64.rpm
7# or with dnf
8sudo dnf install ./Soundie-class="token-number">1.2.class="token-number">1-class="token-number">1.x86_64.rpm

Requires libwebkit2gtk-4.1. It is pulled in automatically by the package manager on supported distros.

Android

Android 10 or later — ARM64 & x86_64

Soundie is not on the Play Store — install via APK sideload. Enable Install from unknown sources in your device settings first.

Download for Android →
terminal
bash
1# Sideload via ADB (optional — you can also just tap the APK on device)
2adb install Soundie.apk
3
4# Verify it installed
5adb shell pm list packages | grep soundie

YouTube cookie: Optional on Android. Local files, SoundCloud, and other sources work without it. If you want YouTube playback, you can add a cookie in Settings → Sources → YouTube.

REST API & WebSocket RPC: Available on Android at http://127.0.0.1:45289 when the app is running — same endpoints as desktop.

Other Platforms

macOS

No confirmed timeline — depends on Apple Developer Program funding.

System Requirements

Windows
OSWindows 10 v1903 or later
CPUx64
RAM2 GB min
Disk~150 MB
RuntimeWebView2 (bundled)
Linux
DistroUbuntu 20.04+ / Fedora 36+
CPUx86_64
RAM2 GB min
Disk~150 MB
Runtimelibwebkit2gtk-4.1
Android
OSAndroid 10 or later
CPUARM64 or x86_64
RAM2 GB min
Disk~45 MB
AuthCookie optional

After Installation

Soundie starts a local server at http://127.0.0.1:45289 on launch — on all platforms, including Android. The REST API and WebSocket RPC are available immediately, no config needed.

terminal
bash
1# Check player state
2curl http://127.0.0.1:45289/player/state
3
4# Play / pause toggle
5curl -X POST http://127.0.0.1:45289/player/toggle
6
7# Connect WebSocket (wscat)
8wscat -c ws://127.0.0.1:45289

See the REST API docs and WebSocket RPC docs for the full reference.