desktop_windows

Electron App

Server + UI in a single installer. The fastest way to get started: install, point it at your music folder, listen.

dns

Server

Backend only, with yt-dlp bundled. Ideal on a NAS or headless machine — any browser on the network becomes the client.

laptop

Client

UI only. Connects to an existing RE-KORD Server on the network — great on a second PC, laptop or tablet.

Windows

x64 10 / 11

Best built natively on Windows for optimal results.

RE-KORD Server

Headless process with yt-dlp bundled. Start it, then open the UI from any browser on the network.

v3.2

ZIP archive · Windows 10/11 x64

RE-KORD Client

Electron UI only. Point it at an existing RE-KORD Server on the network to start listening.

v3.2

.exe installer · Windows 10/11 x64

Linux

x64 Ubuntu 22.04+ · Debian · Fedora

Portable AppImage or .deb package with system integration.

RE-KORD App

Full Electron app for Linux desktop. Launch, set your library root, start listening.

v3.2

AppImage / .deb · x64

RE-KORD Server

Headless backend with yt-dlp. Can be set up as a systemd service for auto-start on boot.

v3.2

AppImage / .deb · includes systemd unit

RE-KORD Client

Electron UI only for Linux. Connect to a RE-KORD Server on the local network or via Cloudflare.

v3.2

AppImage / .deb · x64

Linux tip: on some distributions you may need to disable the Electron sandbox. If launch fails, try ELECTRON_DISABLE_SANDBOX=1 ./rekord.AppImage.

macOS

Coming soon

macOS support is planned for a future release — Universal binary for Apple Silicon and Intel.

RE-KORD App

Universal binary .dmg · Apple Silicon + Intel.

Soon

Not yet available

RE-KORD Server

Headless server for macOS.

Soon

Not yet available

RE-KORD Client

Remote client for macOS.

Soon

Not yet available

Build from source

RE-KORD only needs Node.js LTS and a folder of audio files. No heavy dependencies.

terminal

Quick start (dev)

Three commands to run RE-KORD from source.

# clone and install
git clone https://github.com/Creiv/KORD
cd KORD && npm install
# start dev (browser)
npm run dev
# or with Electron
npm run dev:app
checklist

System requirements

  • desktop_windows

    App / Client

    4 GB RAM recommended · 300 MB disk space · TCP port 3001 available

  • dns

    Server

    2 GB RAM · 200 MB disk space · yt-dlp already included in the package

  • code

    Development

    Recent Node.js LTS · npm · a folder of audio files for testing