Where Is the btop Config File?
btop btop.conf location under ~/.config/btop and where themes go.
Last updated
btop stores settings in btop.conf inside its XDG config directory, written out on first launch with commented defaults. Themes sit in a themes subfolder next to it.
Edit while btop is closed or use the in-app options menu, which writes the same file. Deleting the file is the fastest reset.
Where btop stores this, by platform
~/.config/btop/btop.conf
Main config with every toggle documented inline. Custom themes go in ~/.config/btop/themes as .theme files.
~/.config/btop/btop.conf
Same path and format as Linux. Some collectors behave differently on macOS, so check the proc and net options after migrating a Linux config.
Frequently asked questions
How do I reset btop settings?
Quit btop, delete btop.conf, and relaunch. A fresh annotated default is generated automatically.
Where do btop themes go?
In the themes subfolder next to btop.conf, selected from the options menu or the color_theme line.
Notice an outdated path? Let us know.