Skip to main content

Adds a pythonic wrapper for SimConnect SDK.

Project description

PyPI version

Python-SimConnect

Python interface for Microsoft Flight Simulator 2020 (MSFS2020) using SimConnect

This library allows Python scripts to read and set variables within MSFS2020 and trigger events within the simulation.

It also includes, as an example, "Cockpit Companion", a flask mini http server which runs locally. It provides a web UI with a moving map and simulation variables. It also provides simulation data in JSON format in response to REST API requests.

Full documentation for this example can be found at https://msfs2020.cc and it is included in a standalone repo here on Github as MSFS2020-cockpit-companion.

Python interface example

from SimConnect import *

# Create SimConnect link
sm = SimConnect()
aq = AircraftRequests(sm)
ae = AircraftEvents(sm)

# Get the aircraft's current altitude
altitude = aq.get("PLANE_ALTITUDE")
altitude = altitude + 1000

# Set the aircraft's current altitude
aq.set("PLANE_ALTITUDE", altitude)

# Trigger a simple event
event_to_trigger = ae.find("AP_MASTER")  # Toggles autopilot on or off
event_to_trigger()

# Trigger an event while passing a variable
target_altitude = 15000
event_to_trigger = ae.find("AP_ALT_VAR_SET_ENGLISH")  # Sets AP autopilot hold level
event_to_trigger(target_altitude)

HTTP interface example

Run glass_server.py using Python 3.

http://localhost:5000

Method: GET

Variables: None

Output: Web interface with moving map and aircraft information

http://localhost:5000/dataset/<dataset_name>

Method: GET

Arguments to pass:

Argument Location Description
dataset_name in path can be navigation, airspeed compass, vertical_speed, fuel, flaps, throttle, gear, trim, autopilot, cabin

Description: Returns set of variables from simulator in JSON format

http://localhost:5000/datapoint/<datapoint_name>/get

Method: GET

Arguments to pass:

Argument Location Description
datapoint_name in path any variable name from MS SimConnect documentation

Description: Returns individual variable from simulator in JSON format

http://localhost:5000/datapoint/<datapoint_name>/set

Method: POST

Arguments to pass:

Argument Location Description
datapoint_name in path any variable name from MS SimConnect documentation
index (optional) form or json the relevant index if required (eg engine number) - if not passed defaults to None
value_to_use (optional) value to set variable to - if not passed defaults to 0

Description: Sets datapoint in the simulator

http://localhost:5000/event/<event_name>/trigger

Method: POST

Arguments to pass:

Argument Location Description
event_name in path any event name from MS SimConnect documentation
value_to_use (optional) value to pass to the event

Description: Triggers an event in the simulator

Events and Variables

Below are links to the Microsoft documentation

Event IDs

Simulation Variables

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

SimConnect-0.4.8.tar.gz (58.1 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

SimConnect-0.4.8-py2.py3-none-any.whl (82.0 kB view details)

Uploaded Python 2Python 3

File details

Details for the file SimConnect-0.4.8.tar.gz.

File metadata

  • Download URL: SimConnect-0.4.8.tar.gz
  • Upload date:
  • Size: 58.1 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.2.0 pkginfo/1.5.0.1 requests/2.24.0 setuptools/50.3.0 requests-toolbelt/0.9.1 tqdm/4.49.0 CPython/3.8.5

File hashes

Hashes for SimConnect-0.4.8.tar.gz
Algorithm Hash digest
SHA256 558fd59498ca57a04f75c3e03194aae8d593bcf35b36ad846b9ccf4270530b57
MD5 e0f928965e3ae396fb63919f57f4d36d
BLAKE2b-256 9c3b9b6195e2fa0c57a0aa4d16790ab75d438c419e2b4c6e09edbaf76a4b30ea

See more details on using hashes here.

File details

Details for the file SimConnect-0.4.8-py2.py3-none-any.whl.

File metadata

  • Download URL: SimConnect-0.4.8-py2.py3-none-any.whl
  • Upload date:
  • Size: 82.0 kB
  • Tags: Python 2, Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.2.0 pkginfo/1.5.0.1 requests/2.24.0 setuptools/50.3.0 requests-toolbelt/0.9.1 tqdm/4.49.0 CPython/3.8.5

File hashes

Hashes for SimConnect-0.4.8-py2.py3-none-any.whl
Algorithm Hash digest
SHA256 5087411487dce8fe5a9d847cb63063418ff27324cfa7a46a60589a51c6678c9c
MD5 22768b31f61d9bebb1511bdc63a77a8f
BLAKE2b-256 38c10460b8290068b16e4071d2339e902cbf31703d41dddcf3124404104202fd

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page