- about Music player in POSIX-sh using mpv from the shell/fzf + extras/goodies 📡🛸🚀
- goodies Support TUI, FZF, WEB, CLI, playing youtube & streaming services (See #20221219)
- tags music-player terminal minimal mpv tui media-player mplayer posix-sh mpv-player mpvc mpvc-tui
- github https://github.com/gmt4/mpvc/
- promote Star, share, and promote our work through the buttons below if you find it useful. Thanks!
⠀⠀⠀⠀⠀⠀⠀⢀⣤⠖⠂⠉⠉⠉⠀⠒⠤⣀⠀⠀⠀⠀⠀ ⠀⠀⠀⠀⢀⠀⣶⡟⢀⣴⣶⣿⣾⣶⣶⣄⡀⠈⠑⢤⡀⠀⠀ ⠀⠀⠀⡴⣫⣼⡿⣴⡟⠛⠉⠉⠛⠛⠿⣿⣿⣷⣦⡀⠙⢄⠀ ⠀⠀⣼⢁⣟⡟⣷⠁⠀⠀⠀⠀⠀⠀⠀⠀⠙⢿⣿⣷⣆⠈⢣ ⠀⢰⣿⢼⣿⣷⠇⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠹⣿⣿⡆⠀⢱⠀⠀ ⠀⢸⡵⣾⣇⣸⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠘⣿⣧⠀⠀⢧⠀⠀⠀ ⠀⠘⣴⣿⢯⡏⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠹⡿⠛⠉⠹⡆⠀⠀ ⢀⣼⣿⣧⠟⠁⢀⢀⣀⡀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⢯⣴⣶⣴⡇⠀⠀⠀ ⢸⣿⣼⣿⣋⣉⠀⠀⠀⠈⠙⠦⡀⠀⠀⠀⠀⠀⠀⠀⠀⠈⣿⣿⣷⣷⡀⠀⠀ ⢸⠁⠊⣿⠛⢛⢟⣦⡀⠀⠀⠀⠈⢆⠀⠀⠀⠀⢀⠔⣨⣶⡜⠂⠈⠽⣧⡀⠀ ⠸⣶⣾⡯⠤⢄⡀⠵⢿⣦⡀⠀⠀⠀⡷⡄⠀⡰⢁⣾⣿⣿⣿⠀⠀⠀⣿⡹⡄ ⠀⣿⣡⠦⢄⡀⠈⠳⣬⣹⣿⣆⠀⠀⢉⠻⣴⠇⣾⣿⡟⢻⠁⠀⠀⠀⣿⠁⡇ ⠀⣿⡭⡀⠀⠈⠲⣦⣸⣿⣿⣿⣧⣀⠈⡔⣜⣴⣿⡟⢀⡎⡈⠀⠀⢰⡿⢠⣷ ⠀⢸⣿⣄⣒⡀⡀⣿⣷⡿⣿⢿⣿⣷⡰⡸⣯⣏⣿⡷⢋⣼⣁⡢⢠⠟⠀⣼⣿ ⠀⠀⠻⣷⣈⣁⣮⢻⢸⡇⢨⣿⣿⣿⣷⢶⣿⣏⣩⣶⣿⣿⣿⣿⡯⣤⣴⣿⠃ ⠀⠀⠀⠘⠿⣿⣿⣽⣽⣷⣿⣿⣿⣿⣿⡶⠻⣿⣿⣿⣿⣿⣿⣿⣿⣿⠟⠁⠀ ⠀⠀⠀⠀⠀⠀⠉⠙⠿⢿⣿⣿⣿⣿⠟⠁⠀⠘⠿⣿⣿⣿⠿⠟⠉⠀⠀⠀⠀
Contents
Overview
mpvc is a collection of POSIX shell scripts:- mpvc: provides the core CLI commands to control mpv
- extras/mpvc-tui: provides a console TUI, using mpvc underneath
- extras/mpvc-fzf: provides fzf integration to mpvc.
- extras/mpvc-web: a hack to remotely control mpvc from web
- extras/mpvc-mpris: speaks MPRIS to control mplayer through key-bindings.
- extras/mpvc-equalizer: provides a basic mpv equalizer for the CLI.
- extras/mpvc-autopilot: automatic mpv start/stop based on presence
- extras/mpvc-installer: provides an installer to install/update mpvc.
QuickInstall ▶️
mpvc-installer fetch-user: installs mpvc under BINDIR=~/bin/
curl -fsSL -o mpvc-installer https://github.com/gmt4/mpvc/raw/master/extras/mpvc-installer; sh ./mpvc-installer fetch-user
QuickStart
Below is a Quick Start guide showcasing mpvc commands usage.# fetch a local copy of the github repo git clone https://github.com/gmt4/mpvc/ # use extras/mpvc-installer: just copy/link to your $HOME/bin (cd mpvc; extras/mpvc-installer link-user) (cd mpvc; extras/mpvc-installer config-user) (cd mpvc; extras/mpvc-installer check-reqs) # adjust .config/mpvc/mpvc.conf to suit your needs, mpvc-installer config-user just installs the defaults # use mpvc-fzf to search and play youtube media mpvc-fzf -p 'kupla mirage' # use mpvc-fzf to manage the playlist mpvc-fzf -f # use mpvc to enqueue local media / online YT media mpvc add /path/to/your/*.mp3 # or your URLs # use mpvc-tui to start the tui + desktop notifications mpvc-tui -TFor more check the #Logbook (remeber your best chance is to try, play, and have fun).
Screenshots
mpvc-fzf running on mac OS (screenshot click to view)
mpvc-tui -T: running the mpvc TUI (screenshot click to view)
mpvc-tui -f: running with fzf (screenshot click to view)
mpvc-tui: running with fzf and desktop notifications on the upper-right corner (screenshot click to view)
Logbook
The logbook got big enought to deserve a page on its own, see here: logbook.html
📅 Thu, 06 Nov 2025 by gmt4 ⚡ PoweredBy #HTML