# IQOS Bar: a USB HID client for IQOS ILUMA usage counters

> IQOS Bar implements read-only USB HID access to an IQOS ILUMA i ONE, displaying battery status and lifetime usage counters in a desktop tray or menu bar. Its protocol notes describe report framing, register queries and hidapi response offsets, adapting the command layer credited to iqos-scope.

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

## Requirements & limits

- **Prerequisites:** The application runs on macOS, Windows and Linux; Linux may require a udev rule for HID access.
- **Scope:** An IQOS ILUMA i ONE connected by USB is the author-confirmed device; fields unavailable on other models appear blank.
- **Limits:** The daily chart needs a couple of days of logged lifetime counters to fill in.
- **License:** MIT license.

## Primary sources

1. <https://github.com/tiritfurkan/iqos-bar/blob/9d56260550247402941b10f50c9aec0b338a9118/PROTOCOL.md>
2. <https://github.com/tiritfurkan/iqos-bar/blob/9d56260550247402941b10f50c9aec0b338a9118/README.md>

## More in Protocols

- [Chorus: reconstructing Logitech Harmony remote programming](https://awesomerea.org/resources/chorus-harmony-remote-case/index.md) · Case study
- [tinycoral: reconstructing the Coral Edge TPU instruction set and USB runtime](https://awesomerea.org/resources/tinycoral-edge-tpu-case/index.md) · Case study
- [ninebot-go: reconstructing Ninebot app cloud communication](https://awesomerea.org/resources/ninebot-go-case/index.md) · Case study
- [open-g2-hub: a local Even G2 client built on BLE protocol findings](https://awesomerea.org/resources/open-g2-hub-case/index.md) · Case study
- [Edifier Speakers BLE: reconstructing M60 and M90 speaker control](https://awesomerea.org/resources/edifier-speakers-ble-case/index.md) · Case study
- [Halyard: reconstructing Shadow cloud PC streaming on handhelds](https://awesomerea.org/resources/halyard-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.