Turn your EMF Tildagon badge into a compass that points at your friends, the stages, the bars, villages, and any spot you save. The 12 rim LEDs glide to show the way; the screen shows distance and runs warmer/colder as you close in.
TL;DR (install on a Mac):
git clone https://github.com/Perciville5241/ze-flock.git cd ze-flock ./install.shPlug your badge into the USB IN port first. When it finishes, hold the boop button for ~2 seconds; Ze Flock appears in the launcher. After that, the app keeps itself up to date — Settings → Check for updates.
You need a Tildagon badge, a GPS hexpansion (recommended), and WiFi (automatic at EMF, or set your network in the badge's Settings app).
A companion web app mirrors the badge on your phone (compass + friends + places + custom locations), and you can link your badge to it so they're "your devices". It's invite only — to request access, please email doug@dougaddams.com. Once you have a login, open it on your phone and see its Settings for how to link this badge (you'll enter the badge's name, code and id, then a one-time code the badge shows under Settings -> id).
Open Ze Flock from the launcher. It joins WiFi, registers your badge, and shows a friend code (Settings → your info). Swap codes with a friend and add each other (Add Friend finds nearby badges over the air — no typing).
A compass needle + distance point at one target at a time. Around the screen is an N/E/S/W rose. The four corner buttons cycle the target without leaving the screen:
| Button | Cycles |
|---|---|
| A (up) | your custom locations (yours + shared with you) |
| B (right) | friends |
| C (ok) | compass defaults: EMF Camp, North, South, East, West |
| D (down) | your favourited places |
| F (back) | menu |
When you arrive, the badge pulses green and says MADE IT! (for up to 30s; any press dismisses it).
- Locations — EMF points of interest (stages, bars, first aid, toilets, gates…). C navigate, E heart (favourite).
- Villages — the live EMF villages list.
- Friend List — C navigate to a friend, E heart.
- Group List — open a group to see its members; navigate to / heart people.
- Custom Locations — save your current spot, navigate to saved/shared spots, B send one to a friend.
- Add Friend — finds the nearest badge running Ze Flock.
- Settings — theme, font size, units, default location, and updates.
B on any menu cycles the font size (Small / Medium / Large).
- Theme — Green / Amber / Cyan / Pink / Mono.
- Font — Small / Medium / Large.
- Units — Miles (default), Metric, Clicks, Feet, or EMF (ESC).
- Default Location — what the compass points at by default.
- Check for updates — see below.
Distances default to Miles (UK). Other units: Metric, Clicks (km), Feet, and EMF (ESC).
ESC = Express Sprinter Carriage. One ESC is the length of a single British Rail Class 158 "Express Sprinter" carriage — exactly 22.57 metres (about 74 feet). With EMF units on, distance is shown in whole carriages:
1 ESC= 22.57 m (~74 ft)10 ESC= 225.7 m100 ESC= 2.257 km (≈ 1.4 miles)
The app version shows on the menu footer and in Settings. Go to Settings → Check for updates: if a newer release exists it downloads it and you hold the boop to reboot. Updates are fetched from this public repo; a dropped connection can't break your install (files are staged then swapped in).
You can also re-run ./install.sh any time to reinstall the latest.
The one-liner above uses install.sh (macOS/Linux). If you'd rather do it by
hand, or you're on Windows:
pip install mpremote
mpremote mkdir apps
mpremote mkdir apps/flock
mpremote cp badge_app/*.py badge_app/metadata.json badge_app/version.json :/apps/flock/Then hold the boop button.
MIT — see LICENSE.