otty / apps

All apps/btop++

btop++

btop

Resource monitor that shows usage and stats for processor, memory, disks, network and processes.

Runs as btop|macOS, Linux|github.com

Open form in Otty otty.toml

Sync rules

What travels, what stays, what never leaves

btop++ in your home directory Every rule on this page, by file

net_iface

Each machine keeps its own copy of these.

· themes/ Sync

· btop.log Exclude

· ~/.local/state/btop.log Exclude

Only what the catalog names. A directory that syncs brings everything inside it except what is listed as excluded here.

apps/btop/otty.tomlThe file this page is generated from

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"]

Use it with your dotfile manager

Same data, in the shape your tool already reads

Opens Otty and adds this tool to what it syncs

Opens otty://sync/add/btop. Otty ships with this catalog, so the link only has to name the tool — nothing is downloaded.

Every one of these is generated from the same rules as this page. None of them splits net_iface for you — that part is Otty’s own sync, or a template you write by hand.