---

MATRIX

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

---

Installation

Étapes nécessaires pour installer Matrix sur votre ordinateur personnel.

• Procurez-vous Python :

• Sur Windows : rendez-vous sur le site officiel python.org.

• Sur MacOS : vous avez le choix entre homebrew ou le site officiel 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.

Et pour Finir :

• Si cela n'est pas encore fait : installez Git sur votre ordinateur, plus d'info ici

• Ensuite ouvrez un terminal et entrez les commandes suivantes :

$  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.
• 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 :

  $ lsmod | grep v4l2loopback

  3. Ensuite activé le module v4l2loopback

  $ sudo modprobe v4l2loopback

  4. Nouvelle méthode d'installation Pour Ubuntu 23.04

  $ sudo apt update
  $ sudo apt install -y git python3-pip v4l2loopback-utils libqt6widgets6 libqt6core6 libqt6multimedia6 gstreamer1.0-opencv libopencv-apps2d libopencv-core406 libopencv-imgcodecs406 libopencv-imgproc406 $ libopencv-objdetect406 libopencv-photo406 libopencv-shape406 libopencv-video406 libopencv-videoio406 opencv-data ffmpeg gstreamer1.0-libav v4l2loopback-utils v4l2loopback-dkms
  $ sudo mv /usr/lib/python3.11/EXTERNALLY-MANAGED /usr/lib/python3.11/EXTERNALLY-MANAGED.old
  $ sudo modprobe v4l2loopback
  $ git clone https://github.com/Bit-Scripts/Matrix.git
  $ pip install -r requirements-linux.txt
  $ pip install --upgrade pyqt6_tools

  Pour Linux Mint 21

  $ sudo apt install -y git python3-pip v4l2loopback-utils libqt6widgets6 libqt6core6 libqt6multimedia6 gstreamer1.0-opencv libopencv-apps2d opencv-data ffmpeg gstreamer1.0-libav v4l2loopback-utils v4l2loopback-dkms
  $ git clone https://github.com/Bit-Scripts/Matrix.git
  $ pip install -r requirements-linux.txt
  $ pip install --upgrade pyqt6_tools
  $ sudo modprobe v4l2loopback

Utilisation

$  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.

Sinon des binaires sont disponibles directement à télécharger sur les releases du projet.

Voici un exemple de rendu :

---

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 pour plus de détails.