Foundry modules / Documentation
View photos and files on the phone
Last checked 2026-10-08
Two apps, two jobs
The phone has a Photos app and a Files app. Both are for looking at things. Photos is the camera roll: pictures the GM placed on your phone. Files is everything else that was handed to your character: documents, handouts, audio files the GM uploaded, and pictures or attachments that arrived inside text messages.
The Photos app
- Open PHOTOS from the home screen. The header reads LOCAL ROLL, and an empty roll says "No photos on device".
- Scroll the grid. Pictures are grouped under in-game dates, and each carries a small STILL tag.
- A picture that has no image yet shows PENDING and cannot be opened.
- Tap a picture to open it full size, with its name, who it came from and any caption. Tap it again, press Escape, or use the close button to go back.
The Files app
- Open FILES from the home screen. The header reads SHARED WITH YOU, and an empty list says "No files on device".
- Each row shows a name and a kind (image, audio, text or data), plus the sender when there is one.
- Tap a row to open it. An image shows a preview, audio plays in a small player, and text shows its contents. Data files show a scrambled "ENCRYPTED PAYLOAD" block because the phone cannot open them.
- Handouts are marked Origin: HANDOUT on the file screen.
A badge on each icon counts items that arrived since you last opened the app. Opening the app clears it. The phone shows you only your own handset, but see where the phone keeps your data for how private that really is.
How the GM adds items
There is no button in the phone for adding a photo or file. The GM does it with a macro, one call per item. The kind picks the app: photo goes to Photos, and image, audio, text and data go to Files.
Macro example (script macro, run by the GM): await game.modules.get('shawnsvtts-phone').api.sendFile(game.actors.getName('Aria'), { kind: 'photo', name: 'Dock at night', url: 'path/to/image.png', caption: 'Taken from the roof', fromLabel: 'Anonymous' }); For a text file use { kind: 'text', name: 'Shipping ledger', body: 'Pier 9: 4 crates' }. The first argument is the character or its actor id. takenAt is optional; leave it out and the item is stamped with the in-game time.
To hand over an audio file, set kind to audio and url to a file you have uploaded to Foundry. It plays in the player on the file screen.
Players do not need Foundry's file upload permission for any of this. Players never upload files through the phone: the GM adds photos and attaches audio, and a player sends photos from their own gallery. See Where the phone keeps your data.
Related
Foundry Virtual Tabletop belongs to Foundry Gaming LLC. ShawnsVTTs modules are independent add-ons and are not made, endorsed or supported by Foundry Gaming LLC.