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.
🎯 BGG account
🔒 All of these are stored only on this device and sent only to BGG. Your BGG
password is never saved — type it in the import dialog only when loading a private
collection.
How do I get my cookie?
In a browser logged in to boardgamegeek.com: F12 →
Application → Cookies → https://boardgamegeek.com.
Copy bggusername, bggpassword, SessionID and paste as:
bggusername=YOU; bggpassword=...; SessionID=... (re-paste if it expires).
🔑 API key
Required since BGG's Oct 2025 "XML APIcalypse" for search & box dimension lookups (loading your own collection still works with just the session cookie). Register an application at
boardgamegeek.com/applications,
click Tokens, then copy the token (a long code like e3f8c3ff-…) and paste just the token below — not the word "Bearer".
📥 What gets imported from BGG
A collection sync (or XML import) records, per game: name & thumbnail; your
owned edition (name, year, language → flag); other edition languages
(🇺🇦/+ markers); box size (W×D×H); players, play time,
age; categories & mechanics;
status (own/want/wishlist…); plays; and your BGG comment.
CSV import only carries: name, box dimensions (if present), expansion flag.
Advanced: custom BGG proxy
Web/Android reach BGG through a Cloudflare proxy. The default public one is shared and can be
rate-limited; deploy your own free Worker (see proxy/bgg-cors-worker.js) and paste its
URL here. Leave blank to use the default.
🌍 Edition languages of interest
Your owned edition's flag (from your BGG collection) is always shown on the
list and profile. Below, pick which other edition languages to also flag — as a
flag, a discreet +, or hide (e.g. show Ukrainian
as a flag, Russian as + or hidden). These also drive the language filter above the games table.
📏 Default gap between games (mm)
Prefills the "gap between games" field in Packing Results and Moving House, and is used by the Layout Editor 3D/2D views.
🌐 BGG collection XML URLs
Open these in a browser and save the pages, then import them in 📐 Fix Dimensions → XML. Uses the username from the My Games → Live API tab.
Wipe all games, shelves and saved layouts and start fresh. This can't be undone — make a 💾 Backup or ☁⬆ Save first.
✏️ Edit shelf / box
⬆ Top box — rim opening
For tapered plastic totes that flare wider at the top — the packer lets games rest higher where it opens out. Leave blank for a straight box.
⬇ Bottom box — floor footprint
Inner usable size = outer − 2×wall per axis. With no top dims, plastic totes taper to ~88% usable bottom footprint.
📏 Edit box
⬆ Top box — rim opening
For tapered plastic totes that flare wider at the top. Leave blank for a straight box. The packer uses this — a game too wide for the floor can rest higher up where the tote opens out.
⬇ Bottom box — floor footprint
Wall is removed from all six faces — inner usable size = outer − 2×wall on each axis (e.g. a 100 mm wall takes 200 mm off W, D and H). Gap between games is set once for the whole layout in the Gap (mm) field at the top.
🎲 Game profile
🌐 Import from BoardGameGeek
🔗 Live API
📄 CSV File
📋 XML File
ℹ BGG requires you to be logged in. Set your BGG session cookie in
⚙ Settings → BGG account and this app can load your collection — public
or private. No password is sent.
This imports, per game: name & thumbnail · owned
edition (name/year/language → flag) · other edition languages (🇺🇦/+) · box size (W×D×H) ·
players · play time · age · categories · mechanics · status (own/want/…) · plays · your BGG comment.
Set your BGG session cookie, API key and (optional) custom proxy in ⚙ Settings → BGG account. If the API is unavailable, use the CSV or XML tab.
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
Imports: game name, box dimensions (only if your export includes them), and the expansion flag. Editions, players, categories, status, plays, etc. are not in CSV — use a collection sync or XML for those (or run 🌍 Refresh all BGG info after).
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:
⚠ Expansions are a separate download — BGG's default collection
only returns base games. To get your owned expansions, also save this URL and import it too:
2. Wait for each 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(s) below — import the base-games file and the expansions file (one after the other)
📋
Drop BGG XML file here, or click to browse
File looks like: collection.xml — or a BGG XML you saved earlier
Imports: name, thumbnail, box size, expansion flag — plus (from a collection XML) owned edition, status, plays and your comment. It then runs 🌍 Refresh all BGG info to pull players, categories, mechanics & edition languages.
🔍 Search & Add from BGG
➕ Add Game Manually
Units:
🔍 Fix Missing Dimensions
▼
← Select a game from the list to enter or fix its dimensions
Rim opening at the top of a tapered tote (outer). The W/D/H above are the bottom (outer) footprint. Leave blank to use the flat taper approximation.
💡 Width / Depth / Height = outer dimensions · Wall = board thickness subtracted from each side (5 mm default for cardboard, 0 for IKEA Kallax which uses inner dims)
🗄️ My Shelves (0)
🗄️
No shelves yet — add one above
⚡ Common Shelf Presets
⚙️ Packing Options
Orientation Mode
🤖 Auto Best-Fit
📚 Upright (Spine Out)
📦 Flat Stacked
🎯
Configure your games and shelves, then click Calculate Packing
🚛 Moving House — Pack Collection Into Boxes
Define your removal boxes below, then click Pack Everything to find the most efficient way to move your entire collection.
Units:
📦 Cardboard removal boxes:
🧊 IKEA SAMLA plastic boxes (tapered — usable bottom is smaller than the rim):
Preparing…
✏️ Layout Editor
Build a layout manually or edit a saved one. Select a container to view its 3D packing and add/remove games.
Containers
✏️
Select a layout source above to start
💾 Saved Layouts
📋
No layout saved yet.
Pack your collection (📊 Packing Results or 🚛 Moving House) then click 💾 Save as Layout.