From Zero to Rolling

Setup & Calibration

A short guide to getting DiceCam running at your table. Allow about three minutes for a clean first run.

01

Install the desktop app

Download DiceCam for Windows, or Linux. The installer is a single file, ~450 MB, no admin elevation required.

Windows
10 / 11 (x64)
Linux
AppImage + .deb
Disk
~450 MB after install
TIP · Beta builds are gated through Discord. Join the channel to find out more on how to become a tester today.
02

Aim your camera at the tray

Point any webcam or your phone via a webcam companion app — at the area you roll on. A felt tray or dice tower works best. Top-down or 15° angle, both fine.

Distance
30–80 cm above tray
Resolution
720p minimum, 1080p ideal
Lighting
Even, no direct glare
Surface
Matte, contrasting your dice
TIP · Got bright dice? Use a dark tray. Got black dice? Use a light tray. Contrast is everything.
03

Calibrate your dice

If your dice aren't being picked up correctly, head to settings to calibrate your set. DiceCam will have you roll each die type a few times so it can learn your specific dice—whether they feature numerals or pips, or have unique colours, finishes, and edge styles.

Calibration is per-set, not per-session. Switch sets later? One tap to reload a profile.

TIP · Translucent and metallic sets sometimes need an extra 5–10 sample rolls. The app tells you when it's confident.
04

Install the browser extension

Add the DiceCam extension to Chrome, Edge, or Brave. This is what posts your rolls into your VTT chat.

Roll20
Auto-detected
D&D Beyond
Auto-detected
TableTop Simulator
Coming Soon
05

Roll a d20 to confirm

Open your VTT, click the DiceCam icon in your browser, and roll. The number you see on the table should appear in chat within a heartbeat. If you rolled a nat 20 on your first try, that's a sign.

TIP · The first roll always feels slightly magical. Don't blame us if your party demands you film it.
Troubleshooting

When the dice don't cooperate

My roll didn't register

Most often a contrast issue — try a darker tray or stronger overhead light. Also check that the camera can see every die in the spread.

Numbers read wrong

Recalibrate that die type. Translucent and gemstone sets sometimes need extra training samples to disambiguate similar-looking faces.

Lag between roll and chat

This is a customized experience, you can adjust the delay settings between detection and roll transmission. Additionally, you can choose between Auto-Send or Manual-Send modes to control how your rolls are posted.

Camera not appearing

Windows users, make sure no other app (Zoom, OBS) has an exclusive lock on the device.

VTT not receiving rolls

Roll20 and D&D Beyond occasionally expire OAuth tokens. Reconnect or Refresh from the extension popup.

Ready to roll for real?

Beta access available on request on our Discord. Bring your dice, bring your party.