1. Skip to content

1. Installation

1.1 TelemFFB and Antivirus Software

1.1.1 Why Antivirus Software May Flag This Application

This application is packaged using PyInstaller, a tool that bundles Python applications into standalone Windows executables. Occasionally, Windows Defender or other antivirus software may flag the generated .exe file as potentially malicious. This is a common issue across many open-source and independent software projects and does not mean the application is unsafe.

1.1.1.1 What Causes False Positives?

There are a few key reasons why antivirus software might misidentify the executable:

  1. Heuristic Scanning Security suites often use heuristic analysis to flag behaviors typical of malware (e.g., dynamic imports, compressed binaries, network or file system access). PyInstaller-packaged apps often exhibit similar patterns due to how Python and its libraries are bundled.

  2. Bundled Dependencies This app includes numerous open-source Python libraries, which are all extracted and compiled into a single executable. This results in a large and complex binary - sometimes resembling known malware in structure - especially when compression or UPX is used.

  3. Lack of Widespread Use or Code Signing Applications that are new or not widely installed are more likely to be flagged. Additionally, because this application is not signed with a commercial code signing certificate, Windows may mark it as “unrecognized” or “unknown publisher,” increasing suspicion.

  4. Frequent Builds Every build generates a slightly different binary (even without code changes), which antivirus vendors haven’t yet seen. As a result, they may temporarily flag it until it’s verified as safe by more users.

How We Ensure Safety

  • All source code is openly available and auditable.
  • Dependencies are widely used Python packages from the Python Package Index (PyPI).
  • Builds are produced in a clean environment to prevent contamination.

What You Can Do

  • Allow the app manually if it’s flagged and you trust the source.
  • Submit the executable to Microsoft or your antivirus vendor for review. This helps improve detection accuracy over time.
  • Check with VirusTotal to independently verify whether the file is flagged across multiple engines.

1.2 Installing TelemFFB

New Installations:

TelemFFB does not have an installer. It is distributed as a zip file package. Simply download the latest version from the GitHub Releases page and extract it where you want the application to reside.

The first time you install and launch TelemFFB, you will be greeted by the system settings window. Follow the guidelines in the systems setting section for setting up TelemFFB.

1.3 Running TelemFFB from Source

Most users should download the release executable from the GitHub Releases page as described above. However, developers, testers, and anyone who wants to run an unreleased branch can run TelemFFB directly from source instead.

Note

Running TelemFFB from source uses the exact same user configuration and system settings as the compiled release version. There’s no separate config to manage - changes made while running from source will carry over to the release executable, and vice versa.

1.3.1 1. Install Python

TelemFFB requires Python 3.11 or newer. Python 3.12 is recommended, as it’s the version used to compile the official release builds.

  1. Download the installer from python.org/downloads.
  2. Run the installer. On the first screen, check “Add python.exe to PATH” before clicking Install Now.

  3. Verify the installation by opening a terminal (PowerShell or Command Prompt) and running:

    python --version

    This should print Python 3.11.x or newer.

1.3.2 2. Clone the repository

If you don’t already have Git installed, download and install it from git-scm.com. The default options in the installer are appropriate for most users.

Open a terminal in the folder where you want the project to live, then clone the repository:

git clone https://github.com/walmis/VPforce-TelemFFB.git
cd VPforce-TelemFFB

Note

All of the remaining steps must be run from inside the VPforce-TelemFFB folder created by the clone. If you open a new terminal window or session, make sure to cd into that folder first before continuing.

1.3.3 3. (Optional) Check out a specific branch

By default, the clone checks out the wip branch. To work with a different branch (for example, to test an in-progress feature), make sure you’re in the VPforce-TelemFFB folder, then list the available branches and check out the one you need:

git fetch
git branch -a
git checkout <branch-name>

Replace <branch-name> with the name of the branch you want to use.

1.3.4 4. Install dependencies

From the VPforce-TelemFFB folder, run:

pip install -r requirements.txt

1.3.5 5. Run TelemFFB

With dependencies installed, launch the application from the VPforce-TelemFFB folder with:

python main.py

The first time you run the program, it may prompt you to install an export script in your Saved Games\DCS folder for telemetry data collection - accept this if you intend to use TelemFFB with DCS.

1.3.6 Updating your source checkout

To pull the latest changes on your current branch:

git pull

To discard local changes and reset to the latest version of the branch:

git reset --hard origin/<branch-name>