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