GeoFlight Replay

May 21, 2025 ยท View on GitHub

GeoFlight Replay can replay and capture scenario from Google Earth Studio (YAML format) in Microsoft Flight Simulator.

https://www.youtube.com/watch?v=_r16uJmW4Jw Video comparing Google Earth Studio and Microsoft Flight Simulator using GeoFlight Replay

Installation

Create a new virtual environment and run the following command through pip at the root of this folder:

pip install .

Alternatively, you can install the requirements provided in requirements.txt

Usage

Once installed, simply run:

> geoflight_replay

This will open a command-line menu, but if you prefer, you can provide a yaml scenario file directly in command line, as follows:

> geoflight_replay inputs/file.yaml`

In the command-line menu, you can capture either a single scenario file or a folder containing several scenarios.

To use the package locally, you can run python main.py at the root instead. In this case, you can change the values in the file geoflight_replay/constants.py, typically the default scenario or folder to use as input in the interactive cli.

Features

  • Load, and capture YAML scenarios in Microsoft Flight Simulator.
  • Interactive mode with a menu or script mode for direct execution
  • Add 3D objects supported in Microsoft Flight Simulator near the camera (eq plane) position
  • For example, position the camera at two predefined positions (LFBO and BIRK airport)

Getting Started

  • Start a flight

  • Launch GeoFlight Replay :

    • Interactive mode with an user menu : geoflight_replay/cli.py

      or `

    • Script mode, will launch and capture the provided scenario : python geoflight_replay/cli.py [your YAML scenario file]`. Generated pictures will be in output folder.

Known limitations

  • Only supports Microsoft Flight Simulator 2020
  • Microsoft Flight Simulator SDK doesnt allow to set directly the camera to a desired position and orientation. To bypass this limitation, GeoFlight Replay sets the position of an invisible aircraft JGT Aircraft, delivered in jgt-airplane folder), the camera being attached to the aircraft reference frame. This trick indirectly sets the camera to a desired location and orientation.
  • Microsoft Flight Simulator SDK doesnt allow to peform a screen capture or get a picture from the simulated camera. Picture are generated thanks to a Windows screen capture tool dxcam.The generated pictures therefore depend on your screen resolution. If you have a NVIDIA GeForce GPU, you can use DSR technology to bypass this limitation : https://www.nvidia.com/en-us/geforce/technologies/dsr/technology/