Settings

The Settings screen is the central place to configure Tsumihon’s behavior. It is organized into sections, each grouping related options together.

General

Core display and behavior preferences for the app.

Theme — choose between light, dark, or system theme.
Language — set the app’s interface language.
Default reading direction — choose right-to-left, left-to-right, or vertical scrolling as the default for new books.

Title Display

Controls which title field is shown throughout the app (library grid, detail screen, search results). Books can have up to three title fields: Japanese, Romaji, and English. This setting determines which one takes priority when displaying a book’s name.

Tip: If the selected title field is empty for a particular book, Tsumihon falls back to the next available title automatically.

Automation & AI

Settings for automated workflows and AI-assisted features.

AI OCR API Key — enter an API key from a supported AI provider to enable OCR-based search. With this configured, you can take a photo of a book cover or page and search for it using the provider’s vision capabilities. The settings screen shows the specific provider currently supported and links to where to obtain a key. The key is stored locally on your device and is only sent to the AI provider when you initiate an OCR search.

Auto-Import

Configure automatic import of books from compatible extensions. Auto-import periodically checks your installed sources and adds matching books to your library without manual intervention.

See the Auto-Import documentation for full details on configuring rules, schedules, and behavior.

Auto-Merge

Configure how Tsumihon automatically merges metadata from multiple sources for the same book. Auto-merge uses source IDs and title matching to identify duplicates and combine their metadata.

See the Auto-Merge documentation for details on merge rules and conflict resolution.

Backup & Sync

Configure cloud sync and backup settings. Cloud sync is enabled automatically when you sign in — see the Backup & Sync documentation for details on how sync works.

Privacy & Security

App lock, hide-in-app-switcher, clipboard monitoring, and the in-app browser are all configured here. See Privacy & Security for the full breakdown.

Extensions

Install, configure, and remove extensions that add new metadata sources to the app. See Extensions for the full management guide.

Advanced & Safety

Lower-level controls for advanced users.

App Info — build information and version details.
Data Credits — attribution for the public databases that contribute metadata to Tsumihon. Tap any entry to visit the source. Tsumihon includes credits for publicly licensed datasets that require or appreciate attribution.
Debug Tools — diagnostic logging and log export, primarily used when reporting issues.
Danger Zone — destructive actions such as clearing downloads, bulk cleanup, resetting the local collection, and deleting your account.

Warning: Actions in the Danger Zone cannot be undone. Use them only when you are certain.