Skip to content

Mood Grid

hcan359 edited this page Jul 31, 2026 · 5 revisions

Mood Grid

Build an editable N×M board where each cell pairs a custom label with one item from your collections - perfect for "About Me" boards, year-in-review awards, or themed showcases.

Overview

A Mood Grid is the second board type inside the Tier Lists section, alongside the classic ranked tier list. Instead of placing many items into a few tiers, a Mood Grid gives each cell a single category label (e.g. Favorite Game) and one media item that fills it.

  • The same item can appear in any number of cells.
  • The grid is not tied to a collection - items are picked from across all your collections and the grid lives independently.
  • Mood Grids are included in full app backups but not in .xcoll / .xcollx collection exports.

Creating a Mood Grid

  1. Go to the Tier Lists tab (leaderboard icon).
  2. Tap the + FAB → Create Mood Grid.
  3. Pick a name (default: About Me: Tonkatsu Box).
  4. Choose a preset:
    • About Me: Tonkatsu Box - 1×5 board with five labels: Favorite Game, Favorite Movie, Favorite TV Show, Favorite Anime, Favorite Manga.
    • Blank - empty grid; pick Rows and Columns with the steppers (1 to 10 each).
  5. Tap Create. The detail screen opens and you can start filling cells.

Filling cells

A cell has two tap zones:

  • Tap the cover → the item picker opens (a filled cell opens it preselected with a Replace action).
  • Tap the label below the cover → the label text becomes editable right there.
  • Right-click (desktop) or long-press (mobile) a cell to open the contextual menu:
    • Edit label - change the category text under the cover
    • Pick / Replace item - open the picker
    • Clear item - remove the cover but keep the label

The picker supports searching by name and filtering by a specific collection - All collections by default. It keeps the collection filter and the search text while the grid stays open, so picking ten items in a row does not mean re-typing the filter ten times. A title held in several collections is listed once.

Cell labels template

Next to the row-caption template there is a per-grid Cell labels template that uses the same tokens. When you pick an item into a cell whose label is still empty, the label is filled in from that template. Labels you typed by hand are never overwritten.

Resizing on the fly

A small toolbar above the grid shows the current size and lets you change the number of rows and columns one step at a time. Adding rows or columns creates empty cells. Removing them asks for confirmation; cells outside the new bounds are deleted.

Existing cells keep their position when the grid grows, and each cell keeps the source its title came from.

Cell size

A size stepper in the same toolbar scales the cells between 80 and 240 - on screen and in the exported image alike. The value lasts for the session and comes back at the default the next time you open the grid.

On a narrow window the toolbar reflows into two rows of equal-width controls. On desktop the grid has draggable scrollbars on both axes and pans with a mouse drag.

Row captions

You can show a caption next to every item, in a column to the right of the grid. Open the caption template editor, write a line once, and it applies to every cell. Build the line from tokens that the app fills in per item:

  • {{name}} - the title
  • {{year}} - release year
  • {{genre}} - genre
  • {{rating}} - your rating

The editor has a chip for each token so you can insert them without typing the braces. The default template is {{name}}. Leave the field empty to hide the caption column. Captions show both on screen and in the exported image.

Set the template to {{name}} ({{year}}) for a clean "title and year" label down the side, or {{name}} - {{rating}} to put your score next to each pick.

Export as image

The Export as image button saves the grid as a PNG with a made by Tonkatsu Box watermark. The system Save dialog opens so you can pick where to put it.

  • Desktop: the standard Save dialog. If you remove .png from the file name, the extension is added automatically.
  • Android / iOS: the system file picker; you can pick any folder, including Files, Drive or Photos.

Empty cells are exported as blank slots - the on-screen + placeholder is not drawn into the image. A one-column grid at a small cell size still fits the footer credit line.

When an item is missing

A cell remembers what title is in it independently of your collections. If you remove that title from every collection, the cell still shows its cover and name. If even the saved cover is gone, you'll see a placeholder with the media type icon and the label until you look up that title again.

Backups

Mood grids are included in full app backups (Settings → Database → Backup) alongside collections, wishlist, and tracker data. Older backups without mood grids still restore; they just won't add any grids.

Tips

  • The Mood Grid card on the Tier Lists listing carries a Mood Grid badge and shows the current size.
  • The same media can be placed in multiple cells - no uniqueness constraint.
  • Long-press / right-click any Mood Grid card in the listing to Rename or Delete it.
  • PNG export uses a high-resolution render so covers stay sharp when shared.

🏠 Home


🇬🇧 English


🇷🇺 Русский


🇨🇳 中文


💬 Discord

Clone this wiki locally