Biblioplex Help

Collection Basics

Use the collection view to scan, search, sort, edit, and price your singles.

Table and visual views

The collection view has a table mode for dense editing and a visual mode for browsing card images.
Sort the table by name, set, collector number, finish, rarity, condition, location, quantity, or price.
Open a card from either view to edit its print, finish, condition, language, tags, notes, quantity, and location.

Search and filters

Plain text searches card names. If you type more than one word, each word must match.
Use filters for set, rarity, finish, location, tag, and format legality.
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 location, and loc:none for cards with no location.
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.

Totals

The footer summarizes the current collection or view with unique cards, total quantity, estimated value, containers, or deck counts.
Prices come from Scryfall data when available and are estimates for collection management, not financial records.

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.
Set finish, condition, language, quantity, tags, and location before committing the card.

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 location when it can.
If a line is ambiguous, choose an exact printing before saving.

Import CSV

Paste or upload spreadsheet exports from tools such as Moxfield, Manabox, Deckbox, or Biblioplex's own export format.
Biblioplex detects common headers and imports entries with at least a card name plus enough printing detail to resolve the card.
After import, Biblioplex fills in missing prices and search info when it can.

Storage And Organization

Track where cards live with containers, decks, tags, and bulk actions.

Locations

A location is either a deck or a container. Containers can open as a list or grid.
The Storage view lists your containers and lets you create, rename, inspect, and organize them, and you choose a default view when you create one.
Moving a card updates its collection entry and the relevant container views. Deleting a non-empty container clears the cards' location but keeps the cards in your collection.

Container views

Each container has a default view, and you can switch views while browsing it.
Grid view shows cards as pages (4x3, 3x3, 2x2, or list) with filters for color, type, search, sorting, and price; grid order is kept separate from exploratory sort and filter views.
List view is a dense, scoped inventory list for sorting, filtering, and bulk edits.

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.
Use clear to leave selection mode without changing cards.

Decks

Create deck containers, build lists, check formats, and export decklists.

Create and open decks

Use Decks to create a deck container, then open its workspace.
Decks can include mainboard, sideboard, maybeboard, and commander cards where supported by the workspace.
Deck history tracks meaningful edits so recent changes are visible.

Build and review

Cards can be grouped by type, mana value, color, or rarity.
The deck workspace shows counts, legality cues, deck details, sample hands, and card previews.
Use format selection to check legality for Commander, Standard, Pioneer, Modern, Legacy, Vintage, or Pauper.

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.
Shared snapshots hide editing controls and user account actions.

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 for instant loading.
Editing needs you to be signed in and online. When you are signed out or offline you can still browse the cached 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.
Use export data before clearing browser data if you want a portable copy on hand.

Account sync

The account menu shows sync status, sign-in controls, import/export, settings, and support details.
When you are signed in, Biblioplex keeps changes in sync across your signed-in browsers.
The account menu also creates personal access tokens for the command-line tool and agents (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.
If sync looks stuck, copy the support details from settings and include them with a bug report.

Collection size limits

Collections up to about 10,000 cards sync comfortably. Cloud storage no longer refuses saves by size - the old too large sync error is gone for normal use.
Open "how sync works" from the account menu to see storage used. The gauge is informational now rather than a wall you can hit.
Well beyond 10,000 cards, syncing a whole collection from a new device can get slow, because some operations still transfer the full collection. Speeding that up is planned.

Backups and recovery

Export data gives you a portable copy of the current collection.
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, locations, tags, deck contents, and collection summaries.
Chat answers use the current collection and may return cards you can open in the app.

Preview edits

For risky changes, chat creates a preview instead of immediately editing your collection.
Review the preview, then apply or discard it.
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 menu.
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 text case, text size, how compact the interface feels, and how drawer tabs look.
Preferences are stored locally in the browser.
The layout adapts across desktop and mobile, with drawers and floating actions replacing sidebars on small screens.

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.