creations/hm-hub
1
0
Fork 0
Code Issues Pull requests Projects Releases 3 Packages Wiki Activity Actions
CLI tool for the HM Lab Z-NEO 8K USB Hub LCD screen
9 commits 1 branch 3 tags 151 KiB
  • Rust 96.5%
  • Shell 3.5%
Find a file
Exact
creations f520612f26
 no need
2026-02-25 12:48:57 -05:00
scripts add tidal art script? 2026-02-24 20:17:30 -05:00
src fix crop cli 2026-02-24 20:06:51 -05:00
.gitignore no need 2026-02-25 12:48:57 -05:00
.gitlab-ci.yml fix ci 2026-02-24 20:21:21 -05:00
Cargo.lock 0.1.3 2026-02-24 20:29:33 -05:00
Cargo.toml 0.1.3 2026-02-24 20:29:33 -05:00
LICENSE Initial commit 2026-02-24 19:22:05 -05:00
README.md readme 2026-02-24 19:29:26 -05:00
rustfmt.toml Initial commit 2026-02-24 19:22:05 -05:00

README.md

hm-hub

CLI tool for the HM Lab Z-NEO 8K USB Hub. Controls the built-in 320x170 LCD screen and reads power stats without needing the browser-based web app.

Features

  • Upload images and animated GIFs to the LCD display
  • Read and set device config (brightness, rotation, etc.)
  • Monitor USB power and per-port current draw
  • Backup and restore device state
  • Watch a directory and auto-upload when images change
  • Auto-detects the device serial port

Install

Download a prebuilt binary from releases.

Or build from source:

cargo install --path .

Usage

The device is auto-detected. Use -p /dev/ttyACMx to override.

hm-hub info
hm-hub config
hm-hub config set brightness 20
hm-hub config set rotation 90
hm-hub upload photo.png
hm-hub upload image1.jpg image2.png animation.gif
hm-hub slideshow ./my-images/
hm-hub power
hm-hub power --watch
hm-hub monitor
hm-hub read -o ./output/
hm-hub backup device.bak
hm-hub restore device.bak
hm-hub rotate ./my-images/ --interval 300
hm-hub reset

Run hm-hub config set with no arguments to see all available config fields.

License

AGPL-3.0-or-later