Format du fichier téléchargé

Installer

Gestion des firewalls

Lancer WhiteCat

WhiteCat est fourni en archive .tar.gz (version 64 bits x86_64) sur GitHub. Décompressez-la dans votre dossier personnel, en évitant les chemins contenant des accents ou des espaces. Tous les fichiers (l'exécutable, Fonts/, gfx/, user/, saves/...) doivent rester ensemble dans le même dossier.

Les scripts .sh ci-dessous se lancent au choix par double-clic (choisir « Exécuter » / « Lancer », éventuellement après avoir coché « Autoriser l'exécution ») ou depuis un terminal.

1. Installer les dépendances (une seule fois par machine)

Dans un terminal ouvert dans le dossier extrait :

./install_deps.sh

Ce script installe les bibliothèques nécessaires (SDL2, audio, génération PDF). Le mot de passe administrateur est demandé.

2. Intégration au bureau (recommandé)

./install.sh

Ajoute l'icône du chat et un raccourci dans le menu d'applications et sur le bureau. Aucun mot de passe requis : ce script ne touche qu'à votre profil utilisateur. À noter : l'exécutable lancé seul garde une icône générique — c'est normal sous Linux, l'icône provient du raccourci.

3. Accès aux interfaces DMX USB

Pour piloter une interface DMX USB (Enttec Open/Pro, DMX King...), ajoutez votre utilisateur au groupe dialout, puis reconnectez-vous :

sudo usermod -aG dialout $USER

(Sous Linux, le pilote libftdi1 remplace le pilote FTD2XX de Windows — aucune installation manuelle de driver n'est nécessaire.)

4. Lancer

Double-cliquez sur l'icône WhiteCat (chat) dans le menu d'applications ou sur le bureau — le raccourci créé à l'étape 2. (Au besoin, on peut aussi lancer ./run.sh depuis un terminal.)

• Le tracking vidéo (OpenCV) est désactivé sur la version Linux.
• Si un pare-feu est actif (ufw), autorisez le port UDP 6454 pour l'Art-Net.

WhiteCat fonctionne sur Raspberry Pi sous Raspberry Pi OS Bookworm 64 bits (archive aarch64). Un Raspberry Pi 4 ou 5 est recommandé : le Pi 3 fonctionne mais reste limité (affichage moins fluide).

L'installation est identique à celle de Linux (scripts lançables par double-clic ou en terminal) :

• ./install_deps.sh — dépendances (une fois)
• ./install.sh — icône, raccourci et placement de la fenêtre
• sudo usermod -aG dialout $USER — accès DMX USB
• lancer : en usage courant, un simple double-clic sur l'icône WhiteCat (menu d'applications ou bureau) suffit ; ./run.sh reste une alternative

Placement de la fenêtre (Wayland)

Raspberry Pi OS utilise le compositeur Wayland/labwc, sous lequel une application ne peut pas décider elle-même de sa position à l'écran. Le script install.sh ajoute pour cela une règle labwc qui cale la fenêtre WhiteCat en haut à gauche. Pour choisir une autre position, modifiez les variables WC_POS_X / WC_POS_Y en haut de install.sh puis relancez-le.

Pour émettre du DMX avec une interface USB, le driver de cette interface doit être installé sur l'ordinateur. Voir Configuration DMX pour la liste des interfaces supportées.

La plupart des interfaces MIDI sont reconnues automatiquement par Windows sans installation manuelle. Pour certains périphériques peu communs, installez le driver fourni par le fabricant — toujours en télécharger la version la plus récente sur le site du fabricant.

Conseils généraux pour l'installation des drivers :

• Faites les installations chez vous, calmement, connecté à internet.
• Lancez les installateurs avec des droits d'administrateur (clic droit > Exécuter en tant qu'administrateur).
• Après installation, redémarrez l'ordinateur.
• Si vous partez en tournée internationale, gardez l'installateur du fabricant sur une clé USB.

Vous pouvez vérifier que vos périphériques sont correctement installés via le Gestionnaire de périphériques : clic droit sur le menu Démarrer > Gestionnaire de périphériques. Un périphérique défaillant apparaît avec un triangle d'avertissement jaune.

Depuis la version 0.9.x, WhiteCat semble mieux supporter les mises en veille qu'auparavant. Par précaution, il est tout de même recommandé de désactiver la mise en veille pendant un spectacle.

• Panneau de configuration > Options d'alimentation > modifier les paramètres du mode > mettre Jamais pour la mise en veille, sur batterie ET sur secteur.
• Ne refermez jamais le capot de l'ordinateur avec WhiteCat allumé.

Depuis la version 0.9.x, WhiteCat intègre un ticker intelligent à trois niveaux :

• 60 fps tant que l'utilisateur interagit (souris, clavier)
• 25 fps pendant les animations automatiques (LFO, chasers, crossfades, dampers)
• Mode quasi-idle (100 ms) dès qu'aucune animation n'est active

La consommation CPU est nettement réduite par rapport aux versions précédentes.

Si vous observez tout de même des ralentissements :

• Coupez le Wi-Fi pendant le spectacle.
• Désactivez les analyses antivirus en temps réel.
• Désactivez les mises à jour automatiques Windows.