{"id":18878294,"url":"https://github.com/uriel1998/cgimpd","last_synced_at":"2026-02-19T15:30:16.624Z","repository":{"id":147177149,"uuid":"109459897","full_name":"uriel1998/cgimpd","owner":"uriel1998","description":"A client for MPD using CGI-BIN and BASH","archived":false,"fork":false,"pushed_at":"2021-03-31T14:39:15.000Z","size":871,"stargazers_count":3,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"master","last_synced_at":"2024-12-31T02:40:16.651Z","etag":null,"topics":["bash","cgi-bin","mpd"],"latest_commit_sha":null,"homepage":"https://uriel1998.github.io/cgimpd","language":"Shell","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/uriel1998.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":"2017-11-04T02:16:04.000Z","updated_at":"2022-02-23T14:23:02.000Z","dependencies_parsed_at":null,"dependency_job_id":"5b810f7c-a058-40ba-baac-13b5aad0241c","html_url":"https://github.com/uriel1998/cgimpd","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/uriel1998%2Fcgimpd","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/uriel1998%2Fcgimpd/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/uriel1998%2Fcgimpd/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/uriel1998%2Fcgimpd/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/uriel1998","download_url":"https://codeload.github.com/uriel1998/cgimpd/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":239841731,"owners_count":19705981,"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":["bash","cgi-bin","mpd"],"created_at":"2024-11-08T06:25:46.548Z","updated_at":"2026-02-19T15:30:16.581Z","avatar_url":"https://github.com/uriel1998.png","language":"Shell","readme":"# web-based mpd utilities\n### (officially *cgimpd* )\n\nUsing BASH to create a quick web based lyrics/art view of a playing MPD \ninstance, and using BASH and CGI to implement a web-based remote control for \nMPD.\n\n![cgimpd logo](https://github.com/uriel1998/cgimpd/raw/master/cgimpd-open-graph.png \"logo\")  \n\n## Contents\n 1. [About](#1-about)\n 2. [License](#2-license)\n 3. [Prerequisites](#3-prerequisites)\n 4. [Installation](#4-installation)\n 5. [Attribution](#5-attribution)\n \n***\n\n## 1. About\n\nOriginally, this repository just had the CGI implementation (`cgimpd`) of a \nremote control. Currently, it holds both that and a small script (`mpdview.sh`) \nthat creates a lightweight web page that has information about what's playing.\n\n### CGI-MPD\n\nThere's a lot - a *lot* - of different web UIs for MPD. However, they often \nrely on PHP, databases, don't have a feature I need (such as cover art), or \nhave features I didn't need (a separate webserver). So I decided to make \nthis for a fast, basic, but featureful remote control/status implementation.\n\n`cgimpd` can be installed on a *remote* webserver from the MPD instance.\n\n\n![screenshot](https://raw.githubusercontent.com/uriel1998/cgimpd/master/cgi-mpd-screenshot.jpg)\n\n### MPDVIEW\n\nWhile I love [ompd](https://ompd.pl/) and [rompr](https://fatg3erman.github.io/RompR/), \nI wanted something I could easily pull up and show folks when they asked \nwhat song was playing - or even leave up in the background without worrying \nthat someone would accidentally click a button or press a key. `mpdview` \n does *not* require cgi; it runs separately on the server machine.\n\n`mpdview` can also be installed on a *remote* webserver from the MPD instance.\n\n![screenshot](https://raw.githubusercontent.com/uriel1998/cgimpd/master/screenshot.png)\n\n## 2. License\n\nThis project is licensed under the MIT License. For the full license, see `LICENSE`.\n\n## 3. Prerequisites\n\n* Working webserver\n\n## 4. Installation\n\n1. Download or clone the repository, and put the uncompressed files in a location \nof your choice. Change into that directory.\n\n2. Configure cgimpd.rc \n\n```\nhostname.of.mpd\n1485 \u003c - mpd port\npassword\n5 \u003c - refresh in seconds\n/directory/of/music\n/directory/for/covers\n/www/base/directory\nhttp://url.to/refresh/to/\n/directory/for/fanart\n/directory/for/artistart\n```\n\n3. I utilize my [WebServer Covers script](https://github.com/uriel1998/yolo-mpd/blob/master/webserver_covers.sh) so that my whole music collection doesn't have to be inside of webroot. You can, of course, symlink your music collection inside of webroot, but that just makes me uneasy.\n\n\n4. `mpdview` only:\n- create the directory `out` below the script directory\n- symlink the files in `out` to somewhere in your webroot\n- launch `mpdview.sh \u0026`\n- optionally run as a systemd unit\n- defaults already exist in `images` if fanart, artist art, or album art is \nnot found\n- Lyrics are fetched from the music directory as `[song filename].txt`.\n- Fanart is simply `Band Name.jpg`.  \n\n\n4. `cgimpd` only: \n\n- Ensure AllowOverrides is on for the webserver so that the .htaccess file is acknowledged\n- Configure .htaccess\n\nFormat of .htaccess\n\n```\n#Alternate default index page\nDirectoryIndex mpd.cgi\n\nAddHandler cgi-script .cgi\nOptions +ExecCGI \n\n\u003cFiles \"cgimpd.rc\"\u003e\n        Order Deny,Allow\n        Deny from all\n\u003c/Files\u003e\n\n```\n\n## 5. Attribution\n\n* Webpage template based off of [zenlike](http://www.freecsstemplates.org/preview/zenlike) by [NodeThirtyThree Design](http://www.nodethirtythree.com/)\n* No cover image by [Valentino Funghi](https://unsplash.com/photos/MEcxLZ8ENV8)\n* Icons from [Iconfinder](https://www.iconfinder.com/iconsets/freecns-cumulus)\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Furiel1998%2Fcgimpd","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Furiel1998%2Fcgimpd","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Furiel1998%2Fcgimpd/lists"}