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.

kew .

Play the kew.m3u playlist.

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.

"."

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

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.

SEE ALSO¶

Project home page:

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