# OpenPigeon: reconstructing GamePigeon iMessage game messages

> OpenPigeon is a TypeScript codec for reading GamePigeon iMessage game state and encoding caller-supplied moves for eleven turn-based games. Its protocol documentation describes balloon identity, encrypted move URLs, the length-seeded cipher and the state envelope; captured-message vectors support codec tests.

- Type: Case study
- Targets: Game · Protocol
- Category: Independent reconstruction cases
- Relationship: Independent reconstruction project
- Sources reviewed: 2026-11-06
- Added to the catalog: 2026-11-06
- Original resource: <https://github.com/time-attack/OpenPigeon>
- Primary source: <https://github.com/time-attack/OpenPigeon/blob/86c649174f3521d79a7c7eda58725c99286804b7/docs/PROTOCOL.md>
- Catalog page: <https://awesomerea.org/resources/openpigeon-case/>
- Record JSON: <https://awesomerea.org/resources/openpigeon-case/record.json>
- Chinese version: [简体中文](https://awesomerea.org/zh/resources/openpigeon-case/index.md)

## Requirements & limits

- **Prerequisites:** Node.js 22 or newer.
- **Prerequisites:** Sending through Linq or Photon requires an account and host; Linq webhooks require a public endpoint.
- **Limits:** The SDK handles turn-based payloads; live Play Now mode and move selection are outside its scope.
- **License:** MIT license.

## Primary sources

1. <https://github.com/time-attack/OpenPigeon/blob/86c649174f3521d79a7c7eda58725c99286804b7/docs/PROTOCOL.md>
2. <https://github.com/time-attack/OpenPigeon/blob/86c649174f3521d79a7c7eda58725c99286804b7/README.md>

## More in Games

- [ProjectCane: a native PC port of Sly Cooper and the Thievius Raccoonus](https://awesomerea.org/resources/projectcane-sly1-pc-port-case/index.md) · Case study
- [samp-client-re: a partial SA-MP client reconstruction](https://awesomerea.org/resources/samp-client-rea-partial-reconstruction-case/index.md) · Case study
- [scvk: replacing SimCity 4's renderer with Vulkan](https://awesomerea.org/resources/scvk-case/index.md) · Case study
- [TH04: recover a DOS bullet-ring helper](https://awesomerea.org/resources/rea-th04-case/index.md) · Case study
- [tMock-Server: reconstructing Terraria server handshakes](https://awesomerea.org/resources/tmock-server-case/index.md) · Case study
- [Touhou reconstructions: an agent-driven method across three games](https://awesomerea.org/resources/rea-touhou-reconstruction-method-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.