id = "afplay"
name = "afplay"
description = "Command-line audio file player included with macOS."
executables = ["afplay"]
platforms = ["macos"]

[commands]
format = 1
label = "Play audio file"
description = "Play one audio file with optional volume, duration and rate. Debug and leaks analysis are left out."
quality = "ai-draft"
base = "fig:afplay"
parser = { end_of_options = "--", interleave = "permute", long_equals = true, short_attached = true, short_bundles = false }

[[commands.source]]
id = "fig"
kind = "completion"
url = "https://github.com/withfig/autocomplete/blob/master/src/afplay.ts"
license = "MIT"

[[commands.field]]
id = "file"
label = "Audio file"
type = "path"
position = 0
path = { kind = "file", role = "input" }
sources = ["fig"]

[[commands.field]]
id = "volume"
label = "Volume"
type = "number"
option = ["--volume", "-v"]
description = "0 is silent, 1 is normal; up to 255 is very loud."
sources = ["fig"]

[[commands.field]]
id = "time"
label = "Play for seconds"
type = "number"
option = ["--time", "-t"]
sources = ["fig"]

[[commands.field]]
id = "rate"
label = "Playback rate"
type = "number"
option = ["--rate", "-r"]
description = "Practical limits are about 0.4 (slower) to 3.0 (faster)."
sources = ["fig"]

[[commands.task]]
id = "play"
label = "Play file"
fields = ["file", "volume"]
required = ["file"]

[[commands.group]]
id = "basic"
label = "Basic"
fields = ["file", "volume", "time", "rate"]