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, 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.

Device support

Device	Firmware	State	Section
CMF Watch Pro 2 (JX402, Actions ATS3089C)	1.0.0.73	Full support	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
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.