No description
  • JavaScript 74.7%
  • Monkey C 10.1%
  • Go 5.5%
  • HTML 3.5%
  • CSS 3.4%
  • Other 2.8%
Find a file
Repository files (latest commit first)
Filename Latest commit message Latest commit date
renovate-bot a424eb5dce
Some checks failed
CI / checks (push) Successful in 38s
CI / image (push) Successful in 1m31s
CI / e2e (push) Successful in 4m19s
coverage: CI / relay 83.5%
CI / relay (push) Successful in 1m30s
CI / watch (push) Successful in 6m39s
CI / android (push) Failing after 1m13s
Merge pull request 'fix(deps): update all patch dependencies' (#67) from renovate/all-patch into main
2026-11-22 12:28:10 +00:00
.forgejo/workflows Merge pull request 'fix(deps): update all patch dependencies' (#67) from renovate/all-patch into main 2026-11-22 12:28:10 +00:00
app fix(deps): update all patch dependencies 2026-11-21 09:25:16 +00:00
docs ci: the watch build and the release ask for the Connect IQ SDK's runner label 2026-11-20 20:59:45 +01:00
fastlane/metadata/android/en-US feat(viewer): a bee hive and a skate park in place of the last placeholders 2026-11-18 17:45:13 +01:00
protocol docs: user and developer documentation apart, stale and finished pages dropped 2026-11-18 07:27:00 +01:00
relay fix(deps): update all patch dependencies 2026-11-21 09:25:16 +00:00
tools fix(viewer): hand tracking loads on the web, models free their GPU memory, and a stalled or switched camera is handled 2026-11-18 22:07:19 +01:00
viewer Merge pull request 'fix(deps): update all patch dependencies' (#67) from renovate/all-patch into main 2026-11-22 12:28:10 +00:00
watch feat(channel): a request log for the relay and the link's status on the pairing screen 2026-11-19 14:12:04 +01:00
.cz.toml Milestones 5 and 6: release workflow and deployment, store guide and assets (#4) 2026-11-16 04:59:14 +00:00
.gitattributes feat(android): an App Bundle for Google Play, and the listing for Play and F-Droid 2026-11-18 07:49:49 +01:00
.gitignore docs: user and developer documentation apart, stale and finished pages dropped 2026-11-18 07:27:00 +01:00
.markdownlint.jsonc docs(changelog): the models under Unreleased, no blank line at the end (#8) 2026-11-16 14:22:26 +00:00
CHANGELOG.md chore(release): 0.6.0 2026-11-19 13:17:09 +00:00
compose.yaml feat(channel): a request log for the relay and the link's status on the pairing screen 2026-11-19 14:12:04 +01:00
LICENSE chore: the repository's skeleton, CI, and the detection and dictionary decisions 2026-11-15 16:31:55 +01:00
README.md feat(viewer): a bee hive and a skate park in place of the last placeholders 2026-11-18 17:45:13 +01:00
renovate.json feat: viewer detection with an axis gizmo, a desktop marker page, and the watch app (#1) 2026-11-16 04:56:32 +00:00

WristMarkCompanion

Your watch, in 3D. Point your phone's or laptop's camera at your watch, and a 3D model comes alive on your wrist: tonight's moon, the planets as they stand today, a campfire, dice you roll with a flick of the wrist.

WristMarkCompanion: your watch, in 3D. A Ferris wheel standing on a watch on a wrist

Use it

  1. Open WristMarkCompanion on the watch: it shows a marker.
  2. Open the viewer, https://wristmark.apps.ciepiela.org, on a phone or a laptop with a camera, and tap Start the camera.
  3. Point the camera at the watch. Its buttons switch to the next model.

The user guide has the gestures, the tips for a steady model and what to do when something doesn't work. No watch at hand? The viewer's Markers page shows them on any screen.

  • 50 models, one for every marker, all made in code: the sky (the moon's phase, the Earth with day and night, the planets, a world clock, a satellite, a black hole), time (a watch movement, an hourglass, a sundial, a metronome), science (an atom, DNA, a Newton's cradle, a puzzle cube that solves itself), flight (an attitude indicator, a landing, a helicopter, a balloon, a rocket launch, a UFO), places (a windmill, a sailboat, a Ferris wheel, a carousel, a race track, a castle, a house, a bonsai through the seasons, a volcano, a lighthouse, a rain cloud, a bee hive, a skate park) and fun (dice, a marble maze, fireworks, a tornado, a snowman, a campfire, an aquarium, a jellyfish, butterflies, a lava lamp, a treasure chest, a robot, Tux the Linux penguin, a Tyrannosaurus rex, Glimmer the crystal-tailed creature, a toy train, a gumball machine). The full list.
  • Move your wrist: flick, shake or twist it, and the model reacts. Buttons do the same.
  • Any size: pinch, scroll or + and −; full screen with F.
  • Private: the camera's image is processed in the browser and never leaves the device. No account, no tracking (privacy).

How it works

The watch shows an ArUco marker. The viewer, a static web page, finds it in the camera image (js-aruco2), works out where the watch is and how it's turned, and draws the model for that marker's ID on top of it (three.js). The marker ID is all the viewer needs.

Pair the watch with the viewer (through the camera, encrypted end to end) and the viewer can steer it too: the next model, the automatic cycle, a buzz to find it.

Documentation

  • Using it: the user guide and the models.
  • Developing it: docs/dev/: the architecture, the repository's layout, the watch app, the viewer's content and interaction, Android, CI, deployment, publishing, device tests and decisions.

License

GPL-3.0 (LICENSE). Third-party parts keep their own licenses: js-aruco2 (MIT) and the OpenCV ArUco dictionary (3-clause BSD, its notice is in watch/source/MarkerDictionary.mc).