Your music. Your server. Your rules.
A self-hosted music hub that turns a folder of audio files into a complete listening, curation and play experience, on your disk, on your network, under your control.

re-kord.com · r/RE_KORD · User guide · Downloads

RE-KORD is not a cloud service. Point it at your music folder and it becomes your personal music server: a fast library with rich metadata, a serious player with visualizers and synced lyrics, studio tools to grow and tidy your collection, and a rhythm game generated from your own tracks. Everything stays on your machine, and every device on your network can join in: desktop apps for Linux and Windows, an Android app, and any web browser.

RE-KORD 5 is a complete rewrite: a Rust hub, a Svelte client and Tauri apps replace the legacy React / Node / Electron app. It is faster and lighter, and it keeps your data: the first scan of your existing library imports everything automatically.

Home: Smart Radio, instant playlists, library health	Album page with genres, trivia and editing
Studio › Listen: synced lyrics and visualizers	Sonic Nebula: your library as a galaxy
Studio: discover, download, metadata, covers	Plectr: a rhythm game from any track

Listen

• Persistent player with queue, repeat, crossfade and near-gapless playback.
• Smart shuffle and Smart Radio built from moods, genres and your history; block tracks or whole albums from shuffle.
• Synced LRC lyrics with one-click Auto LRC and a karaoke mode.
• Eight visualizers, including DiscoWall; sleep timer with a 30-second fade-out.
• Google Cast from the Android app and from Chrome; lock-screen, notification and headset controls, and native media controls (MPRIS) on Linux.
• Instant playlist from genres and moods, with live track counts.
• Podcasts & news (optional module): RSS feeds, radio news such as RTL 102.5's Giornale Orario and live radio, in the same player, with resume and "listened" marks.

Library

• Folder-first indexing (Artist/Album/track) with automatic layout detection and a filesystem watcher; embedded tags and covers from FLAC, MP3, M4A, Ogg/Opus, WAV, AIFF, WMA and WebM fill in what you have not edited (titles, artists, genres, dates, track/disc numbers, BPM, lyrics, artwork).
• Browse by artist, genre or one of 14 personal moods; instant accent-insensitive search.
• Sonic Nebula: explore your library as a galaxy laid out by tempo and energy.
• Quality alerts for missing covers and metadata, with a "To fix" list that opens the right editor for each item; safe rescans that never wipe a library when a disk is unplugged.

Studio

• Discover new releases from artists you own, with 30-second previews.
• Download from YouTube Music, SoundCloud or Bandcamp with the bundled, self-updating yt-dlp and its JavaScript engine (QuickJS, or Deno/Node.js if installed): files arrive with tags and a square cover, "In library" badges flag what you already have, and YouTube cookies unlock age-restricted songs.
• Metadata from Discogs, MusicBrainz, iTunes, Deezer and TheAudioDB; title cleanup; web trivia about artists and albums; cover search and upload.
• Hand-edited values are protected from every rescan and fetch.
• Downloading a release you already have? The dialog lists the tracks your folder is missing and fetches only those.

Plectr

• A four-lane rhythm game charted on the fly from your tracks: three difficulties, hold notes, combos, grades, per-song records, latency calibration.

Statistics and achievements

• Top tracks, artists, albums and genres by plays, favorites, blocks and Plectr scores.
• XP, levels, ten ranks from KICKER to KING OF RE-KORD, listening streaks (synced across your devices) and 65 badges, each showing how far you are and what comes next.

Make it yours

• 17 theme presets plus a custom theme: your colors, a background image or animated GIF, colors extracted from the picture, your own text color, adjustable glass. Export a theme and share it.
• Adjustable content and player-bar width on wide screens.
• Switch Sonic Nebula, the visualizer or Plectr off per account if you do not want them.

Anywhere

• LAN access out of the box, with QR pairing for the Android app.
• One-click Cloudflare tunnel for listening away from home, with HTTPS and a QR code.
• Optional access key for hubs reached from outside (tunnel, reverse proxy): one shared key, set from the admin panel or REKORD_ACCESS_KEY, asked once per device.
• Installable web app (PWA) over HTTPS.
• Keep the hub awake: stop the server PC from sleeping, always or only while in use.

Multi-profile

• Several accounts on one hub, each with its own library selection, favorites, playlists, moods, theme, statistics and records. Full backup and restore.

Languages

• Italian, English and German.

Download from GitHub Releases or re-kord.com.

Every desktop download comes in two flavors:

• Server: the app plus the hub, with yt-dlp, cloudflared and ffmpeg bundled. Install it on the computer that holds your music. It is all you need on that machine, and every other device can connect to it.
• Client: the app only. Install it on other computers to connect to your hub.

curl -O https://raw.githubusercontent.com/Creiv/RE-KORD/main/docker-compose.yml
REKORD_MUSIC_HOST=/path/to/Music docker compose up -d

Compose pulls the published image ghcr.io/creiv/re-kord (amd64/arm64). The hub listens on port 7420; data lives in ./docker-data/data. See install.md.

tar -xzf RE-KORD-Server-<v>-linux-x64-headless.tar.gz && cd RE-KORD-Server-<v>-linux-x64-headless
sudo ./systemd/install.sh          # user "rekord", program in /opt/rekord, data in /var/lib/rekord
sudoedit /etc/default/rekord-server

Full instructions per platform, firewall notes and data locations: docs/install.md.

1. Start the hub. Launch RE-KORD Server (or the headless hub, or Docker).
2. Choose your library. Open the admin panel at http://localhost:7420/admin, go to Library › Music folder, enter the path to your music and choose Save path. The scan starts; RE-KORD expects Artist/Album/track and detects other layouts (Analyse folders).
3. Listen. Open the RE-KORD window, or http://localhost:7420/ in a browser.
4. Connect your devices. On a phone, install the Android app and tap Scan the QR: the code is in the admin panel under Network › Local network access. Other computers use the Client app or a browser at http://<hub-ip>:7420/.
5. Away from home? Network › Access from outside › Start tunnel gives you a temporary HTTPS address and a QR code.

The user guide covers every view and feature.

Long VBR MP3s (DJ sets, rips without a Xing header) get an exact duration and accurate seeking. Details: docs/supported-formats.md.

Coming from the Electron / Node app (versions up to 4.4 and the legacy 5.0)? Your data is imported automatically on the first scan of the same music folder. Note that the port changes from 3001 to 7420, the hub has a new data folder, and on Android the old app must be uninstalled first because the signing key changed. Read docs/upgrading-from-legacy.md before you switch.

flowchart LR
  subgraph Clients
    Browser["Browser / PWA"]
    Desktop["Desktop app (Tauri)"]
    Android["Android app (Tauri)"]
  end
  subgraph Hub["Hub (rekord-server or RE-KORD Server)"]
    API["/api/v1 + /media"]
    DB[("SQLite")]
    Tools["ffmpeg · yt-dlp · cloudflared"]
  end
  Music[("Music folder")]
  Browser & Desktop & Android --> API
  API --- DB
  API --- Music
  API --- Tools
  Cast["Chromecast"] --> API

More in docs/architecture.md.

corepack enable && pnpm install
pnpm build:ui            # client and admin panel
pnpm run server          # hub on :7420
pnpm dev:client-ui       # client with hot reload on :7422
pnpm dev:client          # desktop shell
pnpm test && pnpm check  # tests and type checks
pnpm pack:linux:server   # packages (Docker builder)

Requires Rust stable, Node 20+, pnpm 9 and, for the desktop shell, the Tauri 2 system libraries. See docs/development.md and CONTRIBUTING.md.

RE-KORD ships in Italian, English and German, and every string must exist in all three. To improve a translation or add a language, read docs/TRANSLATIONS.md.

All documentation is indexed in docs/README.md: user guide, installation, upgrading, deployment, architecture, API, Android, development.

• 6.0: macOS packages (Server and Client, unsigned: right-click › Open on first launch), an OpenSubsonic-compatible API so existing third-party players can connect, the split of the hub's API module, and the removal of the legacy /api/* aliases.
• Later, no timeline: a native iOS app in Swift. On iPhone and iPad today, use the web app over the tunnel (Safari › Add to Home Screen). Also on the list: ReplayGain and an equalizer, smart playlists, several music folders.
• Help wanted: both Apple targets need a contributor with a Mac. The packages will be unsigned and published on GitHub only, never through the Apple stores. See issue #104.

• Website: re-kord.com
• Reddit: r/RE_KORD
• Bugs and feature requests: GitHub issues
• Security issues: see SECURITY.md
• Release history: CHANGELOG.md

• Created and maintained by Creiv.
• German translation by @knoellix (PR #93); the long-MP3 duration fixes were inspired by his PR #95.
• Optional access key by @mrsalvaa (PR #102).
• Built on Tauri, Svelte, axum, SQLite and lofty; the Server packages bundle yt-dlp, cloudflared and FFmpeg (LGPL build).

RE-KORD and its authors are not responsible for what users download, import or manage. Each user is solely responsible for complying with copyright and local law. Use only content you have the rights or permission to use.