Skip to content

zampierilucas/kinfetch

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

8 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

kinfetch

A neofetch-like system info tool for jailbroken Kindle e-readers. Single static binary (~465K), no runtime dependencies.

Example

On wide terminals (>= 74 columns), a Kindle icon is shown side-by-side:

                                            root@kindle
                                            -----------
        :xkkoc,                             device: Kindle Basic 4 (2022)
      :NMMMMMMM0.                           os: Kindle 5.16.2.1.1
     .MMMMMMMMMMW'                          kernel: 4.9.77-lab126
     ;MMMMMMMMMW0.                          resolution: 1072x1448
     .OMMMMMMMMx                            uptime: 1h 10m
   .kWWMMMWMMWd.         .,,.               shell: sh
 .OMMMMMMMx';.         .xMMK.               cpu: ARMv7 Processor rev 4 (v7l) (2)
:WMMMMMMMMMd          oWMWo                 memory: 343M / 474M
MMMMMMMMMMMMO.       OMMN.                  disk (user): 4.2G / 13.4G (31%)
MMMMMMMMMMMMMWd   .c0MNx.                   local ip: 10.45.2.49
MMMMMMMMMMXMMMWOONMWd.                      tailscale: 100.114.118.55
MMMMMMMMMO oNMMMMMMN.                       battery: 46% [Discharging]
MMMMMMMMMWWMMMMMMMMMW,
MMMMMMMMMMMMMMMMMMMMMW:
MMMMMMMMMMMMMWOc.oWMMMMk
MMMMMMMMMMMKc.    .NMMMN'
MMMMMMMMMNd,.      .'oWMWc
MMMMMMMMMMMMMMWKko:.  'MMMNx;
MMMMMMMMMMMMMMMMMMMMMKOMMMMMMWk:'

On narrow terminals, a compact text logo is used instead:

 _  ___         _ _
| |/ (_)_ _  __| | |___
| ' <| | ' \/ _` | / -_)
|_|\_\_|_||_\__,_|_\___|
root@kindle
-----------
device: Kindle Basic 4 (2022)
os: Kindle 5.16.2.1.1
kernel: 4.9.77-lab126
resolution: 1072x1448
uptime: 1h 10m
shell: sh
cpu: ARMv7 Processor rev 4 (v7l) (2)
memory: 343M / 474M
disk (user): 4.2G / 13.4G (31%)
local ip: 10.45.2.49
tailscale: 100.114.118.55
battery: 46% [Discharging]

kinfetch --full

Adds debug/diagnostic fields useful for troubleshooting on MobileRead forums:

...
serial: G092***********R
board: P092R50340420RS4
wifi mac: 08:c2:24:e1:35:a3
fw abi: armel (soft-float)
jailbreak: yes (mkk)
bat voltage: 3778000 mV
bat temp: 28.0C
koreader: v2025.10
extensions: MRInstaller, renameotabin, koreader, xdotool, kterm, ...

Usage

kinfetch            # standard output
kinfetch --full     # include debug fields (also: --debug, -d)
kinfetch --full --serial  # show full unmasked serial number
kinfetch --help     # show usage (also: -h)

Install

Copy the binary to your Kindle over SSH:

scp kinfetch kindle:/mnt/us/kinfetch
ssh kindle "chmod +x /mnt/us/kinfetch"

Build from source

Requires Rust with the armv7-unknown-linux-musleabihf target:

rustup target add armv7-unknown-linux-musleabihf
cargo build --release --target armv7-unknown-linux-musleabihf

Or with just:

just build-kindle   # build
just deploy         # build + scp to kindle
just deploy-run     # build + scp + run

The binary is statically linked (musl) so it runs on any jailbroken Kindle with no dependencies.

Fields

Field Source
device /proc/usid serial number lookup
os /etc/prettyversion.txt or /etc/version.txt
kernel uname() syscall
resolution /sys/class/graphics/fb0/modes (fallback: virtual_size)
uptime /proc/uptime
shell $SHELL env
cpu /proc/cpuinfo
memory /proc/meminfo
disk (user) statvfs("/mnt/us")
local ip ip -4 addr show wlan0
tailscale ip -4 addr show tailscale0 (optional)
battery /sys/class/power_supply/*/capacity

--full fields

Field Source
serial /proc/usid (masked by default)
board lipc-get-prop com.lab126.system boardid
wifi mac /sys/class/net/wlan0/address
fw abi checks for /lib/ld-linux-armhf.so.3
jailbreak checks /var/local/mkk or /var/local/kmc
bat voltage gasgauge-info -v
bat temp gasgauge-info -k
koreader /mnt/us/koreader/ota/version
extensions ls /mnt/us/extensions/

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors