====== 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 ===

  - Visitez le site officiel de XQuartz : [[https://www.xquartz.org/|Page de Téléchargement 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 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 ===

<code sh>
brew install python3
pip3 install pyqt5
</code>

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

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

==== 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 :

<code sh>
sudo apt-get update
sudo apt-get install -y git python3 python3-pip python3-pyqt5 python3-pyqt5.qtquick python3-pyqt5.sip freerdp2-x11
</code>

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

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

===== 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 ===

  - Visitez le site officiel de XQuartz : [[https://www.xquartz.org/|Page de Téléchargement 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 ===

  - Localisez le fichier ''PyRDPConnect.app'' dans le répertoire ''dist/macos'' ou à l'endroit 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 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é :

<code sh>
sudo apt-get install -y freerdp2-x11
</code>

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

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

===== 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 :
<code sh>
chmod +x <script_name>.sh
</code>

**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 [[https://github.com/LaswitchTech/PyRDPConnect/issues|dépôt GitHub]].