Skip to content
Web interface plugin for DeaDBeeF and foobar2000 players
Branch: master
Clone or download
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
docs
js
scripts scripts/install/foobar2000.cmd: update foobar2000 versions Apr 14, 2019
server
.gitignore js/client: rename ApiClient to PlayerClient Aug 18, 2018
.travis.yml
LICENSE Happy new year :-) Jan 1, 2019
README.md README.md: add note about browser support Sep 17, 2018
appveyor.yml use RelWithDebInfo build type for CI builds Aug 24, 2018

README.md

beefweb

Web interface plugin for DeaDBeeF and foobar2000 music players.

License Build Status - Travis Build Status - AppVeyor

Features

  • Lightweight web user interface
  • Playback control
  • Playlist management
  • Music directory browser
  • Real-time UI updates
  • Mobile-friendly responsive design
  • REST-like API for controlling player from your application

Browser support

  • Any recent browser should work
  • Due to high development effort required Internet Explorer of any version is not supported

Downloads

Check out releases section. If you want to try development builds instead you could download them here. Choose latest available date and pick the file specific to your CPU architecture.

How to install

DeaDBeeF

Unpack ddb_beefweb-*.tar.gz to $HOME/.local/lib/deadbeef.

foobar2000

Open foo_beefweb-*.fb2k-component with foobar2000, you will be asked to install the plugin.

How to use

Point your browser to http://localhost:8880 and enjoy your web interface.

If you've enabled remote connections on plugin configuration screen you'll be able to connect from remote machines as well.

To allow browsing and adding files via web interface specify music directories in plugin configuration screen. For DeaDBeeF multiple music directories should be separated with ;.

Screenshots

Main web interface on Linux

Configuration screen for DeaDBeeF

Main web interface on Windows

Configuration screen for foobar2000

How to build

DeaDBeeF

Beefweb has two distinctive parts: server plugin and web user interface. To build server you'll need a descent C++ compiler such as gcc or clang and a recent version of cmake. To build web UI you'll need node runtime and yarn package manager.

The following command will build server, ui and .tar.gz package:

$ scripts/build.sh --all --release

Get ddb_beefweb-*.tar.gz from build/release directory.

You could also build debug version by switching --release to --debug.

foobar2000

You'll need to install Visual Studio (currently tested with VS2015 Community). The following programs should be installed in addition: node runtime, yarn package manager, cmake build system, 7z archiver and curl HTTP client. These programs should be available in PATH.

Open Visual Studio command prompt, navigate to project directory, run the following command:

> msbuild scripts\build.proj /p:Configuration=Release

Get foo_beefweb-*.fb2k-component from build\release directory.

You could also build debug version by switching /p:Configuration=Release to /p:Configuration=Debug

HTTP API

Swagger API definition is available.

You can’t perform that action at this time.