whatisgithub

What is flux-player-x?

denisvargaeu/flux-player-x — explained in plain English

Analysis updated 2026-05-18

1TypeScriptAudience · developerComplexity · 3/5LicenseSetup · moderate

In one sentence

A modern web interface for controlling a Music Player Daemon (MPD) server, with playlists, an equalizer, and song uploads from your browser.

Mindmap

mindmap
  root((Resonix))
    What it does
      Web player for MPD
      Browse library
      Manage playlists
      Upload songs
    Tech stack
      React
      TypeScript
      Node.js
      SQLite
    Use cases
      Control home music server
      Stream internet radio
      Adjust equalizer
      Show fullscreen cover art
    Audience
      MPD server owners
      Home media enthusiasts

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Control an existing MPD music server from a phone or laptop browser.

USE CASE 2

Upload new songs to your MPD library by dragging files into the browser.

USE CASE 3

Adjust playback with a 10-band equalizer and genre presets.

USE CASE 4

Display a fullscreen now-playing screen with album art on a spare screen or tablet.

What is it built with?

ReactTypeScriptNode.jsExpressSQLite

How does it compare?

denisvargaeu/flux-player-x0xkinno/neuralvault0xmayurrr/ai-contractauditor
Stars111
LanguageTypeScriptTypeScriptTypeScript
Setup difficultymoderatehardeasy
Complexity3/54/52/5
Audiencedeveloperdeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 30min

Requires a running MPD server plus separate backend and frontend installation steps, or Docker Compose.

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

So what is it?

Resonix is a web-based music player, called Flux Player X in this repository, built for Music Player Daemon, or MPD, a program that plays music on a server or home computer. Instead of using MPD's usual command-line tools, Resonix gives you a modern browser interface with a Material Design 3 look that you can use from any device on your network. The player covers the basics you would expect: play, pause, skip, and reordering the queue by drag and drop, plus browsing your library by artist, album, genre, or song with search. On top of that it adds features like managing playlists, marking favorite songs, streaming internet radio stations, and uploading new songs straight into your MPD music folder by dragging them into the browser. There is also a 10-band equalizer with genre presets, automatic extraction of album cover art from MP3 and FLAC files, and a fullscreen screensaver mode that shows the cover art and song info. Other touches include crossfade and gapless playback for smooth transitions between tracks, a sleep timer that stops playback after a set time, light and dark themes with several accent colors, and support for both Slovak and English interfaces. It also works on desktop, tablet, and mobile screens, and has keyboard shortcuts for common actions like play or pause and volume control. Under the hood, the frontend is built with React, TypeScript, and Tailwind CSS, while the backend uses Node.js with Express and a SQLite database to talk to MPD over its network protocol. Setup requires Node.js version 18 or newer and an existing MPD server, with separate installation steps for the backend and frontend, or you can run everything with Docker Compose instead.

Copy-paste prompts

Prompt 1
Walk me through setting up Resonix with an existing MPD server using Docker Compose.
Prompt 2
Explain how the backend and frontend of Resonix talk to each other over WebSocket.
Prompt 3
Show me how to configure the MPD_HOST and MPD_PORT environment variables for Resonix.
Prompt 4
How do I add a custom equalizer preset in Resonix?
Prompt 5
Help me deploy the Resonix frontend build behind nginx.

Frequently asked questions

What is flux-player-x?

A modern web interface for controlling a Music Player Daemon (MPD) server, with playlists, an equalizer, and song uploads from your browser.

What language is flux-player-x written in?

Mainly TypeScript. The stack also includes React, TypeScript, Node.js.

What license does flux-player-x use?

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

How hard is flux-player-x to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is flux-player-x for?

Mainly developer.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.