foobar2k-artwork

foobar2k-artwork is a web interface built on top of beefweb plugin APIs.

It can display current artwork with basic playback and volume controls.

When foobar2000 is not playing, foobar2k-artwork can display images of your selection.

Now YouTube Music is also supported. This project may be renamed soon.

Demo

See it in action. TO BE UPDATED - button action is removed.

Installation

1. You need to have foobar2000 & beefweb plugin installed and configured.

2. Clone the repository.

3. Put images inside placeholders folder, these images will be displayed when foobar2000 is not playing.

4. Modify the placeholder section inside index.html.

5. Modify the beefweb_upstream endpoint inside nginx.conf, pointing to your beefweb API ip.

6. $ make build to build a docker image.

7. $ make run to run the docker image.

8. $ make stop to stop the running docker image.

9. # make enable to enable the systemd unit file of the docker image.

10. Open the web interface at your 8080 port.

Usage

Setup your beefweb or ytmDesktop API server and modify API endpoints in index.html and then build & run the docker image.

Miscellaneous

1. This project is a pure frontend webpage, it contains a nginx reverse proxy just to bypass the CORS limitation of web browsers.

2. beefweb plugin provides authentication to protect it's web UI and APIs. It's not supported by foobar2k-artwork yet.

3. YouTube Music is support via ytmDesktop, enable the remote control server without password.

License

Copyright © 2021 Ash Wu.
This project is MIT licensed.