Documentation en version bêta. Certains textes et images seront retravaillés au fur et à mesure que l'application s'installera dans la version 1.0. Si une section est obsolète, signalez-la via le formulaire de commentaires.

Installer FFB-Bridge

FFB-Bridge est livré sous la forme d'un programme d'installation Windows autonome et d'une AppImage Linux. Les deux regroupent le runtime .NET 10. Il n'y a pas de pilote à télécharger ; votre SideWinder Force Feedback 2 fonctionne déjà au niveau HID sur n'importe quel noyau Windows ou Linux moderne.

Avant de commencer

Vous aurez besoin de :

  • A Microsoft SideWinder Force Feedback 2 joystick (USB VID 045E, PID 001B). The bridge is currently hardcoded to this specific stick.
  • Un simulateur pris en charge : Microsoft Flight Simulator 2024, X-Plane 11 ou X-Plane 12. MSFS 2020 n'a pas été testé. DCS, Prepar3D et les simulateurs de vol antérieurs ne sont pas pris en charge.
  • Windows 10 (version 1809 or newer) or any modern Linux distribution with evdev — which is essentially every mainstream desktop distro.

Fenêtres Installateur

Télécharger

Après vous être inscrit sur le page d'accueil, we email you a tokenised download link. Click the Windows installer link to save FfbBridge-Setup-x64.exe (about 34 MB).

Exécutez le programme d'installation

Double-cliquez sur le programme d'installation. Vous verrez une ou deux invites :

  1. SmartScreen « Application non reconnue ». Le programme d'installation n'est pas encore signé par code - la signature est sur la feuille de route 1.0. Cliquez Plus d'informations, alors Courez quand même.
  2. Assistant de configuration Inno Setup. Cliquez Suivant 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 bloque complètement les applications non signées

Si vous êtes sous Windows 11 avec Contrôle intelligent des applications (SAC) activé en mode actif, le programme d'installation ne se lance tout simplement pas : pas d'invite SmartScreen, pas d'option « Exécuter quand même », rien ne se passe. SAC refuse toute application sans signature de signature de code fiable, et les versions bêta ne sont pas encore signées.

La seule façon de contourner ce problème aujourd’hui est de désactiver Smart App Control suffisamment longtemps pour l’installer. Les propres conseils de Microsoft couvrent le flux (y compris comment le basculer via Paramètres → Confidentialité et sécurité → Sécurité Windows → Contrôle des applications et du navigateur → Paramètres de Smart App Control):

Microsoft : Questions fréquemment posées sur le contrôle intelligent des applications

Bonne nouvelle par rapport aux premiers Windows 11 : les mises à jour cumulatives récentes vous permettent de réactiver SAC à partir de l'application de sécurité Windows une fois l'installation terminée. Microsoft exigeait auparavant une réinstallation complète de Windows, mais cette restriction a disparu. L'application FFB-Bridge elle-même continuera à fonctionner normalement après le redémarrage de SAC ; SAC vérifie uniquement au lancement les applications qu'il n'a jamais vues auparavant.

Les installateurs signés par code figurent sur la feuille de route 1.0 et supprimeront entièrement cette étape.

Lancement

Un raccourci du menu Démarrer nommé FFB-Bridge lands in the FFB-Bridge program group. You can also launch directly from %LOCALAPPDATA%\Programs\FfbBridge\FfbBridge.Desktop.exe.

Attention : 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.

Désinstallation

Ouvert Applications et fonctionnalités dans les paramètres Windows, recherchez FFB-Bridge, et choisissez Désinstaller. 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

Télécharger

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

Rendez-le exécutable et installez-le

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 L'entrée apparaît dans le menu de votre application aux côtés d'autres applications GUI.

Entrée FFB-Bridge dans le lanceur d'applications KDE Plasma après l'installation
Figure 1. The installed menu entry on KDE Plasma. GNOME, Xfce, and other XDG-compatible environments pick it up identically.

règle udev (recommandée)

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 Docteur La page propose une installation en un clic de la règle udev suivante :

# /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.

Désinstallation

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.

Vérification de l'installation

Lancez FFB-Bridge. La première chose que vous devriez voir est la boîte de dialogue de bienvenue (abordé dans la section suivante). Si l'application ne démarre pas du tout ou plante au lancement, passez directement à Dépannage.