NAME

kew , kew music command - A terminal 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.

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.
path <path>,: Sets the path to the music library.
--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.

KEY BINDINGS

+, -: Adjusts volume.
Left-right arrows/h,l: Change song.
Space: Play, Pause.
Shift+s: Stop.
F2 or Shift+z: Show playlist view.
F3 or Shift+x: Show library view.
F4 or Shift+c: Show track view.
F5 or Shift+v: Show search view.
F6 or Shift+b: Show radio search view.
F7 or Shift+n: 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 after playing.
s: Shuffles the playlist.
a: Seek Backward.
d: Seek Forward.
x: Save currently loaded playlist to a .m3u file in the music folder.
Tab: Switch to next view.
Shift+Tab: Switch to previous view.
Backspace: Clear the playlist.
Delete: Remove a single playlist entry.
t,g: Move a song up or down the playlist.
number + G or Enter: Go to specific song number in the playlist.
Esc or q: 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.