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.
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
- Enable Developper mode : https://docs.flightsimulator.com/html/Developer_Mode/Developer_Mode.htm
- Install Microsoft Flight Simulator SDK : https://docs.flightsimulator.com/html/Introduction/SDK_Overview.htm
- Copy jgt-airplane folder into you Microsoft Flight Simulator "Community" folder
- Select JGT Aircraft Corporation invisible aircraft :
-
Start a flight
-
Launch GeoFlight Replay :
-
Interactive mode with an user menu :
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/