# Beltr

Beltr is a self-hosted karaoke server that turns any song in your music library into a karaoke track. It is open source and self-hosted, installable on Unraid.

Canonical page: https://ourlocalhost.com/app/2652/beltr

## Description

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, Mac, Windows, Linux.

## Desktop and other devices

Mac, Windows, Linux.

## Health score

44/100 (Fair), based on 4 of 4 factors.
- Maintained: 70 (last commit 78 days ago)
- Popular: 6 (1 GitHub stars)
- Easy to install: 65 (4 install platforms, install notes, Docker image)
- Light to run: 10 (8 GB minimum RAM)

## Links

- GitHub: https://github.com/CasaVargas/beltr-releases
- Documentation: https://beltr.app/selfhost
- desktop: https://github.com/CasaVargas/beltr-releases/releases/latest
- Official website: https://beltr.app
- Unraid: https://ca.unraid.net/apps/beltr-1hyfxhs1fd6kec?q=Beltr

## 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.

## Alternatives

- 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.

---
Source: Our Local Host (https://ourlocalhost.com/app/2652/beltr), the self-hosted and open-source app directory.
