Case study
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.
- Targets
- Protocol
- Category
- Independent reconstruction cases
- Relationship
- Independent reconstruction project
- Sources reviewed
- Evidence class
- C1 partial scope or analysis entry
- Stars
- 6
- Last commit
- 2026-10-06
- Language
- Python
- License (GitHub)
- MIT
GitHub data as of 2026-11-10
Evidence

- Observed
- Download and demo observed; the case covers part of the target software.
- Scope
- Partial
- Checked
- 2026-11-08
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.
Cite
BibTeX
@misc{iqos-bar-case,
title = {{IQOS Bar: a USB HID client for IQOS ILUMA usage counters}},
howpublished = {\url{https://github.com/tiritfurkan/iqos-bar}},
url = {https://github.com/tiritfurkan/iqos-bar},
urldate = {2026-11-06},
note = {Awesome REA entry: \url{https://awesomerea.org/resources/iqos-bar-case/}}
}Plain text
IQOS Bar: a USB HID client for IQOS ILUMA usage counters. https://github.com/tiritfurkan/iqos-bar (accessed 2026-11-06). Awesome REA entry: https://awesomerea.org/resources/iqos-bar-case/
Useful? Star Awesome REA on GitHub2.4k
About this entry
The description was reviewed against primary sources.
Primary sources
- PROTOCOL.md GitHub · tiritfurkan/iqos-bar · Revision 9d56260
- README.md GitHub · tiritfurkan/iqos-bar · Revision 9d56260
More in Protocols
- Chorus: reconstructing Logitech Harmony remote programming · Case study
- tinycoral: reconstructing the Coral Edge TPU instruction set and USB runtime · Case study
- ninebot-go: reconstructing Ninebot app cloud communication · Case study
- open-g2-hub: a local Even G2 client built on BLE protocol findings · Case study
- Edifier Speakers BLE: reconstructing M60 and M90 speaker control · Case study
- Halyard: reconstructing Shadow cloud PC streaming on handhelds · Case study