Help

Getting started

Collectro keeps track of the games, consoles and other things you collect. A first pass, in about five minutes:

New account? Getting started sets the item types you track and names your first collection.

Rather not type? Add can also read a photo of a shelf (Photo import) or load a JSON file (JSON import and export).

Your list

Items is your whole collection. The buttons at the top switch between a list and a grid, and the sliders open two sheets:

  • Filter narrows the list by status, type, console, region, condition, variant, media and location. Active filters show as pills you can remove one by one, and Clear all takes out the rest.
  • Display picks the view, the sort (title A–Z or Z–A, newest or oldest), how the list is grouped, and which extra columns show (image, status, condition, location, region, variant, console, media).

Grouping can stack: group by Type, then by Collection inside it, and so on. Groups collapse, each with a count of what is inside. Your filters and layout are saved with your account, so they come back on any device you sign in on. The title box on the toolbar narrows the rows already shown, and Show more at the bottom brings in the next batch.

Wishlist

The heart at the top of the list (on a phone: Wishlist only in Filter) is not a filter — it switches the whole view to your wishlist. The filters that were set are remembered and come back when you tap it again.

Bulk editing

Hover a row to reveal its checkbox (on a phone: Select items in Display, or swipe a list row right; the grid has no swipe); a group's header has one that takes the whole group, and swiping it right works in the grid too. The bar at the bottom then moves the selection to a collection, sets its status, condition, console or region, or deletes it — deleting asks first.

Collections

Collections lists yours, each with a count of the items you own in it. Create one there; the ⋮ menu on a card renames or deletes it (deleting asks you to type the name).

Import groups

After you add or import, the list opens grouped by that import, showing everything it created or updated. Import is also one of the group-by options, with a group per import and its date — handy for reviewing or undoing a batch.

The search box in the header is something else again: it looks through everything you own, items and collections, from anywhere in the app. The title box on the list only narrows the rows already shown.

Adding items

Add is one page. Type items into the rows below, or use the section above them: Take photo (on phones and tablets), Upload photo, Upload file (a JSON file) or Paste JSON.

  • Each row is a type and a title. Pick a suggestion from the catalog and the row is linked to that record: a green check appears on the title and its cover to the left. A game's console is optional.
  • The suggestions are forgiving: every word you type has to be in the title, in any order and without punctuation, so super mario 3 finds Super Mario Bros. 3. Add a console to the words (kirby snes) and only that console's games are listed. Results sit under their region, your default region first (Settings → Titles and region, NTSC-U unless you change it).
  • A type with an online lookup (Books, Music, Funko Pop, LEGO and others) can narrow its suggestions: add key:value words after the title, like dune publisher:ace or thriller artist:"michael jackson" (quote a value with spaces). The keys each catalog understands: TMDB (year); TMDB (TV) (year); MusicBrainz (artist, year); Open Library (author, publisher, year, isbn); Rebrickable (theme, year); AmiiboAPI (series, character); Funko Pop data (series). The fields you have already filled on a row (an author, a year) narrow the suggestions the same way, and are dropped if they would find nothing. A book search by publisher or ISBN lists that edition (its own publisher, year and ISBN) instead of the book in general.
  • Add Another adds a row. Each row shows its common fields in a line of boxes; the + More button beside its remove (✕) opens the rest (status, collection, and the type's other fields). Under Change in the bar at the top, you set the type, collection and status for every row, and the console, region and condition of the game rows. Those fill a field on each row you haven't set yourself: a row you edited, or picked a title for, keeps its own value.
  • Every account starts with a Default Collection. New rows start in it, or in the collection you were looking at when you pressed Add. Change the default from the ⋮ menu on the Collections page. Pick another, or New collection…, per row. Rows without a title are skipped, and all the rest are added together or not at all.

Editing an item

Opening an item shows it as it sits on your shelf: the cover, its titles, what it is (console, region) and its facts. Press Edit at the top right to change anything on the same page — title, status, condition, location, notes and the type's own fields save as soon as you change them, so there is no save button to look for. Done goes back to the view, after anything still pending is saved.

  • The title box suggests catalog titles as you type; picking one re-links the item to that record — cover art and details come along — without touching your other fields.
  • In the view, tap the cover to see the original full-size. In Edit the buttons under the cover are Add photo / Update photo (a camera button on phones and tablets). When an item has both its catalog cover and the crop from an import, Artwork / Cutout picks which one shows, and the choice is remembered.
  • An item with no picture has a Fetch artwork button (in Edit) that retries the catalog lookup.
  • Filed under the wrong type? The type box beside Done moves the item to another of your types. Fields the new type does not have are cleared, and so is a catalog link the new type does not use; when anything would go, you are asked first.
  • An item from a photo import keeps its reference photo with the outline that found it, and a link to the import it came from.
  • Delete, at the bottom of Edit, removes the item after you confirm.

Photo import

On Add, Take photo or Upload photo starts with a question: what does the photo show? Pick Items on a shelf or in a pile, Objects or a source under Something on a screen, then Continue — nothing is scanned until you do. Rows you had already typed stay and are added along with the photo's.

  1. A shelf or pile: Collectro draws outlines around the items it finds. On a shelf photographed at an angle they run diagonally along the spines. Flip axes and Rotate 180° fix outlines that look sideways or upside down, Upload another photo starts over, and if nothing was found, a retry button re-runs the detection with a different model. Nothing is read yet, so this costs nothing extra.
  2. Continue to identification reads each title, console and condition, filling the rows in a few at a time. The same rows as on Add: a title that matches a catalog entry exactly is linked (the green check); a ? means no exact match, with Did you mean suggestions to pick from. Fix any title, console, region or condition, remove wrong rows, and tick update existing on a duplicate to update that item instead of adding a copy.
  3. Add to collection. Linked rows get their entry's cover art and details; the rest keep the title you confirmed, with no cover art until Fetch artwork on the item finds one.

Clear, well-lit photos with titles facing the camera read best. You can always correct a row before anything is saved.

When a read stops

Nothing is lost. The photo, the outlines and every edit are saved in the browser, so leaving mid-review and coming back puts you exactly where you were. If a read stops partway — a lost connection, or the photo reaching its spend limit, where Collectro asks before reading on — the rows that were not read stay marked unread: Read on a row reads it again, and Read remaining carries on from where it stopped.

Digital games and movies

For the types that can be read from a screen (Game and Movie, among others), Add offers one source under Something on a screen, named Digital Library: tap the type in its chip row, which is the type the screenshot fills. Take or upload a screenshot, or a photo of a screen, of a library or store page (Steam, Xbox, PlayStation, Switch, a movie app…) and every title on it is read in one go: no outlines to check. The rows arrive as Digital, and for games the platform of the page fills each row's console (Steam, Epic and GOG are PC). Check the rows as usual, then add them; the screenshot itself is not kept on the items. A screenshot lists about 60 titles at most, so a long library takes a few screenshots. Digital items of other types are added by hand.

When the game database has no record for a title, Collectro asks a backup source: an exact match links the item and gives it its cover art; otherwise the backup's records are offered as suggestions. The same backup fills the title suggestions when you type a game the database does not know.

Settings → Imports keeps a history of every import you have run, with how each went — how many titles were found and how many you had to fix — and each entry links back to that import's group in your list.

JSON import and export

Settings → Reports & tools → Export downloads your items as a JSON file — all of them, or part: the export has a checkbox per collection, and none ticked means everything. Add (Upload file or Paste JSON) accepts the same shape, so you can edit an export and apply it back, or write a file from a spreadsheet. Each item carries: id, kind, title, title_en, media_type, console, collection, status, condition, location, notes and attributes. Photos and catalog links are not part of the file.

Create items

{
  "version": 1,
  "items": [
    {
      "kind": "game",
      "title": "The Legend of Zelda",
      "console": "Nintendo Entertainment System (NES)",
      "collection": "Video Game Collection",
      "status": "owned",
      "condition": "CIB",
      "location": "Shelf 2",
      "notes": "Gold cartridge",
      "attributes": { "region": "NTSC-U" }
    }
  ]
}

Update items

An item with an id is updated; only the keys you send change.

{
  "version": 1,
  "items": [
    {
      "id": "11111111-1111-4111-8111-111111111111",
      "status": "sold",
      "location": null,
      "attributes": { "region": "PAL" }
    }
  ]
}
  • collection and console are matched by name (case-insensitive). Use the console's full name, exactly as an export shows it. Collections must already exist.
  • attributes merge per key on update. Unknown keys, or select values that are not one of the options, are rejected.
  • condition and media_type fill the type's Condition and Media fields. Missing parts are attributes.parts, a list of the missing ones (for games missing_manual, missing_cart_disc and missing_extras still tick Manual, Cart/Disc and Extras).
  • lookup (<provider>:<id>, as an export writes it for a linked item) links the item to a record of its type's lookup provider and sets its cover and mapped fields from it; values you list in the same item win.
  • null clears a field, except title. kind cannot change after creation.
  • source, source_id, game_id, artwork_url and photos are filled in by the app and rejected if you send them.
  • A file is applied all-or-none (up to 200 items): if any item has an error, nothing is changed and every error is listed.

Item types

Every item has a type: Game, Console, or another the administrator has added. Settings → Item types lists them.

  • Turn off a type you do not collect: it leaves Add, photo import and the Type filter. Items you already have of it stay in your lists.
  • Each type's page edits it: the name (and its plural), and its fields — your own (text, a number, a choice from a list, a checkbox, a date, or a checklist of several), or a standard field the app knows how to use: Condition (its options are your conditions), Media (formats), Missing parts (the parts a copy can lack, ticked when missing), Title (English), Console (each item names a console, like a game or a controller), Region and Variant.
  • Online lookup on a type's page finds its titles in an online catalog while you add them: picking a suggestion fills the title, its cover and the fields you choose to map (a release year into a number field, genres into a text field). Lookups use the app's shared key, up to a monthly limit per person.
  • Export on a type's page saves it as a file. Your items are not in the file.
  • Photo import (advanced) on a type's page teaches the photo import about it: a hint on what to look for in a shelf photo, a hint on how to read one, and which of the type's fields the read fills in (a series, a number of pieces…). The hints are added to the built-in instructions, never replace them. Whatever was read shows under the row on the review screen.
  • Digital is an option of a type's drop-down: Media on a Game, Format on a Movie, TV show, Music or Book. Picking it hides the fields that only fit a physical copy (Condition, Missing parts, Disc region, Speed, Pressing); what you typed there is kept. Add rows has a Digital checkbox per row, and a digital item shows a download symbol in the list.
  • A type can be deleted once none of your items use it.

Install as an app

Collectro is an app as well as a website: installed, it opens in its own window, without the browser around it. Settings → App has the install (the exact steps depend on your browser) and shows the version you are on, with Check for updates and Reload. On a phone, Items also offers an install card now and then; Not now puts it off for two weeks, and the second time for good — Settings → App always has the install.

When the app itself has an update, a bar at the top says a new version is available: tap Reload and you are current.

Your data

Your collection and photos are stored by this app, not shared with anyone, and there is no advertising or tracking. A few outside services help with photo reading and catalog lookups, and only for the things below.

Vision AI (via OpenRouter)

Reads your photo during photo import. The model is your choice in Settings; OpenRouter passes the request to that model’s provider (Google, Z.ai or Qwen).

What it receives: The photo you import, and cropped pieces of it, only when you run a photo import.

TheGamesDB

Matches a game title to a catalog entry: cover art, genres and release details. Also the source of the console pictures shown in your lists.

What it receives: The game title and console, when an item is matched. Results are saved so each title is looked up once.

RAWG

A backup source for matches TheGamesDB does not have.

What it receives: The game title.

TMDB

Finds movies and TV shows, with posters and details.

What it receives: The title you type, when you look up a movie or TV show.

MusicBrainz and Cover Art Archive

Finds albums and their covers.

What it receives: The album or artist you type, when you look up music.

Open Library

Finds books and their covers.

What it receives: The title or ISBN you type, when you look up a book.

  • Cover art and console pictures are downloaded once by the app and stored with your data, so your browser never loads images from the catalog's servers and they never see you viewing one.
  • Cover art, genres, release details and console pictures come from TheGamesDB, a community-built game database. Every source is credited on the Data sources page.
  • Your photo is saved with the imported items only if you tick Keep the photo as a reference on every imported item in the import preview.

FAQ

What do the regions mean?

Regions follow the catalog's scheme: NTSC, NTSC-U (US), NTSC-C, NTSC-J (Japan), NTSC-K, PAL, PAL-A, PAL-B and Other. Imports pre-fill the region from the catalog match, otherwise NTSC-U (NTSC-J for Japanese titles). Change it in the preview if your copy differs.

What happens to edition text like “Player’s Choice”?

Edition text printed on a box is saved in the item's notes, so it stays with your copy without changing the game's title.

An item has no cover art or the wrong match. What now?

Open the item. Use Fetch artwork to retry the lookup, or pick the right catalog entry in the item's catalog link — Editing an item has the details.

Can I back up or move my collection?

Yes. Settings → Reports & tools → Export saves your items as a JSON file that Add can load again. Photos are not included in the file.

Can I delete my account?

Yes, in Settings → Delete account. It asks for your password and a confirmation word, because it is permanent: your account and all your collections, items and photos go, and cannot be brought back. Export first if you want a copy.

How long do I stay signed in?

Each browser stays signed in for 30 days. Settings has Log out for this browser and Log out everywhere for all of them, and you can change your password there too (other devices are signed out when you do). After several wrong attempts on an account the sign-in form locks for 15 minutes.

I forgot my password.

Use Forgot password? on the sign-in page and a reset link is emailed to you. If no email arrives, this app may not have email set up — ask the administrator, who can also hand you a set-a-new-password link directly.

Who can see my collection and photos?

Only you, inside the app: collections, items, photos and imports belong to your account and are never shown to other users. Shared catalog data (consoles, game records, cover art) is the same for everyone. The person who runs this app has access to the server and database, so they can technically see stored data; they use that only to look after the app.

Why did photo import stop with a message about credits?

Reading photos uses a paid AI service, so every account gets 50 credits to spend on it (1 credit is about 1¢ of AI cost). A long import can use a good few: when a photo reaches its spend limit, Collectro asks before reading on. Settings shows how many you have left and Settings → Usage shows where they went, import by import. Credits do not refresh; ask the administrator if you need more.

Can I use light or dark mode?

Yes. Settings → Appearance lets you pick light, dark, or follow your device. The choice is saved on that device.

Something is broken, or I have an idea. How do I tell you?

Use Report an issue in the ⋯ menu at the top right (on a phone, the flag button in the header). Say what happened and, if it helps, attach a screenshot. The page you were on, the app version and your browser are sent along, so there is no need to describe them.