AutoSync

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.

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
Episode filter	Optional selection of which seasons/episodes to sync (see below)
Movies/specials	Optionally sync the "Movies" collection too — with its own download path
Path-unavailable action	skip or hold (per job, overrides the global setting)

A job is created from the search page: in the series dialog the "Set up Auto-Sync" button opens the configuration dialog (language, provider, path, episode filter). Existing jobs can be changed via Edit on the AutoSync page.

The schedule (interval or weekly plan) is global for all jobs and is set in Settings — see Schedule. The worker checks every 10 seconds which jobs are due; changes take effect immediately.

Episode filter (per job)

By default a job syncs all seasons. The filter in the setup/edit dialog lets you control per job exactly what is downloaded. Two modes:

• Sync everything — all seasons and episodes, including future ones. No selection needed (the season list is hidden in this mode).
• Only selected — the series' seasons are loaded and expandable; per season you click individual episodes as chips to include/exclude. The season checkbox = the whole season incl. future episodes; a partial selection is stored as a range (e.g. 1-12). Unchecked seasons are not synced, and brand-new seasons stay out until you enable them.

aniworld vs. s.to: the selection is based on the series' real season list — you don't need to know the sites' differences. On s.to, specials appear as Season 0 in the list; on aniworld, movies/OVAs live in a dedicated "Movies/specials" collection.

Movies/specials have their own toggle (no per-episode filter) and a separate download path, so series and movies can land in different folders. FilmPalast movies are unaffected.

Saving a changed filter immediately triggers a sync run so the card counters are correct and missing in-scope episodes are queued right away. Already downloaded files are never deleted — the filter only controls what is fetched in the future.

Schedule: interval or weekly plan

The schedule is global and set in Settings → Auto-Sync. Two modes:

• Interval — a fixed gap (1min to 24h). Each job runs at last check + interval.
• Weekly plan — clickable weekdays (Mon–Sun) and one or more times. A job runs once per time slot on the selected days. If the app was off at that time, the run is caught up on the next start. The time base is the local server time.

The "Next check" on the job card shows the next slot or interval time depending on the mode.

How a sync run works

Phase 1 — online inventory: All seasons of the series are fetched and the episodes included by the job filter are counted (the "Movies" collection only if enabled). The count is compared with the previous run to detect new episodes. The episode counters on the card (local / online) also reflect only the configured filter scope.

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. Movies/specials are — if enabled — queued separately and with their own path.

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).