id       = "cava"
name     = "Cava"
homepage = "https://github.com/karlstav/cava"
description = "Cross-platform Audio Visualizer."
executables   = ["cava"]

[dotfiles]

# https://github.com/karlstav/cava#configuration — cava creates and reads its
# per-user configuration at $XDG_CONFIG_HOME/cava/config, falling back to
# ~/.config/cava/config.
paths = ["[configHome]/cava/config"]
secret = []

[commands]
format = 1
label = "Run visualizer"
description = "Start the audio visualizer, optionally with another config file. All other settings live in the config file."
quality = "ai-draft"
parser = { end_of_options = "--", interleave = "permute", long_equals = false, short_attached = false, short_bundles = false }

[[commands.source]]
id = "readme"
kind = "help"
url = "https://github.com/karlstav/cava"
revision = "2026-10-27"
evidence = """
    Usage : cava [options]
    Visualize audio input in terminal.

    Options:
    	    -p          path to config file
    	    -v          print version
"""

[[commands.field]]
id = "config"
label = "Config file"
type = "path"
option = ["-p"]
path = { kind = "file", role = "input" }
sources = ["readme"]

[[commands.task]]
id = "run"
label = "Run with a config file"
fields = ["config"]
required = ["config"]

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