Board Game Shelf Calculator

🌐 Import from BoardGameGeek

🔗 Live API

📄 CSV File

📋 XML File

BGG Username

Password (for private collections)

Remember

Logs in to BGG and fetches your owned games. Password only needed for private collections. If this fails, use the CSV or XML method.

ℹ BGG now requires you to be logged in. Paste your BGG session cookie below (one-time) and this version can load your collection — public or private. No password is sent.

BGG session cookie

BGG API token (for search & dimensions)

BGG now requires a registered-app token for search & box dimensions (your own collection works with just the cookie). Register at boardgamegeek.com/using_the_xml_api, then paste the token here. Leave blank if you don't have one yet.

How do I get my cookie?

On a computer, in a browser logged in to boardgamegeek.com: press F12 → Application tab → Cookies → https://boardgamegeek.com. Copy the values of bggusername, bggpassword and SessionID, and paste them here as:
bggusername=YOU; bggpassword=...; SessionID=...
(Stored only on this device. The cookie expires eventually — re-paste if loading stops working.)

Advanced: custom BGG proxy

The public proxy is often rate-limited or blocked. Deploy your own free Cloudflare Worker (see proxy/bgg-cors-worker.js) and paste its URL here — it's saved on this device and used for all BGG calls. Leave blank to use the default public proxy.

How to export your BGG collection as CSV:
1. Go to boardgamegeek.com and log in
2. Click your username → Collection
3. Click Export (top-right of the page) → Export Collection to CSV
4. Save the file, then drop it below

📄

Drop BGG CSV file here, or click to browse

File looks like: your-collection.csv

How to save your BGG collection as XML:
1. Enter your BGG username in the Live API tab above, then open this URL in your browser:

https://boardgamegeek.com/xmlapi2/collection?username=YOUR_USERNAME&own=1

2. Wait for it to load fully (may say "please try again" — refresh until you see game data)
3. Ctrl+S → save as type Webpage, XML only or XML file
4. Drop the saved file below — or just drag it straight from your Downloads folder

📋

Drop BGG XML file here, or click to browse

File looks like: collection.xml — or a BGG XML you saved earlier

🔍 Search & Add from BGG

➕ Add Game Manually

Units: mm cm inches

Game Name

Width (mm)

Depth (mm)

Height (mm)

Qty

BGG ID (optional)

🔍 Fix Missing Dimensions ▼

← Select a game from the list to enter or fix its dimensions

🔗 BGG page ↗ 🛒 Amazon search ↗

📋 Paste dimension line from BGG / Amazon

✓ Parsed! ⚠ Can't parse — enter manually

Unit: inches (BGG default) mm cm

Width

Depth

Height

✓ Saved!

🎮 Game Collection (0 games)

⚙ Settings

☁ Cloud sync code

Set a secret code here once, then use the ☁⬆ Save / ☁⬇ Load buttons to sync between devices. Use the same code on each device. ⚠ It's like a password — anyone who knows it can read/overwrite your data, so pick something long and unique.

Hide in-box exps

#	🖼	Name	Width	Depth	Height	Qty	In box	Skip	Actions
📭 No games yet — sync from BGG or add manually

Board Game Shelf Calculator

🔍 Fix Missing Dimensions ▼

🎮 Game Collection (0 games)

📐 Add Shelf / Storage Box

🗄️ My Shelves (0)

⚡ Common Shelf Presets

⚙️ Packing Options

🚛 Moving House — Pack Collection Into Boxes

✏️ Layout Editor

💾 Saved Layouts

🌐 Import from BoardGameGeek

🔍 Search & Add from BGG

➕ Add Game Manually

🔍 Fix Missing Dimensions 🔄 Fetch from BGG ▼

🎮 Game Collection (0 games) ➕ Add / Import ▾ 🌐 Import from BGG 🔍 Search & Add ➕ Add manually ☁⬆ Save ☁⬇ Load 💾 Backup 📂 Restore ⚙ Reset

⚙ Settings

☁ Cloud sync code

📐 Add Shelf / Storage Box

🗄️ My Shelves (0)

⚡ Common Shelf Presets

⚙️ Packing Options

🚛 Moving House — Pack Collection Into Boxes

✏️ Layout Editor

💾 Saved Layouts

🔍 Fix Missing Dimensions ▼

🎮 Game Collection (0 games)