Dokumentation in Beta. Einige Texte und Bilder werden überarbeitet, wenn die App auf Version 1.0 umgestellt wird. Wenn ein Abschnitt veraltet ist, kennzeichnen Sie ihn über Feedback-Formular.

FFB-Bridge installieren

FFB-Bridge wird als eigenständiges Windows-Installationsprogramm und als Linux-AppImage geliefert. Beide bündeln die .NET 10-Laufzeitumgebung. Es gibt keinen Treiber zum Herunterladen; Ihr SideWinder Force Feedback 2 funktioniert bereits auf HID-Ebene auf jedem modernen Windows- oder Linux-Kernel.

Bevor Sie beginnen

Sie benötigen:

  • A Microsoft SideWinder Force Feedback 2 joystick (USB VID 045E, PID 001B). The bridge is currently hardcoded to this specific stick.
  • Ein unterstützter Simulator: Microsoft Flight Simulator 2024, X-Plane 11 oder X-Plane 12. MSFS 2020 ist ungetestet. DCS, Prepar3D und frühere Flugsimulatoren werden nicht unterstützt.
  • Windows 10 (version 1809 or newer) or any modern Linux distribution with evdev — which is essentially every mainstream desktop distro.

Windows Installateur

Download

Nachdem Sie sich angemeldet haben Homepage, we email you a tokenised download link. Click the Windows installer link to save FfbBridge-Setup-x64.exe (about 34 MB).

Führen Sie das Installationsprogramm aus

Doppelklicken Sie auf das Installationsprogramm. Es werden ein oder zwei Eingabeaufforderungen angezeigt:

  1. SmartScreen „Unerkannte App“. Das Installationsprogramm ist noch nicht codesigniert – die Signierung steht auf der 1.0-Roadmap. Klicken Sie Weitere Informationen, dann Lauf trotzdem.
  2. Inno Setup-Setup-Assistent. Klicken Sie Als nächstes through the two pages. The default install location is %LOCALAPPDATA%\Programs\FfbBridge — a per-user install, no administrator permission required.
Windows 11 Smart App Control blockiert nicht signierte Apps vollständig

Wenn Sie Windows 11 mit verwenden Intelligente App-Steuerung (SAC) im aktiven Modus aktiviert ist, startet das Installationsprogramm einfach nicht – keine SmartScreen-Eingabeaufforderung, keine Option „Trotzdem ausführen“, es passiert einfach nichts. SAC lehnt jede App ohne vertrauenswürdige Codesignatur-Signatur ab und die Beta-Builds sind noch nicht signiert.

Die einzige Möglichkeit, dies zu umgehen, besteht heute darin, Smart App Control lange genug für die Installation auszuschalten. Microsofts eigene Anleitung deckt den Ablauf ab (einschließlich der Vorgehensweise zum Umschalten über). Einstellungen → Datenschutz und Sicherheit → Windows-Sicherheit → App- und Browsersteuerung → Smart App Control-Einstellungen):

Microsoft: Häufig gestellte Fragen zu Smart App Control

Gute Nachrichten im Vergleich zu frühem Windows 11: Mit den jüngsten kumulativen Updates können Sie SAC über die Windows-Sicherheits-App wieder aktivieren, sobald die Installation abgeschlossen ist. Früher verlangte Microsoft eine vollständige Neuinstallation von Windows, aber diese Einschränkung gibt es nicht mehr. Die FFB-Bridge-App selbst läuft normal weiter, nachdem SAC wieder aktiviert ist. SAC sucht beim Start nur nach Apps, die es zuvor noch nicht gesehen hat.

Codesignierte Installationsprogramme sind auf der 1.0-Roadmap enthalten und werden diesen Schritt vollständig entfernen.

Start

Eine Startmenü-Verknüpfung mit dem Namen FFB-Bridge lands in the FFB-Bridge program group. You can also launch directly from %LOCALAPPDATA%\Programs\FfbBridge\FfbBridge.Desktop.exe.

Achtung – Antivirus

Some antivirus products flag unsigned binaries. If yours quarantines the installer outright (rather than just warning), please email the flagged sample to feedback·ffb-bridge.com (replace the · with an @) so we can investigate.

Deinstallation

Offen Apps und Funktionen Suchen Sie in den Windows-Einstellungen nach FFB-Bridge, und wählen Sie Deinstallieren. Your profiles and preferences under %APPDATA%\ffb-bridge are left in place so a reinstall picks them up again; remove that folder by hand if you want a clean slate.

Linux AppImage

Download

Same signup flow as Windows — click the Linux link in the email and you'll get FfbBridge-x86_64.AppImage (about 40 MB).

Machen Sie es ausführbar und installieren Sie es

AppImages need the executable bit set and, on most distros, to be registered in the application menu so the desktop launcher picks them up. The included install.sh script does both; the long form is:

chmod +x FfbBridge-x86_64.AppImage
mkdir -p ~/Applications
mv FfbBridge-x86_64.AppImage ~/Applications/
~/Applications/FfbBridge-x86_64.AppImage --install

The --install flag registers a .desktop file and icon into your XDG data directories. After that, a FFB-Bridge Der Eintrag wird in Ihrem Anwendungsmenü neben anderen GUI-Apps angezeigt.

FFB-Bridge-Eintrag im KDE Plasma-Anwendungsstarter nach der Installation
Figure 1. The installed menu entry on KDE Plasma. GNOME, Xfce, and other XDG-compatible environments pick it up identically.

udev-Regel (empfohlen)

Out of the box, only the user whose login session owns the joystick can open its /dev/input/eventN node. For the bridge to keep working after a fast-user-switch, or simply to avoid polkit prompts on some distributions, the Doktor Seite bietet eine Ein-Klick-Installation der folgenden udev-Regel:

# /etc/udev/rules.d/99-ffb-bridge.rules
SUBSYSTEM=="input", ATTRS{idVendor}=="045e", ATTRS{idProduct}=="001b", TAG+="uaccess"
NixOS

NixOS reads udev rules from the system config, not /etc/udev/rules.d. Add the equivalent to your configuration.nix:

services.udev.extraRules = ''
  SUBSYSTEM=="input", ATTRS{idVendor}=="045e", ATTRS{idProduct}=="001b", TAG+="uaccess"
'';

Then sudo nixos-rebuild switch and replug the stick.

Deinstallation

Either delete ~/Applications/FfbBridge-x86_64.AppImage and run the bundled uninstaller, or run the AppImage with the --uninstall flag to reverse the menu/icon registration automatically. Profiles and preferences under ~/.config/ffb-bridge are kept for a later reinstall.

Überprüfung der Installation

Starten Sie FFB-Bridge. Das erste, was Sie sehen sollten, ist das Willkommensdialogfeld (werden im nächsten Abschnitt behandelt). Wenn die App überhaupt nicht startet oder beim Start abstürzt, springen Sie direkt zu Fehlerbehebung.