Leo Mobile Sync

A Foundry VTT module that lets you sync and apply maps from the Leo mobile app (or any source) into your game. Pick maps from a configurable folder, apply UVTT multi-layer maps or plain images to the current scene, and control walls, lights, doors, and points of interest per floor.

Features

• Map Picker (toolbar: mobile icon) with two tabs:
  • Maps — Browse a folder of maps; filter by All, UVTT only, or Images only; apply any map to the current scene. Optional rename (display name) per map.
  • Active Map — After applying a UVTT map, switch layers (floors), toggle walls/lights/portals/POI on or off, set background fit, and Apply to Scene once to push the selected floor and options to the canvas.
• UVTT support (.uvtt):
  • Multiple layers (floors); each layer can have its own image, walls, lights, portals, and points of interest.
  • Embedded base64 images are written to your upload folder so Foundry can use them as the scene background.
  • Walls, lights, doors, and POI (as map pins) are applied per selected layer.
• Plain images (.png, .webp) with optional rotation; optional .json walls in the same folder.
• Mobile setup — Settings screen with QR code and connection string, PIN, and upload folder for the Leo app.
• GM-only — Map picker and apply actions are for the GM; players are not shown the picker.

Requirements

• Foundry VTT — Minimum 12, verified on 13.
• Game system — Any (e.g. D&D 5e); the module only manages scene background and embedded documents (walls, lights, notes).

Installation

1. Install the module (e.g. from GitLab: clone or download the repo, or use a manifest URL if you host one).
2. In Foundry Setup → Add-on Modules, enable Leo Mobile Sync.
3. In Configure Settings (or right-click the module’s mobile icon in the scene controls), open Leo Mobile Sync and set:
   • Upload folder — Foundry data path where maps (and UVTT exports) are stored (e.g. assets/leo-sync).
   • Security PIN — Used by the mobile app to connect.
   • Optionally External URL override (e.g. ngrok) if the app cannot reach Foundry directly.

Usage

1. Open the Map Picker — Click the mobile/sync icon in the scene controls (layers area). The Map Picker window opens.
2. Maps tab
   • Set or confirm the folder path and click Refresh.
   • Use Format to show All, UVTT only, or Images only.
   • Optionally type a Rename under a tile to give the map a display name.
   • Click Apply on a tile to apply that map to the current scene and (for UVTT) switch to the Active Map tab.
3. Active Map tab (after applying a UVTT map)
   • Choose a layer (floor) with the layer buttons.
   • Use the checkboxes to include or exclude Walls, Lights, Portals, Points of interest (changes apply immediately).
   • Set Background fit (fill, cover, contain, none).
   • Click Apply "[Layer name]" to Scene to push the selected layer’s image and data to the scene (replacing existing walls/lights/notes as configured).

Configuration

Rename labels for maps are stored per world and do not rename files on disk.

License

See repository or author for license details.

Author

L.E.O.