Adds a pythonic wrapper for SimConnect SDK.
Project description
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. Full documentation for this example can be found at https://msfs2020.cc.
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
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for SimConnect-0.4.2-py2.py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | f3ede03272a228b69b9003ceecab97cb2be2737dc48b2a009ab61ba3fc8c4a30 |
|
MD5 | d63f8928c752c41e1176543fa2d4d191 |
|
BLAKE2b-256 | 9cef762614adb3c3ae335b6c826731a61c0d2ee9253051f88980fdd2aee10571 |