zfree

A zram swap-aware free-alike, or: mashing free and zramctl together. Now in Python!

Usage

$ zfree -h
Memory/swap
      total       used      avail      cache       free
     7.4GiB     7.2GiB   445.4MiB    65.6MiB   146.4MiB
     1.0GiB       0.0B                           1.0GiB
zram
       data      total      ratio      comp%
    14.7GiB     3.2GiB       4.55     43.24%
psi some/full: 60.31, 56.61, 46.29 / 53.32, 50.56, 41.34

Automatically adapts to the presences (or absences) of disk swap, zram swap, and PSI info.

Dependencies

A list of dependencies and why they're here:

• Linux kernel 3.14+: the script peeks at Linux-specific files and requires the MemAvailable field to be present in /proc/meminfo.

• Python 3.6+: f-strings.

Install

• Copy ./src/zfree.py to somewhere in PATH under the name zfree.

• Use pipx, pipx install . (haven't published to PyPI yet)

• Distro packages don't yet exist, but I plan on publishing to Gentoo's GURU at least.

Compatibility

Currently untested, but the script is meant to work on the following platforms:

• All Linux distributions (glibc, musl, future libcs) shipping Python 3.6+ and kernel 3.14+.

RHEL 7 and older are unsupported because those ship kernels older than 3.14.

Limitations

• Only handles a maximum of 1 zram swap device and 1 disk swap device.

• Unaware of zswap (not to be confused with zram, which is supported).

• Stats diverge from procps-ng free for reasons I don't understand.