[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"project-70846":3},{"id":4,"name":5,"fullName":6,"owner":7,"repo":5,"description":8,"homepage":9,"htmlUrl":10,"language":11,"languages":10,"totalLinesOfCode":10,"stars":12,"forks":13,"watchers":14,"openIssues":15,"contributorsCount":16,"subscribersCount":16,"size":16,"stars1d":17,"stars7d":18,"stars30d":19,"stars90d":16,"forks30d":16,"starsTrendScore":20,"compositeScore":21,"rankGlobal":10,"rankLanguage":10,"license":22,"archived":23,"fork":23,"defaultBranch":24,"hasWiki":25,"hasPages":23,"topics":26,"createdAt":10,"pushedAt":10,"updatedAt":27,"readmeContent":28,"aiSummary":29,"trendingCount":16,"starSnapshotCount":16,"syncStatus":17,"lastSyncTime":30,"discoverSource":31},70846,"bashtop","aristocratos\u002Fbashtop","aristocratos","Linux\u002FOSX\u002FFreeBSD resource monitor","",null,"Shell",11111,552,161,60,0,2,3,9,6,74.63,"Apache License 2.0",false,"master",true,[],"2026-06-12 04:00:57","# ![bashtop](Imgs\u002Flogo-t.png)\n\n![Linux](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002F-Linux-grey?logo=linux)\n![OSX](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002F-OSX-black?logo=apple)\n![FreeBSD](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002F-FreeBSD-red?logo=freebsd)\n![Usage](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FUsage-System%20resource%20monitor-blue)\n![Bash](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FBash-v4.4%5E-green?logo=GNU%20bash)\n![Python](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FPython-v3.6%5E-orange?logo=python)\n![bashtop_version](https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Fv\u002Ftag\u002Faristocratos\u002Fbashtop?label=version)\n[![Build Status](https:\u002F\u002Ftravis-ci.com\u002Faristocratos\u002Fbashtop.svg?branch=master)](https:\u002F\u002Ftravis-ci.com\u002Faristocratos\u002Fbashtop)\n[![Donate](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002F-Donate-yellow?logo=paypal)](https:\u002F\u002Fpaypal.me\u002Faristocratos)\n[![Sponsor](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002F-Sponsor-red?logo=github)](https:\u002F\u002Fgithub.com\u002Fsponsors\u002Faristocratos)\n[![Coffee](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002F-Buy%20me%20a%20Coffee-grey?logo=Ko-fi)](https:\u002F\u002Fko-fi.com\u002Faristocratos)\n\n### C++ Version\n\n##### 18 September 2021\n\n![btop++](https:\u002F\u002Fraw.githubusercontent.com\u002Faristocratos\u002Fbtop\u002Fmain\u002FImg\u002Flogo.png)\n\nThe C++ version of bashtop - btop++ is available.\n\nGet it at https:\u002F\u002Fgithub.com\u002Faristocratos\u002Fbtop\n\n#\n\n## Index\n\n* [Documents](#documents)\n* [Description](#description)\n* [Features](#features)\n* [Themes](#themes)\n* [Support and funding](#support-and-funding)\n* [Prerequisites](#prerequisites)\n* [Dependencies](#dependencies)\n* [Screenshots](#screenshots)\n* [Installation](#installation)\n* [Configurability](#configurability)\n* [TODO](#todo)\n* [License](#license)\n\n\n## Documents\n\n#### [CHANGELOG.md](CHANGELOG.md)\n\n#### [CONTRIBUTING.md](CONTRIBUTING.md)\n\n#### [CODE_OF_CONDUCT.md](CODE_OF_CONDUCT.md)\n\n## Description\n\nResource monitor that shows usage and stats for processor, memory, disks, network and processes.\n\n## Features\n\n* Easy to use, with a game inspired menu system.\n* Fast and \"mostly\" responsive UI with UP, DOWN keys process selection.\n* Function for showing detailed stats for selected process.\n* Ability to filter processes.\n* Easy switching between sorting options.\n* Send SIGTERM, SIGKILL, SIGINT to selected process.\n* UI menu for changing all config file options.\n* Auto scaling graph for network usage.\n* Shows message in menu if new version is available\n* Shows current read and write speeds for disks\n* Multiple data collection methods which can be switched if running on Linux\n\n## Themes\n\nBashtop now has theme support and a function to download missing local themes from repository.\n\nSee [themes](themes) folder for available themes.\n\nThe builtin theme downloader places the default themes in `$HOME\u002F.config\u002Fbashtop\u002Fthemes`.\nUser created themes should be placed in `$HOME\u002F.config\u002Fbashtop\u002Fuser_themes` to be safe from overwrites.\n\nLet me know if you want to contribute with new themes.\n\n## Support and funding\n\nBug 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.\nI'm looking into ways of funding this project that would allow me to take off time from my day job to work on this.\n\nAny advice on how to get funding for open source projects is very welcome!\n\n#### Update\n\nYou can now sponsor this project through github, see [my sponsors page](https:\u002F\u002Fgithub.com\u002Fsponsors\u002Faristocratos) for options.\n\nAlso added donation links for [paypal](https:\u002F\u002Fpaypal.me\u002Faristocratos) and [ko-fi](https:\u002F\u002Fko-fi.com\u002Faristocratos).\n\nAny support is greatly appreciated!\n\n## Prerequisites\n\n#### Mac Os X\n\nWill not display correctly in the standard terminal!\nRecommended alternative [iTerm2](https:\u002F\u002Fwww.iterm2.com\u002F)\n\nWill also need to be run as superuser to display stats for processes not owned by user.\n\n#### Linux, Mac Os X and FreeBSD\n\nFor correct display, a terminal with support for:\n\n* 24-bit truecolor ([See list of terminals with truecolor support](https:\u002F\u002Fgist.github.com\u002FXVilka\u002F8346728))\n* Wide characters (Are sometimes problematic in web-based terminals)\n\nAlso needs a UTF8 locale and a font that covers:\n\n* Unicode Block “Braille Patterns” U+2800 - U+28FF\n* Unicode Block “Geometric Shapes” U+25A0 - U+25FF\n* Unicode Block \"Box Drawing\" and \"Block Elements\" U+2500 - U+259F\n\n#### Notice\n\nDropbear seems to not be able to set correct locale. So if accessing bashtop over ssh, OpenSSH is recommended.\n\n## Dependencies\n\n## Linux, OSX and FreeBSD\n\n**[bash](https:\u002F\u002Fwww.gnu.org\u002Fsoftware\u002Fbash\u002F)** (v4.4 or later) Script functionality will most probably break with earlier versions.\nBash version 5 is highly recommended to make use of $EPOCHREALTIME variable instead of a lot of external date command calls.\n\n**[GNU coreutils](https:\u002F\u002Fwww.gnu.org\u002Fsoftware\u002Fcoreutils\u002F)**\n\n**[GNU sed](https:\u002F\u002Fwww.gnu.org\u002Fsoftware\u002Fsed\u002F)**\n\n## Linux using \u002Fproc for data collection\n\n**[GNU grep](https:\u002F\u002Fwww.gnu.org\u002Fsoftware\u002Fgrep\u002F)**\n\n**[ps from procps-ng](https:\u002F\u002Fgitlab.com\u002Fprocps-ng\u002Fprocps)** (v3.1.15 or later)\n\n**[GNU awk](https:\u002F\u002Fwww.gnu.org\u002Fsoftware\u002Fgawk\u002F)**\n\n## OSX and FreeBSD or Linux using psutil for data collection\n\n**[Python3](https:\u002F\u002Fwww.python.org\u002Fdownloads\u002F)** (v3.6 or later)\n\n**[psutil python module](https:\u002F\u002Fgithub.com\u002Fgiampaolo\u002Fpsutil)** (v5.7.0 or later)\n\n## Optionals for additional stats\n\n(Optional OSX) **[osx-cpu-temp](https:\u002F\u002Fgithub.com\u002Flavoiesl\u002Fosx-cpu-temp)** Needed to show CPU temperatures.\n\n(Optional Linux) **[lm-sensors](https:\u002F\u002Fgithub.com\u002Flm-sensors\u002Flm-sensors)** Needed to show CPU temperatures.\n\n(Optional Linux) **[iostat (part of sysstat)](https:\u002F\u002Fgithub.com\u002Fsysstat\u002Fsysstat)** Needed if you want disk read\u002Fwrite stats and are not using psutil data collection.\n\n(Optional OSX\u002FLinux\u002FFreeBSD) **[curl](https:\u002F\u002Fcurl.haxx.se\u002Fdownload.html)** (v7.16.2 or later) Needed if you want messages about updates and the ability to download themes.\n\n## Screenshots\n\nMain UI showing details for a selected process.\n![Screenshot 1](Imgs\u002Fmain.png)\n\nMain menu.\n![Screenshot 2](Imgs\u002Fmenu.png)\n\nOptions menu.\n![Screenshot 3](Imgs\u002Foptions.png)\n\n## Installation\n\n#### Dependencies installation OSX\n\n>Install homebrew if not already installed\n\n``` bash\n\u002Fbin\u002Fbash -c \"$(curl -fsSL https:\u002F\u002Fraw.githubusercontent.com\u002FHomebrew\u002Finstall\u002Fmaster\u002Finstall.sh)\"\n```\n\n\n\n>If you got python 3.6 or later installed outside of brew:\n\n``` bash\nsudo python3 -m ensurepip\nsudo python3 -m pip install psutil\n```\n\n>If you haven't got python3 installed:\n\n```\nbrew install python3\npython3 -m pip install psutil\n```\n\n>Install dependencies\n\n\n``` bash\nbrew install bash coreutils gnu-sed git\n```\n\n>Install optional dependency osx-cpu-temp\n\n``` bash\nbrew install osx-cpu-temp\n```\n\n#### Dependencies installation FreeBSD\n\n>Install with pkg and pip\n\n``` bash\nsudo pkg install coreutils gsed git py37-psutil\n```\n\n#### Manual installation Linux, OSX and FreeBSD\n\n>Clone and install\n\n``` bash\ngit clone https:\u002F\u002Fgithub.com\u002Faristocratos\u002Fbashtop.git\ncd bashtop\nsudo make install\n```\n\n>to uninstall it\n\n``` bash\nsudo make uninstall\n```\n\n#### FreeBSD package\n\nAvailable in [FreeBSD ports](https:\u002F\u002Fwww.freshports.org\u002Fsysutils\u002Fbashtop\u002F)\n\nInstall pre-built pacakge\n\n``` bash\nsudo pkg install bashtop\n```\n\n#### Arch based\n\nAvailable in the AUR as [bashtop-git](https:\u002F\u002Faur.archlinux.org\u002Fpackages\u002Fbashtop-git\u002F)\n\nAvailable in the Arch Linux repository as [bashtop](https:\u002F\u002Fwww.archlinux.org\u002Fpackages\u002Fcommunity\u002Fany\u002Fbashtop\u002F)\n\n#### Debian based\n\nAvailable in [official Debian repository](https:\u002F\u002Ftracker.debian.org\u002Fpkg\u002Fbashtop) since Debian 11\n\nAvailable for debian\u002Fubuntu from [Azlux's repository](http:\u002F\u002Fpackages.azlux.fr\u002F)\n\nOr use quick installation:\n\n>Quick install go to DEB  folder  and type\n\n``` bash\n sudo .\u002Fbuild\n```\n\n>to uninstall it   go to DEB  folder  and type\n\n``` bash\n sudo .\u002Fbuild --remove\n```\n\n#### Guix based\n\nAvailable in [official Guix repository](https:\u002F\u002Fgit.savannah.gnu.org\u002Fcgit\u002Fguix.git\u002Ftree\u002Fgnu\u002Fpackages\u002Fadmin.scm) since 6bbd0fd2\n\n>Installation\n\n``` bash\nguix install bashtop\n```\n\n#### Ubuntu based\n\nAvailable in [official Ubuntu repository](https:\u002F\u002Flaunchpad.net\u002Fubuntu\u002F+source\u002Fbashtop) since Ubuntu 20.10\n\nAvailable for Ubuntu from [PPA repository](https:\u002F\u002Fcode.launchpad.net\u002F~bashtop-monitor\u002F+archive\u002Fubuntu\u002Fbashtop)\n\n>Add PPA repository and install bashtop\n\n``` bash\n sudo add-apt-repository ppa:bashtop-monitor\u002Fbashtop\n sudo apt update\n sudo apt install bashtop\n```\n\n#### Fedora\n\nAvailable in the Fedora repository.\n\n>Installation\n\n``` bash\nsudo dnf install bashtop\n```\n\n#### CentOS 8\n\n>Installation\n\n``` bash\ndnf config-manager --set-enabled PowerTools\ndnf install epel-release\ndnf install bashtop\n```\n\n#### RHEL 8\n\n>Installation\n\n``` bash\nARCH=$( \u002Fbin\u002Farch )\nsubscription-manager repos --enable\n\"codeready-builder-for-rhel-8-${ARCH}-rpms\"\ndnf install epel-release\ndnf install bashtop\n```\n\n## Configurability\n\nAll options changeable from within UI.\nConfig files stored in \"$HOME\u002F.config\u002Fbashtop\" folder\n\n#### bashtop.cfg: (auto generated if not found)\n\n```bash\n#? Config file for bashtop v. 0.9.21\n\n#* Color theme, looks for a .theme file in \"$HOME\u002F.config\u002Fbashtop\u002Fthemes\" and \"$HOME\u002F.config\u002Fbashtop\u002Fuser_themes\"\n#* Should be prefixed with either \"themes\u002F\" or \"user_themes\u002F\" depending on location, \"Default\" for builtin default theme\ncolor_theme=\"Default\"\n\n#* Update time in milliseconds, increases automatically if set below internal loops processing time, recommended 2000 ms or above for better sample times for graphs\nupdate_ms=\"2500\"\n\n#* Processes sorting, \"pid\" \"program\" \"arguments\" \"threads\" \"user\" \"memory\" \"cpu lazy\" \"cpu responsive\"\n#* \"cpu lazy\" updates sorting over time, \"cpu responsive\" updates sorting directly\nproc_sorting=\"cpu lazy\"\n\n#* Reverse sorting order, \"true\" or \"false\"\nproc_reversed=\"false\"\n\n#* Show processes as a tree\nproc_tree=\"false\"\n\n#* Check cpu temperature, only works if \"sensors\", \"vcgencmd\" or \"osx-cpu-temp\" commands is available\ncheck_temp=\"true\"\n\n#* Draw a clock at top of screen, formatting according to strftime, empty string to disable\ndraw_clock=\"%X\"\n\n#* Update main ui when menus are showing, set this to false if the menus is flickering too much for comfort\nbackground_update=\"true\"\n\n#* Custom cpu model name, empty string to disable\ncustom_cpu_name=\"\"\n\n#* Enable error logging to \"$HOME\u002F.config\u002Fbashtop\u002Ferror.log\", \"true\" or \"false\"\nerror_logging=\"true\"\n\n#* Show color gradient in process list, \"true\" or \"false\"\nproc_gradient=\"true\"\n\n#* If process cpu usage should be of the core it's running on or usage of the total available cpu power\nproc_per_core=\"false\"\n\n#* Optional filter for shown disks, should be names of mountpoints, \"root\" replaces \"\u002F\", separate multiple values with space\ndisks_filter=\"\"\n\n#* Enable check for new version from github.com\u002Faristocratos\u002Fbashtop at start\nupdate_check=\"true\"\n\n#* Enable graphs with double the horizontal resolution, increases cpu usage\nhires_graphs=\"false\"\n\n#* Enable the use of psutil python3 module for data collection, default on OSX\nuse_psutil=\"true\"\n```\n\n#### Command line options: (not yet implemented)\n\n``` bash\nUSAGE: bashtop\n\n```\n\n## TODO\n\nMight finish off items out of order since I usually work on multiple at a time.\n\n- [x] Add options to change colors for text, graphs and meters.\n- [x] Fix cross platform compatibility for Mac OSX and *BSD: Working on OSX, and FreeBSD.\n- [x] Add support for showing AMD cpu temperatures.\n- [x] Add option to show tree view of processes.\n- [x] Add option to reset network download\u002Fupload totals.\n- [x] Add option to turn of gradient in processes list.\n- [ ] Add gpu temp and usage. (If feasible)\n- [x] Add io stats for disks.\n- [ ] Add cpu and mem stats for docker containers. (If feasible)\n- [x] Change process list to line scroll instead of page change.\n- [ ] Add optional window for tailing log files.\n- [ ] Add options for resizing all boxes.\n- [ ] Add command line argument parsing.\n- [ ] Builtin updater. Relevant PR #96 by Jukoo\n- [ ] Add support for zram in memory box. Relevant PR #122 by perkinslr\n\n- [ ] Miscellaneous optimizations and code cleanup.\n- [ ] Add more commenting where it's sparse.\n\n- [ ] Python port. (Porting started)\n\n## LICENSE\n\n[Apache License 2.0](LICENSE)\n","bashtop 是一个适用于 Linux、OSX 和 FreeBSD 的系统资源监控工具。它提供了处理器、内存、磁盘、网络及进程的使用情况和统计数据，具有直观易用的游戏风格菜单系统，支持快速响应的用户界面，包括上下键选择进程、显示选定进程详细信息、过滤进程、切换排序选项等功能，并允许用户向选中进程发送 SIGTERM、SIGKILL 或 SIGINT 信号。此外，bashtop 还支持自动缩放网络使用图表、版本更新提示、实时磁盘读写速度展示以及多种数据收集方法等特性。其界面美观且可自定义主题，适合需要高效管理和监控系统资源的技术人员或系统管理员在日常运维工作中使用。","2026-06-11 03:34:30","high_star"]