fmc_go

KO | EN

gitlite — search

#react #ai #llm #go #android #docker #windows #cli #awesome-list #pytorch #mcp #ios #openai #open-source

(★ 18)

No description available.

fmc_go 최신버젼 다운로드

최종 버전 다운로드 (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# fmc

A terminal companion for the **CMF Watch Pro 2** (by Nothing), written in pure Go.
No official app, no cloud — just your watch, BLE, and a TUI.

Everything here is based on reverse engineering: the BLE protocol was ported from
[Gadgetbridge](https://gadgetbridge.org/), and the watchface file format was reversed
from scratch for this project (see below). The complete protocol documentation lives
in [`docs/cmf-protocol.md`](docs/cmf-protocol.md).

## Features

- **Health dashboard (TUI)** — live view of heart rate, resting HR, SpO2, stress,
  steps/distance/calories, and sleep stages, synced over BLE (bubbletea + lipgloss).
- **Pairing & encrypted protocol** — full pairing flow (confirm on the watch), AES-128-CBC
  encrypted command channel, auth key persisted in your user config dir.
- **Watchface upload** — install any `.bin` watchface onto the watch.
- **Watchface decompiler** — unpack any watchface `.bin` into `face.json` + PNG/JPG images.
- **Watchface compiler** — build a valid `.bin` back from `face.json` + images:
  edit positions, swap hand images, redraw backgrounds, then flash your own dial.
- **Watchface editor (browser)** — a visual editor for `.bin` dials: live rendering
  with simulated data, drag & drop widget editing, a stock-dial catalog, one-click
  import of [facer.io](https://facer.io) watchfaces, and `.bin` export. See
  [`editor/README.md`](editor/README.md).
- **Debug probes** — factory shell getters (battery, sensors, GPS, crown…), a live
  accelerometer stream with an ASCII bubble level, and a vibration motor prober.

## Build

Pure Go, no cgo. Needs Bluetooth permissions on macOS (works via tinygo bluetooth).

```sh
go build -o fmc .
```

## Usage

```sh
./fmc                 # TUI dashboard (pairs on first run: confirm on the watch)
./fmc -notui          # same session, plain stdout logging (debugging)

./fmc -watchface face.bin            # upload a watchface and exit

./fmc -wfdecompile face.bin -o dir/  # unpack: dir/face.json + res*.png
./fmc -wfcompile dir/face.json -o out.bin   # rebuild a valid .bin
./fmc -wffacer facer_export/ -o dir/ # convert a facer.io export (also writes dir/face.bin)

./fmc -scan           # 30s dump of BLE advertisements (discovery debugging)
./fmc -infotest       # read-only device info via the factory shell
./fmc -sensortest     # read-only sensor getters
./fmc -accel          # live accelerometer stream (ASCII bubble level)
./fmc -motortest      # SETMOTOR prober (vibrates! run deliberately)
```

The auth key is stored at `~/Library/Application Support/fmc/authkey` (macOS) /
`$XDG_CONFIG_HOME/fmc/authkey` (Linux). Delete it to force re-pairing.

## Editing a watchface

The comfortable way is the [browser editor](editor/README.md). The CLI way:

```sh
./fmc -wfdecompile SomeDial.bin -o dial/
# edit dial/res*.png (hand images, background) and dial/face.json (positions, pivots)
./fmc -wfcompile dial/face.json -o MyDial.bin
./fmc -watchface MyDial.bin
```

`face.json` mirrors the file's TLV tree. The useful parts:

- screens: tag `0x21` = main, `0x22` = always-on display;
- widget structs carry `x`/`y`, an `images` list (indices into `resources`), and a
  14-byte `meta` hex blob (width/height/flags — partially decoded);
- analog hands (`tag 112`) have a `_kind` hint (`hour`/`minute`/`second`) and a pivot
  sub-node — the pivot point always lands on the screen center (233,233);
- multi-frame `images` lists are digit fonts (10 frames), weekdays (7), months (12),
  second-hand animations (60), etc. Frames must stay consecutive;
- anything not yet decoded round-trips losslessly as `hex` fields.

## Watchface `.bin` format (reversed)

Verified against 100 real dials from the official gallery; the full spec is in
[`docs/cmf-protocol.md` §9.6a](docs/cmf-protocol.md). In short:

```
36-byte header ‖ TLV widget tree ‖ image resources ‖ footer (= copy of the header)
```

- Header: "raw" CRC32 (IEEE polynomial, init=0, no final inversion) of the tree at
  offset 0x00 and of the resource section at 0x20; resource section length at 0x1c;
  `fileLength-36` at 0x18; NUL-terminated dial name at 0x08.
- TLV tree: `tag(u8) len(u16 LE) value` — screens, widgets, hand pivots, and a
  270×270 embedded preview per screen (that's what the gallery app shows).
- Resources: LVGL v8 image headers (`cf:5|zero:3|reserved:2|w:11|h:11` bitfield) with
  **LZ4 block**-compressed pixels — RGB565, RGB565+A8, 4-bit alpha, or BGRA8888 —
  or raw JPEG frames for photo dials. Display is 466×466.

Both tools are validated by tests: header formulas and image decoding across the whole
corpus, plus a full decompile → compile → decompile cycle that must reproduce identical
artifacts (`wf_test.go`).

## Project layout

| File | What it does |
|---|---|
| `main.go` | CLI flags, TUI dashboard |
| `ble.go` | BLE lifecycle: scan, connect, notifications, reconnect |
| `protocol.go` | frame codec: chunking, AES-CBC, CRC32, health data parsers |
| `session.go` | pairing, authentication, sync state machine |
| `upload.go` | watchface upload over the data channel |
| `wfformat.go` | watchface container: TLV, header CRCs, LZ4, pixel codecs |
| `wfdecompile.go` / `wfcompile.go` | `.bin` ⇄ `face.json` + images |
| `wffacer.go` | Facer (facer.io) export → `face.json` + `.bin` converter |
| `editor/` | browser watchface editor ([README](editor/README.md)) |
| `debug_*.go` | factory shell probes (read-only, except `-motortest`) |
| `docs/cmf-protocol.md` | the full protocol & file format spec |

## Troubleshooting

**The watch is never found (stuck on "searching for watch…").**
The watch only advertises over BLE while it is *not* connected to a phone. If the
Nothing X app holds the connection, fmc can't see the watch at all. Check what's
actually in the air:

```sh
./fmc -scan        # 30s dump of all BLE advertisements
```

If there is no `CMF Watch …` entry, turn off Bluetooth on the phone (or remove the
watch from Nothing X), wait a few seconds and re-run the scan. Note that on macOS the
watch often advertises with **no local name at all** — fmc also matches by the
advertised service UUID (`0000efe7-…`) and manufacturer ID (`0x0ccb`), so check for an
entry with those even if none show a name.

Whether the watch shows up in the system Bluetooth menu is not a reliable signal here:
that menu mixes cached/previously-seen devices and classic Bluetooth (BR/EDR) state,
which is a separate radio path from BLE advertising. Trust `-scan`'s live output over
what System Settings shows.

**Connects but hangs on "authenticating…".**
The stored auth key is stale — this happens after re-pairing the watch with a phone,
which regenerates the on-watch secret (the watch may silently drop the session instead
of replying `AUTH_FAILED`). Reset the key and pair again:

```sh
rm ~/Library/Application\ Support/fmc/authkey   # macOS
# $XDG_CONFIG_HOME/fmc/authkey on Linux
./fmc          # confirm the pairing dialog on the watch
```

**Connection seems dead / stuck.**
Press `r` in the TUI to force-drop the connection; the connect loop rescans and
re-authenticates automatically. `./fmc -notui` shows the same session as a plain
event log if you need to see where it stops.

## Disclaimers

Unofficial, not affiliated with Nothing/CMF. Everything was obtained by observing a
watch the author owns. Flashing self-built watchfaces is at your own risk — the format
is well-understood and locally validated, but the firmware's tolerance for unusual
input is unknown. Health data shown by this tool is not medical advice.

Protocol knowledge builds on the excellent work of the
[Gadgetbridge](https://gadgetbridge.org/) project (AGPL) — the CMF protocol
implementation here was written from its documentation and source.

fmc_go

fmc_go 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

fmc_go

fmc_go 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

Download README