btop(1)

💖 btop — the manual page, but make it cute 💖

okay bestie, welcome to btop(1) — that's the manual page for btop, and it lives in the User Commands section, so you already know it's the good stuff. grab a strawberry 🍓 and let's go.

---

✨ NAME ✨

btop — a resource monitor that shows usage and stats for processor, memory, disks, network, and processes. yes, ALL of them. she does it all. 👑

---

🎀 SYNOPSIS 🎀

btop [-c file] [-d] [-f filter] [-l] [-p id] [-t] [-u ms] [--force-utf]
[--themes-dir dir]

btop [--default-config | {-h | --help} | {-V | --version}]

---

🦋 DESCRIPTION 🦋

btop is literally a program that shows usage and stats for processor, memory, disks, network, and processes. that's the whole vibe. she's watching your machine's every move and honestly? she's serving. 💅

---

🌸 OPTIONS 🌸

the program follows the usual GNU command line syntax, and long options start with two dashes (-). a summary of options is included below, and no we are NOT skipping any of them, periodt.

• -c, --config file — path to a config file.
• -d, --debug — start in debug mode with additional logs and metrics. extra receipts, basically. 🔍
• -f, --filter filter — set an initial process filter. like a search bar but make it command line.
• --force-utf — force start even if no UTF-8 locale was detected. she's not taking no for an answer. 💪
• -l, --low-color — disable true color, 256 colors only. still cute, just on a budget.
• -p, --preset id — start with a preset (0-9).
• -t, --tty — force tty mode with ANSI graph symbols and 16 colors only. retro era activated. 👾
• --no-tty — force disable tty mode.
• --themes-dir dir — path to a custom themes directory. when specified, this directory takes priority over the default theme search paths. your themes, your rules, main character energy. ✨
• -u, --update ms — set an initial update rate in milliseconds.
• --default-config — print default config to standard output. free config, no cap.
• -h, --help — show summary of options.
• -V, --version — show version of program.

---

😭 BUGS 😭

the upstream bug tracker can be found at https://github.com/aristocratos/btop/issues. if something's acting up, that's the place to spill. 🫶

---

💜 SEE ALSO 💜

top(1), htop(1) — the cousins. iykyk.

---

🌈 AUTHOR 🌈

btop was written by Jakob P. Liljenberg a.k.a. “Aristocratos”. an absolute icon, we stan. 👑

---

and that's a wrap on this lil manual page, dated 2025-05-01 and filed under btop(1) — same title, same date, same page, just with way more sparkle. bye bestie, go monitor something 💖🧚