Mise à jour des README.md et README-ENGLISH.md

Paullux · Paullux · commit 39df5c568361 · 2023-06-22T01:51:55.000+02:00
diff --git a/README-ENGLISH.md b/README-ENGLISH.md
@@ -1,51 +1,97 @@
 - - - -
-    
+
 # MATRIX #
-  
-Capture your WebCam in real time to an ASCII Art rendering in a Tkinter window, all in Python. 
 
-- - - -  
+Capture your WebCam in real time to an ASCII Art renderer in a Qt6 window and to a virtual webcam, all in Python.
+
+Pour la version en français rendez-vous [ici](./README.md)
+
+- - - -
+
 ## Installation ##
-  
-__**Steps needed**__ to install Matrix on your personal computer.   
+
+__**Steps required**__ to install Matrix on your personal computer.
+
 * Get Python:
-* **On Windows**: go to the official website [python.org](https://www.python.org/). 
-* **On MacOS** : you can choose between [homebrew](https://brew.sh/) or the official website [python.org](https://www.python.org/).
-* **On Linux** : install **Python** via your **packages manager**.
-* Attention at the time of the installation only from the official site do not forget to check the box add **the path or the variable Path** and that the use will be **available for all users** of your computer.  
+
+* **On Windows**: visit the official website [python.org](https://www.python.org/).
+
+* **On MacOS**: choose between [homebrew](https://brew.sh/index_fr) or the official [python.org](https://www.python.org/) site.
+
+* **On Linux** : install **Python3**(>=3.6) via your **package manager**.
+
+* When installing from the official website only, don't forget to check the box **add path or Path variable** and that usage will be **available to all users** of your computer.
+
+  
 
 <img src="https://linuxhint.com/wp-content/uploads/2022/09/How-to-Add-Python-to-Windows-Path-3.png" data-canonical-src="https://linuxhint.com/wp-content/uploads/2022/09/How-to-Add-Python-to-Windows-Path-3.png" width="512" height="288" />
 
-__**And to Finish:**__
+  
+
+__**And finally:**__
+
+  
 
 * If you haven't already done so: install Git on your computer, more info [here](https://git-scm.com/book/fr/v2/D%C3%A9marrage-rapide-Installation-de-Git)
-* Then open a terminal and enter the following commands:    
-   
+
+* Then open a terminal and enter the following commands:
+
 ```bash
+
 $ git clone https://github.com/Bit-Scripts/Matrix.git
+
 $ cd Matrix
-$ pip install -r requirements.txt
+
+pip install -r requirements.txt
+
 ```
 
+  
+
 - - - -
+## Configuration ##
+
+* **On Windows**: please follow the instructions to install 'unitycamera' [available here](https://github.com/schellingb/UnityCapture)
+* **On Linux** : 
+    1.  Install v4l2loopback via your package manager.
+        - On Ubuntu/Debian: `sudo apt-get install v4l2loopback`
+        - On Arch: `sudo pacman -S v4l2loopback`
+        - On Fedora: `sudo dnf install v4l2loopback`
+        - On openSUSE: `sudo zypper install v4l2loopback`
+    2. After installation, ensure that the v4l2loopback module is loaded on your system by running the following command:
+    ```bash
+    $ lsmod | grep v4l2loopback
+    ```
+    3. Then activate the v4l2loopback module
+    ```bash
+    $ sudo modprobe v4l2loopback
+    ```
+
 ## Usage ##
-   
+
 ```bash
-$ python ascii12.py #the program starts
+
+$ python ascii17.py #the program launches
+
 ```
+I advise you to use a venv or anaconda to manage the installation of the necessary packages via pip.
+
+Otherwise, binaries are available for direct download from the project releases. 
+  
 
-⚠️⚠️  
-If the window remains black, look at the file ascii12.py by opening it, with a text editor for example the notepad of Windows and change the line 17 `camera = 1` (the possible values of the variable camera are 0, 1 or 2) (more info line 67 we see there the command with cv2 of OpenCV to capture the WebCam) Indeed, with Python I use the OpenCV library to capture your WebCam, only the Webcam can have the number 0, 1 or 2 (for example 1 for me). If the number of your webcam is not the right one, the script will not work, so you will have to change the value to find the one that matches your hardware.   
-⚠️⚠️     
+Here's an example of rendering:
 
-Here is an example of rendering:
-   
 <img src="./Matrix.GIF" data-canonical-src="https://cdn.discordapp.com/attachments/1077054466181832724/1077627784656080936/image.png" width="512" height="288" />
 
+  
+
 - - - -
+
 ## To Contribute ##
 
-We welcome contributions from the community! To contribute, please follow these steps:
+  
+
+We welcome contributions from the community! To contribute, please follow the steps below:
 
 * Fork the project
 * Create a new branch (git checkout -b feature/feature-name)
diff --git a/README.md b/README.md
@@ -1,63 +1,115 @@
+
 - - - -
-    
+
 # MATRIX #
-  
-Capture de votre WebCam en temps réel vers un rendu ASCII Art dans une fenêtre Tkinter, le tout en Python.  
-   
+
+Capture de votre WebCam en temps réel vers un rendu ASCII Art dans une fenêtre Qt6 et vers une webcam virtuelle, le tout en Python.
+
 For English version go to [here](./README-ENGLISH.md)
-    
-- - - -  
+
+- - - -
+
 ## Installation ##
-  
-__**Étapes nécessaires**__ pour installer Matrix sur votre ordinateur personnel.   
+
+__**Étapes nécessaires**__ pour installer Matrix sur votre ordinateur personnel.
+
 * Procurez-vous Python :
-* **Sur Windows** : rendez-vous sur le site officiel [python.org](https://www.python.org/). 
-* **Sur MacOS** : vous avez le choix entre [homebrew](https://brew.sh/index_fr) ou le site officiel [python.org](https://www.python.org/).
-* **Sur Linux** : installez **Python** via votre **gestionnaire de paquets**.
-* Attention au moment de l'installation uniquement depuis le site officiel n'oubliez pas de bien cocher la case ajouter **le chemin d'accès ou la variable Path** et que l'utilisation sera **disponible pour tous les utilisateurs** de votre ordinateur.  
 
-<img src="https://linuxhint.com/wp-content/uploads/2022/09/How-to-Add-Python-to-Windows-Path-3.png" data-canonical-src="https://linuxhint.com/wp-content/uploads/2022/09/How-to-Add-Python-to-Windows-Path-3.png" width="512" height="288" />
+*  **Sur Windows** : rendez-vous sur le site officiel [python.org](https://www.python.org/).
+
+*  **Sur MacOS** : vous avez le choix entre [homebrew](https://brew.sh/index_fr) ou le site officiel [python.org](https://www.python.org/).
+
+*  **Sur Linux** : installez **Python3**(>=3.6) via votre **gestionnaire de paquets**.
+
+* Attention au moment de l'installation uniquement depuis le site officiel n'oubliez pas de bien cocher la case ajouter **le chemin d'accès ou la variable Path** et que l'utilisation sera **disponible pour tous les utilisateurs** de votre ordinateur.
+
+  
+
+<img  src="https://linuxhint.com/wp-content/uploads/2022/09/How-to-Add-Python-to-Windows-Path-3.png"  data-canonical-src="https://linuxhint.com/wp-content/uploads/2022/09/How-to-Add-Python-to-Windows-Path-3.png"  width="512"  height="288"  />
+
+  
 
 __**Et pour Finir :**__
 
+  
+
 * Si cela n'est pas encore fait : installez Git sur votre ordinateur, plus d'info [ici](https://git-scm.com/book/fr/v2/D%C3%A9marrage-rapide-Installation-de-Git)
-* Ensuite ouvrez un terminal et entrez les commandes suivantes :    
-   
+
+* Ensuite ouvrez un terminal et entrez les commandes suivantes :
+
 ```bash
-$ git clone https://github.com/Bit-Scripts/Matrix.git
-$ cd Matrix
-$ pip install -r requirements.txt
+
+$  git  clone  https://github.com/Bit-Scripts/Matrix.git
+
+$  cd  Matrix
+
+$  pip  install  -r  requirements.txt
+
 ```
 
+  
+
 - - - -
+## Configuration ##
+
+*  **Sur Windows** : je vous invite à suivre les instrutions pour installer 'unitycamera' [disponible ici.](https://github.com/schellingb/UnityCapture)
+*  **Sur Linux** : 
+    1.  Installez v4l2loopback via votre gestionnaire de paquets.
+        -   Sur Ubuntu/Debian : `sudo apt-get install v4l2loopback`
+        -   Sur Arch : `sudo pacman -S v4l2loopback`
+        -   Sur Fedora : `sudo dnf install v4l2loopback`
+        -   Sur openSUSE : `sudo zypper install v4l2loopback`
+    2. Après l'installation, assurez-vous que le module v4l2loopback est chargé sur votre système en exécutant la commande suivante :
+    ```bash
+    $ lsmod | grep v4l2loopback
+    ```
+    3. Ensuite activé le module v4l2loopback
+    ```bash
+    $ sudo modprobe v4l2loopback
+    ```
+
 ## Utilisation ##
-   
+
 ```bash
-$ python ascii12.py #le programme se lance
+
+$  python  ascii17.py  #le programme se lance
+
 ```
+Je vous conseil de passé par un venv ou anaconda pour gérer l'installation des paquets nécessaires via pip.
 
-⚠️⚠️  
-Si la fenêtre reste noire, regardez le fichier ascii12.py en l'ouvrant, avec un éditeur de texte par exemple le bloc-notes de Windows et changer la ligne 17 `camera = 1` (les valeurs possibles de la variable camera sont 0, 1 ou 2) (plus d'info ligne 67 on y voit la commande avec cv2 d'OpenCV pour capturer la WebCam). En effet, avec Python j'utilise la bibliothèque OpenCV pour capturer votre WebCam, seulement les Webcam peuvent avoir le numéro 0, 1 ou 2 (par exemple 1 pour moi). Si le numéro de votre webcam n'est pas le bon cela va engendrer une imposibilité au script de fonctionner, du coup il vous faudra changer la valeur pour trouver celle qui corespond à votre matériel.   
-⚠️⚠️     
+Sinon des binaires sont disponibles directement à télécharger sur les releases du projet. 
+  
 
 Voici un exemple de rendu :
-   
-<img src="./Matrix.GIF" data-canonical-src="https://cdn.discordapp.com/attachments/1077054466181832724/1077627784656080936/image.png" width="512" height="288" />
+
+<img  src="./Matrix.GIF"  data-canonical-src="https://cdn.discordapp.com/attachments/1077054466181832724/1077627784656080936/image.png"  width="512"  height="288"  />
+
+  
 
 - - - -
+
 ## Pour Contribuer ##
 
+  
+
 Nous sommes ravis de recevoir des contributions de la communauté ! Pour contribuer, veuillez suivre les étapes suivantes :
 
+  
+
 * Forker le projet
+
 * Créer une nouvelle branche (git checkout -b feature/nom-de-la-fonctionnalité)
+
 * Commiter vos modifications (git commit -am 'Ajout d'une nouvelle fonctionnalité')
+
 * Pousser la branche (git push origin feature/nom-de-la-fonctionnalité)
+
 * Créer une pull request
 
-- - - -  
-## Licence ##
   
-Ce projet est sous licence GPL V3 - voir le fichier [LICENSE](./LICENSE.md) pour plus de détails.
 
-- - - -
+- - - -
+
+## Licence ##
+
+Ce projet est sous licence GPL V3 - voir le fichier [LICENSE](./LICENSE.md) pour plus de détails.
diff --git a/ascii17.py b/ascii17.py
@@ -197,14 +197,15 @@ def __init__(self):
     def run(self):
         global running, init_global
         running = True
+        self.video_device = self.find_virtual_cameras_on_linux()
         if init_global:
             print("entre dans create_virtual_camera()\n")
             if sys.platform.startswith("linux"):
                 while running:
                     try:
                         virtual_frame = self.virtual_frame
                         virtual_frame_resized = self.resize_image(virtual_frame, 1280, 720)
-                        with pyvirtualcam.Camera(width=1280, height=720, fps=30, device='/dev/video4') as cam:
+                        with pyvirtualcam.Camera(width=1280, height=720, fps=30, device=f"{self.video_device}") as cam:
                             if not running:
                                 break
                             cam.send(virtual_frame_resized)
@@ -230,7 +231,18 @@ def run(self):
     def resize_image(self, image, width, height):
         resized_image = cv2.resize(image, (width, height))
         return resized_image
-    
+
+    def find_virtual_cameras_on_linux(self):
+        import pyudev
+        context = pyudev.Context()
+        devices = context.list_devices(subsystem='video4linux')
+        video_device = ""
+        for device in devices:
+            product_id = device.get('ID_V4L_PRODUCT')
+            if product_id == 'Dummy video device (0x0000)':
+                video_device = device.device_node
+        return video_device
+        
     def update_frame(self, virtual_frame):
         self.virtual_frame = virtual_frame
         self.old_frame = self.virtual_frame
