Configuration

La configuration de l’Agent Reemo se fait via le fichier reemo.ini.

Emplacement du fichier

  • Windows Windows : C:\Program Files\Reemo\service\reemo.ini

  • Linux Linux : /opt/reemo/reemo.ini

  • macOS macOS : /Library/Application Support/Reemo/reemo.ini

Configuration minimale

Voici la configuration minimale créée après installation :

[auth]
token=<PRIVATE_KEY>

Avec un serveur de signalisation personnalisé:

[auth]
token=<PRIVATE_KEY>

[signal]
server=<SIGNAL_SERVER> # Souvent <CLIENT_NAME>-signal.cloud.reemo.io:8443

Options disponibles

Note

Après toute modification du fichier reemo.ini, il est nécessaire de redémarrer l’agent Reemo pour que les nouveaux paramètres soient pris en compte.

[auth]

Option

Description

Type

Défaut

Version minimale

token

Le jeton d’authentification utilisé pour connecter l’agent au portail Reemo. Ce jeton correspond à votre Personal Key (clé personnelle) ou Studio Key (clé d’organisation), selon le mode d’intégration choisi. Requis.

chaîne de caractères

N/A

toute version

Exemple :

[auth]
token=<PRIVATE_KEY>

[logger]

Option

Description

Type

Défaut

Version minimale

severity

Le niveau de verbosité des journaux (logs).

entier (plage 0–6)

0

toute version

Exemple :

[logger]
severity=3

[signal]

Option

Description

Type

Défaut

Version minimale

server

L’adresse du serveur de signaling.

chaîne de caractères

signal.reemo.io:443

toute version

Exemple :

[signal]
server=<SIGNAL_SERVER> # Souvent <CLIENT_NAME>-signal.cloud.reemo.io:8443

[privacy]

Option

Description

Type

Défaut

Version minimale

autoon

Active automatiquement le mode confidentialité lors de la connexion à l’appareil (masque l’écran pour l’utilisateur local).

booléen

false

Windows 1.11.0.3
macOS 2.5.1

autolock

Verrouille automatiquement l’appareil après la déconnexion d’une session distante.

booléen

false

Windows 1.11.0.3
macOS 2.5.1
Linux 2.6.0

disablewallpaper

Masque le fond d’écran pendant une session distante.

booléen

false

Windows 1.18.0.2

Exemple :

[privacy]
autoon=true
autolock=true
disablewallpaper=true

[audio]

Option

Description

Type

Défaut

Version minimale

sync

Active la synchronisation audio.

booléen

false

Windows 1.14.0.2
macOS 1.4.1
Linux 1.14.1

interval

Intervalle de capture audio en millisecondes. Des valeurs plus basses augmentent les grésillements mais réduisent la latence audio.

entier (10, 20, 40 ou 60)

20

Windows 2.3.0.0
macOS 2.4.0
Linux 2.5.0

hybrid

Bascule le périphérique audio Windows par défaut de sortie vers celui du driver de carte son virtuelle Reemo lors de la connexion à une session distante, et restaure le périphérique par défaut précédent à la déconnexion. Nécessite le driver audio Reemo (voir le driver audio Reemo) ; ignoré si le driver n’est pas installé.

booléen

false

Windows 2.4.0.11

hybridmic

Même comportement que hybrid, appliqué au périphérique audio par défaut d’entrée (microphone).

booléen

false

Windows 2.4.0.11

Exemple :

[audio]
sync=true
interval=20
hybrid=true
hybridmic=true

[video]

Option

Description

Type

Défaut

Version minimale

constantfps

Ne pas se synchroniser avec le vsync de l’écran et tenter d’atteindre la fréquence d’images cible même avec peu de mouvement sur le bureau.

booléen

false

Windows 1.18.0.2

Exemple :

[video]
constantfps=true

[capture]

Option

Description

Type

Défaut

Version minimale

app

Restreint la capture d’écran à une fenêtre d’application spécifique, identifiée par le nom de l’exécutable. Signale une erreur si l’application est introuvable, et un avertissement si elle perd le focus (ex. après Alt+F4).

chaîne de caractères

""

Windows 2.4.0.9

Exemple :

[capture]
app=clion.exe

[vmon]

Option

Description

Type

Défaut

Version minimale

hybrid

Désactive les écrans physiques pendant la session pour n’utiliser que les écrans virtuels. Restaure les écrans physiques uniquement après la déconnexion.

booléen

false

Windows 1.14.0.2
macOS 2.5.1

Exemple :

[vmon]
hybrid=true

[printer]

Option

Description

Type

Défaut

Version minimale

enabled

Autorise l’impression depuis la session distante vers une imprimante locale.

booléen

false

Windows 1.16.0.3
Linux 1.17.6

Exemple :

[printer]
enabled=true

[filetransfer]

Option

Description

Type

Défaut

Version minimale

enabled

Autorise le transfert de fichiers entre l’appareil local et distant.

booléen

false

Windows 1.19.0.2
macOS 1.10.0
Linux 1.19.0

destination

Le dossier de destination par défaut pour les fichiers transférés. Si non défini, le répertoire personnel de l’utilisateur sera utilisé.

chaîne de caractères

Windows C:\Users\<USERNAME>\Reemo\Transfer
Linux /home/<USERNAME>/Reemo/Transfer
macOS /Users/<USERNAME>/Reemo/Transfer
Windows 1.19.0.2
macOS 1.10.0
Linux 1.19.0

Exemple :

[filetransfer]
enabled=true
destination=/home/<USERNAME>/Reemo/Transfer

[support]

Option

Description

Type

Défaut

Version minimale

enabled

Active le mode support (requis lors de l’utilisation de l’application Reemo Support, permet l’accès à l’appareil par votre équipe support). Voir Reemo Support pour le fonctionnement complet.

booléen

false

Windows 1.18.0.2
macOS 1.9.0

autoaccept_nosession

Autorise automatiquement la connexion lorsqu’aucune session Windows n’est ouverte (écran de connexion, utilisateur déconnecté). Voir Approbation automatique.

booléen

false

Windows 2.4.0.2

autoaccept_locked

Étend autoaccept_nosession aux sessions ouvertes mais non affichées : poste verrouillé, ou session déconnectée par le changement rapide d’utilisateur. Couvre aussi le cas sans session : activer cette option seule suffit.

booléen

false

Windows 2.4.0.2

Exemple :

[support]
enabled=true
autoaccept_locked=true

[proxy]

Configure l’accès à internet via un proxy HTTP sortant.

Option

Description

Type

Défaut

Version minimale

enabled

Active le proxy HTTP.

booléen

false

Windows 1.16.0.0
macOS 1.6.0
Linux 1.16.0

uri

L’URI du serveur proxy. Requis si le proxy est activé.

chaîne de caractères

N/A

Windows 1.16.0.0
macOS 1.6.0
Linux 1.16.0

username

Le nom d’utilisateur pour l’authentification proxy. Requis si le proxy nécessite une authentification.

chaîne de caractères

N/A

Windows 1.16.0.0
macOS 1.6.0
Linux 1.16.0

password

Le mot de passe pour l’authentification proxy. Requis si le proxy nécessite une authentification.

chaîne de caractères

N/A

Windows 1.16.0.0
macOS 1.6.0
Linux 1.16.0

Exemple :

[proxy]
enabled=true
uri=http://proxy.example.com:8080
username=proxyuser
password=<PROXY_PASSWORD>

[udp]

Option

Description

Type

Défaut

Version minimale

portRangeBegin

Le début de la plage de ports UDP utilisée pour les connexions pair-à-pair.

entier (plage 1024–65535)

58200

toute version

portRangeEnd

La fin de la plage de ports UDP utilisée pour les connexions pair-à-pair.

entier (plage 1024–65535)

58400

toute version

Exemple :

[udp]
portRangeBegin=58200
portRangeEnd=58400

[windows]

Option

Description

Type

Défaut

Version minimale

mousekeys

Détermine si l’application active automatiquement la fonction « Touches souris » de Windows pour garantir la visibilité du curseur.

booléen

true

Windows 2.0.0.3

Sur les machines hôtes Windows sans souris physique connectée, le curseur peut disparaître par défaut. Lorsque ce paramètre est à true, l’application force l’activation des Touches souris pour empêcher ce comportement. S’il est réglé sur false, l’application n’intervient plus sur ce paramètre d’accessibilité, laissant l’état du système inchangé (si la fonction est déjà active, elle le reste).

Exemple :

[windows]
mousekeys=false

[linux]

Option

Description

Type

Défaut

Version minimale

lowpower

Ce mode réduit l’utilisation CPU de l’agent Reemo en limitant la fréquence de capture d’images à une valeur plus basse (15 fps).

booléen

false

Linux 1.17.0

xdisplay

Spécifie l’affichage X à utiliser pour la capture d’écran sur les appareils Linux. Utile lors de l’exécution de l’agent dans une session différente.

chaîne de caractères

N/A

Linux toute version

Exemple :

[linux]
lowpower=true
xdisplay=:1