{"id":42665793,"url":"https://github.com/ahloiscreamo/fmpc","last_synced_at":"2026-04-16T09:01:40.347Z","repository":{"id":334689754,"uuid":"1142327696","full_name":"ahloiscreamo/fmpc","owner":"ahloiscreamo","description":"fmpc | TUI browser for MPD using `fzf` and `ueberzugpp`","archived":false,"fork":false,"pushed_at":"2026-01-29T08:36:21.000Z","size":19,"stargazers_count":11,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-01-31T01:51:49.256Z","etag":null,"topics":["bash-script","cli","fzf","mpd","music","music-player","terminal-app","terminal-music-player","ueberzug"],"latest_commit_sha":null,"homepage":"","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ahloiscreamo.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,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-01-26T09:06:27.000Z","updated_at":"2026-01-29T08:28:10.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/ahloiscreamo/fmpc","commit_stats":null,"previous_names":["ahloiscreamo/fmpc"],"tags_count":4,"template":false,"template_full_name":null,"purl":"pkg:github/ahloiscreamo/fmpc","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ahloiscreamo%2Ffmpc","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ahloiscreamo%2Ffmpc/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ahloiscreamo%2Ffmpc/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ahloiscreamo%2Ffmpc/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ahloiscreamo","download_url":"https://codeload.github.com/ahloiscreamo/fmpc/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ahloiscreamo%2Ffmpc/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28941897,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-31T11:39:38.044Z","status":"ssl_error","status_checked_at":"2026-01-31T11:39:27.765Z","response_time":128,"last_error":"SSL_read: 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-script","cli","fzf","mpd","music","music-player","terminal-app","terminal-music-player","ueberzug"],"created_at":"2026-01-29T10:07:09.150Z","updated_at":"2026-04-16T09:01:40.340Z","avatar_url":"https://github.com/ahloiscreamo.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cimg width=\"1626\" height=\"933\" alt=\"Screenshot from 2026-04-16 14-59-09\" src=\"https://github.com/user-attachments/assets/6e1a288b-85ec-4843-80ae-104f148b082a\" /\u003e\n\u003cimg width=\"641\" height=\"1034\" alt=\"Screenshot from 2026-04-16 14-53-12\" src=\"https://github.com/user-attachments/assets/75b0471b-430d-4219-a04e-b3f9b430aec5\" /\u003e\n\n# fmpc - Fast MPC Browser\n\nA minimalist, high-performance TUI browser for MPD using `fzf` and `ueberzugpp`.\n\n## Features\n\n* **Cover Art**: Renders album art using Ueberzug++.\n* **Layouts**: Supports \"Right\" or \"Bottom\" preview modes (centered).\n* **Search**: Uses `fzf` for instant library filtering.\n* **Selection**: Select multiple tracks or albums with TAB to queue them.\n* **Sync**: Auto-selects the currently playing song on startup \u0026 follow-focus song.\n* **UI**: Simple ANSI colors with grey dividers for a cleaner look.\n\n## Dependencies\n\n* `mpd` / `mpc`\n* `fzf`\n* `ueberzugpp`\n* `ffmpeg` (for cover extraction)\n* `Nerd Fonts`\n\n## Installation\n\n1. Clone the repository and move both scripts to your bin directory:\n```bash\nchmod +x fmpc fmpc-play fmpc-follower\ncp fmpc fmpc-play fmpc-follower ~/.local/bin/\n\n```\n\n2. Open `fmpc` and configure your music path:\n\n```bash\nexport MUSIC_DIR=\"/path/to/your/music\"\n\n```\n\n3. Choose your preferred layout at the top of the script:\n\n```bash\nexport PREVIEW_POS=\"right\" # Change to \"bottom\" for centered view\n\n```\n\n## Usage\n\nLaunch the browser:\n\n```bash\nfmpc\n\n```\n\n### Keybindings/--help\n\n| Key | Action |\n| --- | --- |\n| **ENTER** | Play highlighted song |\n| **TAB** | Select/Deselect multiple songs |\n| **Ctrl-x** | Play all selected songs |\n| **Ctrl-f** | Search for current playing song |\n| **Ctrl-p** | Toggle Play/Pause |\n| **Ctrl-n** | Next Track |\n| **Ctrl-b** | Previous Track |\n| **Ctrl-u** | Update MPD database |\n| **ESC** | Clear search / Reset view |\n| **Ctrl-q** | Quit |\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fahloiscreamo%2Ffmpc","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fahloiscreamo%2Ffmpc","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fahloiscreamo%2Ffmpc/lists"}