{"id":49077457,"url":"https://github.com/teegre/smpcp","last_synced_at":"2026-04-20T10:34:29.144Z","repository":{"id":109846833,"uuid":"371367409","full_name":"teegre/smpcp","owner":"teegre","description":"Command line MPD client with auto-playlists (song, album modes), extensible via plugins.","archived":false,"fork":false,"pushed_at":"2026-03-17T18:41:11.000Z","size":465,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2026-03-17T21:44:51.792Z","etag":null,"topics":["bash","command-line","linux","mpd","mpd-client","music"],"latest_commit_sha":null,"homepage":"","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/teegre.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,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2021-05-27T12:35:16.000Z","updated_at":"2025-10-14T10:39:06.000Z","dependencies_parsed_at":"2023-03-13T14:03:08.828Z","dependency_job_id":"7243e810-af93-42cb-85db-56cace708a64","html_url":"https://github.com/teegre/smpcp","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/teegre/smpcp","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/teegre%2Fsmpcp","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/teegre%2Fsmpcp/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/teegre%2Fsmpcp/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/teegre%2Fsmpcp/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/teegre","download_url":"https://codeload.github.com/teegre/smpcp/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/teegre%2Fsmpcp/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32043167,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-20T10:33:29.490Z","status":"ssl_error","status_checked_at":"2026-04-20T10:32:30.107Z","response_time":94,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"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","command-line","linux","mpd","mpd-client","music"],"created_at":"2026-04-20T10:34:28.256Z","updated_at":"2026-04-20T10:34:29.129Z","avatar_url":"https://github.com/teegre.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"```\n.▄▄ · • ▌ ▄ ·.  ▄▄▄· ▄▄·  ▄▄▄· super\n▐█ ▀. ·██ ▐███▪▐█ ▄█▐█ ▌▪▐█ ▄█ music\n▄▀▀▀█▄▐█ ▌▐▌▐█· ██▀·██ ▄▄ ██▀· player\n▐█▄▪▐███ ██▌▐█▌▐█▪·•▐███▌▐█▪·• client\n ▀▀▀▀ ▀▀  █▪▀▀▀.▀   ·▀▀▀ .▀    plus+\n```\n\n# SMPCP\n\n## Description\n\n**smpcp** is a command line client for [Music Player Daemon](https://www.musicpd.org) written in Bash (and a little C), that includes some more advanced features like:\n\n*  Auto-generated playlists (song and album modes).\n*  Notifications (with album art).\n*  Song rating.\n*  Playback statistics.\n*  Can be extended with plugins.\n\n## Dependencies\n\nLatest version of these packages are needed:  \nawk (for auto-completion)  \nbash  \ncdparanoia (optional)  \ncoreutils  \nopenbsd-netcat  \nimagemagick  \nlibmpdclient  \nlibnotify  \nmpd  \nsed (for auto-completion)  \nsqlite3  \nutil-linux\n\n## Install\n\nClone this repository: `git clone https://gitlab.com/teegre/smpcp.git`\n\nThen: `cd smpcp`\n\nFinally: `make install`\n\n## Uninstall\n\n`make uninstall`\n\n## Configuration\n\n**smpcp** reads its configuration from `$XDG_CONFIG_HOME/smpcp`.  \nAs a starting point, a default configuration file called **smpcp.conf** can be found in `/etc/smpcp` directory:\n\n`mkdir $HOME/.config/smpcp`\n\n`cp /etc/smpcp/smpcp.conf ~/.config/smpcp`\n\nFor more info, read **smpcp.conf(5)** manual page.\n\n## Daemon\n\nTo enable auto-playlists and playback statistics, **smpcpd** - the **smpcp** daemon - must be running. A systemd unit is provided for this purpose.\n\nTo enable the daemon:\n\n`systemctl --user enable smpcpd`\n\nTo start the daemon:\n\n`systemctl --user start smpcpd`.\n\n## Usage\n\nTo execute a command: `smpcp \u003ccommand\u003e [options]`\n\nCommands can be chained with the `++` operator: `smpcp clear ++ add kraftwerk/autobahn ++ play`\n\nTo see a list of available commands: `smpcp help`\n\nFor more info, read **smpcp(1)** manual page.\n\n## Plugins\n\nAs stated at the beginning of this document, **smpcp** can be extended with plugins (check out `plugins` in this repository).\n\nUntil I find a convenient way to manage plugin installation, a plugin must be installed manually by copying or symlinking its directory over to `$XDG_CONFIG_HOME/smpcp/plugins/`.\nNo extra step is needed since **smpcp** 'detects' plugins automatically.\n\nType `smpcp plugins` to see a list of installed plugins.\n\n### Writing plugins\n\nI provided a (very basic and still in construction) guide to help plugins development: [Plugins Development Guide Wiki](https://github.com/teegre/smpcp/wiki/SMPCP-Plugins-Development-Guide)  \nAnd you can check out the example plugin called **hello**.\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fteegre%2Fsmpcp","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fteegre%2Fsmpcp","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fteegre%2Fsmpcp/lists"}