CMF Watch Utils

CMF Watch Utils is an unofficial interoperability project. It provides an offline toolkit for the firmware containers used by CMF Watch devices, a Python client for the watch’s BLE services, a Watch Pro 2 QEMU emulator preview, and the research notes behind them.

The project is device-scoped: each supported model has its own section with its own protocol details, format notes and verified results. Shared tooling and general documentation live at the top level, so new devices can be added without duplicating the tools.

Risk

Firmware flashing can leave a watch unbootable, and no universal recovery path has been proven for every failure mode. The tooling exists for research, interoperability and hardware that is owned and whose loss is acceptable. The device section documents the specific risks.

Watch Pro 2 emulator preview

Open the Watch Pro 2 browser emulator to boot stock firmware and use the watch face, touchscreen and crown. The browser downloads the prepared virtual storage on the first visit.

Use the desktop emulator to test virtual OTA and recovery without a watch, phone or Bluetooth adapter.

Device support

Device	Firmware	State	Section
CMF Watch Pro 2 (JX402, Actions ATS3089C)	1.0.0.73	Hardware-tested tooling and QEMU preview	Device pages
Other CMF Watch models	—	Planned	Roadmap

Project contents

Area	Description
Toolkit	fwkit — parse, rebuild and patch AOTA, SDFS, RES, STY, WFDL, AJS and picture containers offline
BLE tooling	cmf_watch.py, ota_client.py — pairing, shell commands, watch-face upload, firmware OTA
Emulator	Stock and custom firmware boot, virtual OTA and modeled recovery
Actions SDK OTA	Separate BLE OTA client with offline validation and loopback testing
Device research	Protocol details, format layouts, verified results and known gaps per device
Dumps	Firmware manifests, hashes and downloadable images
Agent context	A compact briefing for AI coding agents

Orientation

• Requirements, Setup and Quick start cover the first steps.
• Methodology describes how the formats were recovered and verified.
• Legal & attribution covers licensing, third-party notices and the terms for the published artifacts.