New: cross-platform wfbInstaller and a new Wiki / FAQ page
Hey r/watchfacebuilder — two updates that should help with the most common questions in this sub.
1. wfbInstaller — open-source, cross-platform installer
A self-contained installer for putting WFB watch faces onto your Garmin device.
No Python, no pip install, no Garmin Express, no Android File Transfer (Google
discontinued that one anyway). Drop in a URL, a .zip, a .prg, or a .set
file and it does the rest.
Download (single file, no install):
- Windows 64-bit —
wfbinstaller-windows-x64.exe - Linux x86_64 —
wfbinstaller-linux-x64 - macOS Apple Silicon —
wfbinstaller-macos-arm64 - macOS Intel —
wfbinstaller-macos-x64
→ https://github.com/joshuahxh/wfbInstaller/releases/latest
Mac users: this is now the recommended way to install watch faces, since modern macOS no longer mounts the watch as a drive and Android File Transfer is gone. The macOS binaries talk to the device directly — just download, run, paste a watch-face URL, done.
Source is on GitHub and CI builds all four binaries from the same commit on every release: https://github.com/joshuahxh/wfbInstaller
2. Community Wiki & FAQ
A consolidated FAQ pulling together the recurring threads here — install methods, the "my .prg file disappeared after disconnecting" question (it didn't, that's normal), API keys vs OWM keys, MIP vs AMOLED battery, OOM debugging, app properties, language tokens, the full Builder UI reference from the official help guide, and more.
→ https://joshuahxh.github.io/wfbInstaller/
It's a plain web page, no GitHub layout. Source is docs/index.md in the
same repo, so if you spot something wrong or missing:
- Click "Edit this page on GitHub" at the bottom of the wiki, or
- Open a PR against https://github.com/joshuahxh/wfbInstaller/edit/main/docs/index.md
I'll review and merge. The page rebuilds automatically within ~1 minute of merging.
What's not included
- This is not an official Garmin product. It's a community helper.
- ConnectIQ-store publishing is still done through the WFB website (premium).
- For anything related to the Builder itself (bugs, feature requests, new tokens, new device support), keep posting here as usual — u/joshuahxh-1 is the dev to ping.
Feedback / corrections / PRs welcome. Hope it helps cut down on some of the duplicate threads.