Gambit's Image Viewer

Hello and welcome to Gambit's Image Viewer! I built this module because I wanted Foundry’s Image Popout to feel like an actual tabletop handout tool. This module does that by extending Foundry’s native Image Popout with a viewer that supports pan/zoom, real-time annotations, pings, GM-controlled sharing, and even particle effects — for both images and video.

You may enjoy this module if you like showing things like handouts, maps, art, clues, etc to your players, and you want you and your players to be able to interact with them together in real time!

Module Overview

• Pan & Zoom on every image/video.
• Ping any spot on the media to draw everyone’s attention.
• Draw on the media with live multi-user syncing (GM Controlled).
• Write text on the media with live multi-user syncing (GM Controlled).
• Create FXMaster Particle Effects on every image/video.
• Save annotations (GM controlled) with optional Auto Save.
• Share to all players or only specific players from the header controls.
• Post to Chat from the header controls, creating clickable image or video previews for players in chat.

Viewer Modes

The toolbar is built around three main modes:

• Pan Mode — move around the media and zoom comfortably. Long-press on the media to ping a location for everyone viewing.
• Draw Mode — collaborative drawing tools that sync in real time.
• Text Mode — drop text labels/notes directly onto the image/video, synced in real time.

Drawing Tools

• Brush + Line tools
• Eraser tool
• Eyedropper (grab a color directly from the media)
• Color picker
• Opacity + Brush size sliders
• Undo (undoes your last stroke)

Text Tools

• Click to place text directly on the media
• Font, size, and color controls
• Bold / Italic toggles
• Move text after placing it
• Delete text entries cleanly

Particle Effects

This module adds a Particle Effects button to the viewer for GMs. If you have FXMaster+ installed, you can apply particle effects directly in the image/video popout.

• Pick from available FXMaster particle effects
• Toggle effects on/off per viewer
• Adjust effect properties
• Particle configuration is included in the viewer’s saved metadata when you save the image/video

Pings

In Pan Mode, users can long-press to ping a location on the image/video. Users can choose a specific Ping color. Pings are broadcast to everyone viewing that same media, which makes it perfect for:

• "Look right here" moments
• Pointing out clues or map details
• Quickly coordinating without drawing

GM Sharing Controls

From the header controls menu, the GM can:

• Show to all players
• Show to individual players

Saving & Persistence (GM-Controlled)

Annotations are only meant to persist when you actually want them to. In this spirit, the GM can choose whether players are able to use Save functionality.

• Save — persist the current annotations and particle effects for this image/video.
• Auto Save — when enabled, changes persist automatically for that media.
• Media Persistence — annotations remain visible and synced while at least one viewer has the image/video open. If everyone closes without saving, those unsaved changes are discarded.

Cleanup Tools

• Clear drawings you created (player-specific cleanup when allowed)
• Clear player drawings (GM tool)
• Clear all annotations (GM tool)

Chat Integration

As GM, you can Post to Chat directly from the viewer. It posts a clickable preview image or video. Players clicking it will be able to open that media session.

Details / Asset Info

The header menu includes a Details option:

• If you opened the asset via Gambit’s Asset Previewer (GAP), it will integrate with and open the GAP details view.
• Otherwise, it provides a clean details window (filename + filepath) with convenient copy buttons.

Settings

• Default Player Editable — whether newly opened media starts with player annotation enabled by default.
• Allow Player Saves — optionally allow players to use the Save button. (If a specific image has player editing disabled, player save/clear tools are automatically disabled for that image.)
• Clear ALL Saved Image Annotations — An option if you need to reset all image annotations.

Compatibility / Requirements

• Foundry VTT v13+
• libWrapper (required) — used to safely extend Foundry’s Image Popout
• Gambit's FXMaster+ (optional) — required for particle effects inside the viewer
• Gambit’s Asset Previewer (GAP) (optional) — enhanced "Details" integration when viewing GAP assets