pkgtop

Show largest installed packages.

Installation

curl https://raw.githubusercontent.com/SharUpOff/pkgtop/main/dist/pkgtop.sh -so - | sudo tee /usr/local/bin/pkgtop > /dev/null

sudo chmod 755 /usr/local/bin/pkgtop

Usage

pkgtop

Output:

libc6.............................................................. 13.27 MiB perl-base.......................................................... 7.59 MiB coreutils.......................................................... 6.95 MiB dpkg............................................................... 6.58 MiB libssl3............................................................ 5.69 MiB apt................................................................ 4.06 MiB util-linux......................................................... 3.32 MiB libapt-pkg6.0...................................................... 3.10 MiB libstdc++6......................................................... 2.69 MiB libc-bin........................................................... 2.48 MiB 

The colour output makes it possible to compare installed packages visually:

Arguments

$ pkgtop [lines [columns]] [--skip <count>] [--exclude <name>] [--mark <name>] [--other] [--total] [--all] [--raw] [--version] [--help]

Features

• Follow terminal and prompt dimensions by default;
• Specify lines:

  $ pkgtop 5
  libc6.............................................................. 13.27 MiB perl-base.......................................................... 7.59 MiB coreutils.......................................................... 6.95 MiB dpkg............................................................... 6.58 MiB libssl3............................................................ 5.69 MiB 

• Specify columns:

  $ pkgtop 5 42
  libc6........................ 13.27 MiB perl-base.................... 7.59 MiB coreutils.................... 6.95 MiB dpkg......................... 6.58 MiB libssl3...................... 5.69 MiB 

• Show other:

  $ pkgtop 5 --other
  [other]............................................................ 61.35 MiB libc6.............................................................. 13.27 MiB perl-base.......................................................... 7.59 MiB coreutils.......................................................... 6.95 MiB dpkg............................................................... 6.58 MiB 

• Show total:

  $ pkgtop 5 --other --total
  [other]............................................................ 67.93 MiB libc6.............................................................. 13.27 MiB perl-base.......................................................... 7.59 MiB coreutils.......................................................... 6.95 MiB [total]............................................................ 95.74 MiB 

• Skip packages:

  $ pkgtop 5 --other --total --skip 2
  [other]............................................................ 55.67 MiB coreutils.......................................................... 6.95 MiB dpkg............................................................... 6.58 MiB libssl3............................................................ 5.69 MiB [total]............................................................ 74.87 MiB 

• Exclude package:

  $ pkgtop 5 --other --total --exclude libc6
  [other]............................................................ 61.35 MiB perl-base.......................................................... 7.59 MiB coreutils.......................................................... 6.95 MiB dpkg............................................................... 6.58 MiB [total]............................................................ 82.46 MiB 

• Exclude multiple packages:

  $ pkgtop 5 --other --total --exclude libc6 --exclude coreutils
  [other]............................................................ 55.67 MiB perl-base.......................................................... 7.59 MiB dpkg............................................................... 6.58 MiB libssl3............................................................ 5.69 MiB [total]............................................................ 75.52 MiB 

• Mark package:

  $ pkgtop 5 --other --total --mark coreutils
  [other]............................................................ 67.93 MiB libc6.............................................................. 13.27 MiB perl-base.......................................................... 7.59 MiB coreutils.......................................................... 6.95 MiB<
  [total]............................................................ 95.74 MiB 

• Mark multiple packages:

  $ pkgtop 5 --other --total --mark coreutils --mark [other]
  [other]............................................................ 67.93 MiB<
  libc6.............................................................. 13.27 MiB perl-base.......................................................... 7.59 MiB coreutils.......................................................... 6.95 MiB<
  [total]............................................................ 95.74 MiB

• Do not limit the output:

  $ pkgtop --all
  libc6.............................................................. 13.27 MiB perl-base.......................................................... 7.59 MiB
  ...
  libtirpc-common.................................................... 32.00 KiB libaudit-common.................................................... 23.00 KiB 

macOS

⚠️ Use zsh on macOS. This script uses associative arrays introduced in bash>= 4, while macOS have only 3.X.X.

zsh pkgtop.sh

Dependencies

ArchLinux

You may want to install expac to improve script performance:

$ time pkgtop &> /dev/null
real 0m0,576s
user 0m0,527s
sys 0m0,067s
$ sudo pacman -S expac
$ time pkgtop &> /dev/null
real 0m0,391s
user 0m0,245s
sys 0m0,120s

Compatibility

• GNU/Linux
  • Ubuntu
    • 22.04 (TEST OK: 2023-09-10)
    • 20.04 (TEST OK: 2023-09-10)
    • 18.04 (TEST OK: 2023-09-10)
    • 16.04 (TEST OK: 2023-09-10)
    • 14.04 (TEST OK: 2023-09-10)
  • Debian
    • 11 (TEST OK: 2023-09-10)
    • 10 (TEST OK: 2023-09-10)
    • 9 (TEST OK: 2023-09-10)
  • Fedora
    • 37 (TEST OK: 2023-09-10)
    • 36 (TEST OK: 2023-09-10)
    • 35 (TEST OK: 2023-09-10)
    • 34 (TEST OK: 2023-09-10)
  • RedHat
    • 9 (TEST OK: 2023-09-10)
    • 8 (TEST OK: 2023-09-10)
  • CentOS
    • 7 (TEST OK: 2023-09-10)
  • OpenSUSE
    • tumbleweed (TEST OK: 2023-09-10)
    • leap
      • 15 (TEST OK: 2023-09-10)
  • ArchLinux (TEST OK: 2023-09-10)
  • OpenWRT (TEST OK: 2022-07-16)
  • Alpine Linux (TEST OK: 2025-06-30)
    • 3.22 (TEST OK: 2025-06-30)
• Other operating systems
  • macOS
    • 13 (TEST OK: 2023-09-09)
• Multiplatform package management systems
  • Homebrew (TEST OK: 2023-09-09)

Contribution

🛠 You are welcome to add support for other distributions, fix bugs or improve functionality. Please, do not forget to add tests.

Building

docker compose -f docker-build.yml run --rm build

Add distribution support

Create a plugin file src/includes/distributions/yourdistro/01_package-manager.sh

# YourDistro (package-manager)ifcommand -v package-manager &> /dev/null;then# write installed packages to the STDOUT using format: %{bytes}d %{name}s\n
package-manager --installed --format='%{bytes}d %{name}s\n'# prevent other plugins from runningexit$?fi

Add multiplatform package management system support

Create a plugin file src/includes/multiplatform/yourpackagesystem/01_package-manager.sh

# YourPackageSystem (package-manager)ifcommand -v package-manager &> /dev/null;then# write installed packages to the STDOUT using format: %{bytes}d %{name}s\n
package-manager --installed --format='%{bytes}d %{name}s\n'# other plugins can also be run to combine the resultsfi

Yor plugin should write installed packages using format %{bytes}d %{name}s\n to the STDOUT:

2131 foo
34534 bar

Testing

There are some regression tests provided for compatible distributions.

Run tests

docker compose -f docker-tests-run.yml up

Output:

pkgtop-test-ubuntu-22.04-1 exited with code 0
pkgtop-test-ubuntu-20.04-1 exited with code 0
...

How does testing work

• The actual script is running in a docker container for each of compatible distributions;
• The current terminal output is compared with previously created reference file:

bash ./dist/pkgtop.sh 25 80 | diff ./data/ubuntu-22.04.txt -

Update reference data

docker compose -f docker-tests-update.yml up