← Back to Home

Help

How to use Tabletop Display at the table.

D&D Beyond IntegrationSetup

The DnD TrueSight Companion browser extension syncs HP, AC, level, inspiration, and conditions from D&D Beyond to the player display automatically — updating in real time as players make changes on their character sheets.

What each player needs to do

Set sheet to PublicIn D&D Beyond account settings, set the character sheet visibility to Public so the extension can read it.
Share Character IDGive the DM the number at the end of your character sheet URL — e.g. dndbeyond.com/characters/160326824 — the ID is 160326824.
Keep sheet openLeave your character sheet open in a browser tab during the session. It doesn't need to be the active or focused tab.
Optionally installPlayers can install the extension in their own browser for faster, more direct updates — but it's not required.

What the DM needs to do

Install extensionLoad the extension in Chrome using developer mode — open chrome://extensions, enable Developer mode, click Load unpacked, and select the extension folder.
Add Character IDsIn the Character Library, open each PC's edit form and enter their D&D Beyond Character ID. The extension uses this to match open character sheet tabs to library entries.
Keep panel openThe DM panel must be open in a browser tab while the session is running — it's how the extension authenticates and discovers which characters are in the active session.

Troubleshooting

“Character isn't updating”

Check that the Character ID saved in the Character Library matches the number in the D&D Beyond URL exactly — no extra characters, no spaces.

“Extension shows no active session”

Make sure the DM panel is open in a browser tab and a session has been started.

“HP updated on D&D Beyond but not showing on the display”

The extension polls every 30 seconds during combat and every minute otherwise — wait one full cycle. If HP was updated on a phone or different browser, it may take one additional cycle for the desktop tab to refresh and re-read the new value.

“Extension keeps reloading my character sheet”

The extension periodically refreshes background tabs to pick up HP changes made on other devices. Only background tabs are affected — tabs you are actively using are never reloaded.

Reading a character card

AC15

Kozie Sunbeam

Valor Bard · Lv 5

HP34 / 40
Charmed

example card

PortraitThe character's portrait image. The card crops from the top so faces stay visible.
AC badgeThe number in the top-right corner of the portrait — the character's armor class, the minimum roll anyone needs to hit them.
Name & classCharacter name on top, then abbreviated subclass and class with their level below it.
HP barA filled bar inside the nameplate, below the class and level line. Fills and changes color based on current health — green above 50%, amber from 25–50%, red below 25%. The current and max HP numbers appear directly below the bar. When the extension isn't connected, the bar track stays empty and shows “not connected” instead of numbers.
Inspiration pipThe small dot to the right of the character's name. Bright gold with a glow means the character currently has inspiration to spend; dark gray means they don't.
Conc. stripA purple strip below the HP numbers showing the spell being concentrated on. Useful for reminding the party not to let them take avoidable damage.
Condition pillsColored tags at the bottom of the nameplate showing any active conditions — poisoned, charmed, prone, etc. Each condition uses its own color (charmed is pink, poisoned is green, and so on).
Highlight ringA glowing ring around the entire card frame during combat, regardless of border style. It marks whose turn it currently is.

Generating a portrait

Use any AI image generator (Midjourney, Adobe Firefly, Ideogram, etc.) with the prompt below. Replace the tokens in [brackets] with your character's details.

Prompt template
[RACE & APPEARANCE], [ARMOR/GEAR], [EXPRESSION OR HAND POSE], implied [ENVIRONMENT] background with dramatic bokeh, close-up portrait with head and shoulders visible, upper chest in frame, hyperdetailed stylized 3D render, Blizzard cinematics art style, heroic proportions, physically based rendering, 8K textures, surface wear and battle damage, subsurface scattering on skin, dramatic warm volumetric lighting, Unreal Engine 5, octane render, shallow depth of field, head and shoulders portrait framing, ultra-high fidelity game portrait
TokenWhat to put hereExample
[RACE & APPEARANCE]Race, skin, hair, eyes, distinguishing featuresfemale tiefling with dark horns, yellow eyes, short brown hair, battle scars
[ARMOR/GEAR]Armor type, weapon held or visible, accessoriesworn silver plate armor with gold trim, holding a war staff
[EXPRESSION OR HAND POSE]Facial expression, or a specific hand gesture — keep it from the shoulders upconfident smirk · laughing · peace sign · hand raised mid-cast · fingers on chin
[ENVIRONMENT]A setting that implies location without dominating — it will be blurredtavern with firelight · forest clearing at dusk · stone dungeon · stormy cliffside

Tip

If your generator supports reference images — Midjourney's --cref, image prompts in Firefly or Ideogram, etc. — upload an existing picture of your character alongside this prompt. It can carry over appearance and gear details for you so you don't have to type them all out. Just focus the prompt text on whatever the reference image doesn't capture, like pose or expression.

Square images work best. Portrait orientation is also fine — the card crops from the top. Aim for a close-up that shows the head and shoulders rather than a tight face-only crop; the auto-crop system needs that margin to frame the portrait correctly.