1. You must have the X-Plane 12 software installed. Follow the installation steps at this link: https://www.x-plane.com/.
2. Download the latest version of Python (big yellow button): https://www.python.org/downloads/.
3. Download the Zip file for XPPython3: https://xppython3.readthedocs.io/en/latest/usage/installation_plugin.html.
4. Download the Touch Portal for Windows application: https://www.touch-portal.com/.
5. Download the latest version of the X-Plane plugin for Touch Portal Zip file: https://github.com/coussini/XPlaneTouchPortalPlugin/releases.
- Click on the Python installer.
- Check Add Python.exe to PATH on the first page of the installer. Do not check Use admin privileges when installing py.exe.
- Click Install Now.
3. Install the Zip file (downloaded in step 3) for XPPython3 using the steps from this link.
-
Open a Windows command prompt (as administrator).
-
Type and execute the following command:
pip install update
-
Type and execute the following command:
pip install TouchPortal-API
- Double-click the installer and install with default values.
- The installer will prompt for a restart of your computer.
- After the restart, open the Touch Portal application on Windows.
- Choose Create (main).
- A small envelope icon will flash at the top right of your Touch Portal home screen.
- Click this icon and follow the steps.
- Note that at the bottom left of the home screen, you will see a small box with an IP address. We will use this in the next step.
- Leave the Touch Portal application open.
- Go to the following link: https://www.touch-portal.com/.
- Go to the bottom of the page, and you will find a link for Android or iOS devices. Click the PlayStore or AppStore button as applicable.
- Follow the steps for these devices.
- Open the Touch Portal application on your device, and when asked for an IP address, enter the IP address in the format 000.000.0.000 from the small box (without the number in parentheses representing a PORT).
- You should have two identical windows on Windows and your device.
- You now need to purchase the Pro Upgrade version.
- Other options are optional and not required to use the X-Plane plugin.
- To do this, click Settings (top right), choose Get Your Upgrades. Click Buy $$ and follow the steps.
- The multiple Devices Upgrade option has not been tested on this plugin.
- Very important: in Settings, the Restore in-app purchases option is very useful when Touch Portal behavior is not consistent with the Pro Upgrade version.
- Unzip the Zip file on your desktop (downloaded in step 5).
- At the top right of your Touch Portal Windows application, click the icon with a gear. These are the Settings.
- Click Import Icon Pack…
- Install all files from your unzipped folder that end with the .TPI extension (Be careful not to install the same file twice, as this is important!).
- At the top right of your Touch Portal Windows application, click the icon with a gear. These are the Settings.
- Click Import plug-in…
- Install the file from your unzipped folder that ends with the .TP extension (Be careful not to install the same file twice, as this is important!).
- On the home page, you will see several tabs at the top. Select Pages. To the right of the drop-down list, where (main) is written, click the icon with a gear. These are the page Settings.
- Click Import Page…
- Install all files from your unzipped folder that end with the .TPZ extension (Be careful not to install the same file twice, as this is important!).
- In the same drop-down list, you should have:
- (main)
- Cessna 172 G1000_1
- Cessna 172 G1000_2
- Choose (main) if not already selected.
- Click the Page Settings button and choose 10 x 7 as Grid Settings, zero for Grid margin, and zero for Button Spacing.
- Still on your (main) page, double-click to the right of the yellow box titled Press to get help.
- At the top right of the page that appears, click the icon just to the right of the T icon.
- Choose From Iconpacks…
- In the drop-down list (small arrow) of this dialog box, select XP TP BASE ICONS PACK if it is not displayed.
- Choose the icon with an airplane on it.
- Click Icon full button Size to get the enlarged icon image.
- In the left bar, under GENERAL and under Navigation, drag and drop (Action) Go To Page to the middle of the current page.
- In the drop-down list of what you just copied, choose the Cessna 172 G1000_1 page.
- Click the Save and Close button at the bottom of this page.
- You should see this new icon appear on your device.
- Click on it.
- What you see here is the first page serving as a user guide.
5.4). Install the dedicated server for the X-Plane Plugin for Touch Portal in the X-Plane 12 folder:
- Copy the file with the .PY extension from your unzipped folder.
- Paste this file into C:\X-Plane 12\Resources\plugins\PythonPlugins if your X-Plane 12 is installed on the C drive:
- Now, open Windows Explorer and replace the current folder path with %appdata%.
- You should be in the Roaming folder of your Windows computer.
- Scroll through the list of folders in Roaming to find TouchPortal.
- Double-click this folder.
- In the misc folder, create a folder named xplane (lowercase).
- You should have under misc the folders lightroom and xplane.
- Copy the file ending in .JSON from your unzipped folder and paste it into the directory you just created.
- In the xplane folder, you should see default.json.
- In the Windows taskbar (bottom right for Windows 10), there are applications running, such as your antivirus.
- Here, you will see the Touch Portal icon.
- Right-click and select exit.
- Restart Touch Portal on your Windows.
- Restart Touch Portal on your device.
- Click on the Cessna airplane icon.
- You are now invited to download and to read carefully the X-Plane plugin User Guide, as the installation is complete.
- You can use the page HTML Custom Dataref Json Generator to generete your JSON file correctly
-
Your JSON files must not contain these datarefs, as they are already managed internally by the plugin.
-
sim/cockpit2/gauges/actuators/barometer_setting_in_hg_pilot -> Barometer setting (pilot)
-
sim/cockpit2/gauges/actuators/barometer_setting_in_hg_copilot -> Barometer setting (co-pilot)
-
sim/cockpit2/gauges/actuators/barometer_setting_in_hg_stby -> Barometer setting (standard)
-
sim/aircraft/view/acf_descrip -> Aircraft Name Description (full name)
-