[!WARNING]
If you're having issues connecting to websocket, please update to at least v1.8.11. In fact, please update to current latest anyways :) a lot of bugs fixes and performance improvements have been made.

Automated One Pace downloads and metadata for Plex, Jellyfin, and Emby

Built to complement your Sonarr stack

Because Sonarr does not natively support One Pace (the fan-edited, manga-accurate version of One Piece), this app bridges the gap by automatically downloading, organizing, and keeping your One Pace episodes fully up to date both on your disk, and on your Media Server of chosing (Plex, Jellyfin, Emby).

Other than organizing your episode files, it also updates metadata and posters so that it looks nice and professional on your Media Server.

It supports the most popular torrenting clients (qBittorrent, deluge, µTorrent and transmission) and the most popular Media Servers (Plex, Jellyfin, Emby), or it can even be used without a torrenting client or a Media Server at all.

Also check One Pace public API.

Not affiliated with One Pace's team.

Supported Torrenting Clients

Supported Media Servers

Works anywhere

Cross Platform
Deploy Docker Image	✅	✅	✅	✅
Run locally		✅*	✅*	✅*

*Requires Node installed

📃 Table of Contents

• ✨ Features

• 🚀 Getting Started

  • 🧳 Prerequisites
  • 📝 Recommended configs
    • 🐔 Base Operation
    • 🐣 First Run

• ⚡ Usage

  • 🐳 Deploy via Docker
  • 🟢 Running locally
  • 👩‍💻 Contributing to the development

• ⚙️ Environment Variables Explained

  • 🧪 Pipeline
  • 🔎 Filters
  • 🎬 Library (common)
    • 📂 Library (Local Folder)
    • 🍊 Library (Plex Media Server)
    • 🪼 Library (Jellyfin)
    • ✳️ Library (Emby)
    • 💾 Torrent
    • 💿 Mount Path Mappings
    • ℹ️ Metadata

• 🖼️ Poster Sets

  • 🔍 Previews
  • 📥 Adding/Updating Sets

• 🧪 Pipeline Diagram

• 📅 Roadmap

• 🤝 Credits & Acknowledgements

• 💗 Support (One Pace, not me!)

✨ Features

• Automated Discovery: Continuously pulls One Pace's RSS Release feed and metadata to detect missing and new releases.

• Smart Library Scanning: Scans your existing Media Server (Plex, Jellyfin, Emby) or Local Folder Library to compare latest episodes against your local files.

• File Verification (Optional): Hashes existing files to ensure they match the latest releases and automatically re-downloads outdated versions.

• File Organization (Optional): Scans your existing Media Server (Plex, Jellyfin, Emby) or Local Folder library and renames files accordingly when needed.

• Seamless Downloading (Optional): Automatically sends magnetURI links to torrent client for missing episodes.

• Torrent Monitoring (Optional): Tracks download progress. Once completed, it:

  • Copies and renames the file to your designated Library folder.
  • Updates the metadata either directly on your Media Server (Plex, Jellyfin, Emby) or creates the files on your Local Folder for later imports.
  • Assigns a custom (completed) category to the processed torrents.

🚀 Getting Started

🧳 Prerequisites

Before running OnePacerr, ensure you have the following services up and running:

• Docker & Docker Compose (or k8s, or custom app in Truenas or equivalent)
  • Alternatively you can run it locally with node:
    • create a .env file in root (use sample.env as example)
    • npm install
    • npm run build
    • npm start
• one of these torrent clients (with WebUI/APIs enabled)
  • qBittorrent (Recommended)
  • Deluge
  • More torrenting clients coming
• You can simply organize a Local Folder, but the best use case is to organize your Media Server of choosing:
  • Plex Media Server
  • Jellyfin
  • Emby

📝 Recommended configs

🐔 Base Operation

If your files are nicely named and organized and if your Media Server has all the metadata, you can safely leave these as true (default) or not declare them at all:

# 🐔 BASE CONFIG WHEN YOUR LIBRARY IS ALREADY WELL ORGANIZED
PIPELINE_SKIP_VERIFY_PRESENT_FILES=true
PIPELINE_SKIP_ORGANIZE_PRESENT_FILES=true
PIPELINE_SKIP_UPDATE_METADATA_PRESENT_FILES=true

This will prevent the app to verify hash (CRC32 hashing can take a while depending on your machine), to verify Media Server file names (and rename where necessary) and to update metadata for the files that are already present on it.

🐣 First Run

My recommendation when Media Server already has some/all of the episodes is to run it once with the following configs, so that every file is gonna get verified to be up to date and all metadata is gonna be imported.

# 🐣 RECOMMENDED CONFIG FOR FIRST RUN
PIPELINE_SKIP_VERIFY_PRESENT_FILES=false
PIPELINE_SKIP_ORGANIZE_PRESENT_FILES=false
PIPELINE_SKIP_UPDATE_METADATA_PRESENT_FILES=false

After the app is done processing all of the present seasons/episodes, it's gonna continue monitoring for completed downloads and import as usual.

You can also optionally disable downloads for this first run, then stop the app once it's done and update the env vars to keep it running with the basic config.

⚡ Usage

🐳 Deploy via Docker

The recommended way to deploy is via docker-compose.

Create a docker-compose.yml file and copy the configuration below. Make sure to update the environment variables and volume mounts to match your server's setup.

I listed every env variable for convenience. All default are commented out, except the most critical.

services:
  onepacerr:
    image: ghcr.io/eltharynd/onepacerr:latest
    container_name: onepacerr
    restart: unless-stopped
    environment:
      # Set the Timezone to yours
      - TZ=Europe/Zurich
      # Set the User/Group it should run as.
      # This User/Group should have read access to torrent folder
      # This User/Group should have read/write access to library folder
      # Your Media Server User/Group should also have read access to library folder
      - PUID=568
      - PGID=568

      # General
      #- LOG_LEVEL=info
      #- LOG_OUTPUT=text



      # Pipeline
      - PIPELINE_SKIP_VERIFY_PRESENT_FILES=false
      #- PIPELINE_SKIP_VERIFY_NOT_FOR_EXTENDED=false
      - PIPELINE_SKIP_ORGANIZE_PRESENT_FILES=false
      - PIPELINE_SKIP_UPDATE_METADATA_PRESENT_FILES=false
      #- PIPELINE_SKIP_DOWNLOADS=false
      #- PIPELINE_SKIP_DOWNLOADS_IMPORTS=false
      #- PIPELINE_FORCE_REDOWNLOAD=false
      #- PIPELINE_SKIP_POSTERS=false

      #- PIPELINE_INCLUDE_SPECIALS=false
      - PIPELINE_PREFER_EXTENDED=true
      - PIPELINE_PREFER_ALTERNATE=true

      #- PIPELINE_FILTERS_INCLUDE=S01
      #- PIPELINE_FILTERS_EXCLUDE=S35,S36

      #- PIPELINE_RETRY_INTERVAL=10



      # Library 
      - LIBRARY_MEDIA_SERVER=plex 
      - LIBRARY_SERIES_NAME=One Pace
      #- LIBRARY_SERIES_FOLDER_NAME=One Pace

      #- LIBRARY_FILENAME_FORMAT={SERIES_NAME} - S{ARC}E{EPISODE} - {TITLE}.mkv
      #- LIBRARY_CREATE_SHOW_IF_NOT_FOUND=true


      # Library - None
      #- LIBRARY_NONE_ROOT_FOLDER=C:\\OnePacerr

      # Library - Plex
      - PLEX_URL=http://localhost:32400
      - PLEX_TOKEN=<your-token-here>
      - PLEX_LIBRARY_NAME=TV 
      #- PLEX_SKIP_METADATA_FILES=true 
      #- PLEX_PLEXMATCH_EVEN_IF_NOT=false 
      
      # Library - Jellyfin
      - JELLYFIN_URL=http://localhost:8096
      - JELLYFIN_USERNAME=<your-username-here>
      - JELLYFIN_PASSWORD=<your-password-here>
      #- JELLYFIN_LIBRARY_NAME=Shows

      # Library - Emby
      - EMBY_URL=http://localhost:8096
      - EMBY_USERNAME=<your-username-here>
      - EMBY_PASSWORD=<your-password-here>
      #- EMBY_LIBRARY_NAME=TV Shows




      # Torrent Settings
      - TORRENT_URL=http://localhost:8080
      - TORRENT_USER=<your-username-here>
      - TORRENT_PASSWORD=<your-password-here>
      - TORRENT_CLIENT=qbittorrent
      #- TORRENT_CLIENT_TIMEOUT=10
      #- TORRENT_CATEGORY_FORCE=false
      #- TORRENT_CATEGORY=onepacerr
      #- TORRENT_CATEGORY_ONCE_COMPLETED=completed
      #- TORRENT_CHECK_INTERVAL=60



      # Cross-Mount Mappings (Uncomment if needed, defaults to nothing)
      #- MOUNT_LIBRARY_MEDIA_SERVER=/mnt/Library/Series
      #- MOUNT_LIBRARY_ONEPACERR=\\TRUENAS\series
      #- MOUNT_DOWNLOADS_TORRENT=/mnt/Applications/Downloads
      #- MOUNT_DOWNLOADS_ONEPACERR=\\TRUENAS\downloads



      # Metadata Settings
      #- METADATA_URL=https://onepacerr.com/api/v1
      #- METADATA_LANGUAGE=en
      #- METADATA_POSTER_SET=default
      #- METADATA_DISABLE_WEBSOCKET=false
      #- METADATA_CHECK_INTERVAL=3600
    volumes:
      - /mnt/Library/Series:/mnt/Library/Series
      - /mnt/Applications/Downloads:/mnt/Applications/Downloads

🟢 Running locally

Install node (>=24 tested) on your machine then:

• create a .env file in root (use sample.env as example)
• run npm install
• run npm run build
• run npm start

👩‍💻 Contributing to the development

For developing first install dependencies:

npm i

Then, I recommend opening two side-by side tabs in vs code terminal and running one of these in each:

#Compile typescript and watch for changes
#if you have typescript installed globally `npm i -g typescript`
tsc -w
#otherwise you can do
npx tsc -w


#Shortcut for nodemon --enable-source-maps dist/index.js
#runs app and reloads any time tsc-w recompiles an edited file
npm run dev

⚙️ Environment Variables Explained

Here is a breakdown of key optional variables you can adjust in your docker-compose.yml or in your .env file:

• ⭐ Mandatory
• 🍤 Can leave empty but double check default works for you
• 🍏 Useful
• 💭 These configuration are specific to your chosen Media Server type ($LIBRARY_MEDIA_SERVER) so you only need to specify the ones for your case.

General

🧪 Pipeline

🔎 Filters

PIPELINE_FILTERS_INCLUDE and PIPELINE_FILTERS_EXCLUDE are lists of 'filters' as a comma separated string. For example: filter1,filter2,filter3.

Each filter can either match a specific season number, episode number or both. Meaning they can either be Sxx, SxxExx or Exx. For example S01E06 would match only S01E06, whilst S02 would match every episode in S02, and E06 would match episode 6 of every season (don't ask why).

This should give you flexibility to decide to only process whatever you want instead of the whole thing, by combining the _INCLUDE and _EXCLUDE filters.

Here's a couple of setup examples:

Only monitor S16E09 (Probably because you want to re-watch '32:54')

PIPELINE_FILTERS_INCLUDE=S16E09

Monitor all seasons before Wano (S35)

PIPELINE_FILTERS_EXCLUDE=S35,S36

Monitor all first episodes of each Season

PIPELINE_FILTERS_INCLUDE=E01

Monitor all first episodes of each Season, except Wano and Egghead (35,36)

PIPELINE_FILTERS_INCLUDE=E01
PIPELINE_FILTERS_EXCLUDE=S35,S36

In order for an episode to be Monitored (processed/downloaded/updated/etc), it has to match BOTH filters.

🎬 Library (Common)

[!IMPORTANT]
Configure the Library (Media Server) type here.

none just organizes files in a folder, when metadata is updated it creates .plexmatch, .nfo, poster.png and all of the files that can be then used to automatically add metadata if imported to a Media Server at a later time.

plex Plex Media Server.

jellyfin Jellyfin Media Server.

emby Emby Media Server.

[!IMPORTANT] Concerning Hard Links

In short, hard links is a way to copy a file (in this case from download folder to library folder) instantaneously and without taking double the space on your disk. There are limitations, however, the most important is that the two folders have to live on the same drive. Only turn on if you know what your doing.

Read more about it on trash guides.

📂 Library (Local Folder)

🍊 Library (Plex Media Server)

Note on PLEX_SKIP_METADATA_FILES: Metadata for plex is set via API because doing so with just the files is unreliable at best. For this reason, when LIBRARY_MEDIA_SERVER is set to plex, by default (PLEX_SKIP_METADATA_FILES=true) OnePacerr will not generate the .nfo and the various poster.png on the Media Server folder.

If you set PLEX_SKIP_METADATA_FILES=false, you can instead generate those files regardless. This is useful if you want to use the same media folder for multiple Media Servers, or if you just would rather create all of the metadata in case you ever change Media Server (it doesn't take that much space anyways).

🪼 Library (Jellyfin)

✳️ Library (Emby)

💾 Torrent

💿 Mount Path Mappings

If you're not sure what Mount Path Mappings are you can have a read on TRaSH Guides.

ℹ️ Metadata

🖼️ Poster Sets

🔍 Previews

You can preview all of the custom poster sets at the following links:

• piratezekk (default)
• mizzoufan523
• official

When a poster is missing from the set, you will se a placeholder in these preview.

When updating metadata, a missing poster results in falling back to default.

📥 Adding/Updating Sets

If you want to contribute to the posters or create an entire new set, first of all I love you, then please read this.

🧪 Pipeline Diagram

The following diagram synthesizes the pipeline:

📅 Roadmap

• Support uTorrent since v1.7.5

• Support Transmission since v1.7.5

• Support hard/softlinks Thanks to Rasbandit #25 since v1.7.20

• Docusaurus documentation

• Rest API Manual execution/status/configuration endpoints

• Support Libraries with multiple folders (currently only gets the first result from API)

• Request a new feature

🤝 Credits & Acknowledgements

This project wouldn't be possible without the incredible work of the community:

• One Pace: The incredible team behind the unofficial fan edits.
• For the custom poster artwork sets:
  • piratezekk (default) by /u/piratezekk.
    • Name spelling normalization and new Elpbaph matching poster by @3 from One Pace's Discord.
  • mizzoufan523 by /u/Mizzoufan523.
  • official by One Pace's Team
• One Pace public API

💗 Support (One Pace, not me!)

Please do not donate to me for this tool.

Instead, please show your support for the team doing the heavy lifting by backing One Pace.

Go Back up