oled-notifier

Crates.iooled-notifier
lib.rsoled-notifier
version0.1.0
created_at2025-06-23 11:44:10.354276+00
updated_at2025-06-23 11:44:10.354276+00
descriptionSimple statistics for the ODROID-HC4 with OLED device
homepage
repositoryhttps://github.com/wiktor-k/oled-notifier
max_upload_size
id1722836
size101,312
Wiktor Kwapisiewicz (wiktor-k)

documentation

README

HC4 OLED Notifier

This application provides simple statistics for ODROID-HC4 with OLED device.

Real-life render

Currently there are no options and the device used (/dev/i2c-0) and rotation (180 degrees) is hardcoded to match HC4 OLED's display. The display is refreshed every 2 seconds.

Building

export CARGO_TARGET_AARCH64_UNKNOWN_LINUX_MUSL_RUSTFLAGS="-Clink-self-contained=yes -Clinker=rust-lld"
export AR_aarch64_unknown_linux_musl=llvm-ar
export CC_aarch64_unknown_linux_musl=clang

cargo build --bin main --release --target aarch64-unknown-linux-musl

Running

If there are no /dev/i2c-0 device use the kernel module: modprobe i2c-dev.

Installing

Currently the notifier is available on Arch AUR: https://aur.archlinux.org/packages/oled-notifier-git

Note that the package can be built on amd64 systems but must be run on AArch64 system.

End-to-end tests

The end-to-end tests render a frame using fake system statistics and check if the image is consistent with the known-good output:

Simulated output

To regenerate end-to-end screenshots run the following command:

EG_SIMULATOR_DUMP=docs/screenshot.png cargo run --features simulator --bin simulate

See also

Commit count: 0

cargo fmt