Skip to content

A simple Flask & Python 🐍 local web-app 🕸️ to display GMusicBrowser current song 🎶 in full screen of your web-browser. Experiment but stable and used daily since 2018! I love it when I'm cooking or having guests!

License

Notifications You must be signed in to change notification settings

Naereen/GMusicBrowser-FullScreen-WebApp

Repository files navigation

Full Screen mode for GMusicBrowser

This program is a simple web app that connects to the GMusicBrowser API to display in white-on-black and very large font the current song played by my favorite music player. It allows to change to the next and prev song.

Why?

When I host some friends, and use my laptop to play music, and I don't want my screen to show anything but the name of the song, and my friends should only be able to go to the next song, not read my email or whatever: putting this webpage in full screen helps!

Also, it is displayed in very large font, to be easily readable from anywhere in the room.

Screenshot

screenshots/demo1.png

How to install

  • Install Python, preferably version 3, and pip,
  • Install requests and Flask modules with pip:
sudo pip3 install -U requests flask
  • Clone this project,
cd ~/publis/
git clone https://github.com/Naereen/GMusicBrowser-FullScreen-WebApp.git
  • Save it somewhere, for instance ~/publis/GMusicBrowser-FullScreen-WebApp.git,
  • When you want to use it, go in the folder, and do make.

Note: you can also use this .desktop file to install this as a desktop application:

$ desktop-file-validate gmusicbrowser-fullscreen-webapp.desktop
# if this is OK, install it
$ sudo desktop-file-install gmusicbrowser-fullscreen-webapp.desktop

Then the application will be available from your desktop menu, under the name "Full screen mode for GMusicBrowser".

Settings

In GMusicBrowser settings, under the tab "Plugins", enable the "Current song" plugin, and use these two values for the two text boxes:

  • Command to run when the song starts: /home/lilian/publis/GMusicBrowser-FullScreen-WebApp.git/update_ui.py start %t %a %l %y %d %n %f %c

  • Command to run when the song stops: /home/lilian/publis/GMusicBrowser-FullScreen-WebApp.git/update_ui.py stop %t %a %l %y %d %n %f %c

Of course, adapt the path to where you downloaded and saved gmusicbrowser_fullscreen_info.

Interactive demo

This short (15s) video shows how to do that:

screenshots/demo2.gif

How to use

  • Launching the app also opens it in Chromium (by default).
  • Use 'n' to play next song, 'p' for previous song, 'space' to pause, 'u' and 'd' to increase and decrease volume (needs this script somewhere in your PATH).

This is a very minimalist interface to GMusicBrowser, any other manipulation still have to be done from the main GMusicBrowser interface, of course!

Interactive demo

This other video (30s) shows how to do that:

screenshots/demo3.gif

It shows a nice "fireworks" effects that appears on the page for each click and each action (either a click on a button or a shortcut). It is coded with this script, which uses the awesome anime.js project by @juliangarnier (see on GitHub), but I disabled it as I was tired of it. You can enable it again by uncommenting the lines 198-200 on the template file: template.html.


📜 License ? GitHub license

MIT Licensed (file LICENSE). © Lilian Besson, 2018-2021.

Maintenance Ask Me Anything ! Made with Python v3.4+ Made with Bash v4.4+

ForTheBadge built-with-swag ForTheBadge uses-badges ForTheBadge uses-git ForTheBadge uses-css ForTheBadge uses-html ForTheBadge uses-js

About

A simple Flask & Python 🐍 local web-app 🕸️ to display GMusicBrowser current song 🎶 in full screen of your web-browser. Experiment but stable and used daily since 2018! I love it when I'm cooking or having guests!

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published