# aioharmony: Logitech Harmony Hub protocol notes and client

> aioharmony documents Logitech Harmony Hub authentication and control messages while providing an asyncio client for the device. Its protocol notes describe remote ID discovery, session-token exchange, and XMPP IQ stanzas. The client exposes activity, configuration, and device-command operations over WebSockets or XMPP.

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

## Requirements & limits

- **Prerequisites:** A Logitech Harmony Link or Harmony Hub is required.
- **Prerequisites:** Python 3.10 or newer is required; XMPP use requires a hub with XMPP enabled.
- **License:** Apache-2.0 license.

## Primary sources

1. <https://github.com/Harmony-Libs/aioharmony/blob/09e1680dbc1d8749c0c19fcfdf6e752df0a3ed6e/PROTOCOL.md>
2. <https://github.com/Harmony-Libs/aioharmony/blob/09e1680dbc1d8749c0c19fcfdf6e752df0a3ed6e/README.rst>

## More in Protocols

- [MQB-sniffer: decoding Golf MK7 CAN diagnostic exchanges](https://awesomerea.org/resources/mqb-sniffer-case/index.md) · Case study
- [ktm-can: decoding KTM motorcycle CAN messages](https://awesomerea.org/resources/ktm-can-case/index.md) · Case study
- [Xbox-Smartglass-Core: an Xbox One SmartGlass protocol client](https://awesomerea.org/resources/xbox-smartglass-core-python-case/index.md) · Case study
- [Comet: reconstructing GOG Galaxy's game communication service](https://awesomerea.org/resources/comet-gog-service-case/index.md) · Case study
- [PS3Sharp: reconstructing the PS3 TMAPI debug protocol](https://awesomerea.org/resources/ps3sharp-tmapi-case/index.md) · Case study
- [PFire: reconstructing an XFire server from its messaging protocol](https://awesomerea.org/resources/pfire-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.