Auto-Import

Auto-Import lets you automatically pull books from connected providers into your Tsumihon library based on configurable rules. Instead of manually searching and adding books one by one, you define what you want and Tsumihon fetches matching content on a schedule or on demand.

Overview

The Auto-Import system works by evaluating a set of import rules against the catalogs of your connected providers (such as Lanraragi). Each rule specifies criteria — like a particular artist, category, or tag — and when Auto-Import runs, it searches for books matching those criteria, checks for duplicates, and imports new entries into your library.

You can run Auto-Import manually at any time, or configure it to run automatically on a schedule. Imported books can be automatically tagged and categorized so they slot neatly into your existing library organization.

Rule-Based Import

At the heart of Auto-Import are import rules. Each rule defines a set of criteria that books must match to be imported. You can create as many rules as you need, and each rule operates independently.

Rules can filter by any combination of the following:

Category — Match books in a specific category (e.g., Doujinshi, Manga, Artist CG).
Author / Artist — Match books by a specific creator.
Tags — Match books that contain one or more specified tags.
Collection / Favorites — Import from a specific favorites category or collection on the provider.
Uploader — Match books uploaded by a specific user on the provider.

Tip: Combine multiple criteria in a single rule to create precise filters. For example, you could create a rule that imports only Doujinshi by a specific artist that are tagged with a particular parody.

Advanced Filtering

Beyond the basic criteria, each rule supports advanced filters to further refine what gets imported:

Minimum Rating — Only import books with a rating at or above a threshold (e.g., 4 stars or higher).
Page Count Range — Set minimum and/or maximum page counts to skip very short or excessively long entries.
Languages — Restrict imports to specific languages (e.g., Japanese, English, Chinese).
Import Date Cutoff — Only import books added to the provider after a specific date. This is useful for catching up from a known point in time without reimporting older content you have already reviewed.

Scheduling

Auto-Import can run on a fixed schedule or be triggered manually. The available frequency options are:

Manual only — Auto-Import never runs automatically; you trigger it yourself.
Every hour
Every 6 hours
Every 12 hours
Daily
Weekly

Scheduled imports run in the background. On mobile, background execution depends on the operating system’s policies and battery optimization settings.

Tip: If you are on a metered connection, enable the WiFi only option in global settings to prevent Auto-Import from consuming mobile data.

Duplicate Handling

When Auto-Import finds a book that already exists in your library, it uses the configured duplicate handling strategy:

Skip (default) — The duplicate is ignored and not imported again.
Update — The existing library entry is updated with the latest metadata from the provider.
Create New — A new, separate entry is created even though a match already exists. Use this with caution to avoid clutter.

Auto-Categorization

Each import rule can optionally assign categories and tags to every book it imports. This means books brought in by different rules can be automatically organized without any manual effort after import.

For example, a rule targeting a specific artist could automatically tag all imports with that artist’s name and assign them to a “Favorites” category.

Creating a Rule

Follow these steps to create a new import rule:

Open Settings from the navigation bar.
Tap Configure Auto Import under the Auto-Import section.
Tap Manage Import Rules to view your existing rules.
Tap the + button to create a new rule.
Give the rule a descriptive name (e.g., “New releases by Artist X”).
Select the provider to search against.
Configure the matching criteria: category, author/artist, tags, collection, and/or uploader.
Optionally set advanced filters: minimum rating, page count range, languages, and date cutoff.
Optionally configure auto-categorization by assigning categories and tags.
Choose the duplicate handling strategy.
Save the rule.

The rule will take effect the next time Auto-Import runs, or you can trigger a manual run immediately.

Global Settings

In addition to per-rule configuration, there are several global settings that control Auto-Import behavior across all rules:

Enable Auto-Import — Master toggle to turn the entire Auto-Import system on or off.
Frequency — How often scheduled imports run (see Scheduling above).
WiFi Only — When enabled, scheduled imports will only run when connected to WiFi.
Notifications — Receive a notification when an import run completes, summarizing how many books were added.
Concurrency — The number of books that can be processed simultaneously during an import run. Higher values are faster but use more resources.
Max Results per Rule — Limits the number of results fetched per rule in a single run. Useful for controlling data usage and processing time.
Retry on Failure — Automatically retry failed imports on the next scheduled run.

Manual Execution

You can run Auto-Import at any time without waiting for the next scheduled execution. Navigate to Settings > Configure Auto Import and tap Run Now. The import will process all enabled rules and show progress in real time.

Manual runs respect all the same settings as scheduled runs, including duplicate handling, concurrency, and max results.

Viewing History

Every Auto-Import run is logged so you can review what happened. From the Auto-Import settings screen, tap Import History to see a chronological list of past runs. Each entry shows:

The date and time the run started and completed.
Which rules were evaluated.
How many books were found, imported, skipped, or failed.
Any errors or warnings encountered during the run.

Tap on any history entry to see the full details, including the list of individual books that were processed and their import status.

Troubleshooting

Auto-Import is not running on schedule

Confirm that Auto-Import is enabled in Settings > Configure Auto Import.
Check that the frequency is set to something other than “Manual only.”
On mobile, ensure the app has background refresh permissions and is not being killed by battery optimization.
If WiFi Only is enabled, make sure you are connected to WiFi when the scheduled run is expected.

No books are being imported

Verify that your import rules have correct criteria. Try running the same search manually in the Search tab to confirm results exist.
Check that your connected provider is reachable and properly configured (e.g., Lanraragi server URL and API key).
If using a date cutoff, make sure it is not set to a future date.
Review the import history for error messages that might indicate what went wrong.

Duplicates keep appearing

Make sure the duplicate handling strategy is set to Skip (the default) rather than Create New.
Duplicates are detected by matching source IDs and URLs. If a book was added manually without source metadata, Auto-Import may not recognize it as a duplicate.

High data usage

Enable the WiFi Only setting to prevent imports over cellular data.
Reduce the Max Results per Rule value to fetch fewer items per run.
Lower the Concurrency setting to reduce simultaneous network requests.
Increase the scheduling interval (e.g., switch from hourly to daily) to run less frequently.

Warning: Running Auto-Import with very broad rules (e.g., no category or tag filters) against large providers can result in importing a very large number of books. Always use specific filters to keep imports manageable.