Handout Ping Viewer

IN ENGLISH

Handout Ping Viewer extends Foundry's native Image Popout window into a real handout tool for your table. Show a letter, a map, a photograph, or any clue to your players, and let everyone pan, zoom, and point things out together in real time — no extra menus, no separate viewer to open.

Features

• Pan & zoom on any image opened in a popout — mouse wheel to zoom (centered on the cursor), click-and-drag to pan, double-click to reset the view.
• Force View (GM only) — broadcast your current zoom and position to every connected player looking at the same image, so everyone sees exactly what you're pointing at. Opens the image for players who don't have it yet.
• Collaborative ping — anyone (GM or player) can click the image, without dragging, to drop an animated ping marker labelled with their name. It's seen in real time by everyone who already has that same image open — ideal for "look, right there!" moments during an investigation.

How it works

This module hooks directly into Foundry's existing image-sharing flow. Share an image with your players the way you already do — through a Journal Entry image, the "Share Image" option, or any other native method — and as soon as the popout opens, the pan/zoom/ping controls are available automatically for everyone. There's nothing new to learn and no separate file picker to go through.

Installation

1. In Foundry's Setup screen, go to Add-on Modules → Install Module.
2. Search for Handout Ping Viewer, or paste the manifest URL directly.
3. Enable it in your world's module settings.

Compatibility

Verified for Foundry VTT v13 and v14. Fully system-agnostic — works with any game system, since it only touches the core Image Popout application.

Notes

• Free and open source (MIT License).
• No dependencies on other modules.
• Available in English and French.

Development note: this module's concept, direction, and testing were driven by the author; the code and documentation were generated with the assistance of Claude (Anthropic).

EN FRANÇAIS

Handout Ping Viewer transforme la fenêtre native d'aperçu d'image de Foundry (Image Popout) en un véritable outil de handout de table. Montrez une lettre, une carte, une photographie ou n'importe quel indice à vos joueurs, et laissez tout le monde zoomer, se déplacer dans l'image et se montrer des détails en temps réel — sans menu supplémentaire, sans visionneuse séparée à ouvrir.

Fonctionnalités

• Zoom & déplacement sur n'importe quelle image ouverte en aperçu — molette pour zoomer (centré sur le curseur), clic-glissé pour déplacer la vue, double-clic pour réinitialiser.
• Forcer la vue (MJ uniquement) — diffuse ton zoom et ta position actuels à tous les joueurs connectés qui regardent la même image, pour que tout le monde voie exactement ce que tu pointes. Ouvre aussi l'image chez les joueurs qui ne l'ont pas encore.
• Ping collaboratif — n'importe qui (MJ ou joueur) peut cliquer sur l'image, sans glisser, pour poser un marqueur animé portant son nom. Il apparaît en temps réel chez tous ceux qui ont déjà cette même image ouverte — parfait pour les moments « regardez, juste là ! » pendant une enquête.

Comment ça marche

Ce module s'intègre directement au système natif de partage d'image de Foundry. Partagez une image avec vos joueurs comme vous le faites déjà — via une image de journal, l'option « Partager l'image », ou toute autre méthode native — et dès que la fenêtre d'aperçu s'ouvre, les contrôles de zoom/déplacement/ping sont automatiquement disponibles pour tout le monde. Rien de nouveau à apprendre, aucun sélecteur de fichiers séparé à utiliser.

Installation

1. Dans l'écran de configuration de Foundry, va dans Modules complémentaires → Installer un module.
2. Recherche Handout Ping Viewer, ou colle directement l'URL du manifeste.
3. Active-le dans les paramètres de modules de ton monde.

Compatibilité

Vérifié pour Foundry VTT v13 et v14. Entièrement agnostique au système — fonctionne avec n'importe quel système de jeu, puisqu'il ne touche qu'à l'application native d'aperçu d'image.

À noter

• Gratuit et open source (licence MIT).
• Aucune dépendance à d'autres modules.
• Disponible en français et en anglais.

Note de développement : le concept, la direction et les tests de ce module ont été menés par l'auteur ; le code et la documentation ont été générés avec l'assistance de Claude (Anthropic).