id          = "kew"
name        = "kew"
homepage    = "https://www.kewplayer.com/"
description = "Music for the Shell."
executables      = ["kew"]

[dotfiles]

# kew's upstream configuration docs distinguish the hand-edited kewrc and
# user-owned layouts/themes from kewstaterc and library.dat, which are dynamic
# state and listening history. The docs give these Linux, macOS, and Windows
# locations (the latter as %APPDATA%/kew).
# https://www.kewplayer.com/docs.html
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"]