# allmiibo-sync: reconstructing Pixl.js Bluetooth file synchronization

> allmiibo-sync reconstructs the Pixl.js and AmiiboLink Bluetooth LE virtual filesystem protocol to synchronize folders with NFC emulator devices. Its browser app compares local and device trees, plans transfers and deletions, and uses VFS commands documented from official web clients and checked against firmware.

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

## Requirements & limits

- **Prerequisites:** Synchronization requires Chrome or Edge with Web Bluetooth, a compatible Pixl.js or AmiiboLink device, and a page served over HTTPS or http://localhost.
- **Testing evidence:** The author reports hardware checks on Pixl.js 2.11.2 and 2.16.0.
- **License:** The repository contains MIT and GPL-2.0-only licence files.

## Primary sources

1. <https://github.com/mahoudeau/allmiibo-sync/blob/f1f8ad23d89d337da72c6ab385b91dc02d959542/PROTOCOL.md>
2. <https://github.com/mahoudeau/allmiibo-sync/blob/f1f8ad23d89d337da72c6ab385b91dc02d959542/README.md>

## More in Protocols

- [EBO for Home Assistant: reconstructing Enabot cloud control](https://awesomerea.org/resources/ha-enabot-case/index.md) · Case study
- [iM.Master SDK: reconstructing the robot's BLE control protocol](https://awesomerea.org/resources/im-master-sdk-case/index.md) · Case study
- [PumpSaver Plus: decoding the relay's infrared broadcast](https://awesomerea.org/resources/pumpsaver-ir-protocol-case/index.md) · Case study
- [Mazda MX-5 ND3: mapping OBD-II PIDs and responses](https://awesomerea.org/resources/mazda-mx5-nd3-obdii-case/index.md) · Case study
- [QUII Helper: reconstructing Qualvision intercom communication](https://awesomerea.org/resources/quii-helper-case/index.md) · Case study
- [KlipschRemote: reconstructing Klipsch speaker control and update protocols](https://awesomerea.org/resources/klipschremote-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.
