Guide

The complete reference — every screen and every tool. New here? Start with Getting Started, or grab the one-line version on the Cheat Sheet.

1. The screen at a glance

Box the Wind is a map- and position-centric app for hot air balloon competition flying (BFA / FAI AX rules). It carries the day's tasks, your position, navigation to the active target, the contest area and prohibited zones, wind, and the pilot-to-crew link. All of it works offline once your maps are downloaded.

The map fills the screen. A readout strip sits across the top, a status pill in the top-left corner, and a control bar along the bottom.

The glance strip

Eight cells, always on:

On iPad the strip is one row of eight. On iPhone it splits into two rows of four: the directions (TGT, BRG, HDG, STR) on top, the magnitudes (altitude, DIST, MISS, CTR) below. Every cell holds a fixed share of the width, so a long value shrinks rather than shifting the layout. A cell with nothing to show reads .

The status pill

Top-left. It shows the source and link state: REPLAY, CREW · LIVE, CREW · STALE 0:12, PILOT · GPS · Go Live. In pilot mode the pill is also the Live control: tap to start recording (and broadcasting, if a flight code is set), tap again and confirm to stop. See Recording and replay.

The control bar

Along the bottom, left to right:

On a narrow screen the bar wraps to two rows rather than dropping buttons.

2. The map

Map and Aerial

The base-layer button cycles between Map (an OpenStreetMap vector street map) and Aerial (Esri World Imagery online, USDA NAIP in the offline packs). Both render from online tiles or from the packs you download in Settings → Offline Maps, never mixed: a downloaded area shows your downloaded coverage and nothing outside it.

Follow modes

The follow button cycles Track-upCenterFrame. Track-up rotates the map so your direction of travel is up and biases the balloon toward the lower part of the screen, leaving the ground ahead of you visible. Center keeps the balloon centered, north-up. Frame fits your whole track. Panning or zooming by hand drops you into Free; tapping the button again resumes at Track-up. The compass sits in the top-right corner, below the glance strip; tap it for north-up.

The center crosshair

A bright blue crosshair marks the exact center of the map, and the CTR cell reads its 4/4 live as you pan. Every coordinate keypad in the app carries a Use Crosshair Location button that fills in whatever CTR read when you opened it.

The track

Your flown track draws behind the balloon for the whole session. Settings → Source → Clear old balloon track wipes it, which helps when a practice replay or yesterday's flight is still drawn under today's.

Layer colors

Settings → Appearance → Layers lists every overlay: 1 km Grid, Contest Boundary, Red PZs, Yellow PZs, Blue PZs, Red Roads, Flown Track, Target Line, Drift Line + Dots, Task Targets, Task Circles, Task Lines, Wind Line 1, Wind Line 2, and Crew Position. The track, the two nav lines, the task geometry, and the two wind lines open a swatch grid; the rest are plain on/off toggles. The last swatch in the grid — a crossed-out circle — hides that layer entirely, as the footer under the grid says: “Choose a color, or the last swatch to hide this layer.” That's how you turn off the task target X markers, for instance.

3. The 4/4 grid and grid center

What a 4/4 is

An easting/northing within a 100 km UTM square, in 10 m units, like 0280/8012. Box the Wind resolves every 4/4 through a configurable grid reference, center-pinned to the nearest 100 km instance so the square straddles both axes and the official digits are preserved. Targets, goals, keypad entries, the TGT and CTR cells, and the imported task sheet all convert through that one reference.

Setting the grid center

Pan the map so the crosshair sits over your contest area, then open Settings → Grid Center and tap Use Map Center as Grid Center. Confirming also deletes any offline maps you've downloaded, since they were harvested for the old area's grid.

Set this before anything else. An off-area grid reference silently mislocates every target — the numbers still look right, the map still draws, and everything lands in the wrong place. It is the single most damaging misconfiguration in the app, and the first thing to check when a target looks wrong.

The 1 km grid lines

The 1 km Grid layer draws whole-kilometer 4/4 values for the current reference, covering ±50 km around the grid center. Lines fall exactly where a 4/4 ends in 00, so they move when you re-center.

4. Zones, the contest area, and warnings

The four classifications

The app ships empty. You import your own airspace from the files the event director distributes, into one of four prohibited-zone classifications plus the contest area:

Importing

Settings → Zones has an import button per category — Import Red zones…, Import Red roads…, and so on — plus Import Contest area…. Each accepts KML, OziExplorer PLT, or GPX; the format is detected from the file contents, so you pick the file and nothing else. Picking imports immediately; a file with no usable geometry reports an error and changes nothing. PLT and GPX line tracks become zone outlines or road centerlines exactly like the equivalent KML. Every ring in a placemark is captured, so multi-ring zones display; inner-ring holes and file-defined colors are not applied. Swipe a row to delete an imported file.

Altitude limits

Tap a Red or Blue zone to set its own limit and choose AGL or MSL. Blank uses the category default from Settings → Warnings (Default ceiling for red, Default floor for blue). Red roads share one Keepout radius.

The active contest area

Import as many contest areas as you like. Under Contest areas, tap a row to make it the active one; a green checkmark marks it. At most one is active at a time, and tapping the active row deactivates it, leaving none. The active area draws as a boundary, validates declared goals (a goal outside it is blocked — see Declaring goals), and is one of the four warning surfaces. With no active area, Declare Goal is disabled.

Warnings

Four surfaces produce warnings: a red zone's ceiling, a blue zone's floor, a red-road tunnel, and the contest boundary, where leaving is OFB. Evaluation is 3D — horizontal distance and altitude together — so a zone you are safely high above stays quiet.

Pilot and crew each evaluate warnings locally from their own copy of the zones, so the crew device sees the same picture without waiting on the link.

Where AGL comes from

Terrain elevation is sampled from Terrarium tiles at zoom 12, interpolated between tile posts. With a connection the app fetches them on demand; with offline maps downloaded it reads the elevation pack harvested alongside them. The Site elevation figure under Ground reference (for AGL) is the fallback, used only when you're offline and the area isn't downloaded. AGL needs an altitude in the fix; live GPS and recorded GPX carry one.

5. Tasks

Importing a task sheet

Tap Tasks, paste the link into WatchMeFly TDS URL, and tap Import. The app accepts both the structured TDS web page and many task-sheet PDFs, detecting which it got from the response, and parses it into an editable list. Importing replaces the whole list and resets the active-target selection.

What doesn't parse

Results-table PDFs, scanned images with no text layer ("This PDF has no readable text"), and coordinates written with spaces in the German style come back wrong or not at all. A sheet with nothing recognizable reports "No tasks found at that URL." The fix in every case is to correct the list by hand, or build it with Add Task.

Editing a task

The list is fully editable because a parse is never trusted blindly. Check the day's targets against the sheet before you fly.

Tap a task to open it:

Edits save as you make them and persist across launches.

The task list

Each row shows the task number, type code, and type name, with its targets as chips underneath. A task with no published target reads "No targets (declared / distance task)". Tasks that carry marker information show a colored oval on the right with the marker color, its drop or logger number, and the scoring-period deadline (by 8:30).

The launch point

A Launch Point row is pinned at the top of the list, set to Common (CLP) or Individual (ILP) and parsed from the sheet when it's there. It draws as a dotted circle on the map, can't be deleted, and is never offered as a declared goal.

Clearing and sharing

Clear Task List asks for confirmation, then removes the flight title, every task, and the import URL, and leaves a single pristine ILP launch point. Re-Broadcast Tasks pushes the current list to the crew; it needs pilot mode and a live link (see On the crew device).

6. Targets and navigation

Choosing the active target

In the task list, tap a task's A / B target chips. The chip highlights green and that target drives the glance strip and the on-map lines. A chip also shows the target's MSL altitude when it carries one.

Tapping the map drops an ad-hoc target instead, which gives you a range and bearing to something that isn't on the sheet. Clear target removes it. A dropped target and a task chip override each other; the last action wins.

The readouts

BRG and DIST are the bearing and distance from your position to the active target. HDG is your track over ground and STR is the turn from that track onto the bearing, given as a left or right offset. MISS is the closest approach you'd make on your present drift, with the time until that point.

The lines

The target line runs from the balloon to the active target, ending in a mark on the target itself. With no balloon position yet — crew mode before the pilot goes live — there's no line to draw, but the mark still shows, so you can always see which target is selected. The drift line projects your current drift with 5-minute tick dots and a mark at the closest approach. The drift line renders from the fix alone, so it draws with no target selected, and it has its own visibility toggle (Drift Line + Dots) independent of Target Line.

Nudging a target

Long-press the active target on the map to open the nudge pad. It works on a task target only — a tap-dropped ad-hoc target can't be nudged — and the press has to land within about 60 pt of the target. The pad docks near the bottom of the screen so it never covers the target it's moving, and shows the original 4/4, the current one, and the offset between them.

Two wind lines

The Wind Lines button opens a sheet for the active target carrying two independent reference lines. Set each one's bearing on the dial — drag a handle to swing it, and drag farther out from the center for finer control — or step it with the − and + buttons for exact degrees. Clear removes a line.

Each line draws dashed and screen-spanning through the target. The two have separate colors, Wind Line 1 and Wind Line 2, both in the Appearance swatch pickers. The bearings belong to the target, so they follow it if you switch away and back.

7. Tools

The wrench beside the gear opens the tools menu: Wind Cone, T2T Info, Measure, and Practice Drops. Each is a toggle. The first three are on when their map layer is visible; Practice Drops adds the Drop button to the control bar in pilot mode. The wind cone's own behavior is in Wind, practice drops in Practice drops.

T2T Info

Draws connector lines between the task targets with the distance and heading of each leg labeled on the map. The chain starts at the launch point, then runs in task-number order; tasks with no targets are skipped so the chain joins the tasks that have them. Where consecutive tasks each carry several targets, every pairing gets a line. Nothing connects targets within a single task.

Measure

Puts a green and a red circle on the map, each dragged directly with a finger. A panel across the bottom mirrors the layout: green 4/4 on the left, red on the right, distance and bearing between them in the middle.

8. Wind

The cone

The wind cone is a hodograph anchored at the balloon: a curve of drift direction by altitude, colored by height, rotating with the map so a spoke always points where that layer would carry you. Each spoke's length is the ground drift that layer gives you over five minutes, at the map's current scale. Turn it on in the tools menu (the wrench).

A segment draws solid where the wind was measured from your own drift and as dense dots where it comes from the forecast. The cone is source-independent — pilot, crew, and replay all draw it from the active fix stream. It draws only once there is something to draw: measured levels, a fetched forecast, or both. With neither, there is no curve and no scale bar.

Two thin rays run out from the balloon along the two extreme drift directions in the column, extending past the screen edge, so the fan of directions available to you is visible even where the curve itself is short.

The AGL scale bar

A vertical color bar sits on the right, running from the ground to the display ceiling. Every altitude number in the instrument is written on this bar; nothing is written on the curve. Its marks:

Those target marks are exact crossings, interpolated between adjacent levels, where the drift direction lines up with the bearing to the target and is pointed toward it rather than away. There may be none, one, or several. If the target bearing isn't crossed anywhere in the column — the target is outside the cone — nothing is marked. There is no tolerance band and no nearest-available fallback: a mark means that altitude's drift is on the target line, and no mark means no altitude in the column is.

Labels are black on opaque white pills so they stay readable over any base map; the marks themselves carry the color coding.

Forecast and models

Settings → Winds Aloft → Fetch winds aloft pulls the wind profile for the current map center. Do it while you have signal; the result is cached and available offline. Re-fetching replaces the forecast and clears all measured data, so the column starts fresh.

Wind model picks which forecast model the fetch asks for: HRRR (the default), ECMWF, or GFS. It takes effect on the next fetch. HRRR is the highest resolution of the three and covers the continental US only; a fetch outside that coverage returns nothing and reports "HRRR covers the continental US only — choose GFS or ECMWF for this area." Your existing forecast is left alone — the app never quietly swaps models on you. A fetch that can't reach the server reports "Couldn't fetch winds aloft. Check connectivity and try again."

Wind cone ceiling — 1000 to 6000 ft — sets the top of both the cone and the scale bar.

The TOWARD table

Below the fetch controls, Manual Override lists thirteen levels. Each row shows Alt (AGL / MSL), an arrow pointing the way the wind is going, TOWARD (°), and the speed in your current unit. Directions are the direction the wind blows to, matching the windlineweather convention and the cone itself.

Direction and speed are editable; the altitudes are fixed. Edit any rows you want and tap Apply overrides. Applying replaces the forecast and clears in-flight wind data exactly as a re-fetch does.

Smoothing

Settings → Wind Cone holds three controls that shape how measured readings become the curve. They're set-and-forget rather than in-flight controls.

Where the numbers come from

The forecast comes from Open-Meteo, no key required. The app requests pressure levels from 1000 to 800 hPa plus near-surface height levels at 10, 80, 120, and 180 m, converts each level's geopotential height to AGL, and stores the result as drift vectors. Directions are relative to true north.

Measured winds come from your own drift: every fix's ground speed and track updates the estimate for its altitude bin. Readings are weighted by how level you were flying and decay with the Memory half-life, so a later pass through a layer supersedes an earlier one and a layer you don't revisit holds its last value. There's no accept/reject gate — every fix contributes, weighted. Measured bins replace the forecast; bins inside your flown envelope with no reading of their own are filled from their measured neighbors, and bins outside it stay forecast.

9. Declaring goals

Tap Declare Goal in the control bar:

  1. Pick the task under Goal task. Only pilot-declared goal types are listed; a judge-declared goal isn't yours to set, and the launch point is never offered. With none in the flight the sheet reads "No declared-goal task in this flight".
  2. Key the EASTING and NORTHING on the 4/4 keypad, or tap Use Crosshair Location to take whatever the crosshair read when you opened the sheet.
  3. A ghost pin follows what you've entered: green inside the active contest area, red outside it.
  4. Confirm. The goal is stamped onto the task and becomes the active target.

A goal outside the contest area is hard-blocked — confirming is disabled and the sheet says Outside contest area. The check runs against the active contest area, so Declare Goal is disabled entirely until you've imported and activated one (see Zones, the contest area, and warnings).

10. Source and live tracking

The three sources

Settings → Source:

Changing the source takes effect immediately.

Flight code and password

For the two live sources, set a Flight code and Password. Pilot and crew entering the same pair land on the same private channel, derived from the two together — nobody without both can join it. Editing either field reconnects at once, so a mid-flight change takes effect without a restart.

A flight code is required to broadcast. With no code the app runs solo: it records and navigates exactly as usual and sends nothing. The pill shows · solo while you're live that way.

What the pill says about the sensor

The pilot pill reads Pilot · GPS on any device, whatever hardware is actually producing the fix — an iPad reads the same as an iPhone, and a paired receiver the same as the device's own chip. The FAQ's iPad GPS entries cover which iPads have their own receiver and what a Wi-Fi-only iPad does instead.

11. On the crew device

Crew mode is a full copy of the map, running the same tasks, zones, warnings, and navigation as the basket — with the balloon's position arriving over the link instead of from this device's GPS. It's a full map, not a viewer.

Setup

Set Settings → Source to Crew and enter the same Flight code and Password the pilot used. That pair is the whole handshake. Sharing it shares position with whoever holds it, and nothing else.

Your own position

The crew device's own location draws as a blue dot with a white outline. It's kept deliberately separate from the balloon: it never joins the flown track, never feeds the glance strip, and draws beneath the track so it can't cover flight data. It comes from this device's GPS, not the link, so it works with the link down or before the pilot goes live. Toggle it with Crew Position in Settings → Appearance → Layers; it's on by default.

Reading the link

The status pill carries the link state: CREW · CONNECTING while it joins, CREW · LIVE once positions are arriving, CREW · STALE 0:14 with the age when they stop, and CREW · OFFLINE when the connection is down. CREW · NO KEY means no flight code is set, so there's no channel to join. A stale link is always shown as stale — the balloon holds its last known position and is never presented as live. A stationary pilot keeps reading LIVE, since the pilot device re-broadcasts on a heartbeat rather than only on movement.

Tasks from the pilot

When the pilot broadcasts the task list, an alert appears: Pilot Updated Tasks, "The pilot shared an updated task list." — with Accept and Overwrite and Ignore. Accepting replaces the crew's whole list, including which target is active. Ignoring is final on this side; there's no button to bring the offer back. Recovery is the pilot tapping Re-Broadcast Tasks, which re-offers the list even if nothing changed.

The prompt only appears when the incoming list actually differs from what the crew already has, so a relaunch or a repeated broadcast of the same list stays silent. Nothing obliges the crew to take the pilot's list — importing a TDS URL or building a list by hand works exactly as it does in the basket.

Car → X

In crew mode a car button replaces Declare Goal in the control bar. Tapping it opens driving directions to the active target in your maps app. Settings → Targets → Directions app chooses Apple Maps or Google Maps; Google Maps appears in the picker only when it's installed on the device. The button is disabled while no target is active.

What the crew doesn't get

Four things are pilot-only by design, and their controls are absent or inert in crew mode:

What does work

Everything else, at full function:

12. Recording and replay

Going live

In pilot mode the status pill is the Live control. It reads Go Live once there's a fix. Tap it and recording starts to a GPX file — and broadcasting starts too, if a flight code is set. The pill then reads Rec mm:ss, with · solo appended when there's no code and nothing is leaving the device. The dot beside the text is the sensor: orange while the GPS isn't ready, green once it is, red if location permission was denied.

Tap the pill again to stop; it confirms first, asking "Stop recording & broadcasting?" — or "Stop recording?" when you're solo. Recording keeps running with the screen locked and the app in the background.

Recordings are written incrementally and flushed to disk as each fix arrives, so a crash or a flat battery costs you nothing but the last fix. An interrupted recording is found and recovered the next time the app launches.

The Recordings screen

Settings → Recordings lists your saved flights. Each row offers Replay (loads it as the replay source and closes Settings), Share (the GPX file), and Rename; swipe to delete. Import GPX… brings in a flight from elsewhere, and Replay speed sets the playback rate — 1×, 2×, 5×, 10×, or 20× — which can be changed mid-playback.

A GPX can also come straight from another app. Share a flight track from wherever it lives — a logger app, Files, Mail — and pick Box the Wind from the share sheet. The flight is added to Recordings and the app offers to replay it there and then; declining still keeps the file. A flight arriving under a name you already have is kept separately rather than replacing the earlier one.

13. Practice drops

An electronic marker drop, scored against your task targets. As the app says: Practice only — do not use in official competitions. Pilot mode only.

Turn it on with Practice Drops in the wrench tools menu, which adds a Drop button to the control bar.

Dropping

Tapping Drop opens the drop sheet. Under Drop a marker it lists the markers available to drop, in number order: every distinct Logger marker number your tasks carry, each labeled with the task it came from. A task list with none reads "Add a Logger Marker number to a task to drop it." Tap the marker you're throwing and confirm; the app records your position at that moment. The confirmation tells you what it will score against — "Scores against A (0280/8012)." — or warns you that it won't: "No task target selected — recorded without a scoring distance.", or that the active target's task doesn't use the marker number you picked.

Scoring

Each drop is scored as the distance from the marker to the selected target and tagged 2D or 3D, against the 2D / 3D separation (MSL) altitude in Settings → Targets:

Results

The Results section lists every drop in marker-number order: marker number, the exact distance with its 2D/3D tag, and the target and drop positions with AGL and MSL for each. An unscored drop shows — no target or — target ≠ marker in place of a distance. Clear all wipes the log after a confirmation.

14. Units, appearance, and settings

Units

Settings → Appearance → Units:

The setting is display and entry only. Everything is stored metric, and 4/4 coordinates never change. If you upgraded from an older version that was still on the metric default, you'll find yourself on Mixed; picking any mode locks your choice.

Altitude readout

Settings → Appearance → Altitude readout switches the altitude glance cell between AGL and MSL. The cell relabels itself to whichever you chose, and the same choice labels the wind cone's scale-bar ticks.

Layer colors

Under Layers, the track, target and drift lines, the task geometry, and the two wind lines open a swatch grid; the rest are on/off toggles. The last swatch is Transparent (hidden) — pick it to hide a layer without losing its other settings. Full list in The map.

Every settings screen

SourceReplay / Crew / Pilot · GPS, flight code, password, and Clear old balloon track.
AppearanceUnits, altitude readout, and per-layer colors and visibility.
WarningsMaster on/off, per-category default ceiling and floor, the red-road keepout radius, approach distances, and site elevation.
Grid CenterThe current UTM zone and center, and Use Map Center as Grid Center.
ZonesImport and delete red, red-road, yellow, and blue zones and contest areas; per-zone altitude limits; the active contest area.
TargetsNudge step, snap measure circles to targets, the directions app for the crew car button, and the 2D/3D separation altitude for practice drops.
Winds AloftFetch winds aloft, Wind model, Wind cone ceiling, and the TOWARD override table.
Wind ConeLevel-flight filter, memory, and vertical smoothing for measured winds.
RecordingsSaved flights — replay, share, rename, delete — plus GPX import and replay speed.
Offline MapsDownload Offline Maps… and Clear downloaded maps.
HelpLinks to Getting Started, the Cheat Sheet, this Guide, and the FAQ; the app version and build number, the build date, and map data credits.

Quote the version and build from Help in any support email — it's the fastest way to tell us exactly what you're running.