play-media
Synopsis
Section titled “Synopsis”play-media [-p|--player <cmd>]play-media --helpDescription
Section titled “Description”Opens an fzf picker (with thumbnail/metadata preview via _fzf_preview_media) listing audio and video files under the current directory, and plays the selection(s) in the best available media player. Supports multi-select (Tab) to queue several files at once.
Player resolution order:
1. -p/--player <cmd> (explicit override, validated as a command)2. $play_media_player (explicit override, validated as a command)3. xdg-mime default handler for the first selected file's mimetype4. First known player binary found in a built-in list (mpv, vlc)The player is launched backgrounded and detached, mirroring open-url, so the shell is never blocked.
Arguments
Section titled “Arguments”-p, --player <cmd> |
Force a specific player command |
-h, --help |
Print usage and exit |
Exit Status
Section titled “Exit Status”0 |
Player launched (or the picker was cancelled) |
1 |
No media files found, invalid --player/$play_media_player, or no player found |
2 |
Unknown option |
Example
Section titled “Example”play-mediaplay-media --player mpvDependencies: _fzf_preview_media, _fzf_wrapper, fd, fdfind, file, xdg-mime, mpv, vlc