Repository navigation
Collections
Collections are the core of Tonkatsu Box - lists of items (games, movies, shows, etc.) that you organize, rate, and track.
The Collections tab shows all your collections as visual cards.
A grid card throws up to eight covers into a casual pile - every collection keeps its own stable arrangement, so a card always looks the same - and the pile gathers into a neat cascaded deck on hover or gamepad focus. The top cover carries a +N badge for the items beyond the visible ones.
Under the name sit the item count and two markers of what is inside:
- Colored dots - one per media type in the collection, dominant first, overlapping like an avatar stack. Past five types the rest collapse into a "+N" dot. Rich cards and the list view show the same dots.
- A spectrum strip - a thin bar under the stats where each media type takes a slice sized to its share of the collection, like a language bar on a code repository.
- Go to Collections tab
- Tap + New Collection
- Enter a name (e.g. "SNES RPGs", "2025 Watchlist", "Studio Ghibli")
- Optionally tick Hidden collection - see below
- Done - the collection is ready, start adding items
Hidden collections
A collection can be marked hidden when you would rather not delete it, but also would rather not see it - a gift list, a guilty-pleasure shelf, anything you do not want on screen when someone looks over your shoulder.
Mark it hidden in one of three places:
- the Hidden collection checkbox in the New Collection dialog,
- the same checkbox in the Edit dialog,
- right-click (or long-press) the card → the hidden toggle.
What changes:
- The card shows a placeholder instead of the cover mosaic - and a hidden collection always uses the classic card, never a hero image.
- Its items drop out of the All Items screen and out of the preference cloud.
What does not change: the collection keeps its name and count in the list, opens normally, stays a target in every collection picker, still counts in Statistics, and exports without the flag. Toggling applies instantly, in both directions. A full backup remembers which collections were hidden and re-hides them on restore.
- Go to Search tab
- Find a game, movie, or show
- Tap the result → tap Add to Collection
- Select which collection (or create a new one)
You can add the same game to a collection multiple times with different platforms. For example, add Final Fantasy VI for both SNES and GBA.
When selecting a platform, already-added platforms are marked with a ✓ checkmark. Adding the same game on the same platform is blocked (duplicate), but different platforms are allowed.
On the Canvas board, each platform version appears as a separate card.
- Download a
.xcollxfile from tonkatsu-collections - In the app: Collections → Import → select the file
- The entire library imports with covers and metadata
The default view. Items displayed as a visual grid with cover art. Tap any item to open its details.
The title sits under the artwork in a block of fixed height, together with its meta line - rating, platform, year, type, genre. The poster itself stays clear, and cards in a row line up however long the titles are. A long name is cut with an ellipsis; the full one comes up as a tooltip.
The meta line opens with the logo of the source the entry came from - AniList, MangaDex, IGDB, TMDB, TheTVDB and the rest - so it is clear at a glance where a title is tracked. Clicking the logo opens that title's page on the source in a browser; local and custom items keep the logo as a plain marker.
What stays on the poster is a thin translucent strip along the bottom: the status dot and tag on the left, the progress and its bar on the right. For an item with none of them the strip disappears entirely and the poster is bare.
This is the same card everywhere it appears - the collection grid, All Items, Search and Browse.
A vertical list with larger tiles showing the cover, title, subtitle, ratings, description, and comments. Best for browsing with more detail per item.
A spreadsheet-like view with compact rows and columns: name, media type, platform, status, rating, release year, tags and favorite. Ideal for large collections where you want to sort and compare a lot of items at a glance.
You can drag columns to reorder them, drag their edges to resize, and hide the ones you don't need. Column order, widths and which columns are hidden are remembered for each collection separately.
Two buttons sit above the table:
- Filters opens a rule editor. Each rule is a column plus a condition plus a value, and rules combine with AND. Status picks from a dropdown of the statuses you actually use; other columns take text conditions like "contains". On a narrow screen each rule stacks vertically so the controls stay readable.
- Columns toggles which columns are shown.
Click a column header to sort by it. Editing happens right in the row - rating stars, status, favorite and tags - and there's a checkbox column for selecting rows (see Bulk actions below). To open an item, single-tap its name or double-tap anywhere on its row. Switch the collection to manual sort and a drag-handle column appears on the left so you can reorder rows by dragging, touch included.
Use the view toggle button in the collection toolbar to cycle between views: Grid → List → Table → Grid. The icon changes to show which view comes next.
A free-form canvas where you drag posters, add text notes, images, and draw connections between items. Great for franchise maps, "if you liked X try Y" boards, or visual backlogs.
Each item in a collection has a status:
| Status | Meaning |
|---|---|
| Not Started | Haven't touched it yet |
| In Progress | Currently playing / watching / reading |
| Completed | Finished |
| Replaying | Going through a finished title again (Rewatching for movies / TV / anime, Rereading for manga & books) |
| Dropped | Gave up |
| Planned | Want to play / watch later |
| Ignored | Kept in the library, parked on purpose |
Change status by tapping an item → status selector at the top of the detail screen. Replaying leaves the started and completed dates alone, so the item stays finished.
Ignored works like any other status: pick it on the card, in the table cell or from the bulk menu, filter by it, and see it in the collection statistics. It keeps the dates untouched, sorts last, and an import or a tracker sync never pulls an item out of it. See Item Details for the rewatch counter that pairs with it.
Rate any item from 1 to 10. Your personal rating is stored separately from the API rating (IGDB, TMDB). You can sort by either.
Tap the sort/filter icons in the collection toolbar:
Sort by:
- Manual (drag-and-drop order)
- Name (A-Z / Z-A)
- Your rating (highest / lowest) - ranks by your own rating only; unrated items go last
- API rating (IGDB or TMDB score)
- Date added
- Start date (when you began an item)
- Completion date (when you finished it)
- Status
- Favorite (favorites first)
- Activity (recently touched first; items you never touched rank by the date they were added)
The direction label spells out what you'll get ("Newest first", "A-Z") instead of a generic ascending/descending. Editing a rating or status right on a card re-sorts the list immediately.
Filter by:
- Media type (Games, Movies, TV Shows, Animation, Visual Novels, Manga, Books, Audio)
- Status - the dropdown above the grid takes several statuses at once. The menu stays open while you tick them, an item passes when it matches any of the ticked ones, and the segment reads "Statuses: 3" past the first. All clears the set.
- Subcategories - selecting the Games chip reveals platform chips underneath; Manga and Anime reveal format chips (Manhwa, OVA, Light Novel, ...). Chips are built from what's actually present in the collection.
- Favorite - a segment in the same chevron bar that narrows the list to items you starred. It combines with the type, subcategory, tag, status and search filters.
The item count on each media-type chevron follows the active subfilters - pick a platform or a format and the numbers narrow with it. Which chevrons are shown still depends on the unfiltered totals, so a type never disappears from the bar mid-filtering.
Want the platform and format chips visible without selecting a media type first? Turn on Settings → Always show subcategories.
The search field in the top bar, inside a collection and on the All Items screen, has a mode menu in front of it: By title or By details. Both modes ignore case.
By title matches:
- Title name
- Tag name
- Personal notes and author review - you can find titles by what you wrote about them
- The artist of an album and the author of a book
By details matches what the title is made of: genres, tags, studios, authors, publishers, subjects, developers, artists, album label, platform, format, season and release year, across every media type.
- A comma chains conditions with AND, a slash (or
|) inside one condition gives OR:horror / thriller, 2019finds horror or thriller titles released in 2019. - A phrase counts as one value, so
kyoto animationlooks for that studio and not for the two words apart.
On an item card the genres, the anime and manga tags, manga authors, an album label and a custom item's platform are chips. Tap one and the card closes, and the value runs as a details search on the screen underneath. With a details query already on screen, the tapped value joins it as one more AND condition. Tap a chip from Search or Releases and you land on Home with that query.
On desktop, right-clicking items and collections shows a context menu - no need to find the ⋮ button:
- On collection cards (Home screen): Open, Rename, Delete
- On collection items (Grid, List, Table views): Move to Collection, Copy to Collection, Remove, Tags - and a bottom strip with every status. Tap a segment to change status without leaving the menu (labels adapt to media type: Playing for games, Watching for movies & TV).
- On empty area of the Collections screen: New Collection, Import Collection, Toggle view
- On a card in All Items: Move / Copy / Remove + the same inline status switcher
On mobile, use long-press for the same actions.
Terminology: the Russian wording «элемент» was replaced with «тайтл» in stats, tooltips, and dialogs (EN remains "item"). On the canvas «элемент» is kept because there it refers to board primitives (text/sticker/image), not collection items.
Select multiple items and act on them in one go - works in every view (Grid, List, Table, manual-reorder) inside a collection and on the All Items home screen.
Entering selection mode:
- Desktop - hover any card, a check-circle fades in at the top-left corner; click it to select. Once at least one item is selected, the circles stay visible on every card, and plain left-click toggles selection instead of opening the detail screen.
- Mobile - long-press any card to enter selection mode and select it; further taps toggle other items.
- Table view also has a checkbox column. The header checkbox toggles select-all for the currently visible rows (respects table column filters); each row has its own checkbox.
The bulk action bar appears above the list as soon as the selection is non-empty. From it you can:
- Move selected items to another collection
- Copy selected items to another collection
- Change status for the whole selection (Not Started / Playing / Completed / Replaying / Dropped / Planned - labels adapt to media type)
- Export as PNG - render the selected covers into one poster image to save or share
- Remove selected items from the collection (with confirmation showing the count)
- Add tags / Remove tags - both open the same tag picker used for a single item, with nothing pre-checked: a checked box means "apply this to all of them", not "this item has it". Adding is additive, removing drops only the tags you picked, so tags outside your pick and their manual order survive either way
- Move to top / Move to bottom - visible only when the collection is set to manual (custom) sort; the selected group keeps its relative order in the new position
On a narrow window the bar stacks into two rows: the counter keeps its own line and the actions get theirs.
When more items are visible than you've selected, a Select all visible link appears next to the count, picking every item the current filters show.
Press the × button on the left side of the bar to clear selection.
On the All Items home screen the bar operates across collections - each item's source collection is invalidated independently, so stats and counters everywhere stay consistent.
Heads-up about long-press on mobile: long-press now enters selection mode instead of opening the per-item context menu. Move / Copy / Remove / Change status remain available - select the item with long-press, then use the bulk bar.
When the collection is set to manual (custom) sort, the right-click (or long-press) menu of a single row now also has Move to top and Move to bottom. One click jumps the item to the beginning or end of the list without dragging through the whole collection. The entries are hidden in other sort modes, where they would have no visible effect.
Copy your collection as a text list to the clipboard for sharing on forums, Reddit, or social media.
Quick copy: Menu (⋮) → Copy as List - copies all items using the default template {name} ({year}).
Custom template: Menu (⋮) → Copy as Text… - opens a dialog where you can:
- Edit the template using tokens:
{name},{year},{rating},{myRating},{platform},{status},{genres},{notes},{type},{#} - Insert tokens by tapping chips below the text field
- Choose sort order (current, name, rating, year, date added)
- See a live preview of the first 5 items
- Your template is saved for next time
Example template: {#}. {name} ({year}) - ★{rating} - {platform}
Produces: 1. Elden Ring (2022) - ★9.5 - PS5
Empty tokens are automatically cleaned up with their surrounding separators.
- Rename / edit (the dialog also handles description, cover image and the hidden flag): long-press (or right-click) the collection → Rename - opens a dialog where you can change the name, add a description, mark it hidden, and pick a cover image (see Personalized view below)
- Hide / unhide: long-press (or right-click) → the hidden toggle, applied instantly
- Delete: long-press → Delete (items are not deleted, they become uncategorized)
Give each collection its own cover image and one-line description. Toggle Settings → Appearance → Rich collection view to enable.
When on:
- Collection cards on the Home screen switch from the 3+3 cover mosaic to a full-bleed hero image, with the name, description, and stats overlaid in the bottom-left corner. Collections without a custom cover use one of a few bundled default banners (assigned automatically).
- The collection screen gets a large hero banner at the top (image on the right, title and description on the left) that scrolls along with the grid. The banner carries the collection name and the back control, and it stays on screen while the items load.
Settings → Appearance → Collection banner style picks how that banner is drawn: Classic, Comic, Sticker album, Brutalist or Strips. Every style except Classic adds a per-status summary of the collection - a proportional color bar with a dot-and-count legend, round status badges or boxy counters, depending on the style. Strips cuts the photo into one full-bleed picture split by two slanted cuts. Comic and Sticker album draw on a fixed paper-and-ink palette; the rest follow the app theme.
Pick a cover via long-press / right-click on a collection → Rename (the dialog also handles description and cover) → Choose image. Recommended dimensions: 2560×1080 (21:9). Place the main subject on the right side - the left is covered by the title, and the bottom fades into the background. Use Remove image to fall back to the bundled default.
Covers are stored locally and included in full .xcollx exports, so they travel with the collection.
The "All Items" screen on the Home tab has a status filter dropdown chip. Tick as many statuses as you want:
- In Progress (default) - what you're currently playing / watching
- Planned - your backlog
- Not Started - items with no activity yet
- Completed - finished items
- Dropped - items you gave up on
- Ignored - titles you parked
An item passes when it carries any of the ticked statuses. All clears the set. The whole set persists between sessions, per profile.
Right after the status filter sits a favorites toggle - flip it to see only the items you marked with the heart. It also remembers its state, separately for each profile.
On the All Items grid each collection group is headed by the collection name with a thick accent underline, the total count, a small tally per media type (the type icon with its number) and a favorites count. Tap the name to open that collection; while a multi-select is running the name stays inert. Items in no collection group under a muted grey Uncategorized header.
When adding an item to a collection (from Search or item detail), the collection picker dialog has a sort toggle in the header. Cycle through: A-Z, Z-A, date ascending, date descending. The initial sort follows your home screen sort setting.
Tags are your own labels for grouping items - "RPG", "Favorites", "Backlog", whatever you need. They're shared across the whole app: one set of tags that every collection draws from. Create "RPG" once and it's ready to use everywhere. An item can carry any number of tags at the same time.
- From the poster card - tap the tag badge in the bottom-right corner of any card
- From the detail screen - tap the tags row below the description
- From the right-click / long-press menu - pick Tags
Any of these opens the picker. Check as many tags as you want, or type a name and create it on the spot. On a card the badge shows the first tag plus a "+N" counter when there are more.
Manage tags and the Select tags picker share one body, so every tag edit is available wherever you open tags:
- a search field that filters the list as you type, with a Create «…» row for a name that does not exist yet
- rename, background color and an optional label color for when the automatic white text is hard to read
- how many items use each tag
- delete
- drag tags to reorder them in manual mode
Edits in a picker row apply to the tag itself right away, independent of the checkboxes: the checkbox says which tags go on the item, the color dots and the rename apply to every item that carries the tag.
A sort menu offers Manual (your drag order), A–Z and Z–A. The choice is remembered per profile and it also orders the tag bar above a collection and the filter sheet on narrow screens.
Two tags cannot share a name: the create row hides as soon as the typed name matches an existing tag, ignoring case.
On a wide screen the tags of the open collection sit in one chip row above the items, each chip with the tag name and how many items in this collection carry it. The Group toggle comes first in the row, then a reset chip showing how many tags are active. Tap chips to combine them the same way as in the filter sheet.
When the chips overflow, the row scrolls sideways: edge-fade arrows on desktop, the mouse wheel, or a drag with touch or mouse. Narrow screens keep tags and sorting in the sheet behind the filter-bar button.
Inside a collection, items are grouped into sections by their first tag, with a header showing the tag name and count. Items with no tag sit in their own section.
The tag filter is include-only: pick one or more tags and you'll see every item that carries any of them. A collection's filter list only shows tags actually used by items in that collection.
Moving an item to another collection keeps its tags. Copying duplicates the tag links onto the new copy. Exports write the tag names with each item, and a full backup includes the complete tag set, so your tags travel with your data. Older app versions still restore one tag per item from a newer file.
You can manually create items that aren't in any database. Open a collection → menu (⋮) → Add Custom Item.
Fill in the details:
- Title and optional alternate title
- Cover image - from file or URL (2:3 aspect ratio recommended)
- Year, genres (searchable multi-select)
- Description and rating
- Display type - style the item as a game, movie, TV show, etc. (affects colors and icons)
- Platform (custom games) or format (custom manga / anime) - picked from the same lists real items use
- Progress totals - how many episodes, chapters, pages or parts the item has, so you can track progress on it later (see Item Details)
Custom items work like any other item - they appear on canvas, in tier lists, and in exports. In the filter bar a custom item counts both under Custom and under the type it is displayed as, and its platform or format shows up in the subcategory chips.
Items that are not in any collection appear in the "All Items" screen on the Home tab. You can move them to a collection at any time from the item detail screen.
The Uncategorized bucket is being phased out. It is read-only now: it can't be picked as a destination when moving or adding items, its card carries a red "will be removed" warning, and the add button is hidden inside it. Move anything still living there into a normal collection - a banner on All Items reminds you until it's empty.