- System Requirements
- Download the installer
- Run the installer
- Initial Configuration
- Legal Wizard
- Data Loading Wizard
- Copy Models Wizard
- Copy Settings Wizard
- Simulator Wizard
- First Model Set Wizard
- Install XSwiftBus
- Install FSX/P3D terrain probe
- Configure Hotkeys Wizard
- Run swift
- Advanced Topics
This section will guide you through the process to download, install and setup swift for the first time.
First check the System Requirements whether it matches your machine.
There are multiple release channels and you can select the one that fits most your needs.
|Release Channel||Description||Changelog||Download Link|
|Alpha||This is the bleeding edge development content. Use at your own risk.||status||Download alpha versions from datastore|
|Beta||More stable than alpha and mainly for testing of new features. Not recommended for production use.||N/A||Not yet available|
|Stable||Stable and tested content. Recommended for production use.||N/A||Not yet available|
The installer is pretty self-explanatory. It allows you to select the installation path, required and optional components and will allow you to launch swift initial configuration afterwards.
It is generally recommended to install swift into a versioned folder. This allows keeping several versions in parallel (one for testing, one for production for example). All installed and downloaded files are directory based and isolated for each version.
Find below the platform specific notes to run the installer
After downloading, double-click on the downloaded installer to start the installation.
You might see a warning (you need to ignore) when you start the installer. We have no official MS certification.
After downloading, mount the disk image and double-click on the contained installer to start the installation.
After downloading, modify the installer to be executable
chmod +x swiftinstaller-linux-64-<version>.run
and double-click on it in your favorite file browser or run it from console
Problems? Then see Troubleshooting installation and 1st start
After the installation completed, swiftlauncher will launch together with the initial configuration wizard. If you un-selected to launch swift from the installer, it is possible to run the same init mode any time later by using the command line arguments
swiftlauncher -i --bootstrapurl https://datastore.swift-project.org/shared/
The rest of the section will guide you through the different wizards.
The first wizard page deals with the necessary legal bits. It will explain in detail all the licenses involved in the swift project including 3rd party software. It also provides links to data protection policies. It is necessary to accept license and data protection policy to proceed.
This page also asks for your agreement to submit crash reports to our crash report collection server. In case any swift application crashed, a crash report will be generated with information which line of code caused it to abort. With your agreement, the report will be uploaded to our server and helps the developers to diagnose and fix the cause. This agreement can be changed anytime later in the advanced settings (link tbd).
Read more about crash reports (link tbd) and how they look like.
The next wizard will download all data, required by swift to be fully functional. This includes aircraft and airline ICAO data, model strings (no models itself), etc.
It is not necessary to click any of the load buttons. The download will start automatically from randomly one of the shared mirror servers in the background. The button can be used to reload in case there was an update meanwhile.
You can either wait for the download to finish (several seconds depending on your internet bandwidth) or continue, since it will continue in the background. The wizard indicates that all data finished loading by
- The two DB LEDs flashing yellow
- All other LEDs off (idle mode).
- The number of entries and the timestamp of the local cache are equal to the shared cache.
If you had a previous version of swift installed already, then this wizard will help you to migrate your existing model cache and model set.
- Select the older version you want to migrate from the list.
- Select whether you want to migrate the model set and/or model cache and for which simulators.
- Click Start.
Read more about the meaning of model set (link tbd) and model cache (link tbd).
If you had a previous version of swift installed already, then this wizard will help you to migrate your settings.
- Select the older version you want to migrate from the list.
- Select which settings needs migrating
- Grey X means that no user setting is available and the default is in use.
- Click copy
Read more about settings (link tbd).
This page allows you to configure which simulators you want swift to work with. If you have multiple simulators installed and use them regularly, select all of those in the first group box. swift will detect if any of those configured simulators is running and connect to it. It will ignore the ones that have not been selected.
In the group box below, you are able to configure the simulator path and any additional model directories. swift will try to detect as much as possible automatically and use it as default. The default is listed in light grey.
In order to configure the directories, first select the respective simulator from the radio boxes at the bottom
- Use the ... button to select/add more directories
- Use the adjust button to remove redundant directories, fix file path etc.
- Click Save
This wizard will help you to create a first model set for each of your simulators in use. A model set is a subset of the AI models installed on your machine, which are considered for model mapping and model matching. Without any model set, swift will not run properly.
- Select your simulator (repeat the steps below if you are using multiple simulators).
- Check the model directory and change it if necessary.
- Reload the installed AI models if necessary. This is necessary in case the number of models does not look correct to you or if you made any changes to model directories in this or the previous wizard.
- Optionally display and inspect the model list
- Click on Create to create a model set.
- Save the model set.
- Close the dialog
swift - in contrast to other X-Plane clients - is running outside of the X-Plane process. In order to communicate with the X-Plane process and render AI aircraft, a small plugin called XSwiftBus is necessary. It needs to be installed into X-Plane/Resources/plugins. This wizard will download and install it for you.
- Confirm the install directory is correct or change it as necessary.
- Check and correct the temporary download folder.
- Choose a version to install (it is strongly recommended to use the same version as swift itself).
- Click on download.
- Answer Ok in the dialog to extract and install the package directly into X-Plane.
- In case 7z is not available on your machine (Mac OS users!), you will receive an error message and will have to extract it yourself.
- It is recommended to keep the default for the connection settings.
Read more about Installing and updating XSwiftBus
We use a terrain probe object to query simulator data around the AI aircraft. We recommend you install that probe when you are using the 32bit driver versions for FSX/P3D.
Further details can be found here: Installation of the FSX/P3D terrain probe
The last wizard allows you to configure hotkeys. Use this to configure your PTT key.
Your swift suite is now configured and ready to go. Use the launcher to launch the different swift applications in different flavors and modes. For first time users, it is recommended to start swift in standalone mode.
- In the core tab, select Core Mode Standalone
- Click on the blue swift icon named GUI to start swift in standalone mode.
Congratulations, swift is now running on your machine and you are ready to setup everything else for your first connection to the network.
Something didn't work? Check our Troubleshooting page or ask for help in the usual channels.
- You can just install a new version overriding the old. Some people have reported problems with that, in such a case just delete or uninstall swift.
- We recommend you to keep updates of your model set, as creating a model set is the most time consuming job
- swift knows settings and caches (data files, e.g. for downloaded data). You can copy those from other swift versions after installation. See Copy swift data from other versions
- You can install as many swift versions in parallel as you like. swift is a directory based installation, no registry entries or such.
- Each installation has its own settings and cache files (and hence is isolated).
- From the wizard you can copy settings / caches from one swift version to another swift version (if you like)
- You can always open your directories from the main menu
- Windows: normally C:\Users\<username>\AppData\Local\org.swift-project