Skip to main content

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)

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
# or
python -m flysim

Requirements

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

Controls

Keyboard

Action Keys
Throttle up / down W / S
Yaw left / right A / D
Pitch forward / back Up / Down
Roll left / right Left / Right
Toggle airflow V
Toggle fixed-wing / multicopter F
Cycle drone model ` (backtick)
Toggle payload G
Pause P
Reset R
Orbit camera Mouse drag
Zoom Mouse wheel
Quit ESC

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.

Metadata

Release files for flysim 1.2.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for flysim 1.2.0
File Size Uploaded Provenance
flysim-1.2.0.tar.gz 1.5 MB Without provenance Details

Built distribution (wheel)

Table of built distributions (wheels) for flysim 1.2.0
File Interpreter ABI Platform
flysim-1.2.0-py3-none-any.whl Python 3 none any Details

Total release size: 3.1 MB

Release files / flysim-1.2.0.tar.gz

Download URL flysim-1.2.0.tar.gz
Size 1.5 MB
Tags Source
SHA-256 checksum
How to use checksums
5cf15506d39350bb617af55fa8603389ae718081d74ed1499e6341b4dae1bc7d
BLAKE2b-256 checksum
How to use checksums
cd05eb12cf4b3ae1a5ee7da0f80a88d60676538542816cec4b0d7cc2ead34e7d
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.12.12

Release files / flysim-1.2.0-py3-none-any.whl

Download URL flysim-1.2.0-py3-none-any.whl
Size 1.5 MB
Tags Python 3
SHA-256 checksum
How to use checksums
0801f976dfeb90dd41533ffc233fb629ff640cebbf05568e7f5ba7f1760ba70f
BLAKE2b-256 checksum
How to use checksums
f5b4295e048e565edf0da1a8e3201cd5738a352e93c3f21da92a893ff7f67d7f
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.12.12

Security for flysim 1.2.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page