Skip to content

Basic Configuration

Tasks, scraping, and records are the day-to-day settings. You can save a new scrape or task immediately to get defaults, then edit.

Records

Records lists every transfer.

Delete removes destination files by default. Force-delete also removes the source (ignoring lock).

Opening a record lets you change transfer and scrape behavior.

Custom transfer

  • Ignore — skip this file; you can delete the destination and it will not be transferred again
  • Season / episode — for series
  • Top-level folder — outer folder name after transfer; can be applied to other records from the same source
  • Task ID — which task owns the record

Custom scraping

  • Number — watch spaces and _; a mismatch is treated as a new title
  • Source — a site supported by scrapinglib
  • URL — scrape that page directly
  • Part number — start at 1 when the same ID has multiple parts; use 0 for a single file
  • Tags — comma-separated, e.g. chinese-sub,uncensored
  • Crop — whether to crop the poster

After you change a task’s source folder, old records keep the previous prefix. Use Tools → Sync transfer record paths to rewrite prefixes and the linked extra info.

Scraping configuration

A task points at one scrape config.

Basics

  • Save metadata — store the result locally; view it under Metadata
  • Sites — scrapinglib sources, tried in order

Naming and folders

  • Naming rule — default number+' '+title
  • Location rule — default actor+'/'+number+' '+title
  • Max title length — default 50

Tokens include title, actor, studio, director, release, year, number, runtime, series, and similar fields.

Other

  • More storyline — fill in the outline when possible
  • Extra fanart — download extra images and the folder name
  • Watermark size — size relative to the whole image
  • Watermark position — top-right 0, top-left 1, bottom-left 2, bottom-right 3; extra marks increment from there

Task configuration

Basics

  • Content type — movies and series are handled differently
  • Source / output folder
  • Failed folder — where failures land
  • Operation — hard link, soft link, move, copy. Prefer hard link on the same filesystem
  • Auto watch — run this task on create/move/delete; a full run also asks Emby to refresh
  • Clean others — on a full run, delete output files that are not in records
  • Optimize folder names — strip Chinese characters so media servers parse names more easily
  • Escape folders — e.g. Sample,sample,@eaDir
  • Escape literals / size — skip names containing those characters, or files below a size

Linked scraping

Enable scraping and pick a config. Create one under Scraping configs if none fits.

Next steps

Released under the MIT License