Beltr

Beltr is a self-hosted karaoke server that turns any song in your music library into a karaoke track.

  • Media Applications
  • Media Servers
  • Tools & Utilities
Beltr is a self-hosted karaoke server that turns any song in your music library into a karaoke track. It removes the vocals with a local AI model, finds synced lyrics online (or drafts them locally when no provider has the song), force-aligns them to the vocals word by word, and displays them on a TV while every phone in the room acts as a remote — guests scan the QR code on screen, no app to install. Everything runs on your server and nothing about your library is uploaded, so it suits homelabbers who want private karaoke from music they already own. This is the CPU build, which runs on any server with no GPU; if your box has an NVIDIA card or Intel graphics, install Beltr-NVIDIA or Beltr-Intel instead for much faster song processing.

Platform availability

Available on 4 of 10 platforms

  • Unraid
  • TrueNAS (not listed)
  • Umbrel (not listed)
  • ZimaOS (not listed)
  • Proxmox (not listed)
  • Helm (not listed)
  • Mac
  • Windows
  • Linux
  • Any server (not listed)

Health score?A 0-100 score computed nightly from four factors: maintained (40%: recent commits and steady activity), popular (25%: GitHub stars, log scale), easy to install (20%: platforms, install notes, setup guides, Docker image) and light to run (15%: minimum RAM, ARM support). When the source code has been checked, a fifth factor, security check (20%: automated scan for committed secrets, unsafe desktop-app settings, known-vulnerable dependencies and project hygiene; any serious finding caps it at 20), is added. Factors without data are left out and the rest are rescaled.

44/100 Fair

Maintained
70last commit 78 days ago
Popular
61 GitHub stars
Easy to install
654 install platforms, install notes, Docker image
Light to run
108 GB minimum RAM

Availability: platform listings confirmed today, links checked 23 days ago

GitHub stars
1
Open issues
0
Last commit
2026-09-04
Latest release
v1.72.0
Activity
stale

Checked 23 days ago - source: GitHub (CasaVargas/beltr-releases)

Resources & Compatibility

Minimum requirements: 8 GB RAM, 2 GB disk.

Checked 54 days ago - source: Docker Hub image tags and published docs

First-install notes

  • First run Beltr downloads about 2 GB of model weights into /cache the first time it needs them. That happens once and survives container updates as long as /cache stays mapped. Watch the container log if the first song seems to sit still — the download is what it's doing. source

Fetched 47 days ago - each note links to its source

Alternatives (9)

  • Kanto Karaoke - Kanto Karaoke is a smart and reliable tool karaoke player and karaoke recorder for Windows.
  • KaraFun - Transforms a Windows PC into an interactive karaoke system, supporting a wide range of audio and karaoke file formats, including a built-in…
  • Karaoke Mugen - Karaoke Mugen is a playlist manager and player for video and audio karaoke.
  • MidiCo Karaoke - MidiCo professional karaoke software for macOS allows you to host and manage a professional karaoke show.
  • Nightingale Karaoke - Nightingale scans your music folder, Jellyfin server, Navidrome server, or self-hosted web library; separates lead vocals from instrumental…
  • Smule - Join the global karaoke party!
  • UltraStar Deluxe - The free and open source karaoke singing game UltraStar Deluxe, inspired by Sony SingStar™
  • Videoke Pro - Videoke Pro is a web-based karaoke system that lets users queue songs directly from YouTube using one device, while projecting the performa…
  • Wondera - Karaoke and transform any songs in your AI voice.

Checked 54 days ago - source: AlternativeTo

Common questions

Which Beltr ports should I expose?

Expose 8477 for the dashboard and TV screen, and 8478 for the microphone page.

Do phone microphones need HTTPS?

Yes, browsers only allow microphones on a secure page. You can use the free Beltr Remote app for native capture, or put Beltr behind a reverse proxy with a certificate.

What permissions should the music bind mount have?

Mount your music read-only to /media and set PUID/PGID to the user that owns the media. On Unraid that is 99 and 100.

Why does the first song seem stuck?

Beltr downloads about 2 GB of model weights into /cache the first time it needs them. Watch the container log while that download is happening.

Which Docker image do I choose for my hardware?

Use latest for CPU, latest-cuda for NVIDIA GPUs with --gpus all, or latest-openvino for Intel iGPU or Arc with --device /dev/dri.

How can I avoid unwanted updates?

Use version tags to pin a release, such as a full release tag or a major-minor tag for the newest patch of that line. latest follows new releases.

Answers sourced from beltr.app, github.com

Community

Collected 43 days ago - public community threads