Library Management

The Library is the heart of Tsumihon. It is where your entire collection lives — every book you have added, organized exactly the way you want. This page covers everything you can do from the library screen.

Collection View

When you open the Library tab, you see your full collection displayed as a scrollable list of books. Tsumihon offers two view modes that you can switch between at any time using the toggle in the toolbar:

• Grid View — Displays books as cover thumbnails in a responsive grid. This is the default and works best for visual browsing. Cover images are cached locally for fast loading, even in large libraries.
• List View — Displays books as compact rows with the cover thumbnail, title, artist, and page count. This mode is ideal for quickly scanning a long collection or when you need to see more metadata at a glance.

Sorting

Tap the sort button in the toolbar to change how your books are ordered. The following sort options are available:

• Title — Alphabetical by the book's display title.
• Date Added — Most recently added books appear first.
• Rating — Highest-rated books appear first. Unrated books are placed at the end.
• Artist — Alphabetical by primary artist name.
• Pages — Sorted by page count, largest first.

Each sort option can be toggled between ascending and descending order by tapping it again.

Filtering

Use the filter controls to narrow down what is displayed in your library. Filters can be combined for precise results.

By Category

If you have organized your books into categories (see Categories below), you can filter the library to show only books in a specific category. Tap the category chip bar at the top of the library to select one.

By Tags

Filter by one or more tags to find books that match specific themes, genres, or content descriptors. Tags are pulled from each book's metadata.

By Artist

Select an artist name to see only their works. This is useful when you want to browse a specific creator's catalog within your collection.

By Circle

Similar to artist filtering, you can filter by doujin circle to see all works published under a particular group.

Multi-Select Mode

Long-press any book (or tap the multi-select button in the toolbar) to enter multi-select mode. In this mode, you can tap multiple books to select them, then perform batch operations on the entire selection.

Batch Cleanup

Select two or more books and tap Batch in the bottom bar to access batch operations. The Clean Up Titles option runs the title cleanup algorithm across all selected books at once, normalizing formatting, removing extraneous tags, and standardizing naming conventions.

Batch Edit

The Edit in Batch option lets you apply the same metadata changes to all selected books simultaneously. This is helpful for assigning a category, adding a tag, or updating the artist across multiple entries.

Book Details

Tap any book in the library to open its detail view. The detail screen provides a comprehensive look at the book and access to all management actions.

Cover Image

The book's cover is displayed prominently at the top. Cover images are fetched from the metadata source and cached locally. If a book has no cover, a placeholder is shown. You can tap the cover to view it full-screen.

Titles

Tsumihon supports up to three title variants for each book:

• Japanese Title — The original Japanese title, typically in kanji/kana.
• Romaji Title — A romanized transliteration of the Japanese title.
• English Title — An English translation of the title.

At least one of these three titles is required when adding a book. The display title shown in the library grid is determined by your title display preference in Settings.

Metadata

Below the titles, the detail view shows all available metadata for the book:

• Artist — The primary creator or author.
• Circle — The doujin circle or publishing group.
• Pages — Total page count.
• Language — The language of the book's content.
• Rating — Your personal rating (tap to change).
• Tags — Descriptive tags pulled from the metadata source.
• Source URLs — Links back to the original metadata sources.
• Category — The user-assigned category, if any.
• Date Added — When the book was added to your library.

All metadata fields are editable. Tap the edit button to modify any field. See the Book Metadata page for more details on how metadata works.

Categories

Categories let you organize your library into logical groups. Unlike tags (which come from metadata providers), categories are entirely user-defined and managed.

• Create categories from the library filter bar or from a book's detail view.
• Assign a book to a category from its detail screen or via batch edit in multi-select mode.
• Each book can belong to one category at a time.
• Filter your library by category using the chip bar at the top of the library screen.

Common category setups include organizing by format (doujinshi, manga, artbook), by reading status (reading, completed, plan to read), or by content type.

Sharing Books

You can share a book's details with others using the share button on the book detail screen. This uses your device's native share sheet and generates a formatted summary including the book's title, artist, and source URL. It works on iOS, Android, and the web.

Performance with Large Libraries

Tsumihon is optimized for collections of 10,000 books and beyond. The library uses virtualized scrolling, aggressive image caching (with cache keys tied to book IDs), and efficient data structures to ensure smooth performance even at scale. Sorting and filtering operations run on pre-indexed data for instant results.