Skip to content
Yomitomo

Library and Import

Manage web articles, EPUB/AZW3/MOBI ebooks, PDFs, and Markdown notes, and understand how Yomitomo stores reading materials.

The Library is the central hub for all your reading materials. Web articles, ebooks (EPUB/AZW3/MOBI), PDF documents, Markdown/text files, WeRead highlights, and collections are organized neatly so you can transition into the right reading experience with ease. You can customize which sources appear on the home view in Settings. Deleting items requires confirmation, and actions are accompanied by top notifications and optional sound effects.

Collections group related reading items together by topic, project, or custom reading list. A collection never duplicates source files; it simply creates a lightweight membership index across your existing materials.

  1. Click the “+” button in the top-right corner of the Library.
  2. Select “New collection”.
  3. Enter a collection name (e.g., “Distributed Systems”).

The newly created collection opens immediately. You can rename it anytime from its card menu via “Edit collection name”.

A collection can hold web articles, ebooks, PDFs, plain text, and WeRead titles. You can add items in three ways:

  • Pick from Collection View: Inside the collection, click “Add to this collection” and select existing items from your library. The selector supports type filtering and keyword search; click “+” on individual items or drag them into the “Pending” tray on the right.
  • Drag and Drop: From the main library grid, drag any reading item card directly onto a collection card.
  • Card Menu: Choose Add to collection from an item’s card menu, then select collections or create a new one in the dialog.

To remove an item, open its card menu inside the collection and choose “Remove from collection”. This only removes the membership link—the original item remains intact in your library.

Reading items sit on shelves, with progress, titles, and annotation counts below their covers. Collections appear as open crates holding member covers and showing the item count. Empty collections show an empty crate. You can “Pin” frequently accessed collections or essential reading items so they always stay anchored at the top of your library.

Deleting a collection only removes the grouping itself and its membership links. All articles, ebooks, and PDFs contained within remain safe in your library.

  1. Click the “+” button in the Library.
  2. Select “Add Web Page”.
  3. Paste any article URL starting with http:// or https://.
  4. Yomitomo will automatically extract the clean title, author, body text, and images.

For dynamically rendered web pages, Yomitomo uses an internal headless engine to render the DOM before content extraction. HTML responses exceeding 5 MB are rejected.

Yomitomo import a web article
  1. Click the “+” button in the Library.
  2. Select “Ebook file”.
  3. Choose or drag in local .epub, .azw3, or .mobi files.

Yomitomo parses covers, hierarchical tables of contents, chapters, and rich typography. Batch imports support up to 10 books at once, with an 80 MB file size limit per book. DRM-encrypted or excessively large decompressed files cannot be imported.

Yomitomo import an ebook
  1. Click the “+” button in the Library.
  2. Select “PDF Document”.
  3. Choose or drag in local .pdf files.

PDF import supports batches of up to 10 files at once, with a 120 MB limit per file. Once imported, the card displays page count, filename, and essential metadata. If an identical PDF is imported again, Yomitomo detects the duplicate and allows you to open the existing entry directly.

Yomitomo import a PDF
  1. Click the “+” button in the Library.
  2. Select “Text file”.
  3. Choose “Paste text” for quick pasting, or “Upload files” to pick or drag local .txt / .md files (batch selection supported).

Text imports include an instant metadata review: Yomitomo detects character encoding and automatically extracts the title (Markdown prefers YAML Front Matter or the first H1 header; plain text uses filename or the first line). You can confirm or edit the title and author before finalizing.

Markdown YAML Front Matter renders as a metadata banner at the top of the reader. Content is sanitized, and remote images are blocked from automatic background fetching. Text documents feature custom manuscript-themed covers and can be filtered or grouped into collections like any other item.

Drag EPUB, AZW3, MOBI, PDF, TXT, or Markdown files onto the library to import them, several at a time. Files already in the library and unsupported formats are reported separately in the result. You can also import text from File > Import Text… in the menu bar.

Use “All” on the left of the search field to select Collections, Web, Ebooks, PDFs, Text, or WeRead. Selected types appear as removable chips. Search matches titles, authors, sources, and collection names.

Filters, search terms, and the current collection persist across navigation. Sort the library by recently updated, title, reading progress, or annotation count, and filter by unread, reading, finished, or annotated. Pin frequently used items or collections; other items follow the selected order. Use the footer to change pages and the number of items per page.

Choose Edit info from an item’s card menu to change its title and author; the change applies only to your local library. If the original file of a local PDF or ebook is missing, the reader shows a notice; click Choose local file to restore it.

All reading data is stored securely in your desktop application data directory. Enabling “Save images locally” downloads article illustrations directly to your disk upon web import, protecting your reading experience against broken links or removed source media.

Still need help?

GitHub IssuesX
Contents
On this page