Share images, videos, audio, PDFs, text files, 3D assets, and fonts in your Foundry VTT chat — as easily as texting a friend.

Drop a file. Paste a link. Hit Enter. Your whole table sees it.

Chat Snap adds image, video, audio, and file sharing directly to your game chat. No external tools, no copying links manually — just drag, drop, and post.

Whether you're a GM setting the atmosphere with a dramatic scene illustration, a player sharing a portrait of a new character, or anyone at the table sending a sound clip to complement the moment, Chat Snap keeps everyone in sync.

Drag any image, video, audio, or document file from your computer straight onto the chat box. A preview appears before you send — remove it if you change your mind, add a caption, and post when ready.

Copy an image URL from the web and paste it into the chat. The module detects it automatically and queues it as a preview. Works with images copied directly from web pages too.

When you paste an external URL, Chat Snap silently fetches the file in the background and uploads it to your Foundry server — so the posted message stores a local copy instead of depending on the external host. If the remote server blocks the request (CORS), the original URL is used as a fallback with no interruption.

Queued media shows up as thumbnails (or a named badge for audio, PDFs, and other files) above the chat input. You can remove items before posting, or mix media with a text message — all sent together in one click.

Any image in chat can be clicked to open a larger view. Videos embed with full playback controls and can be double-clicked to go fullscreen. PDFs, text files, and 3D models each open their own dedicated viewer.

Every media item in chat shows an action link below it. For files hosted on your Foundry server it reads Download — clicking saves the file to your device. For external URLs it reads Open and launches the link in a new browser tab so Foundry stays running. Can be disabled in module settings.

A dedicated Storage & Upload dialog (accessible from the module settings panel) lets the GM configure the file size limit and check how much disk space the upload folder is using. A Chat Log section shows the current message count and estimated in-memory size of the chat log — useful for keeping session join times fast. Click Check Usage to scan the upload folder; the result and date are saved and shown on the next visit.

BMP, JPEG, JPG, and PNG uploads are automatically re-encoded to WebP to save server storage — on by default, and toggleable in module settings. A WebP compression quality slider (0.6–0.95, default 0.85) tunes the balance between file size and image quality. Compression runs before the file-size check, so an oversized image that fits once re-encoded is still accepted; it's only rejected if the compressed version still exceeds the limit. If re-encoding wouldn't make a file smaller, the original is kept untouched. Animated and vector formats (GIF, APNG, SVG, WebP, AVIF) and TIFF are never altered.

Audio files embed directly in chat with native browser playback controls. Playback is client-side only — each player controls their own volume and timing independently, so pressing play only affects that client.

Drag a PDF onto the chat input to share it. A badge (PDF icon + filename) appears in the upload strip before sending, and again in the posted message. Click the badge to open the PDF in a viewer dialog with an Open in new tab button as fallback. The viewer fetches the file with your session credentials, so it works reliably for both GMs and players across browsers.

Drag a .txt, .json, .csv, .md, .tsv, .xml, .yml, or .yaml file onto the chat input to share it. A badge with a type-specific icon appears in the message. Click the badge to open a viewer dialog with the file contents — JSON is automatically pretty-printed.

Drag a glTF model (.glb or .gltf) onto the chat input. A cube badge appears in the message — clicking it opens an interactive 3D viewer in a resizable popout, where you can orbit, zoom, and watch the model auto-rotate. A Download button is available in the viewer's toolbar.

Drag a font (.otf, .ttf, .woff, .woff2) or other 3D/game asset (.fbx, .obj, .stl, .usdz, .mtl, .basis, .ktx2) onto the chat input. A badge with a type-specific icon appears in the message. Clicking it opens the file in a new browser tab to download.

Note: Only one audio, PDF, text, model, or asset file can be queued per message. These types cannot be mixed with each other or with visual media (images/videos) in the same message.

The following features are visible and available to the GM only.

Images, videos, and audio files in chat messages show a grip handle to the right of the Download button. Drag it onto an active scene to place the asset directly on the canvas — images and videos are dropped as Tiles, audio files as Ambient Sounds at the exact drop position. The handle is hidden for external URLs and disappears when no scene is open.

Images shared in chat (.webp, .png, .jpg, .jpeg) show a copy icon button next to the drag handle. Click it to copy the image URL to your clipboard instantly — handy for pasting into actor sheets, journal entries, or anywhere else in Foundry.

Next to the copy button, a portrait icon opens a dialog listing every player's linked character (the actor assigned to a user as their Player Character). Each row shows the actor's current portrait alongside a preview of the new image, with a Set Portrait button to apply the change in one click. The dialog only appears for image formats (.webp, .png, .jpg, .jpeg).

Accessible via the Configure button in the module settings panel.