Add-on for Aerowinx PSX for taxing using OpenStreetMap

This is a Java application that connects to the main server of Aerowinx PSX simulator and continuously shows aircraft's position on a map, using OpenStreetMap data and Mapsforge framework.

It is primarily intended to enable taxing around airports since PSX does not have taxiways. Of course, this is not as good as having a scenery generator, but it's much more lightweight and lighter on the hardware resources (i.e. CPU/GPU).

Running

Download the latest release .jar file from Github (from the Releases section, e.g. psxtaxi-1.0.1-b5.jar).

In order to run it, you need Java version 8 or later.

Run the application:

java -jar psxtaxi-1.0.1-b5.jar

Replace psxtaxi-1.0.1-b5.jar with the exact version of the jar file that you've downloaded.

Using

Here's a screenshot of taxing. The red circle indicates aircraft's position, the red line extending from the position circle indicates current heading, while black tip indicates tiller input. The text next to the position circle indicates speed. For technical reasons, it's IAS, not ground speed.

Known bug: Don't use Cmd+Q to quit the application on MacOS because that event is not properly handled by the application and might cause the connection to the main server to remain open.

Configuration

If the directory where you run the application (i.e. where you started that java -jar command above) contains a file called psxtaxi.properties, it will be read and used for configuring various application parameters.

Here's an example of a psxtaxi.properties file content:

showSpeed=true
initialWindowWidth=1024
initialWindowHeight=768
cutoffSpeed=60
mapTileSize=256
alwaysOnTop=true
hostname=localhost
port=10747

Parameter showSpeed can be true or false and indicates where aircraft's speed should be displayed. Parameters initialWindowWidth and initialWindowHeight specify the size (in pixels) of the window when the application opens. Parameter cutoffSpeed is the speed above which the application stops rendering the map and aircraft because it assumes that you're not taxing any more. Parameter mapTileSize is specific to Mapsforge. Try values such as 64, 128, 256, and 512 and see what works best for you. Parameter alwaysOnTop, if true, makes the application window remain on top of other windows at all times. Parameter hostname and port indicate PSX Main Server network address.

Changelog

2021-12-10
- Add alwaysOnTop property that makes the application window stay visible above other windors. Made this the default.

License

This program and the accompanying materials are made available under the terms of the Eclipse Public License 2.0 which is available at http://www.eclipse.org/legal/epl-2.0.