🎧 mpvc

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!

                                            ___
 ⠀⠀⠀⠀⠀⠀⢀⣤⠖⠂⠉⠉⠉⠀⠒⠤⣀⠀⠀⠀⠀⠀              ____ _/ (_)___ ______⠀⠀⠀⠀⠀
⠀⠀⠀⠀⢀⠀⣶⡟⢀⣴⣶⣿⣾⣶⣶⣄⡀⠈⠑⢤⡀⠀⠀             / __ `/ / / __ `/ ___/⠀⠀⠀⠀⠀
⠀⠀⠀⡴⣫⣼⡿⣴⡟⠛⠉⠉⠛⠛⠿⣿⣿⣷⣦⡀⠙⢄⠀            / /_/ / / / /_/ (__  ) ⠀⠀⠀⠀⠀
⠀⠀⣼⢁⣟⡟⣷⠁⠀⠀⠀⠀⠀⠀⠀⠀⠙⢿⣿⣷⣆⠈⢣            \__,_/_/_/\__,_/____/  ⡀⠀⠀⠀⠀
⠀⢰⣿⢼⣿⣷⠇⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠹⣿⣿⡆⠀⢱⠀⠀
⠀⢸⡵⣾⣇⣸⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠘⣿⣧⠀⠀⢧⠀⠀⠀          ____ ___  ____ _   __  _____
⠀⠘⣴⣿⢯⡏⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠹⡿⠛⠉⠹⡆⠀⠀         / __ `__ \/ __ \ | / / / ___/
⢀⣼⣿⣧⠟⠁⢀⢀⣀⡀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⢯⣴⣶⣴⡇⠀⠀⠀       / / / / / / /_/ / |/ / / /__
⢸⣿⣼⣿⣋⣉⠀⠀⠀⠈⠙⠦⡀⠀⠀⠀⠀⠀⠀⠀⠀⠈⣿⣿⣷⣷⡀⠀⠀      /_/ /_/ /_/ .___/|___/  \___/
⢸⠁⠊⣿⠛⢛⢟⣦⡀⠀⠀⠀⠈⢆⠀⠀⠀⠀⢀⠔⣨⣶⡜⠂⠈⠽⣧⡀⠀               /_/                           ⠀
⠸⣶⣾⡯⠤⢄⡀⠵⢿⣦⡀⠀⠀⠀⡷⡄⠀⡰⢁⣾⣿⣿⣿⠀⠀⠀⣿⡹⡄         ____ ___  ____ _   __     __     _____/ /_ ⠀
⠀⣿⣡⠦⢄⡀⠈⠳⣬⣹⣿⣆⠀⠀⢉⠻⣴⠇⣾⣿⡟⢻⠁⠀⠀⠀⣿⠁⡇        / __ `__ \/ __ \ | / /  __/ /_   / ___/ __ \⠀
⠀⣿⡭⡀⠀⠈⠲⣦⣸⣿⣿⣿⣧⣀⠈⡔⣜⣴⣿⡟⢀⡎⡈⠀⠀⢰⡿⢠⣷   ⠀   / / / / / / /_/ / |/ /  /_  __/  (__  ) / / /⠀
⠀⢸⣿⣄⣒⡀⡀⣿⣷⡿⣿⢿⣿⣷⡰⡸⣯⣏⣿⡷⢋⣼⣁⡢⢠⠟⠀⣼⣿      /_/ /_/ /_/ .___/|___/    /_/    /____/_/ /_/
⠀⠀⠻⣷⣈⣁⣮⢻⢸⡇⢨⣿⣿⣿⣷⢶⣿⣏⣩⣶⣿⣿⣿⣿⡯⣤⣴⣿⠃               /_/
⠀⠀⠀⠘⠿⣿⣿⣽⣽⣷⣿⣿⣿⣿⣿⡶⠻⣿⣿⣿⣿⣿⣿⣿⣿⣿⠟⠁⠀      (mpvc, where mpv meets the shell)
⠀⠀⠀⠀⠀⠀⠉⠙⠿⢿⣿⣿⣿⣿⠟⠁⠀⠘⠿⣿⣿⣿⠿⠟⠉⠀⠀⠀⠀

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: web player to remotely control mpvc (*a hack)
extras/mpvc-web-browser: mpvc-web companion to browse media library (*a hack)
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.

For more details on how to use the above tools have a look at the logbook.html. In addition, the casts/ directory to shows some screencasts of mpvc in action.

▶️ Installation

curl -fsSLO https://github.com/gmt4/mpvc/raw/master/extras/mpvc-installer;
# take your time to review the mpvc-installer for peace-of-mind
BINDIR=$HOME/bin SHELL=/bin/sh $SHELL ./mpvc-installer quickstart

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 -T

For more check the Log Book (remember your best chance is to try, play, and have fun).