| Latest version | 2.4.2 |
|---|---|
| Minimum Core | |
| Compatible Core | |
| File size | 0 B |
| Last updated | 2 months ago |
| Created | 8 months ago |
| Authors | |
| Languages |
|
| Systems | All systems |
| Project source | Project URL |
Hover Portrait enhances your game by displaying a customizable portrait whenever you hover over a token.
Designed with a premium UX philosophy, it provides a clean, modern, and fully sandboxed portrait picker that never touches the default Foundry FilePicker.
✨ Features
- Hover Portrait Display
Shows a portrait when hovering over tokens, with support for images and videos.
- Custom Sandboxed Portrait Picker
A fully custom UI that browses only inside the module’s portrait directory.
Includes category buttons, auto‑discovered folders, and a responsive grid layout.
- Video Support
Works with png, jpg, webp, gif, webm, mp4, ogg, and more.
- Token Inheritance
Newly created tokens automatically inherit the actor’s saved portrait.
- Border Themes
Choose from multiple border styles including Fantasy, Fire, Nature, Necromancer, Steel, Gold, Moon, and Dragon.
- Pinning Support
Keep the portrait window fixed in place with a per‑user setting.
- Zero UI Interference
No Foundry UI bleed, no resizing logic, and no deprecated API usage.
📁 Portrait Storage
Portraits are stored in:
Data/portraits
Add your own folders and images — the picker will detect them automatically.
🧩 Compatibility
- Works with any game system
- Foundry VTT v12 – v15
- Fully verified for v13
To install this package, open your Foundry Setup screen and navigate to your Module tab and click the Install Module button.
From there, you can either search for the package unique name: hover-portrait or copy its manifest URL:
And paste it to the input box at the bottom of your window.

You can install this package directly to your Forge account.