{"id":17662780,"url":"https://github.com/naereen/gmusicbrowser-fullscreen-webapp","last_synced_at":"2025-03-30T11:41:26.086Z","repository":{"id":94051896,"uuid":"117096548","full_name":"Naereen/GMusicBrowser-FullScreen-WebApp","owner":"Naereen","description":"A simple Flask \u0026 Python :snake: local web-app :spider_web: to display GMusicBrowser current song :notes: 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!","archived":false,"fork":false,"pushed_at":"2021-03-13T16:38:24.000Z","size":4037,"stargazers_count":2,"open_issues_count":0,"forks_count":1,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-02-05T13:34:21.885Z","etag":null,"topics":["flask-application","fullscreen-mode","gmusicbrowser","music-player-client","python3"],"latest_commit_sha":null,"homepage":"https://naereen.github.io/GMusicBrowser-FullScreen-WebApp/","language":"HTML","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Naereen.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2018-01-11T12:20:26.000Z","updated_at":"2021-03-13T16:38:26.000Z","dependencies_parsed_at":"2023-03-13T17:07:55.616Z","dependency_job_id":null,"html_url":"https://github.com/Naereen/GMusicBrowser-FullScreen-WebApp","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Naereen%2FGMusicBrowser-FullScreen-WebApp","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Naereen%2FGMusicBrowser-FullScreen-WebApp/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Naereen%2FGMusicBrowser-FullScreen-WebApp/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Naereen%2FGMusicBrowser-FullScreen-WebApp/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Naereen","download_url":"https://codeload.github.com/Naereen/GMusicBrowser-FullScreen-WebApp/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":246314127,"owners_count":20757457,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["flask-application","fullscreen-mode","gmusicbrowser","music-player-client","python3"],"created_at":"2024-10-23T18:23:34.089Z","updated_at":"2025-03-30T11:41:26.066Z","avatar_url":"https://github.com/Naereen.png","language":"HTML","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Full Screen mode for [GMusicBrowser](http://gmusicbrowser.org/)\n\nThis 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.\nIt allows to change to the next and prev song.\n\n## Why?\n\u003e 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!\n\n\u003e Also, it is displayed in very large font, to be easily readable from anywhere in the room.\n\n## Screenshot\n![screenshots/demo1.png](screenshots/demo1.png)\n\n## How to install\n- Install Python, preferably version 3, and pip,\n- Install requests and Flask modules with `pip`:\n```bash\nsudo pip3 install -U requests flask\n```\n- Clone this project,\n```bash\ncd ~/publis/\ngit clone https://github.com/Naereen/GMusicBrowser-FullScreen-WebApp.git\n```\n- Save it somewhere, for instance `~/publis/GMusicBrowser-FullScreen-WebApp.git`,\n- When you want to use it, go in the folder, and do `make`.\n\nNote: you can also use [this .desktop file](gmusicbrowser-fullscreen-webapp.desktop) to install this as a desktop application:\n\n```bash\n$ desktop-file-validate gmusicbrowser-fullscreen-webapp.desktop\n# if this is OK, install it\n$ sudo desktop-file-install gmusicbrowser-fullscreen-webapp.desktop\n```\n\nThen the application will be available from your desktop menu, under the name \"Full screen mode for GMusicBrowser\".\n\n## Settings\nIn GMusicBrowser settings, under the tab \"Plugins\", enable the \"Current song\" plugin,\nand use these two values for the two text boxes:\n\n- Command to run when the song starts:\n  `/home/lilian/publis/GMusicBrowser-FullScreen-WebApp.git/update_ui.py start %t %a %l %y %d %n %f %c`\n\n- Command to run when the song stops:\n  `/home/lilian/publis/GMusicBrowser-FullScreen-WebApp.git/update_ui.py stop %t %a %l %y %d %n %f %c`\n\nOf course, adapt the path to where you downloaded and saved `gmusicbrowser_fullscreen_info`.\n\n## Interactive demo\nThis short (15s) video shows how to do that:\n\n![screenshots/demo2.gif](screenshots/demo2.gif)\n\n## How to use\n- Launching the app also opens it in Chromium (by default).\n- Use 'n' to play next song, 'p' for previous song, 'space' to pause, 'u' and 'd' to increase and decrease volume (needs [this script](Volume.sh) somewhere in your PATH).\n\n\u003e This is a **very minimalist** interface to GMusicBrowser, any other manipulation still have to be done from the main GMusicBrowser interface, of course!\n\n## Interactive demo\nThis other video (30s) shows how to do that:\n\n![screenshots/demo3.gif](screenshots/demo3.gif)\n\n\u003e 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).\n\u003e It is coded [with this script](static/js/fireworks.js), which uses the [awesome `anime.js`](http://animejs.com/) project by [@juliangarnier](https://github.com/juliangarnier/) ([see on GitHub](https://github.com/juliangarnier/anime)), but I disabled it as I was tired of it.\n\u003e You can enable it again by uncommenting the lines 198-200 on the template file: [`template.html`](template.html).\n\n----\n\n## :scroll: License ? [![GitHub license](https://img.shields.io/github/license/Naereen/GMusicBrowser-FullScreen-WebApp.svg)](https://github.com/Naereen/GMusicBrowser-FullScreen-WebApp/blob/master/LICENSE)\n[MIT Licensed](https://lbesson.mit-license.org/) (file [LICENSE](LICENSE)).\n© [Lilian Besson](https://GitHub.com/Naereen), 2018-2021.\n\n[![Maintenance](https://img.shields.io/badge/Maintained%3F-yes-green.svg)](https://GitHub.com/Naereen/GMusicBrowser-FullScreen-WebApp/graphs/commit-activity)\n[![Ask Me Anything !](https://img.shields.io/badge/Ask%20me-anything-1abc9c.svg)](https://GitHub.com/Naereen/ama)\n[![Made with Python v3.4+](https://img.shields.io/badge/Made%20with-Python-1f425f.svg)](https://www.python.org/)\n[![Made with Bash v4.4+](https://img.shields.io/badge/Made%20with-GNU%20Bash-1f425f.svg)](https://www.gnu.org/software/bash/)\n\n[![ForTheBadge built-with-swag](http://ForTheBadge.com/images/badges/built-with-swag.svg)](https://GitHub.com/Naereen/)\n[![ForTheBadge uses-badges](http://ForTheBadge.com/images/badges/uses-badges.svg)](http://ForTheBadge.com)\n[![ForTheBadge uses-git](http://ForTheBadge.com/images/badges/uses-git.svg)](https://GitHub.com/)\n[![ForTheBadge uses-css](http://ForTheBadge.com/images/badges/uses-css.svg)](http://ForTheBadge.com)\n[![ForTheBadge uses-html](http://ForTheBadge.com/images/badges/uses-html.svg)](http://ForTheBadge.com)\n[![ForTheBadge uses-js](http://ForTheBadge.com/images/badges/uses-js.svg)](http://ForTheBadge.com)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnaereen%2Fgmusicbrowser-fullscreen-webapp","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnaereen%2Fgmusicbrowser-fullscreen-webapp","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnaereen%2Fgmusicbrowser-fullscreen-webapp/lists"}