Skip to content

AutoSync

TheMRX13 edited this page Jun 12, 2026 · 4 revisions

AutoSync

🌐 English · Deutsch

AutoSync keeps series up to date automatically: at a configurable interval the app checks whether new episodes are available online and whether episodes are missing locally — missing ones are queued for download automatically.

Screenshot: AutoSync page

Creating a job

On the AutoSync page (/autosync) you create one job per series with:

Field Description
Series URL aniworld.to or s.to series
Language A single language or All Languages (downloads every available language; English Sub can be excluded globally)
Provider Host used for the downloads
Custom path Optional dedicated download target
Enabled Jobs can be paused individually
Path-unavailable action skip or hold (per job, overrides the global setting)

The global interval (1min to 24h, default: off) applies to all jobs and is set in Settings. The worker checks every 10 seconds which jobs are due — interval changes take effect immediately.

How a sync run works

Phase 1 — online inventory: All seasons of the series are fetched and the total number of episodes available online is counted (movie "seasons" are skipped). The count is compared with the previous run to detect new episodes.

Phase 2 — local comparison per language: The download folders (default path + all custom paths; with language separation enabled, the respective language folder) are scanned for files matching the SxxExx pattern. For every episode that exists online but not locally, the app additionally verifies that the target language is actually available at the host — only then is it queued. This prevents "language not available" errors in the queue.

If a download for the series in the same language is already queued or running, the job is skipped for this cycle.

Custom path unavailable (NAS offline)

If a job has a custom path that is unreachable:

  • skip (default): the run is skipped and recorded as an error; next attempt in the next interval.
  • hold: the job is paused ("on hold") and a notification is sent. As soon as the path is reachable again the job resumes automatically (with a notification).

Errors & retries

  • Network errors (timeouts, DNS, connection resets) count as transient: no retry counter, retried next interval.
  • Other errors increase the retry counter. With sync_error_retries (0–10) and sync_error_retry_time (0–5 min) the job is retried at a shorter interval after failures. Optionally, error notifications are only sent once all retries have failed.

Actions

Action Description
Sync now Run a single job immediately
Sync all Run all enabled jobs immediately
Export / Import Back up all jobs as JSON / restore them
Batch add Add multiple series URLs at once

Notifications

AutoSync fires the events on_autosync (new episodes are being downloaded), on_sync_error, on_sync_hold and on_sync_resume — configurable per service and user (Notifications).

Clone this wiki locally