# miband11-watchface-maker: reconstructing the Smart Band 11 .face format

> miband11-watchface-maker reconstructs the .face watch-face package format for Xiaomi Smart Band 11 by comparing inputs and outputs of the official compiler. Its format specification covers headers, metadata, indexes, embedded Lua and image data. Python, Java and JavaScript implementations assemble watch faces from media inputs.

- Type: Case study
- Targets: Firmware
- 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/AIR-pixel/miband11-watchface-maker>
- Primary source: <https://github.com/AIR-pixel/miband11-watchface-maker/blob/07d1f64903e061dc63cd58b6ccf6da3d3c5091be/docs/face%E6%A0%BC%E5%BC%8F%E8%A7%84%E8%8C%83.md>
- Catalog page: <https://awesomerea.org/resources/miband11-watchface-maker-case/>
- Record JSON: <https://awesomerea.org/resources/miband11-watchface-maker-case/record.json>
- Chinese version: [简体中文](https://awesomerea.org/zh/resources/miband11-watchface-maker-case/index.md)

## Requirements & limits

- **Prerequisites:** The Windows implementation requires Python 3.8 or newer and Pillow; video input also requires ffmpeg.
- **Prerequisites:** Installing generated watch faces requires third-party tooling.
- **Scope:** The documented output target is Xiaomi Smart Band 11 watch faces.
- **Limits:** The format was tested against the project’s firmware and toolchain versions; other versions may differ.
- **License:** MIT license.

## Primary sources

1. <https://github.com/AIR-pixel/miband11-watchface-maker/blob/07d1f64903e061dc63cd58b6ccf6da3d3c5091be/docs/face%E6%A0%BC%E5%BC%8F%E8%A7%84%E8%8C%83.md>
2. <https://github.com/AIR-pixel/miband11-watchface-maker/blob/07d1f64903e061dc63cd58b6ccf6da3d3c5091be/README.md>

## More in Firmware and hardware

- [fb200-tools: reconstructing FLAMMA FB200 firmware and control protocols](https://awesomerea.org/resources/fb200-tools-case/index.md) · Case study
- [Orion Unchained: reconstructing Acer Predator Orion lighting control](https://awesomerea.org/resources/orion-unchained-case/index.md) · Case study
- [p2afan: mapping ASPEED BMC fan control through the P2A bridge](https://awesomerea.org/resources/p2afan-case/index.md) · Case study
- [Cisco CP-9951 DOOM: mapping phone input for a native game port](https://awesomerea.org/resources/cisco-9951-doom-case/index.md) · Case study
- [Zeppelin Air: reconstructing USB firmware recovery](https://awesomerea.org/resources/zeppelin-air-recovery-case/index.md) · Case study
- [EmuWorks: emulating NumWorks N0110 calculator hardware](https://awesomerea.org/resources/emuworks-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.