id          = "ocp"
name        = "Open Cubic Player"
homepage    = "https://github.com/mywave82/opencubicplayer"
description = "Unix port of Open Cubic Player, which is a text-based player with some few graphical views."
executables      = ["ocp", "ocp-curses"]
platforms   = ["macos", "linux"]

[dotfiles]

# The upstream source follows the XDG configuration directory and names the
# file ocp.ini (the project's issue tracker prints cfConfigHomeDir as
# ~/.config/ocp/ and its changelog documents the XDG migration). Older Unix
# installs used ~/.ocp, so retain that documented legacy location.
# https://github.com/mywave82/opencubicplayer/issues/167
# https://github.com/mywave82/opencubicplayer/blob/master/Changelog
paths  = ["[configHome]/ocp/ocp.ini", "~/.ocp/ocp.ini"]
secret = []

[commands]
format = 1
label = "Open Cubic Player"
description = "Start ocp with a playlist or module. Option values (-f, -v, -s sub-settings) are not covered."
quality = "ai-draft"
parser = { end_of_options = "--", interleave = "permute", long_equals = false, short_attached = true, short_bundles = false }

[[commands.source]]
id = "man"
kind = "manual"
url = "https://dokk.org/manpages/debian/12/opencubicplayer/ocp.1.en"
revision = "Debian 12 man page"
evidence = """
ocp [ options ] [ playlist ] [ modulename ]
-c Use specific configuration.
-p Quit when playlist is empty.
"""

[[commands.field]]
id = "config"
label = "Configuration"
description = "Use a specific configuration."
type = "string"
option = ["-c"]
sources = ["man"]

[[commands.field]]
id = "quit_when_empty"
label = "Quit when playlist is empty"
type = "boolean"
option = ["-p"]
sources = ["man"]

[[commands.field]]
id = "file"
label = "Playlist or module"
type = "path"
path = { kind = "file", role = "input" }
position = 0
sources = ["man"]

[[commands.task]]
id = "play"
label = "Play a module or playlist"
fields = ["file", "quit_when_empty"]
required = ["file"]

[[commands.group]]
id = "basic"
label = "Basic"
fields = ["file", "quit_when_empty", "config"]