Index
Documents
Description
Resource monitor that shows usage and stats for processor, memory, disks, network and processes.
Features
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
Themes
Bashtop now has theme support and a function to download missing local themes from repository.
See themes folder for available themes.
Let me know if you want to contribute with new themes.
Upcoming
(Python port)
Currently rewriting to use python3 psutil for data collection instead of linux specific tools.
This will add python 3 and psutil as dependencies, but will make bashtop cross platform compatible.
This will be integrated in to main version when done and add the possibility to switch between psutil and linux tools for users running linux.
Bashtop is now Mac OS X compatible!
Update
Work on a complete python port will begin this summer has begun. My aim is to keep it compatible with pypy3 for a lot of added efficiency.
PyPyTop?
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!
Update
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!
Compatibility
Should work on most modern linux distributions and on Mac OS X.
Will not display correctly on the standard terminal on OSX!
Recommended alternative iTerm2
Will also need to be run as superuser on OSX to display stats for processes not owned by user.
The disk io stats on OSX shows iostats for all disks at the top instead of per disk because of limitations with psutil on OSX.
For correct display, a terminal with support for:
24-bit truecolor
Wide characters
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
Notice
Dropbear seems to not be able to set correct locale. So if accessing bashtop over ssh, OpenSSH is recommended.
Dependencies
Linux and OSX
Linux using /proc for data collection
OSX or Linux using psutil for data collecton
Optionals for additional stats
(Optional OSX)
(Optional Linux)
(Optional Linux)
(Optional OSX/Linux)
Screenshots
Main UI showing details for a selected process.
Main menu.
Options menu.
Installation
Dependencies installation OSX
Install homebrew if not already installed
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install.sh)"
Install dependencies
brew installbash coreutils gnu-sed python3 git
pip3 installpsutil
Install optional dependency osx-cpu-temp
git clone https://github.com/lavoiesl/osx-cpu-temp.git
cdosx-cpu-temp
make
sudomake install
Manual installation Linux and OSX
Clone and install
git clone https://github.com/aristocratos/bashtop.git
cdbashtop
sudomake install
to uninstall it
sudomake uninstall
Arch based
Available in the AUR as bashtop-git
Available in the Arch Linux repository as bashtop (Flagged out-of-date on 2020-04-28)
Debian based
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 for Ubuntu from PPA repository
Add PPA repository and install bashtop
sudoadd-apt-repository ppa:bashtop-monitor/bashtop
sudoapt update
sudoapt installbashtop
Fedora
Available in the Fedora repository.
Installation
sudodnf installbashtop
CentOS
Installation
dnf config-manager --set-enabled PowerTools
dnf installepel-release
dnf installbashtop
RHEL 8
Installation
ARCH=$( /bin/arch )
subscription-manager repos --enable
"codeready-builder-for-rhel-8-${ARCH}-rpms"
dnf installepel-release
dnf installbashtop
Configurability
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.0
#* Color theme, looks for a .theme file in "$HOME/.config/bashtop/themes", "Default" for builtin default theme
color_theme="Default"
#* Update time in milliseconds, increases automatically if set below internal loops processing time, recommended 2000 ms or above for better sample times for graphs
update_ms="2500"
#* Processes sorting, "pid" "program" "arguments" "threads" "user" "memory" "cpu lazy" "cpu responsive" "tree"
#* "cpu lazy" updates sorting over time, "cpu responsive" updates sorting directly at a cpu usage cost
proc_sorting="cpu lazy"
#* Reverse sorting order, "true" or "false"
proc_reversed="false"
#* Check cpu temperature, only works if "sensors", "vcgencmd" or "osx-cpu-temp" commands is available
check_temp="true"
#* Draw a clock at top of screen, formatting according to strftime, empty string to disable
draw_clock="%X"
#* Update main ui when menus are showing, set this to false if the menus is flickering too much for comfort
background_update="true"
#* Custom cpu model name, empty string to disable
custom_cpu_name=""
#* Enable error logging to "$HOME/.config/bashtop/error.log", "true" or "false"
error_logging="true"
#* Show color gradient in process list, "true" or "false"
proc_gradient="true"
#* If process cpu usage should be of the core it's running on or usage of the total available cpu power
proc_per_core="false"
#* Optional filter for shown disks, should be names of mountpoints, "root" replaces "/", separate multiple values with space
disks_filter=""
#* Enable check for new version from github.com/aristocratos/bashtop at start
update_check="true"
#* Enable graphs with double the horizontal resolution, increases cpu usage
hires_graphs="false"
#* Enable the use of psutil python3 module for data collection, default on OSX
use_psutil="true"
Command line options: (not yet implemented)
USAGE: bashtop
TODO
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, not fully tested on *BSD.
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 option for custom color gradient in process list in theme settings.
Add optional window for tailing log files.
Add options for resizing all boxes.
Add command line argument parsing.
Miscellaneous optimizations and code cleanup.
Add more commenting where it's sparse.
Python port.
LICENSE