diff --git a/README.md b/README.md
new file mode 100644
index 0000000..8ee2929
--- /dev/null
+++ b/README.md
@@ -0,0 +1,213 @@
+
+ 
+
+
+Scrying Pool
+
+
+ GM camera visibility control for FoundryVTT v14+
+
+ Français · English
+
+
+---
+
+## Français
+
+**Scrying Pool** est un module FoundryVTT qui donne au MJ un contrôle total sur la visibilité des caméras des participants. Fini les flux vidéo désordonnés — gérez qui voit quoi depuis une interface flottante et discrète.
+
+### Fonctionnalités
+
+| Fonction | Description |
+|---|---|
+| **Barre du MJ** | Palette flottante listant tous les participants connectés, avec leur état caméra en temps réel |
+| **Director's Board** | Fenêtre de pilotage complète : grille de participants, actions groupées, mise en avant |
+| **Masquer / Afficher** | Cache ou révèle un flux à la table — par clic droit ou popover |
+| **Actions groupées** | Tout afficher, tout masquer, annuler la dernière action en un clic |
+| **Mise en avant (Spotlight)** | `Shift+clic` sur un participant → sa vidéo s'agrandit (×2), les autres disparaissent. `Échap` pour quitter |
+| **Réorganisation** | Faites glisser les participants dans la barre pour les réorganiser. Double-clic sur la poignée pour réinitialiser |
+| **Mosaïque / Grille** | 6 dispositions : vertical/horizontal/mosaïque, chacune en taille S ou L |
+| **Formes des tuiles** | Rond, arrondi, hexagone, octogone — appliqué aux avatars et aux vidéos |
+| **Bordures** | Largeur et couleur paramétrables pour les tuiles vidéo |
+| **Préréglages** | Sauvegardez et chargez des dispositions de visibilité, avec application automatique par scène |
+| **Portrait personnalisé** | Les joueurs peuvent choisir une image de remplacement quand leur caméra est indisponible |
+| **Confidentialité** | Panneau de consentement pour les automatismes (caméra de réaction, etc.) |
+| **Notifications** | Notifications configurables (toutes, MJ seulement, silencieux) |
+| **Rétablissement position** | La position de la barre est sauvegardée automatiquement toutes les 30s et au relâché du glisser |
+
+### Installation
+
+1. Dans FoundryVTT, allez dans la **Galerie de Modules**
+2. Recherchez **Scrying Pool**
+3. Cliquez **Installer**
+
+Ou ajoutez manuellement dans `module.json` :
+
+```json
+{
+ "url": "https://github.com/morr/scrying-pool",
+ "manifest": "https://github.com/morr/scrying-pool/releases/latest/download/module.json",
+ "download": "https://github.com/morr/scrying-pool/releases/latest/download/module.zip"
+}
+```
+
+### Utilisation
+
+#### Barre du MJ (strip)
+
+La barre flottante apparaît automatiquement quand vous vous connectez en tant que MJ. Elle liste tous les participants avec leur état :
+
+- **Clic** → popover pour masquer/afficher ce participant
+- **Clic droit** → menu contextuel (masquer/afficher)
+- **Shift+clic** → mode Spotlight (vidéo ×2)
+- **Glisser** la poignée ⟞ pour déplacer la barre
+- **Glisser** un participant pour le réorganiser
+- **Double-clic** sur la poignée → réinitialiser l'ordre des participants
+- **Bouton `[+]`** → basculer taille S/L
+- **Bouton `[⊞]`** → ouvrir le Director's Board
+
+La barre se fondu dans le décor — pas de chrome visible tant que vous ne la survolez pas.
+
+#### Director's Board
+
+Ouvrable depuis la barre (bouton `[⊞]`) ou via `Ctrl+Shift+V`.
+
+- Grille de tous les participants avec statut et indicateur d'opération en attente
+- Boutons **Tout afficher** / **Tout masquer**
+- **Undo** (apparaît après une action groupée)
+- **Rétablir** (après une mise en avant Spotlight)
+- Sélecteur de **disposition** (vertical/horizontal/mosaïque, S/L)
+- Sélecteur de **forme** des tuiles (cercle, arrondi, hexagone, octogone)
+- Contrôles de **bordure** (largeur, couleur)
+- Réglages de **taille des widgets** (petite 60–200px, grande 60–400px)
+- Sauvegarde/chargement/export/import de **préréglages**
+- **Application automatique** par scène
+- Activation/désactivation A/V
+- **Bouton Réinitialiser la barre** (rétablit la position par défaut)
+
+#### Raccourcis clavier
+
+| Raccourci | Action |
+|---|---|
+| `Ctrl+Shift+V` | Ouvrir/Fermer le Director's Board |
+| `Ctrl+Shift+S` | Tout afficher |
+| `Ctrl+Shift+H` | Tout masquer |
+| `Ctrl+Shift+P` | Mettre en avant le participant sélectionné |
+
+### Configuration
+
+Module accessible depuis **Paramètres → Gérer les modules → Scrying Pool**.
+
+| Option | Description |
+|---|---|
+| Afficher le flux du MJ | Quand activé, la propre caméra du MJ est visible dans la barre |
+| Verbosité des notifications | Toutes / MJ seulement / Silencieux |
+| Application automatique | Activer/désactiver globalement l'application des préréglages par scène |
+
+### Support
+
+Pour signaler un bug ou proposer une amélioration : [ouvrir un ticket](https://github.com/morr/scrying-pool/issues).
+
+---
+
+## English
+
+**Scrying Pool** is a FoundryVTT module that gives GMs full control over participant camera visibility. No more messy video feeds — manage who sees what from a discreet floating interface.
+
+### Features
+
+| Feature | Description |
+|---|---|
+| **GM Strip** | Floating palette listing all connected participants with real-time camera state |
+| **Director's Board** | Full command window: participant grid, bulk actions, spotlight |
+| **Hide / Show** | Hide or reveal a feed to the table — via right-click or popover |
+| **Bulk actions** | Show all, hide all, undo last bulk action in one click |
+| **Spotlight** | `Shift+click` a participant → their video enlarges (×2), others disappear. `Esc` to exit |
+| **Re-order** | Drag participants in the strip to rearrange them. Double-click the grip to reset |
+| **Mosaic / Grid** | 6 layouts: vertical/horizontal/mosaic, each in S or L size |
+| **Tile shapes** | Circle, rounded, hexagon, octagon — applied to avatars and video feeds |
+| **Borders** | Configurable width and color for video tiles |
+| **Presets** | Save and load visibility layouts, with per-scene auto-apply |
+| **Custom portrait** | Players can set a fallback image when their camera is unavailable |
+| **Privacy** | Consent panel for automation features (reaction cam, etc.) |
+| **Notifications** | Configurable notification verbosity (all, GM only, silent) |
+| **Position recovery** | Strip position auto-saved every 30s and on drag release |
+
+### Installation
+
+1. In FoundryVTT, go to the **Module Gallery**
+2. Search for **Scrying Pool**
+3. Click **Install**
+
+Or add manually in your `module.json`:
+
+```json
+{
+ "url": "https://github.com/morr/scrying-pool",
+ "manifest": "https://github.com/morr/scrying-pool/releases/latest/download/module.json",
+ "download": "https://github.com/morr/scrying-pool/releases/latest/download/module.zip"
+}
+```
+
+### Usage
+
+#### GM Strip
+
+The floating strip appears automatically when you log in as GM. It lists all participants with their state:
+
+- **Click** → popover to hide/show that participant
+- **Right-click** → context menu (hide/show)
+- **Shift+click** → Spotlight mode (×2 video)
+- **Drag** the ⟞ handle to move the strip
+- **Drag** a participant to reorder them
+- **Double-click** the handle → reset participant order
+- **`[+]` button** → toggle S/L size
+- **`[⊞]` button** → open the Director's Board
+
+The strip is stealthy — no chrome visible until hover.
+
+#### Director's Board
+
+Open from the strip (`[⊞]` button) or via `Ctrl+Shift+V`.
+
+- Grid of all participants with status and pending-operation indicator
+- **Show All** / **Hide All** buttons
+- **Undo** (appears after a bulk action)
+- **Restore** (after a Spotlight)
+- **Layout** selector (vertical/horizontal/mosaic, S/L)
+- **Shape** selector (circle, rounded, hexagon, octagon)
+- **Border** controls (width, color)
+- **Widget size** settings (small 60–200px, large 60–400px)
+- **Preset** save/load/export/import
+- Per-scene **auto-apply**
+- A/V toggle
+- **Reset Strip** button (restores default position)
+
+#### Keyboard Shortcuts
+
+| Shortcut | Action |
+|---|---|
+| `Ctrl+Shift+V` | Open/Close Director's Board |
+| `Ctrl+Shift+S` | Show All |
+| `Ctrl+Shift+H` | Hide All |
+| `Ctrl+Shift+P` | Spotlight focused participant |
+
+### Settings
+
+Access from **Settings → Manage Modules → Scrying Pool**.
+
+| Option | Description |
+|---|---|
+| Show GM Self Feed | When enabled, the GM's own camera feed is shown in the strip |
+| Notification Verbosity | All / GM Only / Silent |
+| Auto-Apply | Globally enable/disable per-scene preset auto-apply |
+
+### Support
+
+Report bugs or request features: [open an issue](https://github.com/morr/scrying-pool/issues).
+
+---
+
+
+ Made for FoundryVTT v14+ · MIT License
+