MusicPlayerPlus

Featureful ncurses based MPD client inspired by ncmpc with integration for Beets, spectrum visualization,Bandcamp/Soundcloud, asciimatics, cantata, and more

Project maintained by doctorfree Hosted on GitHub Pages — Theme by ronrecord

NAME

fzmp - list and search songs in the MPD music library using the fzf fuzzy finder

SYNOPSIS

fzmp [OPTIONS]

DESCRIPTION

The fzmp command lists and searches for songs in an MPD library by artist, album, or playlist using the fzf fuzzy finder.

COMMAND LINE OPTIONS

-h –help: print this help
-a –artist: search artist then filter by album (or F3 when running)
-A –all: search all songs in the library (or F2 when running)
-g –genre: list genres (or F4 when running)
-P –playlists: list saved playlists (or F5 when running)
-p –playlist: search the current playlist (or F1 when running)

Playlist view has the following keybinds:

>: go to the next song in the playlist
<: go to the previous song in the playlist
Ctrl-d: delete the selected songs from the playlist
Ctrl-s: save current playlist
Ctrl-p: toggle play/pause

CONFIGURATION:

A configuration file can be defined at $HOME/.config/mpcplus/fzmp.conf

If a line begins with ‘#’ it is treated as a comment and ignored

The configuration file reads the following options:

default_view: Must be ‘artists’ ‘songs’ ‘playlist’ ‘playlists’ or ‘genres’
full_song_format: A format string to be passed directly to mpc format -f in ‘playlist’ and ‘all’ views. Defaults to:

    [[[%artist% / ][[(%date%) ]%album% / ][[%track% - ][%title%]]]|%file%]

For colorized output try:

    [[[\e\[32m%artist%\e\[0m / ][\e\[31m[(%date%) ]%album%\e\[0m / ][\e\[34m[%track% - ][%title%]\e\[0m]]|%file%]

playlist_view_key: (default F1)
track_view_key: (default F2)
artist_view_key: (default F3)
genre_view_key: (default F4)
playlists_view_key: (default F5)
findadd_key: Adds all songs under the cursor by artist/genre/album (default ctrl-space)
fzf_options: Command line options to be passed directly to fzf.
Changing this will override the default options:

      --height='100%' +s -e -i --reverse --cycle

To use the jump feature of fzf you can try:

      --bind=`:jump --height='100%' +s -e -i --reverse --cycle

It also helps to have a bind for toggle-all:

      --bind=ctrl-t:toggle-all --bind=`:jump --height=100% +s -e -i --reverse --cycle

Individual sessions can override with the environment variable FZMP_FZF_OPTIONS

fzmp will also inherit options from FZF_DEFAULT_OPTS

AUTHORS

Written by Daniel F Gray DanielFGray@gmail.com

Modified and adapted by Ronald Record github@ronrecord.com

LICENSING

FZMP is distributed under an Open Source license. See the file LICENSE in the FZMP source distribution for information on terms & conditions for accessing and otherwise using FZMP and for a DISCLAIMER OF ALL WARRANTIES.

BUGS

Submit bug reports online at:

https://github.com/doctorfree/MusicPlayerPlus/issues