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 verify the installer 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_0.class="token-number">1.0_amd64.deb
3sudo apt-get install -f # fix any missing deps
4
5# Fedora / RHEL (.rpm)
6sudo rpm -i Soundie-class="token-number">0.1.class="token-number">0-class="token-number">1.x86_64.rpm
7# or with dnf
8sudo dnf install ./Soundie-class="token-number">0.1.class="token-number">0-class="token-number">1.x86_64.rpm
Requires libwebkit2gtk-4.1. It is pulled in automatically by the package manager on supported distros.
Other Platforms
macOS
Planned for v0.2.0 — Apple Silicon & Intel builds
Android
Mobile companion app in early planning
System Requirements
Windows
| OS | Windows 10 v1903 (build 18362) or later |
| CPU | x64 |
| RAM | 2 GB min, 4 GB recommended |
| Disk | ~150 MB installed |
| Runtime | WebView2 (bundled with installer) |
Linux
| Distro | Ubuntu 20.04+ / Fedora 36+ (or equivalent) |
| CPU | x86_64 |
| RAM | 2 GB min, 4 GB recommended |
| Disk | ~150 MB installed |
| Runtime | libwebkit2gtk-4.1 (auto-installed) |
After Installation
Soundie starts a local server at http://127.0.0.1:45289 on launch. 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.