Installer le plugin Stream Deck Pushrod

Pilote Pushrod Overlay pour iRacing depuis un Stream Deck Elgato — bascule les fenêtres d'overlay, tape tes messages radio, arme le service au stand et ouvre les Black Box sans lâcher le volant.

Gratuit pour tous — tous les niveaux

Aucun déblocage payant : le plugin Stream Deck est inclus à chaque niveau de licence.

Prérequis

Élément	Version / détail
Plugin Stream Deck Pushrod	v1.0.0 (ce téléchargement). Les versions antérieures à 0.1.5 ne démarraient pas.
Pushrod Overlay	0.1.62 ou plus récent — c'est la version qui embarque le Control API. Sans elle, aucune touche ne fait rien.
Application Stream Deck	6.5 ou plus récent (Elgato / Corsair).
Système d'exploitation	Windows 10 ou 11 (64-bit).
iRacing	Installé et lancé au moins une fois (pour que `app.ini` existe).

Le Control API est embarqué dans Pushrod Overlay et écoute en loopback uniquement (127.0.0.1). Rien n'est exposé sur ton réseau et le plugin ne contacte jamais nos serveurs.

Étapes d'installation

1.Installer et lancer Pushrod Overlay

Installe (ou mets à jour vers) la version de Pushrod Overlay qui embarque le Control API et lance-la une fois. Au premier démarrage, l'overlay :

démarre automatiquement le Control API sur le port 8721 (loopback),
génère et écrit automatiquement un token d'authentification dans un fichier de découverte partagé, pour que le plugin trouve l'API avec zéro configuration :

%APPDATA%\Pushrod\control-token

(JSON : { "version": 1, "token": "…", "port": 8721 }.) Laisse l'overlay ouvert dès que tu veux utiliser le deck.

2.Installer le plugin

Télécharge com.pushrod.overlay.streamDeckPlugin depuis ce lien et double-clique dessus. L'application Stream Deck l'installe automatiquement et les actions Pushrod apparaissent dans ta liste d'actions.

3.Importer un profil

Le plugin fournit des profils prêts à l'emploi dans son dossier /profiles :

MK.2 — 5×3, quatre pages : Fenêtres · Radio · Stands · Black Box.
XL — 8×4, quatre pages : Course (fenêtres, lancement, messages radio) · Config (réglages, verrou, lancement) · Stands · Black Box.

Dans l'application Stream Deck : Profils ▾ → Importer…, puis choisis le profil correspondant à ton matériel. Tu peux aussi construire le tien à partir des actions individuelles.

4.Vérifier que le token est détecté automatiquement

Ouvre l'inspecteur de n'importe quelle touche Pushrod. Il doit afficher Connecté. Le plugin a déjà lu le token et le port depuis %APPDATA%\Pushrod\control-token — aucun copier-coller nécessaire. Si les touches sont grisées, voir Dépannage ci-dessous.

5.Touches radio : rien à configurer

Les touches radio tapent leur message dans le chat d'iRacing — ouvrir le chat, taper, Entrée — il n'y a donc aucune configuration de macros app.ini à lancer. Chaque touche porte son propre texte, son libellé, sa taille et sa couleur ; les profils prêts à l'emploi viennent avec douze messages.

iRacing doit avoir le focus quand tu appuies : le message part vers la fenêtre au premier plan.

La touche ouvre le chat avec T, la touche par défaut d'iRacing. Si tu as lié le chat à une autre touche, indique-la dans l'inspecteur de la touche radio ; si les premiers caractères sont coupés, augmente le délai de la touche au même endroit.

Note : rien n'est écrit dans app.ini — tes macros de chat iRacing restent les tiennes.

6.Rouler

Lance iRacing et monte dans la voiture. Quand la télémétrie est active, l'indicateur Connecté du deck est vert et les LED reflètent l'overlay en temps réel (appui touche → changement d'overlay en < 100 ms en local).

Dépannage

Les touches sont grisées (avec un point orange)

Le plugin n'arrive pas à joindre le Control API.

Overlay non lancé — démarre Pushrod Overlay ; l'API n'existe que tant que l'overlay est ouvert. (La touche Lancer reste active précisément pour pouvoir démarrer l'app depuis le deck.)
Token différent — si tu réinitialises le token (Overlay → Réglages → Réinitialiser le token de contrôle), le fichier %APPDATA%\Pushrod\control-token est réécrit ; le plugin le relit automatiquement. Redémarre l'application Stream Deck s'il ne se rafraîchit pas.
connected: false mais les touches marchent — c'est le lien télémétrie, pas l'API : l'overlay tourne mais iRacing n'envoie pas encore de données. Entre dans une session.

Conflit de port

Le port par défaut est 8721. S'il est occupé, l'overlay balaie automatiquement 8721 → 8729 et écrit le port choisi dans control-token. Le plugin lit le port depuis ce fichier, donc aucun changement manuel n'est nécessaire. Tu peux aussi fixer un port via la clé de config controlApi.port de l'overlay.

Les touches radio ne font rien

Une touche radio tape dans la fenêtre qui a le focus.

Clique dans iRacing avant d'appuyer — sinon le texte part dans une autre fenêtre.
Touche de chat — si le chat d'iRacing n'est pas sur T, indique ta touche dans l'inspecteur de la touche radio. Premiers caractères manquants ? Augmente le délai de la touche.
iRacing lancé en administrateur — Windows bloque les frappes envoyées à une fenêtre qui a plus de droits ; lance aussi l'application Stream Deck en administrateur.

Désinstaller

Clic droit sur n'importe quelle action Pushrod dans l'application Stream Deck et choisis Désinstaller, ou retire-la depuis Stream Deck ▸ Préférences ▸ Plugins. Si une version antérieure t'a fait lancer la configuration des macros radio, ses sauvegardes app.ini (app.ini.pushrod-backup-<n>) sont toujours à côté d'app.ini, si tu veux retrouver tes macros de chat d'origine.