Tomebound Help
Find help for the main Tomebound workflows: tracking cards, organizing storage, building
decks, syncing data, sharing lists, using collection chat, and working from the command
line or an agent.
Collection Basics
Use the collection view to scan, search, sort, edit, and price your singles.
Starting with an empty collection
-
After a first sign-in finishes syncing to a genuinely empty account, a two-step
setup guide asks whether you want to import a collection, import a deck, or add
cards one by one. The next step explains the selected path, introduces the
collection, container, deck, history, export, and sharing capabilities, then opens
the existing workspace for that task.
-
Closing or finishing the guide keeps it from appearing automatically again on that
account in the current browser. An empty collection always keeps a Show setup guide
action, and signed-in users can also choose Restart setup guide from the Account
section in Settings. Restarting the guide is safe on a populated account and does
not change collection data.
-
Opening a container or deck that has never held any cards shows a plain no-cards-yet
message. That is different from a search or filter matching nothing in a non-empty
collection, which shows the zero-results debugger described under Search and filters
below.
Table and visual views
-
The collection view has a table mode for dense editing and a visual mode for
browsing card images. Known printings request their artwork as cards come into view,
without waiting for the collection's background metadata refresh. Images that are
unavailable show a placeholder.
-
Containers, including the signed-out trade-binder demo, use those same table and
visual views, search, filters, and View settings. A container's visual default no
longer opens a separate grid workspace. Binder pages are an optional layout in
visual View settings. The demo keeps the same browsing controls while hiding
account-only editing and sharing actions; demo cards are not saved.
-
Visual View settings offer one full-width four-stop card-size slider. The four
unlabeled notches snap to Compact, Medium, Large, and Extra large; the current named
size and pixel width appear above the track and are announced by assistive
technology. The choice is remembered. You can instead display cards as fixed binder
pages in 2x2, 3x3, 4x4, or 4x3 pocket layouts. Tab to a binder card and press Enter
or Space to open its details.
-
Normal finishes stay visually quiet. When Visible fields > Finishes is enabled in
visual view, foil and etched cards show their finish in the metadata line beneath
the card, between quantity and price, plus the same material treatment used by the
enlarged card in Details. Disabling Finishes removes both the label and treatment.
-
On pointer devices, visual card art gains one solid, fully opaque outline in the
theme accent color on hover so it reads as clickable without moving or shifting
layout. Keyboard focus uses the same treatment, including in reduced-motion mode.
-
Sort the table by name, set, collector number, finish, rarity, condition, container,
tags, quantity, or price. Tags sort alphabetically, with card names breaking ties;
untagged cards come first in ascending order.
-
In table View settings, choose comfortable or compact row density, show or hide
columns, drag headers to reorder, resize their edges, or reset the entire table
layout. The Select and Name columns stay pinned while you scroll a wide table
horizontally. Book appearance uses ornate column headings, shortened to their
initial when a column is narrow.
-
Right-click a card or its location for quick actions. Destination submenus open
toward available space and remain inside the screen; long menus scroll so every
destination stays reachable.
-
Collection updates preserve your tag filter and unsaved tag identity edits, along
with keyboard focus. Table tags stay on one line in dense mode. When the cell cannot
show every tag, a +N badge reports how many are hidden; click the cell or its +
action to review and edit the full tag list.
-
Open a card from either view to see its artwork, mana cost, and price, make quick
quantity or container changes, add another copy, and jump among other tracked copies
of the same card. Each tracked copy identifies its set and collector number
separately from finish, condition, language, location, and quantity. An open card is
reflected in the address bar, so refresh restores it and the browser Back button
closes it without losing your collection view.
-
Hover or keyboard-focus a displayed price to see its currency, Scryfall provenance,
latest snapshot date when available, and whether a regular-price fallback is
standing in for a missing exact-finish price.
-
Prices come from a daily Scryfall snapshot. The footer's prices as of date shows
when the latest available snapshot was generated. If an update fails, the previous
snapshot stays available with its original date.
-
The card drawer also shows which of your Tomebound decks use the card. Less-common
printing, finish, condition, language, and tag corrections stay under Edit details.
These edits stay staged while you browse printings or the collection refreshes. Save
or Shift+Enter commits them; Cancel or Escape discards them.
-
Use the previous and next buttons, or the j and k keys, to step through the drawer
in your current filtered and sorted order without closing it. Stepping stops at
either end of the list, and j/k are ignored while you are typing in a field. On
desktop, close the drawer with Escape or by clicking outside it; the full-width
mobile drawer also has a close button. Closing the drawer returns you to the card
you opened it from.
Search and filters
-
Plain text searches card names. If you type more than one word, each word must
match.
-
The sidebar has three destinations: Collection, Containers, and Decks. Their
semantic icons stay consistent in the sidebar and page headings. Containers and
Decks are collapsible lists; hover or move keyboard focus into a group row to reveal
its Add action. Cards with no container appear as a muted No container set row at
the end of Containers, with a live count, and it is hidden when every card has a
container.
-
On desktop, the account menu sits at the bottom of the sidebar. Use the button
beside the Tomebound name, or press [, to show or hide the sidebar. Drag the sidebar
edge to resize it, or click anywhere on that edge to collapse it. With the edge
focused, use arrow keys to resize or Enter to collapse. A closed sidebar becomes a
narrow book spine; click it to reopen navigation. On tablet-sized workspaces, the
sidebar starts closed so the collection keeps enough room.
-
On phones, the sidebar button opens navigation. Tap Account at the bottom to open
the account menu above it, then choose Sign in if you are signed out. Escape or a
tap outside closes the open menu or navigation. Browse & filter opens a drawer
with separate Browse, Filters, and View tabs. Browse contains search and collection
destinations, Filters contains card criteria, and View contains table/visual and
saved-view settings.
- Use filters for set, rarity, finish, tag, and format legality.
-
On desktop, Search expands across the available collection toolbar space. Filters
sits in the right action cluster beside the Table/Visual toggle and View settings;
its popover stays anchored to the Filters button and flips or clamps inside narrow
viewports. Escape, outside click, or Apply closes it and returns focus. While you
edit Filters, Apply previews the exact number of cards the draft will show.
-
The Filters button shows the number of active filter groups. Reopen it to review or
remove individual criteria, then Apply; the clear button beside Filters removes all
of those criteria while keeping your search text. Escape discards unapplied edits.
-
Use shortcuts for precise searches: t:creature for type, c:rg for colors,
o:"flying" for rules text, set:fin for set, tag:trade for tags, loc:bulk
for a container, and loc:none for cards with no container.
-
Use comparisons like cmc<=3 for mana value 3 or less and qty>=2 for two or
more copies. Put a dash before a term to exclude it.
-
Start typing a shortcut like set: or loc: and a dropdown suggests the field, then
matching values from your own collection (set codes, container names, tags, and so
on) - pick one or keep typing your own. Plain name searches never trigger it.
-
When a search and filter combination matches nothing, the empty state names the
specific filter responsible when there is one clear cause, with a button to remove
just that filter or clear everything. When legality or price data for some cards
hasn't finished loading yet, that is called out instead of blaming the format or
price filter - unknown legality and unknown price never count as match failures, so
cards stay visible while their data backfills.
Keyboard shortcuts
-
Ctrl+K (Cmd+K on Mac) opens quick jump: type to find a card, a container or deck, or
run an action - new deck, new container, import, export, open history, and settings,
alongside help, feedback, and chat.
-
Press / to focus search from anywhere. Focusing an empty search field shows your
recent searches with a quiet recent label; use the pointer or Arrow keys and Enter
to pick one, or keep typing.
-
In table view, arrow keys move a keyboard cursor between rows. Shift+Up or
Shift+Down extends a selection range from where you started. Space selects the
focused row without opening it; Enter opens it.
-
Inside the card drawer, use j and k to step to the next or previous card in your
current filtered and sorted order, same as the previous and next buttons.
-
The [ key shows or hides the sidebar. Elsewhere, a (add cards), h (help in a new
tab), f (capture feedback), and c (collection chat) are one-key shortcuts, and
Ctrl+Z (Cmd+Z) undoes your last change. Help also opens in a new tab when chosen
from quick jump, so your collection position and filters stay in place. All of these
are ignored while you are typing in a field.
Saved views
-
A new account starts with one saved Collection view, which is both current and
default. It owns the current search, filters, sort, columns, and table or visual
layout.
-
Changing those controls marks the current saved view as modified. Use Save changes
to update it, or Save new view to keep the original and activate a new saved view.
-
The active saved view appears in one management row. Its ellipsis menu contains
Rename, Duplicate, Set as default, and Delete; the default view explains why Delete
is unavailable until another view is made default. Other saved views appear below
when available, and Tomebound asks before replacing unsaved modifications.
-
When renaming a saved view, Enter saves and Escape cancels. Your unfinished name
stays in place when the collection refreshes in the background. Saved views
synchronize with the rest of your collection preferences across signed-in devices.
Link to this view
-
Copy view link, in the view settings panel, copies a link back to your current
filters, sort, and table or visual mode. Opening that link creates an ad-hoc view
and never overwrites a saved view; use Save new view if you want to keep it.
-
This is not the Share link under Export and share - it does not grant anyone read
access to your cards. It is a private bookmark to a view of your own collection, for
you.
-
The link never includes search text, tags, container names, or oracle/type-line text
searches, since those can contain personal wording. It carries only closed choices -
set, rarity, finish, format, format legality, color, condition, language, and
numeric ranges like price or mana value.
Totals
-
The footer summarizes the current collection or view: unique cards, total cards,
estimated value, and container or deck counts where they apply.
-
The right end of the footer shows a compact rendering of the most recent change, a
one-click undo only when that exact event is still safe to reverse, and a history
link that opens the full history panel. Hover or focus the compact line or an entity
in it to reveal the complete event. It updates for changes made in chat, the CLI, or
by an agent as well as your own edits. On desktop, Help, Feedback, Chat, and Add
remain individually visible at the lower right. On smaller screens, those actions
and History live behind the compact More launcher.
-
Ctrl+Z (Cmd+Z on Mac) also triggers that same undo, as long as you are not typing in
a field. Large undos still ask you to confirm first.
-
Prices come from Scryfall data when available and are estimates for collection
management, not financial records.
History and undo
-
Open the history panel from the history link in the footer. It lists recent changes
with the time, where each change came from, and per-entry undo, redo, and remove
controls. Undo and redo appear only while the exact stack transition remains safe;
their accessible labels state the full action they will reverse or reapply. History
updates preserve keyboard focus on controls and card references that remain
available. Removing a focused entry moves focus to a neighboring entry, or back to
the scope controls when the list is empty.
-
History summaries come from one structured event formatter shared by the panel and
footer. They distinguish create, delete, rename, set, change, clear, add, remove,
and move; card edits name fields such as quantity, printing, finish, condition,
language, tags, container, and deck zone. Bulk actions name representative cards and
disclose the accurate remaining count.
-
Container, deck, and tag references use compact inline identity chips with the full
captured name and historical emoji or semantic fallback icon, so a later rename or
deletion does not rewrite older history. Existing containers and decks can be opened
from their history references; deleted entities remain readable without becoming
broken links. Card names are restrained underlined text links rather than chips.
Hovering or focusing one opens its card preview in the global overlay, wholly clear
of the History panel. The footer keeps the line compact, and hover or keyboard focus
reveals its complete event and full names without shifting the page.
-
A bulk edit or bulk delete on multiple selected cards is recorded as one entry;
undoing it restores every card in that batch together, not one at a time.
-
The panel scopes to what you are looking at. Switch between This view and All at the
top; the choice is remembered.
-
History is stored per browser and capped, so it is a recent-activity log rather than
a permanent audit trail. Sync keeps a smaller shared window across your devices.
Add And Import Cards
Add one card at a time, paste shorthand entries, or import a spreadsheet from another
collection tool.
Add one card
-
Open Add Cards, search for a card, choose the exact printing, then confirm the
preview.
-
Use set code and collector number when you care about the printing, for example fin
142. In a printing picker, Up and Down move from the filter into results. Focused
results support Up, Down, Home, End, and Enter or Space to select. Price refreshes
preserve the filter text, caret, and keyboard focus.
-
Set finish, condition, language, quantity, tags, and container before committing the
card. Changing printing or language preserves your quantity draft, condition, tags,
container choice, new-container text, and keyboard focus.
Paste shorthand
-
The text add flow accepts compact lines such as two fin 142 foil lp in breya deck.
-
Biblioplex parses quantity, set, collector number, finish, condition, language, and
container when it can.
- If a line is ambiguous, choose an exact printing before saving.
Import a spreadsheet or list
-
The import tab leads with how you're bringing cards in: upload a file, paste a list,
or start from a provider link. Picking one reveals just that input; a compact what
can I import? panel next to it lists the supported fields, two working examples, and
a downloadable template CSV.
-
Switching import sources keeps the text and link you've entered in the open form. A
failed provider fetch keeps the link so you can correct or retry it; a successful
import clears it. While a file or provider import is running, the form prevents
another submission. The upload area also opens the file picker with Enter or Space
when focused.
-
Paste or upload spreadsheet exports from tools such as Moxfield, Manabox, Deckbox,
or Biblioplex's own export format. Biblioplex detects common headers automatically.
-
If the headers aren't recognized, Biblioplex asks you to match each column to a
field once, showing a sample value from the first row. That mapping is remembered by
column name, so importing the same spreadsheet shape again skips the question even
if its columns move. Older saved mappings may ask you to match the columns once
more.
-
Before you confirm, the preview breaks rows into add, merge quantity, and needs
attention, with a status next to each row. Choose whether cards already in your
collection get their quantity added to or are left alone, and override that choice
per row.
-
Confirming shows a receipt: the add/merge/attention counts, any warnings, the
destination, and buttons to view the imported cards or undo the whole import in one
step. An import that changes nothing has no undo button.
- After import, Biblioplex fills in missing prices and search info when it can.
Scan cards
-
Open the scan tab and either use this device's camera or pair a phone by scanning
the QR code shown on desktop.
-
Every card scanned from a paired phone lands in a live session queue on desktop,
showing each card as pending, confirmed, corrected, or skipped, with running totals.
-
Phone-paired adds use the destination, condition, and tags currently set in the
desktop add session, not anything picked on the phone, so a whole stack lands in the
same container without repicking it per card.
-
Undo any confirmed or corrected entry from the session queue without touching the
phone, or use fix match on any entry to search for the right card and re-add it if
the scan matched the wrong printing.
-
The session queue stays populated if you close and reopen the add panel during the
same visit.
Storage And Containers
Track where cards live with containers, decks, tags, and bulk actions.
Containers
-
Collection shows what you own, Containers organizes where those physical copies are
stored, and Decks holds the lists you are building or playing. Each owned copy has
one physical location, while the same card can appear in several decklists.
-
The collection table's Location column includes both containers and decks. Container
counts describe physical copies. Deck sidebar and home counts describe required
cards (main, commander, sideboard, and pool), excluding the optional maybeboard; the
workspace's cards in list total includes the maybeboard. Sidebar count tooltips
explain which is being shown.
-
The Storage view is for container management: create, rename, color-label, choose an
icon, and manage containers. Icons can be a Biblioplex glyph, mana symbol, Magic set
symbol, or emoji. Related Magic products that belong to the same set family share
one set-symbol choice. Opening a container moves to the Collection tab scoped to
that container; use the quiet actions menu beside its heading to edit container
information.
-
Move copies to changes the physical location of owned copies; it does not add to or
remove from any decklist. Clear location leaves those copies unfiled. Deleting a
non-empty container likewise keeps its cards in your collection.
-
Every place you pick a destination container - adding a card, bulk-moving selected
cards, editing a card, moving a card from its row or location pill's right-click
menu, or importing - also lets you create a missing container inline with a name and
an icon. Confirming returns you to that same picker (or, from a right-click menu,
applies the move) with the new container selected and anything else you had set up
(like a pending bulk edit) untouched. Entering a name that already exists selects
that container instead of creating a duplicate.
-
The Storage home page stays a roomy card grid while you only have a handful of
containers. Once it grows past a handful, a sort and layout toolbar appears above
the cards: sort by name, recent, or value, and switch to a compact list for scanning
a lot of containers at once. Search (the sidebar search box) already filters storage
by name regardless of size. Your sort and layout choice is remembered on this
device. Deck and container home updates keep keyboard focus and unsaved create or
edit forms in place.
Container views
-
Your saved Collection views remain available while browsing a container, so you can
switch filters and layouts without creating a separate container default. Because
the page is already scoped, its cards and table do not repeat the current container
as a separate field.
-
Grid view shows cards as pages (4x3, 3x3, 2x2, or list) with filters for color,
type, search, sorting, and price; exploratory sort and filter views do not change
the saved slot layout.
-
List view is a dense, scoped inventory list for sorting, filtering, and bulk edits.
-
Leaving a container, deck, or collection view and coming back silently restores
where you scrolled to and which row you had open for that scope.
Bulk edit
-
Select rows in table view to move, tag, untag, correct condition, correct finish,
correct language, or delete many cards at once.
-
Bulk edits preview their pending action in the toolbar before they commit. The Save
button counts only selected cards visible under the current filters; it is disabled
when all selected cards are hidden.
- Use clear to leave selection mode without changing cards.
-
If a filter or search hides some of your selected cards, the toolbar states how many
are hidden with review and clear hidden actions. Bulk actions only ever apply to the
cards currently visible - hidden selections are never silently included. Sorting
never hides a card, so it never affects your selection.
-
Export selected opens the same export data flow used from the account menu, scoped
to your selection (still only the visible, non-hidden cards).
-
On desktop, you can also drag a card row - or your current selection - onto a
container or deck in the left sidebar to move it there in one step. This is a
shortcut for the same move, not a separate one: it still only moves the visible,
non-hidden cards, and dropping outside a real container or deck does nothing. The
"move to..." menu and keyboard selection remain fully supported.
Decks
Plan decklists, track owned copies and physical contents, check formats, and export
lists.
Create and open decks
-
Use Decks to create a deck, then open its workspace. Its decklist describes the
plan; owned copies can stay in a binder, another deck, or this deck's physical
location.
-
When adding a card to a deck, choose decklist only to add the requirement without
changing owned inventory. The action then reads add to decklist. With that option
off, add to decklist + collection also records new owned copies at the selected deck
location; it does not move existing copies. A deck card's record an owned copy
action likewise records additional inventory. To relocate a copy you already own,
use move copies to from Collection.
-
Removing a card from a decklist or moving it between list sections leaves physical
inventory unchanged. Build mode shows matching copies owned across the collection
and, separately, all copies physically stored in this deck, including extras outside
the list. Owned counts may include copies in other decks: decklists do not reserve
cards. For example, one Sol Ring can satisfy the owned check for two planned decks,
but it still has only one physical location.
-
Decks can include maindeck, sideboard, maybeboard, and commander cards where
supported by the workspace.
-
Deck history tracks meaningful edits so recent changes are visible. Open the history
panel from the footer while a deck is open and it scopes itself to that deck.
-
The Decks home page stays a roomy card grid while you only have a handful of decks.
Once it grows past a handful, a sort and layout toolbar appears above the cards:
sort by name, recent, or value, and switch to a compact list for scanning a lot of
decks at once. Search (the sidebar search box) already filters decks by name
regardless of size. Your sort and layout choice is remembered on this device. Deck
and container home updates keep keyboard focus and unsaved create or edit forms in
place.
Import a decklist into a new deck
-
Choose import when creating a deck, then paste a decklist or a provider URL
(Moxfield, Archidekt, MTGGoldfish, and similar). Leave add these cards to my
collection unchecked for a list-only import, or check it when the imported printings
should also become owned collection cards.
-
Provider imports bring over the deck name, description, and format whenever the
source supplies them. A source description that only repeats the detected format is
omitted. Main deck, sideboard, commander/companion, and maybeboard cards keep their
quantities and separate boards. MTGGoldfish URL imports recognize its blank-line
sideboard separator; pasted lists should use explicit section headings or SB:
prefixes.
-
When the source omits the format, Biblioplex makes a best-effort inference from
commander markers, deck size, copy counts, and resolved card legality across the
main deck and sideboard. It tries Standard, Pauper, Pioneer, Modern, Legacy, then
Vintage for 60–80-card constructed lists and labels the result inferred in the
review. Source formats always take priority; incomplete or uncertain lists remain
unset. You can correct the format in Edit details after importing.
-
Before the deck is created, a review screen shows what was detected: commander and
partners, format, maindeck/sideboard/maybeboard totals, unknown cards, unspecified
printings, and duplicate lines.
-
Source-selected sets and collector numbers are preserved when available. MTGGoldfish
imports use the author's saved versions when Use Specific Card Versions is enabled,
not the site's automatically displayed cheapest versions. A neutral printing not
specified label means the source only provided the card name; Biblioplex selects a
default printing that you can change after importing. An explicitly requested
printing that cannot be matched remains a warning instead of being silently replaced
by another edition.
-
Nothing is created yet at that point. Go back to edit the pasted list or URL and try
again, or confirm to create the deck with those cards. After a successful import,
Biblioplex adds the deck to Decks, opens its workspace, and records both its total
card count and unique-card count in history.
-
If any card cannot be resolved, confirmation stops without creating a partial deck
or adding owned copies. Correct the unknown card or retry the lookup instead of
losing it silently.
-
Closing or canceling the review leaves your collection and deck list exactly as they
were - there is no partially created deck to clean up.
Build and review
-
Open deck details retain unsaved fields and keyboard focus during collection
refreshes. Use the single workspace bar to move among Stacks, Gallery, Decklist,
List, Stats, Sample hand, and Notes. Stacks, Gallery, and Decklist add a contextual
row with Group by, Sort within, and View settings. Group by type, mana value, color,
color identity, rarity, first tag, or none, then sort by name, mana value, or price.
Sparse neighboring mana-value stacks share a column automatically while tall stacks
and lands keep their own columns.
-
The deck header has one quiet summary for cards, lands, average mana value, and list
value. Turn on Build mode in the workspace bar to add ownership counts, missing-card
tools, physical locations, and owned value. Ownership details expands the physical
count, owned value, and how shared copies are counted. Legality is stated against
the current format rules: an older Standard list can identify cards outside the
current format without claiming that Biblioplex knows the deck was once legal.
Expand the issue summary for the full explanation. Use show cards beside an illegal
status to highlight and move to the affected cards. On desktop, the preview beside
the deck keeps the selected card's printing, rarity, finish, condition, language,
treatments, promo types, and tags visible whenever those details are available;
click it to open the full card drawer, or use flip card for a double-faced card. In
visual and gallery views, cards with multiple copies have a numbered tab on their
left edge; single-copy cards have no tab. Foil and etched cards use the same visible
material treatment as other card surfaces without placing a finish label over the
artwork.
-
In every deck format, the visual stacks give the maindeck the full workspace width.
A non-empty sideboard follows underneath as a single stack, while an empty
maybeboard stays hidden until cards are moved into it. Non-empty maybeboards and
Limited pool sections also follow underneath the maindeck. Small, medium, and large
set fixed, predictable stack sizes on desktop; narrow screens may compress them to
avoid overflow. Biblioplex adds another column only when it meaningfully shortens
the tallest stack, otherwise neighboring groups share a column at the selected size.
-
New decks start on Standard and can also use Custom for kitchen-table or otherwise
nonstandard lists. Use format selection to check legality for Commander, Standard,
Pioneer, Modern, Legacy, Vintage, or Pauper. Commander decklists show the commander
in a dedicated Commander category.
-
Decklist mana costs use card-symbol glyphs. List view uses deck-specific columns for
quantity, name, mana cost, type, mana value, set, finish, price, and tags. Stats
includes curve, rarity, composition, pips versus colored lands, full-list and owned
value, and the ten most expensive cards. Sample hand shows lands drawn, expected
opening-hand lands, play/draw position, and London mulligans. Keyboard focus stays
on its controls after drawing or mulliganing. Draw is disabled when the library is
empty, and decks without maindeck cards show an empty-hand message.
Export and share
- Export decklists for external tools from the deck workspace.
-
Share creates a read-only snapshot link for a deck or collection view without giving
edit access.
-
While a share link is being created, repeated creation is disabled and you can still
close the dialog. The new URL is selected for copying when creation finishes.
Opening a shared link shows a focused read-only view: a banner across the top names
what is being shared and when it was updated, and the table or card view fills the
width. Exit in that banner returns you to your own collection. Shared decks carry
the full list's prices, mana costs, and legality; on a phone they open directly in
decklist view with one compact view picker.
-
Shared snapshots omit row selection and every editing action, including move,
add-copy, and delete controls in card details. You can still browse card details.
The sidebar and user account actions stay hidden; what you are signed in as does not
change what a shared link shows, and viewing one never touches your own collection.
Ownership and missing cards
-
The deck header shows an owned count against the maindeck total. When every card is
on hand it reads as a plain count; when cards are short, it becomes an "N/total
owned · M missing" button.
-
Opening it lists what's short, grouped into not owned, a different printing owned,
and ambiguous (several other printings owned) - each entry explains the match, like
owning a copy in another container under a different set.
-
From there you can point the deck at a printing you already own, choose which owned
copy to use when more than one qualifies, or mark an entry as leave missing to quiet
it until something changes. For commanders and partners, changing to an owned
printing updates the command-zone card and deck header together; editing other deck
details keeps an already-tracked printing unless you change the card itself.
-
Buy missing opens the current missing quantities in TCGplayer Mass Entry. Copy list
puts the same plain-text quantities and names on the clipboard for another store or
a manual order.
Sync, Backup, And Account
Your collection lives in your account in the cloud. This browser keeps a fast read copy
so the app opens instantly.
Data on this device
-
Your signed-in collection is stored in the cloud; this browser keeps a read copy to
speed up repeat visits. Startup confirms your account and sync connection before
enabling edits. Chat and some dialogs prepare when you first open them after loading
the page, so opening them may take a moment on a slow connection.
-
Editing needs you to be signed in and online. Signed in but offline, you can still
browse the cached read copy, but changes are disabled rather than saved somewhere
risky.
-
A save either reaches the cloud while you watch or fails with a clear error - there
is no background queue, so what you see after a save is what is stored.
-
Signing out clears the read copy from this browser, and opening Biblioplex while
signed out shows the signed-out demo instead of your last collection. Nothing is
lost - your collection lives in your account, and signing back in restores it from
the cloud.
-
Use export data before signing out or clearing browser data if you want a portable
copy on hand.
-
Signed out, the account chip reads "demo - not saved" while the welcome
demo is loaded; signing in replaces the demo with your account collection, and demo
cards are never saved. If you try an edit in the demo, Biblioplex reminds you at
that moment that the change is temporary. Empty signed-in collections show a zero
state, with add and import available from the normal app controls.
Account sync
-
The sidebar account menu stays compact: it shows your full account name, then
Account, Settings, Export data, and Sign out. Routine sync status is kept out of
this menu.
-
When you are signed in, Biblioplex keeps changes in sync across your signed-in
browsers. Everyday edits sync incrementally - only the change itself travels, not
your whole collection.
-
Card art, prices, and printing details are not carried in the cloud copy. Tomebound
refreshes that metadata silently from Scryfall after you sign in; known printings
can display artwork directly while the refresh is still running.
-
Signed-in users manage personal access tokens from the Account section in Settings,
keeping this less-common tool out of the main account menu (see Automation and
integrations).
-
If two devices edit the same card at the same time, Biblioplex tries to protect the
newer work instead of silently overwriting it.
-
During temporary signed-in connecting, offline, or bootstrap-error states, Add and
row-selection controls remain in place so the page does not jump, disabled while
writes are blocked and re-enabled in place on recovery. Startup, account
restoration, and brief connection hiccups stay silent: a connection problem waits
about eight seconds before it says anything, so a momentary drop that fixes itself
never interrupts you. If it lasts, one banner across the top explains the situation
and offers Retry sync. A change that actually failed to save says so immediately,
and that message stays until you dismiss it or a later change saves. Only shared and
signed-out demo views omit mutation controls.
-
Background prices, Scryfall metadata, set icons, search indexing, and remote
revisions never reorder or rebuild the screen you are currently using. Routine
background work stays silent and applies at your next explicit route, view, filter,
sort, reload, or mutation boundary. Automatic card-detail backfills do not flash a
separate progress message.
-
A failed sync always shows as an error banner - there is no silent queue - while
routine successful syncing stays out of the way.
-
If sync looks stuck, copy the support details from settings and include them with a
bug report.
Collection size limits
-
Collections up to about 50,000 cards sync comfortably. Cloud storage does not refuse
saves by size, and everyday edits transfer only the change itself.
-
Cloud storage is not presented as a quota you need to manage; at this scale, the
practical limit is the browser's memory rather than a sync meter.
-
The first sync on a new device still downloads the whole collection once; after
that, updates arrive incrementally. Beyond roughly 50,000 cards the practical limit
becomes your browser's memory, not the cloud.
Backups and recovery
-
Export data asks for a scope every time - entire collection, only the cards matching
your current filters, or just the cards you have selected - so a stale filter can
never quietly produce a partial file you mistake for a full backup. It also
remembers the format you last used and shows a receipt with the count, format, and
filename after the download.
-
Biblioplex JSON, the full portable backup with containers, decks, tags, and saved
history, is only offered for the entire-collection scope; the CSV formats support
all three scopes.
-
To restore a Biblioplex JSON backup, sign in, open Add cards, choose import, then
upload a file. The preview shows its card, container, and history counts and offers
a download of your current collection first. Check the replacement box and choose
restore backup. This replaces your account collection across devices; cancel leaves
it unchanged.
-
JSON backups must be smaller than 8 MB and fit your account storage limit. Stay
online during restoration. If your account or collection changes while the preview
is open, close it and open the file again to review the current state.
-
History and recovery points can help undo big changes, like deleting cards or
replacing your collection.
-
Delete everything intentionally clears collection, decks, storage, and history for
the current browser state.
Collection Chat
Ask natural-language questions and stage edits through the chat surface.
Ask questions
-
Use collection chat to ask about cards, prices, containers, tags, deck contents, and
collection summaries. Questions about the most recently added or acquired card use
its latest acquisition timestamp, while recently changed or moved questions use edit
history instead.
-
Consult the tome answers questions using the current collection and may return cards
you can open in the app. While a response is being prepared, Consulting the
collection appears with three stars; the stars stay still when reduced motion is
enabled.
-
Chat opens in a compact panel. On desktop, drag the Consult the tome heading to move
it and drag an edge or bottom corner to resize it. The panel stays inside the screen
and remembers its position and size; temporarily shrinking the browser does not
replace your saved dimensions. Closing chat preserves your unfinished message. Reset
chat appears after a conversation starts and clears the conversation, unfinished
message, and any pending previews.
-
Choose a suggested question to send it, or write your own message and choose Ask.
Enter sends; Shift+Enter adds a new line.
-
Collection chat requires signing in — opening it while signed out disables the
message box and shows a sign-in reminder inside it.
Preview edits
-
For risky changes, chat creates a preview instead of immediately editing your
collection.
-
Previews appear as proposed amendments. Review each entry, then choose Apply changes
or Discard. With multiple entries, Apply all changes applies the group after
confirmation; Discard all clears the pending previews.
- Exact card additions may ask for a printing when the request is ambiguous.
Before changes happen
- Chat can suggest changes, but risky edits wait for your approval.
-
Biblioplex checks that you are still signed in and allowed to make the change before
applying it.
-
When possible, Biblioplex creates a recovery point before applying a chat change.
Automation And Integrations
Work with your collection outside the app: a command-line tool, agent access over MCP,
and personal access tokens.
Command line (CLI)
-
Biblioplex has a command-line tool, biblioplex (short alias bp), for managing your
collection from a terminal.
-
Install it with npm install -g biblioplex or brew install benson/tap/biblioplex,
then run bp login to sign in.
-
It can search, add, edit, move, import, and export, and prints machine-readable
output with --json plus meaningful exit codes for scripts and agents.
Agents and MCP
-
Biblioplex exposes an MCP server so external AI assistants can read your collection
and stage changes.
-
Like collection chat, agent edits are previewed and need your confirmation before
anything is written, and a recovery point is created before each applied change.
Personal access tokens
-
For headless or automated use without a browser sign-in, create a personal access
token from the Account section in Settings while signed in.
-
Use it with the CLI or an agent by setting the BIBLIOPLEX_TOKEN environment
variable.
-
Tokens carry read-only or read-and-write access and can be revoked at any time.
Preferences And Troubleshooting
Adjust the interface, load test data, and get unstuck.
Display preferences
-
Settings include theme, text case, text size, table-cell wrapping, anonymous
analytics and session-replay controls, copyable support details, and signed-in
access-token management. Book is the default appearance, with paper, cloth, and
ornamental headings. Choose Light or Dark in Settings for a simpler surface;
switching themes keeps your current collection view.
- Preferences are stored locally in the browser.
-
The layout adapts across desktop and mobile, with drawers and floating actions
replacing sidebars on small screens.
Analytics and session replay
-
For the US service, anonymous PostHog product analytics and session replay are on by
default to help find confusing interactions. Analytics requests are routed through
the first-party domain t.bensonperry.com before PostHog Cloud US processes them.
Biblioplex does not attach your Clerk account identity or email to PostHog and does
not create a PostHog person profile.
-
Replays can include the Biblioplex workspace you see and use, including card and
deck names, searches, container names, imported text, and form values. Account and
Clerk authentication surfaces and password fields are excluded; URL query strings,
console logs, network bodies, error capture, and performance capture are not
collected.
-
Open Settings to turn analytics and replay off or back on for this browser. A
supported Global Privacy Control or Do Not Track browser signal keeps them off
automatically.
Test data
-
Reset test data loads a representative sample collection for development and demos.
- Use it only when you are comfortable replacing the current local state.
When something feels wrong
-
Check whether filters, search, or format legality are narrowing the current view.
- Use clear all filters to get back to the full collection.
- Copy the support details from settings when reporting a bug.