Tutorial · Home library

Home Library and Import

Updated · 2026-08-10Public document

Home is the entry point for books, character cards, and Companions. Its current top panes are All, Books, Characters, and Companions; the bottom navigation is Home, Discover, and Me. This guide covers the current import and library paths.

Import paths and formats

What you haveCurrent pathResult
One txt / epub / md bookHome → + → Import a novelThe system file picker adds it to Books; first open converts and detects chapters
Many txt / epub / md booksHome → + → Batch import from folderScan a chosen folder, select results, then import them together
PNG / JSON / .charx card, worldbook, preset, regex, Quick Reply, or backup zipHome → + → Import Tavern character card → Pick from phoneThe import hub detects the type, shows a preview/warning, and places it in the matching local library
SillyTavern .jsonl historyHome → + → Import chat historyAttaches the imported history to a matching character
Import and local conversion do not call an AI model. Free-plan book/card limits still apply, and the app shows the Pro gate before adding items beyond the allowance. The site build can offer full-device scanning after Android grants all-files access; the Play build stays SAF-only and uses the system folder picker.

Four Home panes

  • All: a combined desk for books, active character-chat worlds, Companions, and playable works.
  • Books: books and playable works, with reading progress, search, and library organization.
  • Characters: imported character cards and chat sessions, including search, filters, groups, import, and card details.
  • Companions: Companion cards, creation, groups, and management.
  • The Home header provides search, + import, and Agent-workbench actions. Quick Dock remains available for active Agent sessions.

Where each item opens

  • Tap a book to open Reader. AI segments are managed in place; switch branches from the chapter branch badge inside Contents.
  • Tap a character to open its card/detail or existing chat; Start chat creates a chat-world copy without changing the library card.
  • Tap a Companion to open its conversation. Profile, memory, proactive-message controls, and backup live inside that Companion.
  • Standalone worldbooks and Tavern assets are managed under Me → Advanced settings → Character Cards & Tavern → Tavern Asset Hub, then selected from chat settings as needed.

Manage, export, and delete

  • Long-press an item in All or Books to select, pin, delete, or open More. A single selected book also exposes details, cover replacement, home-screen shortcut, storage location, and Convert to playable work.
  • Character cards have their own menu for edit, copy, JSON/PNG export, grouping, Start chat, and deletion.
  • Before deleting, export irreplaceable books/cards/chats or use Me → Advanced settings → Data → Full library backup (Pro). Deleting a book removes its local progress, branches, and generated assets; deleting a Companion removes persona, memory, and chats. There is no recycle bin.