# aiowapy: a Python implementation of WhatsApp Multi-Device protocols

> aiowapy implements a Python client for WhatsApp Multi-Device using Noise transport, Signal sessions and a WABinary codec. Its protocol notes describe framing, pairing and message stanzas; the code also covers media, groups, app-state sync and SQLite session storage. The author reports extensive offline tests but no live end-to-end message delivery yet.

- 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/Yarfer800/aiowapy>
- Primary source: <https://github.com/Yarfer800/aiowapy/blob/57a9296aacadb094ddc27b67f266f07211db2b20/docs/protocol.md>
- Catalog page: <https://awesomerea.org/resources/aiowapy-whatsapp-protocol-case/>
- Record JSON: <https://awesomerea.org/resources/aiowapy-whatsapp-protocol-case/record.json>
- Chinese version: [简体中文](https://awesomerea.org/zh/resources/aiowapy-whatsapp-protocol-case/index.md)

## Requirements & limits

- **Prerequisites:** Python 3.11 or newer and a phone account for device linking.
- **Limits:** Live traffic has not been exercised; calls, channels, statuses, polls, buttons and LID-based encryption are not implemented.
- **License:** MIT licence.

## Primary sources

1. <https://github.com/Yarfer800/aiowapy/blob/57a9296aacadb094ddc27b67f266f07211db2b20/docs/protocol.md>
2. <https://github.com/Yarfer800/aiowapy/blob/57a9296aacadb094ddc27b67f266f07211db2b20/README.md>

## More in Protocols

- [redmi-buds-linux: rebuilding Redmi earbud controls over JieLi RCSP](https://awesomerea.org/resources/redmi-buds-linux-case/index.md) · Case study
- [iPod Classic LCD: recovering the display pinout and bus protocol](https://awesomerea.org/resources/ipod-classic-lcd-protocol-case/index.md) · Case study
- [OBSBOT Tiny 3: USB control protocol investigation](https://awesomerea.org/resources/obsbot-tiny3-protocol-case/index.md) · Case study
- [StargateCryo: an Intel Cryo controller dashboard built on serial-protocol research](https://awesomerea.org/resources/stargatecryo-case/index.md) · Case study
- [infrared: LG and Vityas remote command mappings](https://awesomerea.org/resources/infrared-remote-configs-case/index.md) · Case study
- [Winbond Keyboard Colour: reconstructing keyboard lighting commands](https://awesomerea.org/resources/winbond-keyboard-colour-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.