id       = "btop"
name     = "btop++"
homepage = "https://github.com/aristocratos/btop"
description = "Resource monitor that shows usage and stats for processor, memory, disks, network and processes."
# The app icon, from the project's repository; the logo beside it is a wordmark.
icon     = "https://raw.githubusercontent.com/aristocratos/btop/main/Img/icon.svg"
executables   = ["btop"]
platforms = ["macos", "linux"]

[dotfiles]

# README (Configurability): "Config and log files stored in $XDG_CONFIG_HOME/btop
# or $HOME/.config/btop folder" — that pair is [configHome] — btop.conf plus a
# themes/ folder for user ".theme" files. Windows is a separate project
# (btop4win), so it is not listed.
paths = [
  "[configHome]/btop/btop.conf",
  "[configHome]/btop/themes/",
]

# The log is state, not config. Current btop writes ~/.local/state/btop.log
# (README); older versions kept btop.log next to btop.conf.
exclude = [
  "[configHome]/btop/btop.log",
  "~/.local/state/btop.log",
]

# A resource monitor with no accounts and no credentials.
secret = []

# btop rewrites btop.conf from memory when it exits, so a config written under a
# running instance is lost. side_effect stays at its default of true.

# The pinned network interface is the one piece of this file that describes
# hardware: en0 on one laptop is eth0 or wlan0 on the next box. Themes, refresh
# rate and box layout are preferences and stay syncable. The user pinned that
# interface by hand and it names this box's own hardware, so it is kept to set
# the box up again rather than pushed anywhere: backup.
[[dotfiles.machine_lines]]
file  = "[configHome]/btop/btop.conf"
match = { prefix = ["net_iface"] }
scope = "backup"

[commands]
format = 1
label = "Start btop++"
description = "Launch the resource monitor with display options. Short single-dash spellings like -lc are left out."
quality = "ai-draft"
base = "fig:btop"
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/btop.ts"
license = "MIT"

[[commands.field]]
id = "preset"
label = "Start preset"
description = "Preset number from 0 to 9."
type = "integer"
option = ["--preset", "-p"]
suggestions = [{ value = "0", label = "0" }, { value = "1", label = "1" }, { value = "2", label = "2" }, { value = "3", label = "3" }, { value = "4", label = "4" }, { value = "5", label = "5" }, { value = "6", label = "6" }, { value = "7", label = "7" }, { value = "8", label = "8" }, { value = "9", label = "9" }]
sources = ["fig"]

[[commands.field]]
id = "low_color"
label = "Low color"
description = "Disable truecolor; convert 24-bit colors to 256-color."
type = "boolean"
option = ["--low-color"]
sources = ["fig"]

[[commands.field]]
id = "tty_on"
label = "Force TTY mode"
description = "Max 16 colors and tty-friendly graph symbols."
type = "boolean"
option = ["--tty_on", "-t"]
sources = ["fig"]

[[commands.field]]
id = "tty_off"
label = "Force TTY mode off"
type = "boolean"
option = ["--tty_off"]
sources = ["fig"]

[[commands.field]]
id = "utf_force"
label = "Force UTF-8"
description = "Start even if no UTF-8 locale was detected."
type = "boolean"
option = ["--utf-force"]
sources = ["fig"]

[[commands.field]]
id = "debug"
label = "Debug mode"
description = "Show microsecond timers and set loglevel to DEBUG."
type = "boolean"
option = ["--debug"]
sources = ["fig"]

[[commands.task]]
id = "tty"
label = "Linux console friendly"
fields = ["tty_on", "low_color"]
required = []
set = { tty_on = [true], low_color = [true] }

[[commands.task]]
id = "preset"
label = "Start on a preset"
fields = ["preset"]
required = ["preset"]

[[commands.group]]
id = "basic"
label = "Basic"
fields = ["preset", "low_color", "tty_on", "tty_off"]

[[commands.group]]
id = "advanced"
label = "Advanced"
fields = ["utf_force", "debug"]