# Installer l'isoloir « Dites-le ICI » — guide pas à pas

Ce guide s'adresse à toute personne, **sans connaissance technique**, qui doit installer
l'expérience sur l'ordinateur d'un booth (Windows). Comptez environ **10 minutes**.

Tout le nécessaire est fourni sur la clé USB (ou le fichier ZIP). **Aucune connexion Internet
n'est nécessaire.**

--

## Ce qu'il vous faut

- L'ordinateur du booth (**Windows 10 ou 11**).
- La **clé USB** fournie (ou le fichier **.zip** à décompresser).
- Le **boîtier de commande** (Streamdeck) — pour piloter l'expérience ensuite.

---

## Etape 1 : Première installation de l'ordinateur

1. Démarrer l'ordinateur et faire l'initialisation de l'ordinateur avec les dernières mises à jour (vous devrez le connecter à un réseau WiFi).
2. Ignorer le nommage de l'appareil.
3. Suivez la configuration (pour une utilisation personnelle) jusqu'à ce que vous atteigniez l'écran de connexion.
4. Appuyez sur Shift + F10 pour ouvrir l'invite de commandes.
5. Tapez `start ms-cxh:localonly` et appuyez sur Entrée.
6. Cela ouvre la création de compte local sans connexion à un compte microsoft.
7. Créez un utilisateur `ICINOMDELALOCALE` avec le mot de passe `R@diofr@nceXX` XX étant le numéro de département de votre locale.

## Paramétrage de l'ordinateur pour une expérience idéale
1. Paramètres > Système > écran : Mise à l'échelle 100%
2. Paramètres > Système > Batterie et alimentation > Délai d'expiration de l'écran : Sur secteur > Désactiver l'écran après : jamais

---

## Étape 2 — Installez l'isoloir

1. Branchez la clé USB / Si vous avez reçu un **.zip** : faites un clic droit dessus → **Extraire tout…**
2. Ouvrez le dossier livré. Vous devez y voir un fichier nommé **`install.bat`**.
3. **Double-cliquez sur `install.bat`**.
4. Une fenêtre noire s'ouvre et copie les fichiers. C'est normal.

> **Si Windows affiche un avertissement bleu « Windows a protégé votre ordinateur »** :
> cliquez sur **« Informations complémentaires »** puis sur **« Exécuter quand même »**.
> (Cet avertissement apparaît car le programme vient d'une clé, il n'y a aucun risque.)

5. À la fin, un raccourci **« Isoloir »** apparaît sur le **Bureau**.
6. L'installateur demande **« Supprimer les fichiers d'installation ? »** — répondez **O**
   (Entrée) : le dossier extrait est effacé automatiquement à la fermeture de la fenêtre
   (il contient des données sensibles et ne sert plus). **Supprimez aussi le fichier `.zip`
   d'origine** (et videz la Corbeille) — cette suppression-là reste manuelle.

---
## Étape 3 — Installer le logiciel du streamdeck & le configurer

### Installation

L'installation lance automatiquement l'installateur **Bitfocus Companion** s'il ne l'est pas déjà:

1. Suivez l'assistant (cliquez **Suivant / Installer / Terminer**).
2. Laissez les options par défaut.

### Configuration

> À ne faire **qu'une fois**, sauf si une mise à jour vous est demandée

1. Ouvrez **Bitfocus Companion** (icône créée à l'étape 3).
2. Sélectionner `localhost` dans GUI Interface
3. Changez le port en **8484** eet cliquez sur Change
4. Cochez **Run at login**
5. Dans le navigateur, allez sur **`http://localhost:8484`** (ou cliquez sur Launch GUI).
6. Cliquez sur l'onglet **« Import / Export »**, puis **« Import »**.
7. Choisissez le fichier **`.companionconfig`** qui se trouve dans le dossier
   `Documents` → `Isoloir` (ou indiqué à la fin de l'étape 2).
8. Appuyez sur **Full Reset & Import**
9. Dans Connections, appuyez sur **Download & Install Missing versions**
10. Branchez le StreamDeck

Les boutons du boîtier affichent alors les bonnes icônes (coche verte, caméra barrée, croix
rouge, flèches).

- **Sur le StreamDeck, j'ai des points d'exclamation rouge sur chaque bouton** -> les connections n'ont pas toutes été installées
- **Le Streamdeck n'affiche rien après l'avoir branché** -> Allez dans "Surfaces" dans l'interface Companion (`http://localhost:8484`) et appuyez sur "Rescan USB"

## Étape 4 — Verrouiller le clavier du participant

> À ne faire **qu'une fois** par ordinateur. Une fois activé, **tout clavier USB externe** est restreint aux seules touches **alphanumériques** — impossible d'ouvrir le
> menu Windows, de changer d'application, etc. Le **clavier intégré du portable reste libre**
> (Alt+F4 y fonctionne toujours pour quitter l'expérience).

Le filtre clavier s'installe **automatiquement pendant l'Étape 2** (à la première
installation) :

1. Juste après la copie des fichiers, une **demande d'autorisation administrateur (UAC)**
   apparaît : cliquez **« Oui »**.
2. Le pilote de filtrage s'installe.
3. **Redémarrez l'ordinateur.**

C'est terminé : au prochain lancement de l'Isoloir, le clavier USB du participant est
   automatiquement limité une fois l'expérience lancée.

> **Si l'autorisation n'apparaît pas** (ou si vous avez refusé) : dans le dossier livré, faites
> un **clic droit** sur **`install-keyfilter.bat`** → *Exécuter en tant qu'administrateur*, puis
> redémarrez. C'est le même résultat, à faire manuellement.

> **Pour vérifier** quel clavier est libre / filtré : double-cliquez sur le raccourci
> **« Vérifier les claviers »** (créé sur le Bureau), puis pressez une touche sur chaque
> clavier.
>
> **Pour désactiver le filtre une fois l'expérience terminée** : double-cliquez sur **`uninstall-keyfilter.bat`**
> (désinstalle le pilote ; un **redémarrage** est demandé).

---

## Où sont enregistrées les vidéos ?

Dans **`Documents` → `Isoloir` → `recordings`**.

Chaque participation crée :
- un fichier **`.json`** (informations de la personne, consentement),
- une **vidéo `.mp4` par question**.

A chaque fin de journée, envoyez ces fichiers sur le serveur Everdian puis supprimez les.

---

## Mettre à jour l'expérience

1. Branchez la **nouvelle** clé USB (ou décompressez le nouveau ZIP).
2. Double-cliquez de nouveau sur **`install.bat`**.

Le programme est mis à jour, **les questions sont actualisées automatiquement**, et vos
réglages du booth ainsi que les vidéos déjà enregistrées sont **conservés**.

---

## En cas de problème

- **La webcam ne s'affiche pas** → vérifiez qu'aucune autre application (Teams, Zoom…) ne
  l'utilise, et que la webcam est bien branchée.
- **L'écran ne s'ouvre pas en plein écran** → ouvrez le navigateur **Microsoft Edge** et tapez
  `http://localhost:3000`.
- **Les boutons du boîtier ne réagissent pas** → vérifiez que **Companion** est lancé et que la
  configuration a bien été importée (Étape 4).
- **Rien ne se passe au double-clic sur `install.bat`** → refaites l'Étape 2 en autorisant
  l'exécution (avertissement bleu).

En cas de problème, une interface d'administration vous permettra de simuler les boutons du Streamdeck ainsi que de comprendre les différentes informations en cours d'expérience. Vous pourrez y accéder depuis `http://localhost:3000/admin.html`

Pour toute question, contactez l'équipe technique du projet **Dites-le ICI**.
