# zenvision-linux: reconstructing ASUS ZenVision OLED control over USB

> zenvision-linux reconstructs USB control of the ASUS ZenVision lid OLED on the Zenbook 14X OLED Space Edition. Its Python driver sends 256×64 grayscale frames through a documented command handshake and bulk endpoint, supporting images and animations on Linux.

- Type: Case study
- Targets: Protocol
- Category: Independent reconstruction cases
- Relationship: Independent reconstruction project
- Sources reviewed: 2026-11-06
- Added to the catalog: 2026-11-09
- Original resource: <https://github.com/tarpediem/zenvision-linux>
- Primary source: <https://github.com/tarpediem/zenvision-linux/blob/c0df6b59a4f135d3a02eac09da45f6f0b11fce75/README.md>
- Catalog page: <https://awesomerea.org/resources/zenvision-linux-case/>
- Record JSON: <https://awesomerea.org/resources/zenvision-linux-case/record.json>
- Chinese version: [简体中文](https://awesomerea.org/zh/resources/zenvision-linux-case/index.md)

## Requirements & limits

- **Prerequisites:** ASUS Zenbook 14X OLED Space Edition UX5401ZAS with a ZenVision panel; Linux and raw USB access.
- **Prerequisites:** Python 3.9+, pyusb, Pillow and libusb-1.0.
- **Limits:** The author reports operation on UX5401ZAS; other lid-OLED models are unconfirmed.
- **License:** MIT license.

## Primary sources

1. <https://github.com/tarpediem/zenvision-linux/blob/c0df6b59a4f135d3a02eac09da45f6f0b11fce75/README.md>
2. <https://github.com/tarpediem/zenvision-linux/blob/c0df6b59a4f135d3a02eac09da45f6f0b11fce75/PROTOCOL.md>

## More in Protocols

- [orba-protocol: reconstructing Artiphon Orba 2 control messages](https://awesomerea.org/resources/orba-protocol-artiphon-orba-2-case/index.md) · Case study
- [TrikiEmu: reconstructing the Żabka Triki BLE controller](https://awesomerea.org/resources/trikiemu-zabka-triki-case/index.md) · Case study
- [TrikiScope: decoding the Żabka Triki BLE motion stream](https://awesomerea.org/resources/trikiscope-zabka-triki-case/index.md) · Case study
- [G2CC: a replacement Even G2 client built from Bluetooth traffic analysis](https://awesomerea.org/resources/g2cc-even-g2-client-case/index.md) · Case study
- [Melitta Barista & Nivona: reconstructing coffee-machine BLE control](https://awesomerea.org/resources/melitta-barista-nivona-ha-case/index.md) · Case study
- [OpenHX: rebuilding Line 6 HX preset control over USB](https://awesomerea.org/resources/openhx-case/index.md) · Case study

## About this entry

The description was reviewed against primary sources.
Original editorial content: MIT. Linked projects, papers and assets retain their own rights and licenses.