Table des matières
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
- Rendez-vous sur le site officiel de XQuartz : Page de Téléchargement de XQuartz.
- Téléchargez et installez la dernière version de XQuartz.
- (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
- 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
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
- Rendez-vous sur le site officiel de XQuartz : Page de Téléchargement de XQuartz.
- Téléchargez et installez la dernière version de XQuartz.
- (Optionnel) Redémarrez votre ordinateur pour vous assurer que tous les composants nécessaires sont initialisés.
Étape 2 : Exécuter l'Application PyRDPConnect
- Trouvez
PyRDPConnect.app
dans le répertoiredist/macos
ou dans l'emplacement où vous l'avez sauvegardé. - Double-cliquez sur l'application pour la lancer.
- 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
- Trouvez l'exécutable
PyRDPConnect
dans le répertoiredist/linux
ou dans l'emplacement où vous l'avez sauvegardé. - Rendez le fichier exécutable s'il ne l'est pas déjà :
chmod +x dist/linux/PyRDPConnect
- 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.