FlySim

A 3D drone & fixed-wing flight simulator with real-time OpenGL rendering, realistic aerodynamics, and a Qt control panel. Supports keyboard, mouse, and the WFLY ET16S RC transmitter over USB HID.

Features

• 12 multicopter models (quad / hexa / octo): GEPRC Mark5, iFlight, TBS, Tarot 680 Pro / T18 / T960, E616P, DJI Agras T50, DJI M600 Pro, DJI F450 — each built to its real wheelbase and frame dimensions
• 3 fixed-wing aircraft: trainer, Eclipson Model A, sport plane, with a proper aerodynamic model (angle of attack, lift, drag, stall)
• Power-system builder: 12 motors, 39 propellers (3"→54", incl. 3011), 12 batteries — real-time payload capacity & endurance via actuator-disc theory
• Terrain system: flat, fractal-noise random DEM, load DEM (PNG/ASC/GeoTIFF), and satellite imagery (ESRI World Imagery), with terrain-aware collision
• Airflow visualization: particle streamlines, rotor downwash, wind arrows
• Atmosphere: temperature / pressure / humidity / CO₂ → real-time air density, viscosity, speed of sound (ideal-gas law + Sutherland's law)
• Qt control panel (flysim --qt): tabbed menu, model selection, power system, environment, and camera zoom
• Realistic physics: alternating motor spin (CW/CCW), momentum-theory hover power, per-motor thrust mixing, Verlet rope + payload
• Live RC panel (channels CH1–CH4 in PWM, RSSI signal strength)
• CFD airflow analysis (flysim --cfd): Lattice Boltzmann Method solver, 3D drone model, horizontal/vertical planes, streamlines, velocity/vorticity visualization, adjustable precision
• 10 languages: 中文 / English / 日本語 / Français / Русский / Deutsch / Español / Português / Italiano / 한국어 (switchable in-menu, all UI + HUD)

Install

pip install flysim

Or from source:

git clone https://github.com/CodeOfMe/FlySim.git
cd FlySim
pip install -e .

Run

flysim              # pygame front-end
flysim --qt         # PySide6 front-end with control panel
flysim --cfd        # CFD airflow analysis window (LBM solver)
# or
python -m flysim

flysim --qt also opens the CFD window via File → Open CFD Analysis.

Language

Change language at runtime from the Language menu in the Qt front-end. Supports 10 languages; the HUD and control panel update instantly.

Requirements

• Python >= 3.10
• pygame >= 2.4, PyOpenGL >= 3.1.7, numpy >= 1.24
• trimesh >= 4.0, pygltflib >= 1.0
• PySide6 (optional, for --qt and --cfd)

Install with Qt support:

pip install flysim[qt]

Controls

Keyboard

WFLY ET16S (HID, Mode 2)

Throttle = left stick Y, Yaw = left stick X, Pitch = right stick Y, Roll = right stick X. Auto-detected via pygame joystick.

Coordinate system

• North = -Z, East = +X, Up = +Y
• yaw = 0 faces North; yaw increases clockwise (top view)

License

GPL-3.0-or-later. See LICENSE.