Skip to content

hyperblast/beefweb

Repository files navigation

beefweb

Web interface plugin for DeaDBeeF and foobar2000 music players.

License Build Status

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.

How to install

DeaDBeeF

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

Alternatively if you use universal deadbeef-static_*.deb package you can install matching universal deb of beefweb:

$ sudo dpkg -i deadbeef-beefweb_*.deb

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

See advanced configuration guide to unlock hidden developer features.

Donations

If you like this project feel free to donate. Any amount is appreciated.

Peer projects

beefweb_dotnet project provides command line client as well as client library for .NET.

Screenshots

Main web interface on Linux

Configuration screen for DeaDBeeF

Main web interface on Windows

Configuration screen for foobar2000

How to build

See building instructions.

HTTP API

Swagger API definition is available.