selfhost.directory

The index of self-hostable projects — ranked, categorized and served with live updates.
Own your data and stop giving it to big tech.

GitHub
FeedBack logo

Self-host FeedBack

vst-linux-v1

Self-hosted song library and highway viewer

BetaOpen SourceAGPL-3.0
Updated17 hours ago
LanguageJavaScript
Setup difficultyModerate
Stars
183
Port
8000 (HTTP/WebSocket server)
Install with Docker Compose

What is FeedBack?

FeedBack is a self-hosted web application built with FastAPI that serves as a song library manager and highway viewer for rhythm practice tools. It organizes custom songs (in feedpak/sloppak and loose-folder formats), provides a scrolling note highway visualization via WebSocket, enriches metadata from MusicBrainz and Cover Art Archive, and supports playlists, loops, artist pages, and practice statistics. The app runs in Docker on port 8000, mounts a user's song library folder, and persists config and cache in a Docker volume. It includes a plugin system that loads community sources like CustomsForge and Ultimate Guitar. Licensed under AGPL-3.0-only.

Should you self-host FeedBack?

FeedBack scores 43/100 on selfhost.directory (how scoring works) and ranks #25 of 31 in Music. It has 183 GitHub stars.

It shipped 4 stable releases in the past year. The latest, vst-linux-v1, came out on 22 July 2026.

Setup is moderate: expect some configuration beyond a single command. It is AGPL-3.0-licensed and written mostly in JavaScript.

Its closest alternative on selfhost.directory is Beets (77/100, 15 860 stars). It scores higher overall, so compare the two before you pick. See FeedBack vs Beets side by side.

Features

  • Artist pages and aliases
  • Audio fingerprintingOpt-in, default OFF
  • Background library scanning
  • Cover art fetching
  • Demo Mode
  • Loop practice
  • Multiple tuning support
  • MusicBrainz metadata enrichment
  • Note highway viewer
  • Playlists and custom covers
  • Plugin System
  • Practice statistics and XP
  • Song library management

How to install FeedBack

Install FeedBack with Docker Compose

Environment variables
DLC_DIR, CONFIG_DIR, STATIC_DIR, PYTHONPATH, LOG_LEVEL, LOG_FORMAT, LOG_FILE

services: web: build: . ports: - "8000:8000" volumes: # Mount your song library folder (adjust path for your system) - ${LIBRARY_PATH:-./library}:/dlc # Persistent config and cache - feedBack-config:/config # Mount source for live reload during development - ./static:/app/static - ./server.py:/app/server.py - ./VERSION:/app/VERSION - ./ug_browser.py:/app/ug_browser.py - ./lib:/app/lib - ./plugins:/app/plugins - ./.git:/app/.git:ro environment: - PYTHONPATH=/app/lib:/app - DLC_DIR=/dlc - CONFIG_DIR=/config # Write note_detect recordings to the host-visible bind mount (./static) # rather than the /config Docker volume: recorded takes (and training # bundles) then land in static/note_detect_recordings/ on the host, where # the offline harness can read them directly. - STATIC_DIR=/app/static # Logging (optional) # - LOG_LEVEL=DEBUG # DEBUG | INFO | WARNING | ERROR (default: INFO) # - LOG_FORMAT=json # json | text (default: text — coloured console) # - LOG_FILE=/config/feedBack.log # also write to a persistent file dns: - 8.8.8.8 - 1.1.1.1

volumes: feedBack-config:

Mount your song library folder at LIBRARY_PATH

How to configure FeedBack

  • CONFIG_DIRPersistent config and cache directory (mounted at /config)

    Persistent config and cache directory (mounted at /config)

  • DLC_DIR./libraryPath to song library folder (mounted at /dlc in container)

    Path to song library folder (mounted at /dlc in container)

  • LOG_FILEOptional persistent log file path

    Optional persistent log file path

  • LOG_FORMATtextLog output format

    Log output format

    values: json | text

  • LOG_LEVELINFOLogging level

    Logging level

    values: DEBUG | INFO | WARNING | ERROR

  • PYTHONPATH/app/lib:/appPython module search path

    Python module search path

  • STATIC_DIR/app/staticStatic files directory for recordings and assets

    Static files directory for recordings and assets

FeedBack releases & version history

More in Audio

Rate this project

Click to rate — no account needed.

0 comments

Posting as guest
Loading comments…