NAME

mpvc-fzf - fuzzy search interface for discovering and playing media with mpvc

SYNOPSIS

mpvc-fzf [option]

DESCRIPTION

mpvc-fzf is a fuzzy search interface that integrates fzf with mpvc to enable interactive discovery, searching, and playback of media from multiple sources. It supports local files, YouTube, Invidious, streaming services, and custom feeds.

The tool provides an interactive terminal interface for selecting and managing media, with support for advanced features like video quality selection, equalizer management, and playlist manipulation.

OPTIONS

Search and Playback

-p, --splay

Search and play media on Invidious.

-s, --search

Search for media on Invidious without auto-playing.

-U, --Url

Search and play from a given YouTube URL.

-u, --url

Search a given YouTube URL (videos, channels, playlists).

-l, --local PATH

Search and play local media at the specified path.

-k, --dplay

Search and play videos from DuckDuckGo.

-K, --dsearch

Search DuckDuckGo videos without auto-playing.

-y, --related

Search for related media on Invidious based on current selection.

-Y, --Related

Search and play related media on Invidious.

-z, --relatedo

Search currently playing media on Invidious for related videos.

Download and Fetch

-g, --fetch

Fetch a YouTube URL and store locally.

-G, --Fetch

Search Invidious, fetch the media, and store locally.

-C, --cache

Search cache by URL for remote media.

-r, --explorer

Shortcut to search ytdl-archive directory.

-b, --browse

Manage ytdl-archive URL collections.

Playlist and Media Management

-f, --playlist

Manage the current mpv playlist interactively with fzf.

-a, --stash

Manage mpvc stashes (saved playlists or media collections).

-c, --chapters

Manage mpv chapter list interactively.

-e, --eqz

Manage equalizer settings with preset selection.

-q, --quality

Select and change video quality for playback.

Metadata and Information

-i, --lyrics

Search media lyrics on Invidious.

-I, --Lyrics

Search media lyrics on DuckDuckGo.

-t, --thumbnail

Retrieve thumbnail URL from media metadata.

-T, --Thumbnail

Display thumbnail image from metadata.

Radio and Streaming Services

--now

Return shareable “now listening” playlist with current media information.

--lofi

Search and play Lo-Fi music channels.

--somafm

Search and play SomaFM streaming channels.

--rapi

Search and play stations from Radio Browser API.

--ntsr

Search and play stations from NTS Radio API.

--custom

Search and play custom media feeds.

custom-gen

Generate a custom feeds template for configuration.

invid-list

List available Invidious instances.

Socket and Display Options

-S, --socket SOCKET

Set the path to the mpv Unix socket for communication.

-SS, --socklist

Select and set mpv socket from available sockets.

-x, --launch

Start mpvc-fzf in a new xterm window. Information

-v, --version

Display mpvc-fzf version information.

-h, --help

Display help message with usage information.

EXAMPLES

Search and play a song on Invidious:

mpvc-fzf -p 'kupla mirage'

Search YouTube and interactively select results:

mpvc-fzf -U

Browse and manage current mpv playlist:

mpvc-fzf -f

Search for media lyrics on Invidious:

mpvc-fzf -i 'artist name'

Play Lo-Fi music streams:

mpvc-fzf lofi

Manage equalizer settings:

mpvc-fzf -e

Search local music directory:

mpvc-fzf -l ~/Music

Fetch and download YouTube video locally:

mpvc-fzf -G 'video title'

Search DuckDuckGo videos and play:

mpvc-fzf -k 'search query'

Play SomaFM streams:

mpvc-fzf somafm

Select video quality:

mpvc-fzf -q

Display media thumbnail:

mpvc-fzf -T

Search for related videos:

mpvc-fzf -Y 'video title'

ENVIRONMENT

MPV_SOCKET

Path to the mpv Unix socket. If not set, mpvc-fzf will attempt to locate the default socket automatically.

FZF_DEFAULT_OPTS

Default options for fzf fuzzy finder behavior and appearance.

XDG_CONFIG_HOME

Base directory for user configuration files. Defaults to ~/.config.

FILES

~/.config/mpvc/mpvc.conf

mpvc configuration file.

~/.config/mpvc/yt-dlp.conf

yt-dlp configuration for YouTube downloads.

~/.config/mpvc/custom-feeds.json

Custom media feed definitions for streaming.

~/.cache/mpvc/

Cache directory for downloaded media and metadata.

SEE ALSO

mpvc-fzf(1), mpvc-web(1), mpvc-tui(1), mpvc-equalizer(1) mpv(1), fzf(1), yt-dlp(1), mpv(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