Some code(mostly style and CSS) has been generated with AI because I suck at CSS
Tokener adds a searchable token art picker to the Foundry VTT Token HUD.
Select a token, open its HUD, click the Tokener button, then search and apply art from enabled token-art modules or your own world data folders. The picker opens as a Foundry ApplicationV2 window, so it stays open while you pan or zoom the canvas.
Tokener does not include art. It indexes image files and art metadata from other enabled sources, then points selected tokens and actors at those existing images.
The internal module id remains pf2e-tokener so existing settings, favorites, tag overrides, and revert flags keep working.
Feature Summary
- Token HUD button for selected tokens in any Foundry system.
- Searchable gallery of token art from enabled token-art modules.
- System-profile support for native compendium art mappings keyed by the active system id.
- PF2e compatibility profile for existing PF2e compendium art mappings and legacy
pf2e-artmapping modules. - Support for mapped module art, gallery datasheets, common token folders, actor portraits, and dynamic token ring subject art.
- Custom world data folders with optional source names, recursive scans, folder browser thumbnails, source-level tags, nested
folder:*tags, and advanced split paths for token, portrait/artwork, and subject images. - Search by actor name, creature or NPC name, filename, module/source name, broad terms, or tags.
- Multi-source filter with source search, select all, and clear all.
- Tag filters grouped by category, with include and exclude controls.
- Direct tag search syntax such as
ancestry:human,equipment:sword,tag:magic, and!family:undead. - Client-side favorites with a sidebar favorites filter.
- GM image tag overrides for any indexed image, with source tags kept read-only.
- Matched tag chips on result cards and grouped tags in fullscreen preview.
Token,Actor,Portrait, andBothapply actions.- Revert last Tokener change from the sidebar or by right-clicking the highlighted HUD button.
- Current-token marker, result counts, paging with
Show more, and scroll preservation while applying art or changing filters.
Supported Art Sources
Tokener builds its index when the world loads and when relevant Tokener settings change.
It can index:
- Native compendium art mappings for the active system, such as
compendiumArtMappings.dnd5e,compendiumArtMappings.pf2e, orcompendiumArtMappings.sf2e. - Older PF2e
pf2e-artmapping modules when the active system is PF2e. - Gallery datasheets with searchable tags.
- Datasheet JSON files discovered in common module data folders.
- Token images in common module paths such as
tokens,assets/tokens, andresources/tokens. - Matching portrait art in paths such as
art,portraits,assets/art,assets/portraits,resources/art, andresources/portraits. - Matching dynamic token subject art in paths such as
subjects,assets/subjects, andresources/subjects. - Custom world data folders configured in the module settings.
Known compatible source styles include:
- Pathfinder Tokens: Bestiaries
- Pathfinder Tokens: Monster Core
- Pathfinder Tokens: Monster Core 2
- Pathfinder Tokens: NPC Core
- Pathfinder Tokens: Character Gallery
- Pathfinder Tokens: Myth and Magic
- Pathfinder Tokens: Draconic Codex
- Starfinder Tokens: Alien Core
- older PF2e art mapping modules such as PF2e All Tokens
- other token modules that use recognizable token folders, active-system mappings, or datasheets
Some sources only provide token images. When portrait or subject art is missing, Tokener hides unavailable panes and actions instead of showing broken image placeholders.