One Pace Plex Automator

Automates downloading, renaming, and Plex metadata management for One Pace — a fan edit of the One Piece anime that removes filler and aligns with manga pacing.

What it does

1. Polls the One Pace RSS feed on a schedule
2. Detects new episode releases (and re-releases with an updated CRC32)
3. Sends magnet links to qBittorrent
4. Renames completed downloads to Plex naming format
5. Moves files to the correct Plex library folder, replacing superseded copies
6. Keeps Plex metadata, thumbnails, and posters rich and current automatically (see Metadata & thumbnails and Posters)
7. Sends Discord webhook notifications — per-event toggles (new episode, downloaded, updated, errors) plus health alerts when a service or disk problem starts or clears (Settings → Discord Notifications)
8. Backs up its own state nightly (/data/backups/, keeps the last 7)

A web dashboard (port 8282) provides live logs with text/level filtering, manual controls, a library coverage report, a metadata & thumbnail audit, live download progress, and a system health panel. It's responsive on phones and installable to a home screen. Settings live behind the gear icon in the navbar, including appearance options (light/dark/auto theme, any DaisyUI theme, and a choice of logo).

Dashboard controls

Control	What it does
Refresh Sources	Clears all metadata caches, re-fetches the metadata dataset and episode-guide sheets, then polls RSS — the same cycle the cron runs. Use it to pick up a release the schedule hasn't seen yet. With auto-reconcile on, it also pushes any changed metadata and generates missing thumbnails.
Library → Scan / Reconcile	Scan checks your media folder for coverage (present/missing/upgradeable) and diffs Plex against the dataset, flagging episodes with missing/drifted metadata or no thumbnail. Reconcile fixes only the flagged ones — pushing metadata and triggering thumbnail generation. See below.
Full Plex sync	Re-pushes titles/descriptions/air dates for every season and episode to Plex, applies the show's genres/rating/studio, then syncs season posters (skipping any whose image hasn't changed). The resync-everything hammer — day-to-day this happens automatically, so it's rarely needed.
Retry failed	Re-queues episodes whose download or processing failed.
Normalize File Naming	Scans for files whose names don't match the canonical scheme, previews each old → new rename, and applies the ones you select.
Clear done	Removes completed rows from the pipeline table (files are kept).

Each pipeline row also has per-episode actions (download, retry, re-sync metadata, upgrade, remove), and the coverage report can queue upgrades individually or in batch.

Metadata & thumbnails

Plex episode/season titles, summaries, air dates, and thumbnails are kept rich and current automatically. The tool tracks, per episode, what the dataset says the metadata should be versus what it last pushed to Plex — so when the metadata source updates (a new data.min.json or an episode-guide sheet edit), it knows exactly which episodes changed and re-syncs only those, no full library sweep.

• Metadata — missing (never synced) or drifted (differs from the dataset) titles/summaries/air dates are pushed for just the affected episodes and seasons (seasons get the arc's earliest release date).
• Show details — since a fan edit has no metadata agent, the show itself gets genres, a content rating, and a studio applied (locked) so it looks complete and shows up in Plex's genre browsing.
• Thumbnails — episodes with no thumbnail get generation triggered in Plex (a still frame plus scrubber previews). Generation runs in Plex's background queue, so results appear on a later scan; attempts are spaced ~30 minutes apart. Thumbnails that exist but are blank (Plex grabbed a fade-to-black/ white transition frame) are detected by pixel analysis and regenerated too. If Plex keeps producing a bad frame after a few tries, the tool generates the thumbnail itself: ffmpeg samples frames across the episode, scores them for detail and brightness, and uploads the best one. A Retry thumbnails button restarts the whole process for anything still missing.

This runs automatically after every Refresh Sources and whenever a new episode is added (AUTO_RECONCILE, on by default). The Library card shows the current state (coverage, metadata, and thumbnails in one per-arc view) and lets you scan or reconcile on demand; turn AUTO_RECONCILE off to make it manual-only.

Library coverage & upgrades

The dashboard scans your media folder and diffs it against the One Pace catalog, classifying every episode as present, upgradeable (an out-of-date CRC32 — a newer release exists), downloading (the new release is in the pipeline), or missing. Upgradeable episodes split into Upgrade Now (a download link is available — click to compare old vs new and queue the upgrade, individually or in a batch) and Cannot Upgrade Automatically (no link in the feed yet). The coverage report refreshes itself when an episode finishes or a pipeline action runs.

Extended cuts

Some episodes have both a standard and an extended cut. By default the extended cut is treated as the one to have (PREFER_EXTENDED): it's the canonical release in coverage, the RSS poll won't replace an extended cut on disk with a standard re-release, and extended files are tagged [Extended] in the filename.

Normalize file naming

The Normalize File Naming operation scans the library for files whose names don't match the canonical scheme (old arc titles, raw source names, a missing [Extended] tag, etc.), previews the old → new name for each, and batch-renames the selected ones.

Plex filename format

One Pace - {Arc Title} - S{season}E{episode} [{resolution}][{CRC32}].mkv
One Pace - {Arc Title} - S{season}E{episode} [{resolution}][{CRC32}][Extended].mkv   # extended cut

Examples:

• One Pace - Baratie - S05E01 [1080p][BE634289].mkv
• One Pace - Reverse Mountain - S09E02 [1080p][3B7CBD0F][Extended].mkv

Requirements

• qBittorrent with Web UI enabled
• Plex Media Server
• Docker

Deployment

Docker Compose (recommended)

Save this as docker-compose.yml, change the highlighted values, and run docker compose up -d. This is a complete, self-contained config — no .env or external network required.

services:
  one-pace-automator:
    image: ghcr.io/dyonng/one-pace-plex-automator:latest
    container_name: one-pace-automator
    restart: unless-stopped
    ports:
      - "8282:8282"
    environment:
      - RSS_FEED_URL=https://onepace.net/en/releases/rss.xml
      - QBIT_URL=http://192.168.1.10:8080      # qBittorrent Web UI (host IP)
      - QBIT_PASSWORD=CHANGE_ME                # <-- your qBittorrent password
      - PLEX_URL=http://192.168.1.10:32400     # <-- your Plex (host IP)
      - PLEX_TOKEN=CHANGE_ME                   # <-- your Plex token
      - TZ=America/Toronto                     # <-- your timezone
    volumes:
      - ./data:/data
      - /path/to/your/one-pace:/media/one-pace # <-- your One Pace show folder
      - /path/to/your/downloads:/downloads     # <-- qBittorrent's output folder

Then open http://<host>:8282 for the dashboard. See Configuration for the optional variables you can add to the environment: list.

Tip: prefer keeping secrets out of the compose file? Replace a value with ${PLEX_TOKEN} (etc.) and put PLEX_TOKEN=... in a .env file beside it — Compose loads it automatically. The repo's docker-compose.yml is set up this way and also supports joining an existing media-stack network so you can reference qBittorrent by container name instead of host IP.

Manual (docker run)

Run the published image directly, supplying config with --env-file (or repeated -e flags) and binding the two media paths:

docker run -d \
  --name one-pace-automator \
  --restart unless-stopped \
  --env-file .env \
  -p 8282:8282 \
  -v /path/to/your/one-pace:/media/one-pace \
  -v /path/to/your/downloads:/downloads \
  -v "$PWD/data:/data" \
  ghcr.io/dyonng/one-pace-plex-automator:latest

With --env-file, the ${VAR:-default} fallbacks in the compose file don't apply, so make sure every value you need is set explicitly in .env.

Configuration

Settings are passed as environment variables. Required values must be set; the rest fall back to the defaults shown.

Variable	Required	Description
RSS_FEED_URL	✅	One Pace RSS feed (e.g. https://onepace.net/en/releases/rss.xml)
QBIT_PASSWORD	✅	qBittorrent password
PLEX_URL	✅	Plex Media Server URL (use host IP if Plex runs on baremetal)
PLEX_TOKEN	✅	Plex authentication token
QBIT_URL		qBittorrent Web UI URL (default http://qbittorrent:8080)
QBIT_USERNAME		qBittorrent username (default admin)
QBIT_CATEGORY		Category applied to added torrents (default one-pace)
PLEX_LIBRARY_NAME		Plex library holding One Pace (default TV Shows)
POLL_CRON		Refresh Sources schedule (default */5 * * * *)
POLL_ENABLED		Gate the scheduled refresh; false = manual Refresh Sources only (default true)
DOWNLOAD_CHECK_SECONDS		qBittorrent completion-check interval (default 30)
AUTO_DOWNLOAD		Auto-download discovered releases (default true)
AUTO_POSTERS		Auto-apply posters to new seasons (default true)
AUTO_RECONCILE		Auto-sync Plex metadata & thumbnails on source changes/ingest (default true)
PREFER_EXTENDED		Prefer the extended cut when an episode has both (default true)
PREFER_ARABASTA		Render arc 14's title as "Arabasta" instead of the dataset's "Alabasta" (default true)
POSTER_REPO_RAW_BASE		Raw base URL for the poster repo (default: SpykerNZ — see Posters)
DISCORD_WEBHOOK_URL		Discord webhook URL for notifications
NOTIFY_NEW_EPISODE / NOTIFY_DOWNLOAD_COMPLETE / NOTIFY_EPISODE_UPDATED / NOTIFY_ERROR / NOTIFY_HEALTH		Per-event Discord toggles (all default true); no-op without a webhook
GOOGLE_SHEETS_API_KEY		Enables reading the official One Pace episode-guide sheets — an early metadata source for releases the dataset doesn't list yet
ANIMETOSHO_API_KEY		Optional AnimeTosho key (raises rate limits for torrent search)
TZ		Timezone for cron schedules (default UTC)

Two host paths are bound as volumes: your One Pace show root → /media/one-pace, and qBittorrent's output folder → /downloads (set these on the volumes: mounts in the compose example above). The dashboard's Settings panel is split into System & Services (polling, intervals, feed/integration URLs) and Preferences (AUTO_DOWNLOAD, AUTO_POSTERS, AUTO_RECONCILE, PREFER_EXTENDED, PREFER_ARABASTA); these can be edited live, and a dashboard override wins over the env value.

Finding your Plex token: Open Plex web UI, browse to any media item, open browser devtools → Network tab, look for X-Plex-Token in any request.

Download sources

Downloads come from the RSS feed: each release's magnet: URI is pulled from its RSS item and handed to qBittorrent. If an item has no magnet but does provide an http(s) .torrent URL (in its <enclosure> or <link>), that's used as a fallback — qBittorrent accepts either. Magnets are preferred because they carry the info hash inline; for a .torrent URL the hash is resolved from qBittorrent right after adding. There's no plain direct/HTTP file download (only torrents/magnets).

For episodes the feed no longer carries (older releases that show as upgradeable or missing in coverage), the dashboard can search AnimeTosho and Nyaa for a matching torrent and queue it directly.

Metadata source

Episode metadata (titles, descriptions, arc mappings, and the standard/extended CRC32 for every episode) is sourced from ladyisatis/one-pace-metadata (v2/metadata/data.min.json).

With a GOOGLE_SHEETS_API_KEY set, two Google Sheets supplement the dataset — the official One Pace episode guide and the metadata maintainer's working sheet. These are usually updated before the published dataset, so brand-new releases can be resolved (CRC32, titles, descriptions) without waiting for the dataset to catch up. Without a key the sheets are simply skipped.

Specials (the One Pace animated specials, including One Piece Fan Letter) are arc part 0 in the dataset and are handled like any other season — they land in Plex's native Season 0 / Specials, with the specials poster applied.

If a release appears in the feed before any source lists its CRC32, it's still downloaded provisionally when its arc can be identified from the title. If it can't be placed at all, the feed item is left pending rather than discarded, so a later poll retries it once the dataset or guide catches up.

A couple of releases have feed titles that aren't arc names and so can never be resolved that way — One Piece Fan Letter is the current example. These are matched by name and pinned to the slot the catalog already uses for them (Fan Letter → S00E98), so they download and inherit the right metadata.

Posters

Season and show posters are the fan-made artwork by /u/piratezekk — full credit for the poster set goes to them. The images are pulled from the SpykerNZ/one-pace-for-plex repo, which distributes them. When a brand-new season first appears, its poster is applied automatically (AUTO_POSTERS, on by default); existing seasons are left untouched so any art you set manually is preserved. The poster repo is also re-checked daily as part of the automatic reconcile (and during a manual Full Plex sync) — change detection is ETag-based, so unchanged images are skipped without re-downloading, and updated art flows in on its own. Point POSTER_REPO_RAW_BASE elsewhere to use a different source.

The repo ships two designs for the series poster. Set SHOW_POSTER_VARIANT to 2 (Settings → Preferences) to use the alternate one; season posters have a single design each and aren't affected. After changing it, use Re-apply posters on the Library card to push it right away.

Re-apply posters also forgets which posters are recorded as applied and uploads them all again — useful if Plex is missing art the app believes it already set.

Updates

Pull the new image and restart (e.g. docker compose pull && docker compose up -d) — the dashboard auto-reloads when the server restarts. The navbar's version button glows when a newer image has been published, a What's New modal shows the changelog entries added since your last visit, and clicking the version button opens the full changelog anytime (also in CHANGELOG.md).

Backups

The SQLite state (settings overrides, dashboard password hash, pipeline and reconcile state) is backed up nightly at 04:00 to /data/backups/ — plus on startup when the newest backup is older than a day — keeping the last 7. To restore, stop the container and copy a backup over data/state.db.

Tech stack

• Backend — TypeScript on Node.js 22; native http server with a tiny router (no Express), Zod-validated config, pino logging, node-cron scheduling
• State — SQLite via better-sqlite3 (WAL mode), single file at /data/state.db
• Frontend — Svelte 5 (runes) + Vite, Tailwind CSS v4 with DaisyUI v5; builds to static files served by the backend — no separate frontend server
• Integrations — Plex HTTP API, qBittorrent Web API, Discord webhooks, Google Sheets API (optional), AnimeTosho/Nyaa feeds
• Media — ffmpeg/ffprobe for thumbnail frame extraction; pure-JS jpeg-js / pngjs for pixel analysis (no native image dependencies)
• Packaging — multi-stage Alpine Docker image, built and published to GHCR by GitHub Actions on every push to main; releases are tagged semver images

Development

# Install deps (skips native build for Windows)
npm run install:dev

# Type check
npm run typecheck

# Unit tests (Vitest)
npm test

# Full build (backend tsc + frontend vite) — run before committing
npm run build

# Run locally (requires .env and the better-sqlite3 native build)
npm run dev

# Frontend-only development: mock backend + Vite HMR (no Plex/qBit needed)
npm run mock     # fake API on :8282
npm run dev:web  # HMR dev server proxying /api to :8282

See AGENTS.md for architecture details and CHANGELOG.md for release history.