Table of Contents

Guide d'installation

Prérequis pour Exécuter à partir du Code Source

Utilisateurs macOS

PyRDPConnect nécessite XQuartz pour fonctionner correctement sur macOS. XQuartz est une version open-source du serveur X.Org X, un composant nécessaire pour exécuter des applications de bureau à distance.

Étape 1 : Installer XQuartz

  1. Visitez le site officiel de XQuartz : Page de Téléchargement XQuartz.
  2. Téléchargez et installez la dernière version de XQuartz.
  3. (Optionnel) Redémarrez votre ordinateur pour vous assurer que tous les composants nécessaires sont initialisés.

Pourquoi XQuartz ? XQuartz fournit l'environnement X11 dont FreeRDP dépend pour le rendu graphique sur macOS. Sans cela, l'application peut ne pas afficher correctement la session RDP.

Étape 2 : Installer Python et les Paquets Requis

brew install python3
pip3 install pyqt5

Étape 3 : Cloner le Dépôt et Exécuter à partir du Code Source

  1. Clonez le dépôt PyRDPConnect :
    git clone https://github.com/LaswitchTech/PyRDPConnect.git
  2. Accédez au répertoire src et exécutez l'application :
    python3 src/client.py

Utilisateurs Linux

Pour les utilisateurs de Linux, PyRDPConnect nécessite Python 3, PyQt5, et FreeRDP pour fonctionner correctement.

Étape 1 : Installer les Paquets Requis

Mettez à jour la liste des paquets et installez les paquets nécessaires :

sudo apt-get update
sudo apt-get install -y git python3 python3-pip python3-pyqt5 python3-pyqt5.qtquick python3-pyqt5.sip freerdp2-x11

Étape 2 : Cloner le Dépôt et Exécuter à partir du Code Source

  1. Clonez le dépôt PyRDPConnect :
    git clone https://github.com/LaswitchTech/PyRDPConnect.git
  2. Accédez au répertoire src et exécutez l'application :
    python3 src/client.py

Exécuter l'Application Précompilée

Utilisateurs macOS

PyRDPConnect est disponible en tant qu'application macOS précompilée (.app). Avant d'utiliser l'application, vous devez installer XQuartz.

Étape 1 : Installer XQuartz

  1. Visitez le site officiel de XQuartz : Page de Téléchargement XQuartz.
  2. Téléchargez et installez la dernière version de XQuartz.
  3. (Optionnel) Redémarrez votre ordinateur pour vous assurer que tous les composants nécessaires sont initialisés.

Étape 2 : Exécuter l'Application PyRDPConnect

  1. Localisez le fichier PyRDPConnect.app dans le répertoire dist/macos ou à l'endroit où vous l'avez sauvegardé.
  2. Double-cliquez sur l'application pour la lancer.
  3. PyRDPConnect devrait maintenant s'ouvrir et fonctionner comme prévu.

Dépannage : Si PyRDPConnect ne s'ouvre pas ou affiche une erreur liée à X11 ou XQuartz, assurez-vous que XQuartz est installé et en cours d'exécution. Vous pouvez démarrer XQuartz manuellement depuis votre dossier Applications (/Applications/Utilities/XQuartz.app).

Utilisateurs Linux

PyRDPConnect est également disponible en tant qu'exécutable autonome précompilé pour Linux.

Étape 1 : Télécharger et Installer les Dépendances

Assurez-vous que FreeRDP est installé :

sudo apt-get install -y freerdp2-x11

Étape 2 : Exécuter l'Exécutable PyRDPConnect

  1. Localisez l'exécutable PyRDPConnect dans le répertoire dist/linux ou à l'endroit où vous l'avez sauvegardé.
  2. Rendez le fichier exécutable s'il ne l'est pas déjà :
    chmod +x dist/linux/PyRDPConnect
  3. Exécutez l'application :
    ./dist/linux/PyRDPConnect

Résolution des Problèmes Courants

Erreur Permission Denied : Si vous rencontrez une erreur “Permission denied”, assurez-vous que le script a les permissions d'exécution :

chmod +x <script_name>.sh

Problèmes avec XQuartz : Si XQuartz ne démarre pas automatiquement, vous pouvez le démarrer manuellement depuis /Applications/Utilities/XQuartz.app.

Informations Supplémentaires

Si vous avez des questions ou avez besoin d'aide supplémentaire, n'hésitez pas à ouvrir un ticket dans le dépôt GitHub.