URL: https://flybefore.com/docs/
Last updated: 2026-11-15

# User guide

Last updated November 15, 2026 · Summary of the in-app guide.

- [License](#license) 

- [First flight](#first-flight) 

- [Controls](#controls) 

- [Connecting a controller](#controllers) 

- [Lessons and help levels](#learn) 

- [Workshop](#workshop) 

- [ArduPilot and QGroundControl](#ardupilot) 

- [Adding your own plane](#own-plane) 

- [Language and units](#units) 

- [Troubleshooting](#trouble) 

## 1. Your license

- Fly Before comes in one version: once you buy it, everything is open, including all planes and fields, all lessons, ArduPilot, FPV, the Workshop and your own planes and fields. To buy: [Pricing](https://flybefore.com/pricing/). 

- Until a license is entered, the app shows only the License screen: the license box, Paste license , Choose license file , Buy and the support address. 

- Enter your license: after buying you get an email with a license that starts with FB1. and a .flybefore-license file. Copy the text and press Paste license (Cmd+V works too), or paste it into the box and press Activate , or drag the file onto the window, or double-click the file. The license is stored on your Mac and works offline. Every update is free. 

- Remove the license: Settings (or the main menu), License , Remove license (press twice). The app goes back to the License screen. 

## 2. First flight

- On first launch, the "Plug in your controller" screen appears. No controller? Choose Use keyboard . 

- Make four short moves: right stick right, pull back, left stick right, throttle up. Each step advances when it sees the right movement. 

- Help: Lots is selected and the first lesson, Fly straight, starts. 

- Next time, press FLY on the main menu to start on the runway with your last plane and field. 

## 3. Controls

| Action | PS5 controller | Keyboard | 

| Aileron, elevator | Right stick | Arrow keys | 

| Rudder, throttle | Left stick, R2 | A D, W S | 

| Restart, back 5 s | Triangle, Square | R, Delete | 

| Pause | Options | Esc | 

| Camera | Touchpad | C | 

| Less, more help | L1, R1 | Q, E | 

Crash, and "Try again" appears within half a second.

## 4. Connecting a controller

- Gamepads (PS5, PS4, Xbox, Switch Pro, 8BitDo): connect by USB or Bluetooth; recognized automatically. Xbox: use Bluetooth. 8BitDo: D mode. 

- RC radios (for example EdgeTX): connect by USB and choose "USB Joystick" on the radio. Then Settings, Set up controller . 

- Settings, Connections, Controllers shows connected devices, a status light and a Test screen with a verification badge for each device. 

Details per device: [controller compatibility](https://flybefore.com/controllers/).

## 5. Lessons and help levels

Each lesson takes one to three minutes, has one goal and three stars. All are open; the suggested order is marked. Groups: Basics, Failures, VTOL, and ArduPilot (when ArduPilot is on). Help levels: Lots (levels itself, won't let you stall or dive, manages throttle), Some (levels the wings when you let go), Off (like the real plane). [All lessons](https://flybefore.com/learn/)

## 6. Workshop

In the Hangar, choose Workshop under a plane. Change motor, propeller, battery, ESC, extra weight, balance point and control throws; read Power, Flight time, Slow flight and Balance. Details opens the bench table and flight report; Bench test holds the plane in place; Fly takes it to the field; Compare and Save keep your setups. All numbers are model output. [Workshop](https://flybefore.com/workshop/)

## 7. ArduPilot and QGroundControl

- Settings, Connections, Fly with ArduPilot . Needs the free ArduPilot helper; if it is missing, the card says what to do and you fly with Fly Before's own assistance meanwhile. 

- Arm: throttle down, rudder full right, three seconds. Fixed-wing mode switch: 1 FBWA, 2 TAKEOFF, 3 AUTO, 4 RTL, 5 LOITER, 6 MANUAL. 

- Restart reloads ArduPilot in about two to three seconds. 

- Parameters you change in QGroundControl are saved after the flight and loaded next time. "Back to original settings" sets them aside. 

- Logs: "Show last log" and "Open log folder" (.BIN, for UAV Log Viewer or Mission Planner). "Delete old logs" asks twice and keeps the latest. 

- Connect QGroundControl or Mission Planner over UDP 14550, or in Comm Links add TCP, 127.0.0.1, port 5760. Tablet or phone on the same Wi-Fi: TCP to the Mac address shown on screen, port 5760. 

## 8. Adding your own plane

Hangar, Add your plane shows five steps: put the STL files in a folder, write a short settings file, line it up in the preview, convert, then check it in the sim and correct the numbers with a scale and your manual. If the model file is missing, the plane flies as a simple stand-in shape.

## 9. Language and units

Settings, Language (English, Turkish) and Units (imperial: mph, ft, oz; metric: km/h, m, g). Chosen from your Mac's settings on first launch; changes apply immediately.

## 10. Troubleshooting

**The plane keeps drifting to one side**
Pause, then Trim. On a PS5 controller, hold Create and correct with the stick.

**I can't see the plane**
An arrow at the screen edge points to it. In detailed settings keep "Show the ground" and "Drop line" on.

**Left and right feel swapped**
Normal when the plane flies toward you. A "Coming at you" hint appears; practice the Flying toward you lesson.

**ArduPilot did not start: port busy**
Another simulator may be running. Close it and try again.

**The throttle starts at half or is reversed**
If the screen says "Move the throttle once", move it to the bottom once. Still reversed? Run Set up controller again, or set Throttle, Reverse in RC axes and calibration.

**My settings disappeared**
The settings file was damaged. The app went back to defaults and kept a backup copy of the old file next to it.

Fly Before: RC Flight Simulator is a native macOS app (Apple Silicon) for flying RC planes and fixed-wing VTOLs that runs real ArduPilot in one click through the free ArduPilot Helper. One-time purchase, not on sale yet.
