NAME

       kew , kew music command - A command-line music player.

SYNOPSIS

       kew [OPTIONS] [PARTIAL FILE OR DIRECTORY NAME]

DESCRIPTION

       kew plays audio from your music folder when given a partial (or whole) file or directory
       name.  A playlist is created when finding more than one file.  It supports gapless
       playback, 24-bit/192khz audio and MPRIS.

       On first use, set a path for the music library (this is a once-only operation):

       kew path "/home/joe/Music"

       Typical use:

       kew artist, album or song name

       kew returns results from the location of the first match, it doesn't return every result
       possible.

OPTIONS

       -h, --help
                Displays help.

       -v, --version
                Displays version info.

       --nocover
                Hides the cover.

       --noui   Completely hides the UI.

       -q, --quitonstop
                Exits after playing the whole playlist.

       -e, --exact,
                Specifies you want an exact (but not case sensitive) match, of for instance an
                album.

       shuffle  Shuffles the playlist before starting to play it.

       dir      Plays the directory not the song.

       song     Plays the song not the directory.

       list     Searches for a (.m3u) playlist. These are normally not included in searches.

EXAMPLES

       kew      Start kew in library view.

       kew all  Start kew with all songs loaded into a playlist.

       kew albums
                Start kew with all albums randomly added one after the other in the playlist.

       kew moonlight son
                Play moonlight sonata.

       kew moon
                Play moonlight sonata.

       kew nirv
                Play all music under Nirvana folder shuffled.

       kew neverm
                Play Nevermind album in alphabetical order.

       kew shuffle neverm
                Play Nevermind album shuffled.

       kew list mix
                Play the mix.m3u playlist.

       kew <words A>:<words B>:<words C>
                Play the first match (whole directory or file) found under A, B, and C, shuffled.
                Searches are separated by a colon ':' character.

       kew .    Play the kew.m3u playlist.

KEY BINDINGS

       +, -     Adjusts volume.

       Left-right arrows/h,l
                Change song.

       Space    Pause.

       F2       Show playlist view.

       F3       Show library view.

       F4       Show track view.

       F5       Show search view.

       F6       Show key bindings view.

       u        Update the library.

       i        Toggle colors derived from album cover or from color theme.

       v        Toggle spectrum visualizer.

       b        Switch between ascii and image album cover.

       r        Repeat current song.

       s        Shuffles the playlist.

       a        Seek Backward.

       d        Seek Forward.

       Add to kew.m3u playlist. Run with "kew .".

       x        Save currently loaded playlist to a .m3u file in the music folder.

       gg       Go to first song.

       number + G, g or Enter
                Go to specific song number in the playlist.

       G        Go to last song.

       Esc      Quit kew.

FILES

       ~/<configfolder>/kew/kewrc
                 Config file.

       ~/<configfolder>/kew/kewlibrary
                 Music library directory tree cache.

       /<musicfolder>/kew.m3u
                 The kew playlist. Add to it by pressing '.' during playback of any song. This
                 playlist is saved before q exits.

COPYRIGHT

       Copyright © 2023 Ravachol. License GPLv2+: GNU GPL version 2 or later
       <https://gnu.org/licenses/gpl.html>.  This is free software: you are free to change and
       redistribute it.  There is NO WARRANTY, to the extent permitted by law.

SEE ALSO

       Project home page:

       <https://github.com/ravachol/kew>.