Skip to content
Interactive package manager and resource monitor designed for the GNU/Linux.
Go Dockerfile
Branch: master
Clone or download
Type Name Latest commit message Commit time
Failed to load latest commit information.
.github Update files due to username change Sep 12, 2019
docker Update files due to username change Sep 12, 2019
src Update files due to username change Sep 12, 2019
.gitignore Initial commit Jul 19, 2019
.travis.yml Add travis configuration file Aug 15, 2019
LICENSE Add LICENSE (gplv3) Aug 24, 2019 Update dockerhub build badge II Sep 12, 2019


pkgtop is an interactive package manager & resource monitor tool designed for the GNU/Linux.

Release AUR Travis Build Docker Build Codacy Badge Go Report Card Stars License


Package management (install/upgrade/remove etc.) can be a problem if the user is not familiar with the operating system or the required command for that operation. So pkgtop tries to solve this problem with an easy-to-use terminal interface and shortcut keys. Briefly, pkgtop aims to provide a terminal dashboard for managing packages on GNU/Linux systems. Using the terminal dashboard, it's possible to list installed packages by size (or alphabetically with -a argument), show information about the package, install/upgrade/remove packages and search package. Also, there are other handy shortcuts for easing the package management process which mentioned in the usage information.

In addition to the package management features, there's a section at the top of the dashboard that shows disk usages and general system information. For example, this section can be used as a resource monitor and help decide whether the system should be cleaned or not.
Another useful section is the 'executed' or 'confirm to execute' command list which is placed below the installed packages. Thus, the user can see which command executed recently or confirm & execute the selected command. (The commands that need confirmation to execute exist in the list with a prefix like "[y]".) After scrolling the commands list with "c" key for selecting the command to execute, press "y" for executing it. pkgtop will execute the command and restart the terminal dashboard afterwards.

pkgtop uses the advantage of mainly used package managers being installed on most of the preferred GNU/Linux distributions. As an example, it works on a Manjaro based system as it works on Arch Linux systems since both distributions use the Pacman package manager. You can use pkgtop if you have one of the package managers listed below.

  • pacman
  • apt
  • zypp
  • dnf
  • xbps
  • portage
  • nix
  • guix

If the distribution is not defined in the source but has the required package manager for running the pkgtop, -d argument can be used for specifying a distribution that has the same package manager. Current defined and supported distributions are arch, manjaro, debian, ubuntu, mint, suse, fedora, centos, redhat, void, gentoo, nixos, guix.


• Dependencies

• AUR (pkgtop-git)

git clone && cd pkgtop-git/
makepkg --install

• Manual Installation

go get ./...
go build src/pkgtop.go
sudo mv pkgtop /usr/local/bin/

Preferably, go install command can be used.

Command-Line Arguments

-h, show help message
-d, select linux distribution
-c, main color of the dashboard (default: blue)
   [red, green, yellow, blue, magenta, cyan, white]
-a, sort packages alphabetically
-r, reverse the package list
-v, print version


Key Action
? help
enter, space, tab show package information
i install package
u/ctrl-u upgrade package/with input
r/ctrl-r remove package/with input
s,/ search package
g go to package (index)
y confirm and execute the selected command
p copy selected package
e copy selected command
c scroll executed commands list
j/k, down/up scroll down/up (packages)
ctrl-j/ctrl-k scroll to bottom/top (packages)
l/h, right/left scroll down/up (disk usage)
backspace go back
q, esc, ctrl-c, ctrl-d exit

List Installed Packages & Show Package Information

List Packages & Show Information

pressed keys: down, enter, backspace

Search, Go-to Package

Search, Go-to Package

pressed keys: s, (type), enter, g, (type), enter

Install, Upgrade, Remove Package

Install, Upgrade, Remove Package

pressed keys:
i, (type), enter, y -> install
ctrl-u, (type), enter, y -> upgrade
ctrl-r, (type), enter, y -> remove

Show Disk Usage Information

Show Disk Usage Information

pressed keys: right, left

Confirm Command to Execute

Confirm Command to Execute

pressed keys: c, y

Show Help

Show Help

pressed key: ?


Build Docker Image

docker build -f docker/Dockerfile -t pkgtop-docker .

Run the Container

docker run pkgtop-docker

Start a shell in the Container

docker run -it pkgtop-docker /bin/ash


Fedora Screenshot

Manjaro-Mint Screenshot

Debian-Ubuntu Screenshot


  • Add 'paste' feature


If you would like to support the development of pkgtop or other projects on my GitHub, consider becoming a sponsor. Very appreciated!

Become a Patron!


GNU General Public License v3. (see gpl)


Copyright (C) 2019 by orhun

You can’t perform that action at this time.