Files
scrying-pool/README.md
T
uberwald daed472b46
CI / ci (push) Successful in 40s
Add CC BY-NC-SA 4.0 license
2026-05-27 12:09:20 +02:00

10 KiB
Raw Blame History

Scrying Pool

Scrying Pool

GM camera visibility control for FoundryVTT v14+
License: CC BY-NC-SA 4.0
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 Modules
  2. Recherchez Scrying Pool
  3. Cliquez Installer

### 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 60200px, grande 60400px)
- 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 **Modules**
2. Search for **Scrying Pool**
3. Click **Install**

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 60200px, large 60400px)
  • 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+ · CC BY-NC-SA 4.0