Drivers additionnels¶
Des drivers additionnels peuvent être installés pour permettre des fonctionnalités supplémentaires de l’Agent Reemo.
- Sur Windows, des drivers additionnels peuvent être installés pour permettre:
Micro & Carte son virtuelle
Reemo fournit un driver de carte son virtuelle qui active la redirection du microphone sur votre ordinateur distant. Ce driver doit être installé sur l’ordinateur distant pour utiliser la redirection du microphone avec Reemo, indépendamment de la présence d’une carte son physique. Ce driver fournit également une carte son virtuelle pour la sortie audio sur les ordinateurs headless (machines sans carte son physique). Une fois installé, vous pourrez enregistrer l’audio distant via Reemo ainsi que transmettre votre microphone.
Ce driver est également nécessaire pour utiliser les options de configuration de l’agent hybrid et hybridmic, qui basculent automatiquement le périphérique audio par défaut de Windows pendant une session distante.
Pour installer le driver manuellement :
md "C:\Program Files\Reemo\drivers"
powershell Invoke-WebRequest 'https://downloads.reemo.io/drivers/reemaudio_v2.zip' -OutFile 'C:\Program Files\Reemo\drivers\reemaudio.zip'
powershell Expand-Archive -LiteralPath 'C:\Program Files\Reemo\drivers\reemaudio.zip' -DestinationPath 'C:\Program Files\Reemo\drivers\'
"C:\Program Files\Reemo\drivers\reemaudio\devcon.exe" install "C:\Program Files\Reemo\drivers\reemaudio\reemaudio.inf" ROOT\reemaudio
Pour désinstaller le driver :
"C:\Program Files\Reemo\drivers\reemaudio\devcon.exe" remove ROOT\reemaudio
Webcam virtuelle
Pour émuler une webcam virtuelle que Reemo peut utiliser, vous devez installer notre driver de webcam virtuelle. Une fois installé, la webcam virtuelle apparaîtra dans le gestionnaire de périphériques de votre ordinateur distant.
Pour installer le driver :
md "C:\Program Files\Reemo\drivers"
powershell Invoke-WebRequest 'https://downloads.reemo.io/drivers/reecam.zip' -OutFile 'C:\Program Files\Reemo\drivers\reecam.zip'
powershell Expand-Archive -LiteralPath 'C:\Program Files\Reemo\drivers\reecam.zip' -DestinationPath 'C:\Program Files\Reemo\drivers\'
"C:\Program Files\Reemo\drivers\reecam\devcon.exe" install "C:\Program Files\Reemo\drivers\reecam\reecam.inf" REECAM
Pour désinstaller le driver :
"C:\Program Files\Reemo\drivers\reecam\devcon.exe" remove REECAM
Redirection USB
Si vous avez besoin de transférer des périphériques USB, Reemo fournit un driver USB virtuel — inclus par défaut dans l’installateur de l’Agent Reemo. Disponible sur Windows, Linux et macOS, la fonctionnalité de transfert USB nécessite Reemo pour Windows version 1.13.0.1 et supérieure, Reemo pour Linux version 2.3.1 et supérieure, et Reemo pour macOS version 2.6.0 et supérieure (macOS 10.15 ou version ultérieure).
Note
La redirection USB Reemo est conçue pour les périphériques HID (tablettes graphiques, télécommandes, clés cryptographiques, etc.). Les périphériques audio et vidéo ne sont pas pris en charge pour la redirection USB en raison des exigences de performance en temps réel.
Si vous souhaitez toujours l’installer séparément, vous pouvez suivre cet exemple :
md "C:\Program Files\Reemo\drivers"
powershell Invoke-WebRequest 'https://downloads.reemo.io/drivers/reemousb.zip' -OutFile 'C:\Program Files\Reemo\drivers\reemousb.zip'
powershell Expand-Archive -LiteralPath 'C:\Program Files\Reemo\drivers\reemousb.zip' -DestinationPath 'C:\Program Files\Reemo\drivers\'
"C:\Program Files\Reemo\drivers\reemousb\devcon.exe" install "C:\Program Files\Reemo\drivers\reemousb\reemousb.inf" ROOT\ReemUSB
Pour désinstaller le driver :
"C:\Program Files\Reemo\drivers\reemousb\devcon.exe" remove ROOT\ReemUSB
Pour transférer des périphériques USB locaux, votre ordinateur local doit aussi exécuter le Compagnon USB — voir Compagnon USB dans le panneau Paramètres pour les liens de téléchargement.
Écrans virtuels
Si vous voulez utiliser Reemo sur un ordinateur « headless » (sans écran), Reemo fournit un driver de moniteur virtuel. Sous Windows, ce driver doit être installé sur l’ordinateur distant pour émuler jusqu’à 5 moniteurs. Une fois installé, vous verrez un nouveau moniteur sur votre ordinateur distant et pourrez en ajouter d’autres dynamiquement depuis le menu du client web.
Note
Pour installer le driver manuellement :
md "C:\Program Files\Reemo\drivers"
powershell Invoke-WebRequest 'https://downloads.reemo.io/drivers/reemon.zip' -OutFile 'C:\Program Files\Reemo\drivers\reemon.zip'
powershell Expand-Archive -LiteralPath 'C:\Program Files\Reemo\drivers\reemon.zip' -DestinationPath 'C:\Program Files\Reemo\drivers\'
"C:\Program Files\Reemo\drivers\reemon\devcon.exe" install "C:\Program Files\Reemo\drivers\reemon\reemon.inf" Root\reemon
Pour désinstaller le driver :
"C:\Program Files\Reemo\drivers\reemon\devcon.exe" remove Root\reemon
Manettes de jeux
Si vous souhaitez utiliser des manettes de jeux avec Reemo, vous devez installer le driver ViGEmBus sur l’ordinateur distant. Vous pouvez télécharger le driver ici : https://github.com/ViGEm/ViGEmBus/releases
Note
Les manettes de jeux sont désormais également prises en charge nativement via le driver USB Reemo (voir Redirection USB), ce qui est la solution recommandée : meilleure latence et prise en charge de fonctionnalités avancées (Adaptive Triggers et Trackpad sur la DualSense, par exemple). ViGEmBus reste recommandé uniquement pour une utilisation en Bluetooth.
Pour désinstaller le driver :
Désinstallez le driver ViGEmBus en utilisant les Paramètres Windows : allez à Paramètres > Applications > Applications et fonctionnalités, trouvez ViGEmBus dans la liste, et cliquez sur Désinstaller.
Note
- Sous Linux, des composants supplémentaires peuvent être installés pour activer :
Écrans virtuels
Sur une carte Intel ou AMD, les écrans virtuels fonctionnent sans installation supplémentaire. Reemo active une sortie vidéo qu’aucun écran physique n’occupe : le nombre d’écrans virtuels que vous pouvez ajouter est donc limité aux sorties que votre carte graphique laisse libres.
Sur une carte NVIDIA avec le pilote propriétaire, une sortie libre est inutilisable : l’environnement de bureau la traite comme une sortie PRIME secondaire et la bride à 640x480. Reemo exige donc le module noyau EVDI sur ces machines, et désactive les écrans virtuels lorsqu’il est absent. EVDI fournit 5 écrans virtuels. Vous pouvez aussi l’installer sur une carte Intel ou AMD, où ces 5 écrans s’ajoutent aux sorties libres.
Pour installer EVDI sur l’ordinateur distant :
# Base Debian (Ubuntu, Debian, etc.)
curl -sL -o /tmp/reemo_evdi.x 'https://download.reemo.io/linux/deb/setup_evdi.x'
sudo bash /tmp/reemo_evdi.x
# Base RHEL (Rocky Linux, Fedora, etc.)
curl -sL -o /tmp/reemo_evdi.x 'https://download.reemo.io/linux/rpm/setup_evdi.x'
sudo bash /tmp/reemo_evdi.x
Le script compile EVDI pour votre noyau courant via DKMS. Redémarrez la machine à la fin de l’installation : les écrans virtuels ne sont disponibles qu’après ce redémarrage.
Note
virtual_monitors = false dans la section [linux] de reemo.ini.Redirection USB
La redirection USB exige le module noyau vhci-hcd sur l’ordinateur distant. Ce module est le contrôleur USB virtuel auquel se rattache le périphérique redirigé, comme s’il avait été branché sur un port physique de cet ordinateur. Sans lui, un périphérique redirigé n’atteint jamais la session distante.
Le script d’installation de l’Agent Reemo prend ce module en charge et écrit /etc/modules-load.d/vhci-hcd.conf pour qu’il soit rechargé après un redémarrage. Ce qu’il installe dépend de la distribution :
Distribution |
Ce que fait le script d’installation |
|---|---|
Ubuntu, Debian |
Installe |
Fedora |
Installe |
RHEL, Rocky Linux, AlmaLinux |
Installe |
Arch Linux |
Rien à installer : le module fait partie du noyau standard. |
Le noyau lui-même n’est jamais modifié et rien n’est compilé sur l’ordinateur distant : un module est seulement ajouté à côté du noyau en cours d’exécution. Lorsqu’aucun module n’est disponible, le script le signale et l’installation se poursuit. L’Agent fonctionne alors normalement, sans redirection USB.
Pour vérifier le résultat sur l’ordinateur distant :
lsmod | grep vhci_hcd # le module est chargé
ls /sys/devices/platform/vhci_hcd.0/ # le contrôleur virtuel existe
cat /etc/modules-load.d/vhci-hcd.conf # il sera rechargé après un redémarrage
Note
Stations Autodesk
Sur une station Autodesk (Flame, Flare, Flame Assist ou Lustre), le script d’installation reconnaît la station et n’installe pas le module. La redirection USB y reste indisponible tant que vous ne la demandez pas explicitement, pour deux raisons :
Le pilote NVIDIA de ces stations ne repose pas sur DKMS. Il est compilé pour un noyau précis et ne se reconstruit pas tout seul : toute modification du noyau casse le pilote graphique. Le script d’installation laisse donc intact le noyau géré par Autodesk.
Le chargement de
vhci-hcdmarque le noyau comme tainted. Ce drapeau enregistre seulement qu’un module compilé en dehors du noyau officiel a été chargé. Il ne change aucun comportement et disparaît au redémarrage suivant, mais sur une station certifiée il doit rester une décision délibérée.
Pour installer le module sur une telle station, ajoutez --force-usb à la commande d’installation :
curl -sL -o /tmp/reemo.x 'https://download.reemo.io/linux/rpm/setup.x'
sudo bash /tmp/reemo.x --key <PRIVATE_KEY> --force-usb
Lorsque /opt/reemo/reemo.ini existe déjà sur la station, la clé est conservée et --key peut être omis.
Important
Sur les noyaux Enterprise Linux antérieurs à el9_7, rediriger une tablette graphique Wacom ou Cintiq fait planter l’ordinateur distant pendant l’énumération du périphérique. Le défaut se situe dans le pilote de tablette du noyau et a été corrigé en el9_7 : ces tablettes exigent donc un noyau el9_7 ou plus récent sur l’ordinateur distant. Les autres périphériques, stockage, souris, claviers et dongles, se redirigent normalement. Sur une station Flame le noyau est épinglé par la version du DKU : cela dépend donc de la publication par Autodesk d’un DKU basé sur el9_7 ou plus récent.
Sur macOS, les écrans virtuels sont pris en charge par défaut sans nécessiter d’installation de driver supplémentaire.
- Des drivers additionnels peuvent également être installés pour permettre :
Installer ou retirer les pilotes seuls
Sur un Mac où l’agent est déjà installé, les pilotes micro et webcam peuvent être installés ou retirés séparément avec un script dédié :
curl -skL -o /tmp/install_reemo_drivers.x 'https://download.reemo.io/macos/drivers/setup_drivers.x'
# Installe les deux périphériques (par défaut)
sudo bash /tmp/install_reemo_drivers.x
# Ou un seul des deux
sudo bash /tmp/install_reemo_drivers.x --microphone-driver
sudo bash /tmp/install_reemo_drivers.x --webcam-driver
# Retire les deux périphériques, ou un seul des deux
sudo bash /tmp/install_reemo_drivers.x --uninstall
sudo bash /tmp/install_reemo_drivers.x --uninstall --microphone-driver
sudo bash /tmp/install_reemo_drivers.x --uninstall --webcam-driver
Note
--uninstall.sudo) et accès Internet vers download.reemo.io requis. Aucun redémarrage du Mac n’est nécessaire. Binaires universels (Intel et Apple Silicon).Microphone
Pendant une session Reemo vers ce Mac, le microphone de l’utilisateur connecté apparaît comme le périphérique d’entrée audio « Reemo Microphone ». N’importe quelle application du Mac peut l’utiliser comme un microphone normal.
Note
Pour installer le pilote :
sudo bash /tmp/install_reemo_drivers.x --microphone-driver
L’installation du pilote redémarre brièvement le service audio du Mac (coupure audio de 1 à 2 secondes). Aucune approbation utilisateur ni redémarrage du Mac ne sont nécessaires — l’agent détecte le nouveau périphérique automatiquement.
Pour vérifier le résultat : Réglages Système > Son > Entrée doit lister « Reemo Microphone », ou exécutez system_profiler SPAudioDataType | grep Reemo dans le Terminal.
Sélectionnez « Reemo Microphone » comme périphérique d’entrée dans l’application du Mac concernée (Teams, Zoom, OBS, etc.). Le microphone n’est transmis que lorsque l’application enregistre depuis « Reemo Microphone ».
Pour désinstaller le pilote :
sudo bash /tmp/install_reemo_drivers.x --uninstall --microphone-driver
Cela retire le pilote et redémarre le service audio (même brève coupure). Aucune interaction utilisateur n’est nécessaire.
Webcam virtuelle
Pendant une session Reemo vers ce Mac, la webcam de l’utilisateur connecté devient disponible sur le Mac comme caméra « Reemo Camera ». Quand aucune vidéo n’est envoyée, la caméra affiche une image grise.
Note
Pour installer le pilote :
sudo bash /tmp/install_reemo_drivers.x --webcam-driver
L’installation du pilote ajoute « Reemo Camera.app » dans /Applications (elle embarque l’extension système caméra com.hubitech.reemo.camera.extension) et demande à macOS d’activer l’extension. macOS exige une approbation, une seule fois.
Activation de l’extension sur macOS 15 Sequoia
macOS affiche une notification proposant d’autoriser la nouvelle extension caméra.
Notification d’activation de l’extension caméra.¶
Cliquez sur Ouvrir Réglages Système, qui mène directement à Général > Ouverture et extensions > section Extensions de caméra.
Activez la bascule « Reemo Camera » — macOS demande alors le mot de passe administrateur du Mac, comme à la désinstallation.
Extension « Reemo Camera » activée.¶
Activation sur macOS 13 Ventura / 14 Sonoma
Réglages Système > Confidentialité et sécurité > section Sécurité > « Le logiciel système de l’application « Reemo Camera » a été bloqué » > Autoriser.
Important
Cette approbation est impossible en SSH : elle exige un utilisateur devant l’écran, ou un profil de gestion d’appareils mobiles (MDM, voir ci-dessous). Si personne n’est connecté au moment de l’installation, l’agent redemande l’activation à la prochaine connexion, et continue de la redemander à chaque démarrage tant qu’elle n’est pas accordée.
Pour relancer la demande d’approbation manuellement, double-cliquez sur /Applications/Reemo Camera.app.
Note
Parc géré (MDM) : pré-approuvez l’extension avec un profil de configuration SystemExtensions — Team ID UC3NDD63KG, bundle ID de l’extension com.hubitech.reemo.camera.extension. Aucune interaction utilisateur n’est alors nécessaire.
Une fois approuvée, la caméra devient disponible — aucun redémarrage de l’agent n’est nécessaire.
Pour vérifier le résultat : ouvrez Photo Booth ou FaceTime, puis vérifiez le menu Caméra pour « Reemo Camera » (tant qu’aucune vidéo n’est envoyée, l’image reste grise), ou exécutez systemextensionsctl list dans le Terminal — l’extension com.hubitech.reemo.camera.extension doit apparaître avec l’état [activated enabled].
Photo Booth avec « Reemo Camera » sélectionnée, avant l’envoi d’un flux vidéo.¶
Sélectionnez « Reemo Camera » comme caméra dans l’application du Mac concernée (Teams, Zoom, OBS, etc.). La webcam n’est transmise que lorsque l’application utilise « Reemo Camera ».
Pour désinstaller le pilote :
sudo bash /tmp/install_reemo_drivers.x --uninstall --webcam-driver
Retirer l’extension exige le mot de passe administrateur de l’utilisateur connecté (impossible en SSH seul). Une fois acceptée, l’application est supprimée de /Applications — macOS finalise parfois la suppression au redémarrage suivant. Si personne n’est connecté, ou si la demande est annulée ou échoue, « Reemo Camera.app » reste en place et la commande peut être relancée.
Audio (BlackHole)
Si vous avez une version ancienne de macOS (antérieure à Ventura), vous devrez installer un driver séparé pour capturer l’audio de votre bureau. BlackHole fournit un driver sous licence GPL que Reemo peut enregistrer.
Note
Pour installer le driver :
brew install blackhole-2ch
Ou vous pouvez télécharger l’installateur fourni ici : https://existential.audio/blackhole/