scrying-pool/README.md

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 :

{
  "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.

---

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:

{
  "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.

---

_{Made for FoundryVTT v14+ · MIT License}