{"id":17941848,"url":"https://github.com/tkapias/bemenu-mpdcli","last_synced_at":"2025-04-03T13:20:04.641Z","repository":{"id":259885136,"uuid":"869001284","full_name":"tkapias/bemenu-mpdcli","owner":"tkapias","description":"A simple bemenu client for MPD using mpc.","archived":false,"fork":false,"pushed_at":"2024-11-01T07:42:41.000Z","size":2068,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-02-09T02:17:40.305Z","etag":null,"topics":["bash-script","bemenu","mpd","mpd-client"],"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/tkapias.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"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":"2024-10-07T14:50:07.000Z","updated_at":"2024-11-01T07:42:44.000Z","dependencies_parsed_at":"2024-10-28T16:35:10.786Z","dependency_job_id":"c75717a9-3940-4469-b6b3-1163efd1144c","html_url":"https://github.com/tkapias/bemenu-mpdcli","commit_stats":null,"previous_names":["tkapias/bemenu-mpdcli"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tkapias%2Fbemenu-mpdcli","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tkapias%2Fbemenu-mpdcli/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tkapias%2Fbemenu-mpdcli/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tkapias%2Fbemenu-mpdcli/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/tkapias","download_url":"https://codeload.github.com/tkapias/bemenu-mpdcli/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247006668,"owners_count":20868033,"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-script","bemenu","mpd","mpd-client"],"created_at":"2024-10-29T02:04:26.900Z","updated_at":"2025-04-03T13:20:04.615Z","avatar_url":"https://github.com/tkapias.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# bemenu-mpdcli\n\nA [bemenu](https://github.com/Cloudef/bemenu) client for [MPD](https://github.com/MusicPlayerDaemon/MPD) using [mpc](https://github.com/MusicPlayerDaemon/mpc). Control you local or remote Music Player Daemon from a simple and fast menu.\n\n![preview](assets/preview.png)\n\nThe preview uses my wrapper for bemenu: [bemenu-orange-wrapper](https://github.com/tkapias/bemenu-orange-wrapper).\n\n## Dependencies\n\n- [MPD](https://github.com/MusicPlayerDaemon/MPD)\n- [mpc](https://github.com/MusicPlayerDaemon/mpc)\n- [bemenu \u003e= 0.6](https://github.com/Cloudef/bemenu)\n- [Nerd Fonts (Symbols Only)](https://github.com/ryanoasis/nerd-fonts/releases/latest)\n- Bash \u003e= 5\n- Gnu awk\n- xclip\n- exiftool\n\n### Optional\n\n- [bemenu-orange-wrapper](https://github.com/tkapias/bemenu-orange-wrapper)\n\n## Installation\n\n### Dependencies\n\n- Debian example with [bemenu-orange-wrapper](https://github.com/tkapias/bemenu-orange-wrapper):\n\n1. Follow [bemenu-orange-wrapper instructions](https://github.com/tkapias/bemenu-orange-wrapper?tab=readme-ov-file#installation).\n\n2. Next:\n\n``` bash\n# GNU awk, exiftool, xclip, mpd, mpc\nsudo apt install gawk libimage-exiftool-perl xclip mpd mpdris2 mpc\n```\n\n### bemenu-mpdcli\n\n```bash\ngit clone --depth 1 https://github.com/tkapias/bemenu-mpdcli.git bemenu-mpdcli\ncd bemenu-mpdcli\nchmod +x bemenu-mpdcli.bash\n```\n\n- Optional: Symlink to a directory in your user's path:\n\n```bash\nln -s $PWD/bemenu-mpdcli.bash $HOME/.local/bin/bemenu-mpdcli\n```\n\n## Features\n\n- Display current title, albumartist (or url/filename).\n- Player commands: Play/Pause, Stop, Prev, Next.\n- Queue:\n  - List position, title, albumartist, album (or url/filename).\n  - Play selected.\n- Playlists:\n  - List mpd playlists by filename.\n  - Replace queue with a playlist and play it.\n- Library:\n  - List albumartist.\n  - List albums for a selected albumartist.\n  - Replace queue with an album and play it.\n- Lyrics:\n  - Display lyrics included in current song's file.\n  - Parse SynchronizedLyricsText-xxx or Lyrics-xxx tags.\n  - Prefer Synchronized Lyrics if available.\n  - Seek position in current song from a line in Synchronized Lyrics.\n\n## Usage\n\nbemenu-mpdcli shoould work out of the box for a local mpd server.\n\nYou can also provide arguments to mpc for custom locations.\n\n```bash\n[MPD_LIBRARY_PATH=$HOME/Music] bemenu-mpdcli [--host ip/socket] [--port num] [--partition name]\n```\n\n### Lyrics\n\nFor the lyrics extraction to work, you need exiftool and a way for\nbemenu-mpdcli to locate the root folder of the MPD library.\nYou can declare the path to this folder as the env variable\n`MPD_LIBRARY_PATH` or let it use XDG_MUSIC_DIR by default if it's defined\nby your session manager.\n\nYou can also source your custom XDG user directories in your `.profile`,\n`.xsession` or `.bashrc` files:\n\n```bash\n# set -a to export the sourced variables\nset -a\n. ${HOME}/.config/user-dirs.dirs\nset +a\n```\n\n### Integrations\n\n- Binding example for bemenu-mpdcli in i3wm:\n\n```i3wm\nbindsym $mod+m exec --no-startup-id \"bemenu-mpdcli\"\n```\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftkapias%2Fbemenu-mpdcli","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftkapias%2Fbemenu-mpdcli","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftkapias%2Fbemenu-mpdcli/lists"}