Table of Contents

Guide d'Installation


Prérequis pour l'Exécution depuis le Code Source

Utilisateurs macOS

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

Étape 1 : Installer XQuartz

  1. Rendez-vous sur le site officiel de XQuartz : Page de Téléchargement de 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 nécessaire auquel FreeRDP fait appel pour le rendu graphique sur macOS. Sans cela, l'application risque de 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 Répertoire et Exécuter depuis le Code Source

Clonez le répertoire PyRDPConnect :

git clone https://github.com/LaswitchTech/PyRDPConnect.git

Accédez au répertoire src et exécutez l'application :

python3 src/client.py

Utilisateurs Linux

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

Étape 1 : Installer les Paquets Requis

Mettez à jour votre liste de 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 Répertoire et Exécuter depuis le Code Source

  1. Clonez le répertoire 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écution de l'Application Pré-compilée

Utilisateurs macOS

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

Étape 1 : Installer XQuartz

  1. Rendez-vous sur le site officiel de XQuartz : Page de Téléchargement de 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. Trouvez PyRDPConnect.app dans le répertoire dist/macos ou dans l'emplacement 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 lancer XQuartz manuellement depuis votre dossier Applications (/Applications/Utilities/XQuartz.app).

Utilisateurs Linux

PyRDPConnect est également disponible en tant qu'exécutable unique 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. Trouvez l'exécutable PyRDPConnect dans le répertoire dist/linux ou dans l'emplacement 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 de Permission Refusée : 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 se lance 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 problème dans le Dépôt GitHub.