NAME

mpvc-tui - Terminal User Interface for displaying the MPV playlist and playback

SYNOPSIS

mpvc-tui options files

DESCRIPTION

mpvc-tui is a terminal-based user interface that displays status/playlist info of the currently mpv instance.

OPTIONS

-d, --dir PATH

Set the working directory to the specified media directory. All media operations will be relative to this directory.

-h, --help

Display the help message and exit.

-H, --history

Start the mpvc-tui history interface. This allows you to browse and replay previously played media.

-k, --kill

Stop the currently running mpvc-tui instance.

-n, --notify

Enable desktop notifications for mpvc events using notify-send. Notifications will appear for playback state changes and media transitions.

--socket PATH

Set the MPV socket path. Overrides the default socket connection (defaults to MPV’s standard socket if not specified).

-s, --suggest

Suggest a random media item to play based on previously played media. Useful for discovering content from your history.

-S, --scrobbler

Start the mpvc-tui scrobbler interface. This feature tracks and logs media that you play.

-t, --tui

Start the main TUI for managing the MPV playlist (uses rlwrap for enhanced readline functionality).

-T, --Tui

Combo option that starts mpvc-tui with both TUI (-t) and desktop notifications (-n) enabled. This is the recommended starting option. Additional files provided as arguments will be added to the playlist.

-x, --launch

Start mpvc-tui in a new xterm window. This respects the $MPVC_TUI_TERM environment variable for terminal selection. Can be combined with other options.

-v, --version

Display the mpvc-tui version and exit.

EXAMPLES

Start TUI with notifications for a media directory

mpvc-tui -d ~/Music -T
mpvc-tui -t

Enable desktop notifications separately

mpvc-tui -n

Launch in a new terminal window

mpvc-tui -x -t -d ~/Music

Access playback history

mpvc-tui -H

Enable media scrobbling

mpvc-tui -S

ENVIRONMENT

MPVC_TUI_TERM

Specifies the terminal emulator to use when launching mpvc-tui with the -x option. If not set, xterm is used as the default.

MPV_SOCKET

Override the default MPV socket path. Can also be set directly using the –socket option.

XDG_CONFIG_HOME

Directory where mpvc configuration is stored. Defaults to ~/.config/ if not set.

FILES

~/.config/mpvc/mpvc.conf

mpvc-specific configuration file.

SEE ALSO

mpv(1), mpc(1), mpvc-fzf(1), mpvc-web(1), mpvc-tui(1), mpvc-equalizer(1)

AUTHOR

Manual written by gmt4. See https://github.com/gmt4/mpvc for more information.

REPORTING BUGS

Report bugs at: https://github.com/gmt4/mpvc/issues