Skip to content

Latest commit

 

History

History
143 lines (96 loc) · 3.04 KB

fzmp.1.md

File metadata and controls

143 lines (96 loc) · 3.04 KB
Raw
title section header footer date
FZMP
1
User Manual
fzmp 1.0.0
March 24, 2022

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

SEE ALSO

mpcplus(1), mpcpluskeys(1)

Full documentation and sources at:

https://github.com/doctorfree/MusicPlayerPlus