bashtop  0.9.25
About: Bashtop is a resource monitor that shows usage and stats for processor, memory, disks, network and processes.
  Fossies Dox: bashtop-0.9.25.tar.gz  ("unofficial" and yet experimental doxygen-generated source code documentation)  

bashtop Documentation

Some Fossies usage hints in advance:

  1. To see the Doxygen generated documentation please click on one of the items in the steelblue colored "quick index" bar above or use the side panel at the left which displays a hierarchical tree-like index structure and is adjustable in width.
  2. If you want to search for something by keyword rather than browse for it you can use the client side search facility (using Javascript and DHTML) that provides live searching, i.e. the search results are presented and adapted as you type in the Search input field at the top right.
  3. Doxygen doesn't incorporate all member files but just a definable subset (basically the main project source code files that are written in a supported language). So to search and browse all member files you may visit the Fossies bashtop-0.9.25.tar.gz contents page and use the Fossies standard member browsing features (also with source code highlighting and additionally with optional code folding).


Linux OSX FreeBSD Usage Bash Python bashtop_version Build Status Donate Sponsor Coffee




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


  • Easy to use, with a game inspired menu system.
  • Fast and "mostly" responsive UI with UP, DOWN keys process selection.
  • Function for showing detailed stats for selected process.
  • Ability to filter processes.
  • Easy switching between sorting options.
  • Send SIGTERM, SIGKILL, SIGINT to selected process.
  • UI menu for changing all config file options.
  • Auto scaling graph for network usage.
  • Shows message in menu if new version is available
  • Shows current read and write speeds for disks
  • Multiple data collection methods which can be switched if running on Linux


Bashtop now has theme support and a function to download missing local themes from repository.

See themes folder for available themes.

The builtin theme downloader places the default themes in $HOME/.config/bashtop/themes. User created themes should be placed in $HOME/.config/bashtop/user_themes to be safe from overwrites.

Let me know if you want to contribute with new themes.


Python port: bpytop

Currently working full time on this during my vacation :) I'm aiming to have a first release by end of July.

Support and funding

Bug fixes and updates might be slow during normal workdays since I work full time as an industrial worker and don't have much time or energy left during the week. I'm looking into ways of funding this project that would allow me to take off time from my day job to work on this.

Any advice on how to get funding for open source projects is very welcome!


You can now sponsor this project through github, see my sponsors page for options.

Also added donation links for paypal and ko-fi.

Any support is greatly appreciated!


Mac Os X

Will not display correctly in the standard terminal! Recommended alternative iTerm2

Will also need to be run as superuser to display stats for processes not owned by user.

Linux, Mac Os X and FreeBSD

For correct display, a terminal with support for:

Also needs a UTF8 locale and a font that covers:

  • Unicode Block “Braille Patterns” U+2800 - U+28FF
  • Unicode Block “Geometric Shapes” U+25A0 - U+25FF
  • Unicode Block "Box Drawing" and "Block Elements" U+2500 - U+259F


Dropbear seems to not be able to set correct locale. So if accessing bashtop over ssh, OpenSSH is recommended.


Linux, OSX and FreeBSD

bash (v4.4 or later) Script functionality will most probably break with earlier versions. Bash version 5 is highly recommended to make use of $EPOCHREALTIME variable instead of a lot of external date command calls.

GNU coreutils

GNU sed

Linux using /proc for data collection

GNU grep

ps from procps-ng (v3.1.15 or later)

GNU awk

OSX and FreeBSD or Linux using psutil for data collection

Python3 (v3.6 or later)

psutil python module (v5.7.0 or later)

Optionals for additional stats

(Optional OSX) osx-cpu-temp Needed to show CPU temperatures.

(Optional Linux) lm-sensors Needed to show CPU temperatures.

(Optional Linux) iostat (part of sysstat) Needed if you want disk read/write stats and are not using psutil data collection.

(Optional OSX/Linux/FreeBSD) curl (v7.16.2 or later) Needed if you want messages about updates and the ability to download themes.


Main UI showing details for a selected process. Screenshot 1

Main menu. Screenshot 2

Options menu. Screenshot 3


Dependencies installation OSX

Install homebrew if not already installed

/bin/bash -c "$(curl -fsSL"

If you got python 3.6 or later installed outside of brew:

sudo python3 -m ensurepip
sudo python3 -m pip install psutil

If you haven't got python3 installed:

brew install python3
python3 -m pip install psutil

Install dependencies

brew install bash coreutils gnu-sed git

Install optional dependency osx-cpu-temp

brew install osx-cpu-temp

Dependencies installation FreeBSD

Install with pkg and pip

sudo pkg install coreutils gsed python3 git
sudo python3 -m ensurepip
sudo pip3 install psutil

Manual installation Linux, OSX and FreeBSD

Clone and install

git clone
cd bashtop
sudo make install

to uninstall it

sudo make uninstall

Arch based

Available in the AUR as bashtop-git

Available in the Arch Linux repository as bashtop

Debian based

Available in official Debian repository since Debian 11

Available for debian/ubuntu from Azlux's repository

Or use quick installation:

Quick install go to DEB folder and type

 sudo ./build

to uninstall it go to DEB folder and type

 sudo ./build --remove

Ubuntu based

Available in official Ubuntu repository since Ubuntu 20.10

Available for Ubuntu from PPA repository

Add PPA repository and install bashtop

 sudo add-apt-repository ppa:bashtop-monitor/bashtop
 sudo apt update
 sudo apt install bashtop


Available in the Fedora repository.


sudo dnf install bashtop

CentOS 8


dnf config-manager --set-enabled PowerTools
dnf install epel-release
dnf install bashtop



ARCH=$( /bin/arch )
subscription-manager repos --enable
dnf install epel-release
dnf install bashtop


All options changeable from within UI. Config files stored in "$HOME/.config/bashtop" folder

bashtop.cfg: (auto generated if not found)

#? Config file for bashtop v. 0.9.21

#* Color theme, looks for a .theme file in "$HOME/.config/bashtop/themes" and "$HOME/.config/bashtop/user_themes"
#* Should be prefixed with either "themes/" or "user_themes/" depending on location, "Default" for builtin default theme

#* Update time in milliseconds, increases automatically if set below internal loops processing time, recommended 2000 ms or above for better sample times for graphs

#* Processes sorting, "pid" "program" "arguments" "threads" "user" "memory" "cpu lazy" "cpu responsive"
#* "cpu lazy" updates sorting over time, "cpu responsive" updates sorting directly
proc_sorting="cpu lazy"

#* Reverse sorting order, "true" or "false"

#* Show processes as a tree

#* Check cpu temperature, only works if "sensors", "vcgencmd" or "osx-cpu-temp" commands is available

#* Draw a clock at top of screen, formatting according to strftime, empty string to disable

#* Update main ui when menus are showing, set this to false if the menus is flickering too much for comfort

#* Custom cpu model name, empty string to disable

#* Enable error logging to "$HOME/.config/bashtop/error.log", "true" or "false"

#* Show color gradient in process list, "true" or "false"

#* If process cpu usage should be of the core it's running on or usage of the total available cpu power

#* Optional filter for shown disks, should be names of mountpoints, "root" replaces "/", separate multiple values with space

#* Enable check for new version from at start

#* Enable graphs with double the horizontal resolution, increases cpu usage

#* Enable the use of psutil python3 module for data collection, default on OSX

Command line options: (not yet implemented)

USAGE: bashtop


Might finish off items out of order since I usually work on multiple at a time.

  • Add options to change colors for text, graphs and meters.
  • Fix cross platform compatibility for Mac OSX and *BSD: Working on OSX, and FreeBSD.
  • Add support for showing AMD cpu temperatures.
  • Add option to show tree view of processes.
  • Add option to reset network download/upload totals.
  • Add option to turn of gradient in processes list.
  • Add gpu temp and usage. (If feasible)
  • Add io stats for disks.
  • Add cpu and mem stats for docker containers. (If feasible)
  • Change process list to line scroll instead of page change.
  • Add optional window for tailing log files.
  • Add options for resizing all boxes.
  • Add command line argument parsing.
  • Builtin updater. Relevant PR #96 by Jukoo
  • Add support for zram in memory box. Relevant PR #122 by perkinslr
  • Miscellaneous optimizations and code cleanup.
  • Add more commenting where it's sparse.
  • Python port. (Porting started)


Apache License 2.0