User Guide & Troubleshooting

GeekFlight

Everything you need to set up, verify, and fix GeekFlight — fast.
1
Phone Orientation — Flat Wins
How to mount your phone

Recommended: lay the phone flat on the tray table, screen up. The gyroscope works correctly at any angle, but flat eliminates the 90° yaw-as-bank problem and is more stable on a tray table during turbulence.

FLAT ON TRAY TABLE

Phone face-up, USB port facing the nose of the aircraft. Screen readable from above. This is the easiest and most reliable orientation — no mount needed, doesn't fall over in turbulence.

✓ Recommended ✓ Stable ✓ No mount
UPRIGHT IN SEAT POCKET

Phone vertical, screen facing you. Works fine but requires the phone to stay upright. SET LEVEL must be pressed after placing the phone. Turbulence can shift the mount angle and cause drift.

⚠ Needs stable mount SET LEVEL after placing

GeekFlight works at any angle — the sensor blend adapts continuously. You do not need to tell the app which orientation you're using.

2
Roll, Pitch & Yaw — What They Mean
The three axes of flight

Every movement an aircraft makes is described by three rotations. GeekFlight measures all three from your phone's gyroscope.

✈️
ROLL
One wing goes up, the other goes down. Turns are made by rolling.
Bank angle
🛫
PITCH
Nose goes up or down. Controls climb and descent rate.
Nose up / down
🧭
YAW
Nose swings left or right. Used with roll to coordinate turns.
Left / right swing

Quick memory test: Roll = tip a wine glass sideways. Pitch = tilt it forward so wine pours out. Yaw = spin it on the table without tilting.

WHAT GEEKFLIGHT DISPLAYS

The bank gauge (artificial horizon) shows roll. The pitch indicator shows nose angle. The turn coordinator shows yaw rate. On the Gyro screen, the 3D plane model moves with the phone — that's your ground truth test.

3
Gyro Screen Test — Verify Before You Fly
Confirm the 3D plane matches your phone

Do this before every flight. The Gyro screen lets you verify the gyroscope is working and all axes are correct before you rely on the attitude display.

  1. Open GeekFlight and tap the GYRO button in the bottom menu to open the Gyro screen.

  2. You'll see a 3D wireframe aircraft and three bar charts labelled PITCH · ROLL · YAW. The bars show live gyro rates as you move the phone.

  3. Hold the phone flat on the tray table (or a flat surface). Tap SET LEVEL. The plane model should sit wings-level.

  4. Test roll: tilt the right edge of the phone up. The plane's right wing should rise. Tilt it back — wing should return to level.

  5. Test pitch: tilt the top edge of the phone up (like a ramp). The plane's nose should rise. Tilt it back — nose returns level.

  6. Test yaw: slowly rotate the phone clockwise (spinning on the table). The plane should yaw right. Spin back — returns to heading.

  7. If all three match, your gyro is working correctly. You're done.

WHAT GOOD LOOKS LIKE

Phone movement → plane movement, with no lag and no drift after you stop moving. The plane holds position when the phone is still. If it slowly drifts back to level by itself, that's the G-sensor correction working — this is normal and intentional.

WHAT BAD LOOKS LIKE

Yaw moves bank gauge: rotating the phone causes the bank to show 90° — see Section 6 to fix.
Roll and pitch are swapped: tilting forward moves the bank gauge — try toggling AXES SWAP in Settings.
Plane doesn't move at all: no gyro hardware detected — see Section 7.
Bank is backwards: toggle BANK FLIP in Settings.
Pitch is backwards: toggle PITCH FLIP in Settings.

4
First Flight Setup
Step-by-step for a new session
  1. Select your aircraft — tap the aircraft type on the main screen. This sets the cabin pressurisation model, turbulence weight class, and cruise speed used for ETA.

  2. Calibrate gyro (optional but recommended) — in Settings, run the SPIN/ROLL/FLIP calibration for each axis. One slow 360° rotation per axis. Only needs doing once per device.

  3. Run the gyro test — Gyro screen, SET LEVEL, test all three axes as per Section 3. Adjust AXES SWAP / BANK FLIP / PITCH FLIP in Settings until correct.

  4. Set your route — enter departure and arrival ICAO codes (e.g. LHR, JFK) and scheduled times. GeekFlight uses baro climb detection to auto-start the flight timer.

  5. SET LEVEL in the cockpit — after placing the phone in its final position, tap SET LEVEL. This zeros the attitude reference. Do not move the phone after this.

  6. At cruise — set altitude — read your plane altitude from the seatback screen, enter it in the ALT SET box and tap SET. This calibrates the cabin pressure model to real conditions.

SET LEVEL only resets the gyro attitude. It does not reset the barometric altitude reference. You can tap SET LEVEL to fix a drifted horizon without losing your altitude calibration.

5
Altitude & Cabin Pressure
Understanding what the gauges show
CABIN ALTITUDE (top-left gauge)

This is the pressurised cabin altitude — the altitude equivalent of the air pressure inside the cabin. At cruise (e.g. FL350) the cabin is pressurised to the equivalent of about 8,000ft on most aircraft (6,000ft on B787/A350). This is what your body experiences, not the actual plane altitude.

ESTIMATED PLANE ALTITUDE (third gauge, left column)

GeekFlight estimates the true outside altitude by modelling the pressurisation differential — the difference between cabin pressure and outside air. This is accurate to ±500ft without calibration, and much more accurate after using ALT SET.

ALT SET — HOW TO USE IT

1. Look at the seatback screen for your current plane altitude (e.g. 35,000ft).
2. Enter that number in the ALT SET box in the cockpit screen.
3. Tap SET.

GeekFlight back-calculates the exact pressure differential and QNH for your conditions. After setting, the plane altitude estimate becomes accurate. Do this once at cruise — no need to repeat unless you change aircraft.

✓ Enter PLANE altitude Not cabin altitude Best done at cruise
QNH

QNH is the reference pressure that converts raw barometric pressure into altitude. Standard atmosphere = 1013.25 hPa. If you're on the ground and the altimeter reads wrong, adjust QNH until it shows your known elevation. In flight, use ALT SET instead — it sets QNH automatically.

On the ground at sea level: QNH should read ~1013 hPa. If the ALT SET function gives a crazy QNH number, check the barometer is working on the Sensor Status screen (Section 7) — some devices return pressure in Pascals rather than hPa, which the app corrects automatically.

6
Troubleshooting
Symptom → fix
Bank jumps to 90° when I rotate the phone
This is the yaw-as-bank issue — fixed in v3.78. Update the app. If already on v3.78+, tap SET LEVEL again.
Roll and pitch are swapped
In Settings → AXES SWAP, toggle ON. Test the gyro screen again. If still wrong, toggle back OFF and try BANK FLIP or PITCH FLIP.
Bank is backwards (left bank shows as right)
Settings → toggle BANK FLIP.
Pitch is backwards (nose up shows nose down)
Settings → toggle PITCH FLIP.
Horizon slowly drifts when phone is still
Normal — G-sensor drift correction is re-levelling. Tap SET LEVEL to re-zero. If it drifts repeatedly, the gyro noise threshold may need calibrating — run a rest calibration in Settings.
Airspeed or altitude gauge is grey / missing
GPS is off. In GPS-off mode, airspeed uses the estimated cruise speed and altitude uses the cabin barometer. Tap GPS OFF in the bottom bar to confirm this mode is active. Gauges will populate with estimated data.
ALT SET gives a huge QNH number
Check the Data screen — if the raw pressure reads ~101,000 instead of ~1013, your device is returning Pascals. The app corrects this automatically from v3.79. Update the app.
ALT SET says "out of range"
The entered altitude produced a physically impossible QNH. Check you're entering plane altitude (e.g. 35000), not cabin altitude or QNH. On the ground, entering 100ft with a sea-level reading should work correctly.
Flight tracker shows 100% before takeoff
The flight timer uses baro climb detection — it starts when the cabin pressure rises by 300ft. If you see 100% on the ground, the app may have a stale epoch from a previous session. Close and reopen the route panel and re-enter times.
Turbulence always reads 0%
Run the shake calibration in Settings. Hold the phone and shake firmly for 3 seconds when prompted. This sets the sensitivity for your device's accelerometer.
Compass doesn't work
The compass requires the device magnetometer and location permission. Move away from metal (tray table, window frame) and wave the phone in a figure-8 to calibrate the magnetometer. Check permissions in Android Settings → Apps → GeekFlight.
7
Sensor Status & No-Gyro Phones
What to do if sensors are missing
CHECKING SENSOR STATUS

Open the Data screen (bottom bar → DATA). Scroll to the sensor diagnostic section. Each sensor shows ✅ working or ❌ missing. This is the first place to look when something isn't working.

NO GYROSCOPE — WHAT HAPPENS

Some budget phones have no gyroscope hardware. Without a gyro, GeekFlight falls back to G-sensor mode for bank and pitch — using the accelerometer alone. This works at level cruise but cannot track attitude through manoeuvres (the G-sensor sees the same acceleration as gravity during turns). Turbulence measurement and route tracking still work fully.

✗ No attitude tracking through turns ✓ Turbulence still works ✓ Route tracking still works ✓ Altitude still works
NO BAROMETER — WHAT HAPPENS

Without a barometer, cabin altitude, plane altitude, and baro-based takeoff detection are unavailable. The grey ALT gauge indicates no baro. Flight progress tracking will use scheduled times from your route instead of baro climb detection. GPS altitude (if available) is shown separately.

GYRO CALIBRATION — WHEN TO DO IT

Once per device, or if the attitude readings feel consistently off by the same amount. In Settings, run each axis (SPIN, ROLL, FLIP) by doing one slow 360° rotation and tapping DONE. The calibration scale factor is saved permanently. You do not need to redo this every flight.

Tip: if the 3D plane on the Gyro screen drifts slowly when the phone is still, this is normal G-correction behaviour, not a broken gyro. A broken gyro means the plane does not move at all when you rotate the phone.

Quick Reference
SET LEVEL — zeroes gyro attitude only
ALT SET — enter plane ft from seatback
AXES SWAP — fixes roll/pitch swap
BANK FLIP — fixes reversed bank
PITCH FLIP — fixes reversed pitch
GPS OFF — switches to baro/estimated mode
QNH — reference pressure (hPa)
DATA screen — sensor diagnostics