This Magisk module contains btop++ for arm64 CPUs

ASUS_I006D:/ # btop -V
btop version: 1.4.4
ASUS_I006D:/ # 

Note that in the rest of this document the term "btop" is used instead of "btop++".

The btop executable is installed in /system/bin/usr; in /system/bin is a wrapper script for btop.

When the wrapper script is executed by a non-root user, it executes the btop executable with the following command

su - --preserve-environment -c /system/usr/bin/btop  $*

The btop executable only needs the standard Android libraries:

ASUS_I006D:/ $ ldd /system/usr/bin/btop
	linux-vdso.so.1 => [vdso] (0x7263c86000)
	libc.so => /apex/com.android.runtime/lib64/bionic/libc.so (0x72610e9000)
	libm.so => /apex/com.android.runtime/lib64/bionic/libm.so (0x7262a43000)
	libdl.so => /apex/com.android.runtime/lib64/bionic/libdl.so (0x72610b8000)
ASUS_I006D:/ $ 



The btop executable searches the config dir for btop in these directories in this order:

- the contents of the environment variable XDG_CONFIG_HOME if not empty
- the contents of the environment variable HOME if not empty and NOT "/"
the directory /data/local/tmp/sysroot/usr/share/btop

To change the directory to be used for the btop config files, set one of the environment variables mentioned above before executing btop.


The btop executable searches the following directories for system themes in this order:

../share/btop/themes (this path is relative to the btop executable)
/system/usr/share/btop/themes
/data/local/tmp/sysroot/usr/share/btop/themes

A sample config file for btop can be found here:

/system/usr/share/btop/btop.conf


Notes

The default value for "use_fstab" in this  btop binary is false


Mouse support does not work reliable for this btop binary - it's recommended to not use it
If you really want to use the mouse, execute btop in an ssh session to the phone.


The source code used to create the btop binary is  copied from the repository

https://github.com/aristocratos/btop

at 15.08.2025


The btop binary was compiled using the clang19 tool chain for the phone:

https://xdaforums.com/t/guide-how-to-install-a-toolchain-for-clang-on-phones-without-root-access.4710235/

on the phone.


The patches used to patch the source code for btop are in the directory ./patches in this Magisk module


History

15.08.2024 v1.0.0 /bs
  initial release

