id = "kew"
name = "kew"
homepage = "https://www.kewplayer.com/"
description = "Music for the Shell."
executables = ["kew"]
[dotfiles]
paths = [
"[configHome]/kew/kewrc",
"[configHome]/kew/layouts/",
"[configHome]/kew/themes/",
"[preferences]/kew/kewrc",
"[preferences]/kew/layouts/",
"[preferences]/kew/themes/",
"%APPDATA%/kew/kewrc",
"%APPDATA%/kew/layouts/",
"%APPDATA%/kew/themes/",
]
secret = []
side_effect = false
[commands]
format = 1
label = "Play music"
description = "Play music by partial file or directory name, or start in library view when no name is given. Themes, playlists (list), the path setting and special keywords are left out."
quality = "ai-draft"
parser = { end_of_options = "--", interleave = "permute", long_equals = false, short_attached = false, short_bundles = false }
[[commands.source]]
id = "help"
kind = "manual"
url = "https://github.com/ravachol/kew/blob/main/docs/kew.1"
revision = "main 2026-10"
evidence = """
kew [OPTIONS] [PARTIAL FILE OR DIRECTORY NAME]
--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.
shuffle Shuffles the playlist before starting to play it.
"""
[[commands.field]]
id = "query"
label = "Artist, album or song name"
description = "Partial file or directory name; leave empty to open the library view."
type = "string"
position = 0
multiple = true
sources = ["help"]
[[commands.field]]
id = "exact"
label = "Exact match"
description = "Exact but not case sensitive."
type = "boolean"
option = ["--exact", "-e"]
sources = ["help"]
[[commands.field]]
id = "quitonstop"
label = "Quit when playlist ends"
type = "boolean"
option = ["--quitonstop", "-q"]
sources = ["help"]
[[commands.field]]
id = "nocover"
label = "Hide cover"
type = "boolean"
option = ["--nocover"]
sources = ["help"]
[[commands.field]]
id = "noui"
label = "Hide the whole UI"
type = "boolean"
option = ["--noui"]
sources = ["help"]
[[commands.task]]
id = "play"
label = "Play by name"
fields = ["query", "exact"]
required = ["query"]
[[commands.group]]
id = "basic"
label = "Basic"
fields = ["query", "exact"]
[[commands.group]]
id = "advanced"
label = "Advanced"
fields = ["quitonstop", "nocover", "noui"]
