The hoppie-connector project is an API implementation for Jeroen Hoppenbrouwers' "Hoppie's ACARS" services for online multiplayer flight simulation. It can be used to create custom flight tracking and dispatch systems, or serve as a basis for airborne station implementations!

A pre-built package is hosted on PyPI and can be installed and updated using the pip utility:

pip install -U hoppie-connector

from hoppie_connector import HoppieConnector, HoppieError

cnx = HoppieConnector('<your callsign>', '<your logon code>')

try:
    # Send a telex message
    cnx.send_telex('<other callsign>', '<message>')

    # Fetch and print incoming messages
    messages, delay = cnx.peek()
    for m_id, msg in messages: 
        print(f"Message {m_id}: {msg}")
except HoppieError as e:
    print(e)

A more comprehensive documentation is currently in development on this project's GitHub Wiki.

Great thanks to Jeroen Hoppenbrouwers for creating and maintaining the "Hoppie's ACARS" services.

The contents of this repository are licensed under the MIT License. The full license text is provided in the LICENSE file.

SPDX-License-Identifier: MIT