A complete guide to RE-KORD — from installation to the Plectr rhythm game. Add screenshots to assets/images/ to replace the placeholders.
Step 1
Installation
Go to the Download page and pick the right package. If it's your first time, grab the Electron App — it includes everything (server, UI and yt-dlp) in a single file.
window
Windows: run the .exe installer and follow the wizard. RE-KORD launches automatically when done.
terminal
Linux AppImage: make it executable with chmod +x REKORD.AppImage and launch it directly. No installation required.
package_2
Linux .deb:sudo dpkg -i rekord.deb. RE-KORD will appear in your desktop application menu.
add_photo_alternate
Screenshot: welcome screen and library root selection on first launch
assets/images/tut-01-install.png
Library root: on first launch you'll be asked to choose your main music folder. You can change it any time from Settings → Library root. All account data is stored in .kord/ inside this folder.
Step 2
Library
The Library is the heart of RE-KORD. Browse by artist, genre and mood, search instantly with Ctrl+K, and manage tags, lyrics and artwork without leaving the app.
add_photo_alternate
Screenshot: Library view with artist and genre navigation
assets/images/tut-02-library.png
Edit metadata
Open any album or track sheet to edit title, artist, genre, year, mood, and paste synced LRC lyrics or plain text.
Smart shuffle
Exclude individual tracks, full albums or genres from shuffle. Exclusions are saved per profile and don't affect other accounts.
Favorites & playlists
Add tracks to favorites with one click. Create and reorder unlimited playlists for themed sessions or genre-based mixes.
Quality alerts
The Dashboard automatically flags albums without artwork, incomplete metadata and folders with loose tracks.
Step 3
Player & Visualizer
The player is persistent and stays active while you navigate the app. It handles queue, shuffle, repeat (off / all / one), volume and restores your session on next launch.
add_photo_alternate
Screenshot: player with bars visualizer and synced LRC lyrics panel
assets/images/tut-03-player.png
Visualizer modes: click the visualizer icon in the player bar to switch between bars, mirror, wave, smooth wave, H·M·B waves, signals and karaoke (syncs LRC lyrics in real time). DiscoWall is also part of the visualizer suite — a reactive color grid driven by audio energy and the Plectr chart. Best in fullscreen.
Crossfade: enable 3 s or 5 s crossfade between tracks from Settings.
Step 4
Studio
The Studio is RE-KORD's advanced workspace — a single screen with five tabs: guided listening, catalog discovery, downloads, metadata enrichment and cover art.
add_photo_alternate
Screenshot: Studio — Discover tab with local and web suggestions
assets/images/tut-04-studio.png
headphones
Listen: guided listening experience inside the Studio, with live queue, recent history and synced lyrics.
travel_explore
Discover: local catalog suggestions and web suggestions with preview and direct download into the library.
label
Metadata: automatic enrichment via MusicBrainz / iTunes, heuristic title cleanup, bulk scan and orphan metadata pruning.
image
Covers: search and apply artwork to album folders directly from the dedicated tab.
Step 5
Downloader (yt-dlp)
The Studio's Download tab uses yt-dlp — already bundled in the Server packages — to download music directly into your library.
add_photo_alternate
Screenshot: Studio — Download tab with progress bar
assets/images/tut-05-download.png
1
Open Studio → Download tab. Paste the URL of a track, playlist or channel.
2
Choose Classic UI (single URL, immediate) or Explore (advanced navigation of artists and playlists).
3
RE-KORD downloads in native AAC/Opus (m4a / webm) without ffmpeg. The file lands directly in your Music root folder.
YouTube cookies: for age-restricted content, supply a Netscape-format cookies file via Settings or the KORD_YTDLP_COOKIES environment variable.
Step 6
Plectr — Rhythm Game
Plectr turns any track in your library into a rhythm game. The chart is generated from the audio analysis of the song you're already listening to.
add_photo_alternate
Screenshot: Plectr in-game with notes, combo and score
assets/images/tut-06-plectr.png
Easy
Sparse notes, basic rhythm.
Normal
Denser chart, hold and swipe inputs.
Hard
Full chart from complete audio analysis.
Per-account records: each profile keeps its own records per track. Plectr syncs live with the player.
Step 7
LAN & Remote Access
RE-KORD Server listens on all network interfaces by default. Any device on the same Wi-Fi network can open the UI from a browser at http://<IP>:3001.
add_photo_alternate
Screenshot: Settings — LAN and Cloudflare tunnel section
assets/images/tut-08-network.png
router
LAN: works out of the box. Make sure your firewall allows traffic on port 3001.
cloud
Cloudflare Tunnel: from Settings, enable a public temporary URL (trycloudflare) or a stable named tunnel.
lock
To restrict access to localhost only, set KORD_LISTEN_HOST=127.0.0.1 before starting the server.
Step 8
Local Profiles & Backup
RE-KORD supports multiple local accounts on the same machine. Each profile has its own favorites, playlists, stats, Plectr records and shuffle exclusions, stored in MUSIC_ROOT/.kord/.
add_photo_alternate
Screenshot: profile selection and account management screen
assets/images/tut-09-profiles.png
Backup: go to Settings → Backup to export a ZIP archive containing all settings and the state of every profile.
All clear?
Download RE-KORD and put this into practice. Found something that doesn't work? Open an issue on GitHub.