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.
| Cross Platform |  |  |  |  |
|---|---|---|---|---|
| Deploy Docker Image | ✅ | ✅ | ✅ | ✅ |
| Run locally | ✅* | ✅* | ✅* |
*Requires Node installed
✨ Features
⚡ Usage
🖼️ Poster Sets
📅 Roadmap
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
magnetURIlinks 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.
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
.envfile in root (usesample.envas example) npm installnpm run buildnpm start
- create a
- Alternatively you can run it locally with node:
- 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:
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 ORGANIZEDPIPELINE_SKIP_VERIFY_PRESENT_FILES=truePIPELINE_SKIP_ORGANIZE_PRESENT_FILES=truePIPELINE_SKIP_UPDATE_METADATA_PRESENT_FILES=trueThis 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.
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 RUNPIPELINE_SKIP_VERIFY_PRESENT_FILES=falsePIPELINE_SKIP_ORGANIZE_PRESENT_FILES=falsePIPELINE_SKIP_UPDATE_METADATA_PRESENT_FILES=falseAfter 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.
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:latestcontainer_name: onepacerrrestart: unless-stoppedenvironment:
# 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=3600volumes:
- /mnt/Library/Series:/mnt/Library/Series
- /mnt/Applications/Downloads:/mnt/Applications/DownloadsInstall node (>=24 tested) on your machine then:
- create a
.envfile in root (usesample.envas example) - run
npm install - run
npm run build - run
npm start
For developing first install dependencies:
npm iThen, 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 devHere 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 Variables | Default | Description |
|---|---|---|
LOG_LEVEL | info | Can be critical, error, warning, info, debug. |
LOG_OUTPUT | text | Can be set to json if you need to scrape your logs with Loki/Promtail for Grafana. |
| Pipeline Variables | Default | Description |
|---|---|---|
🍏 PIPELINE_SKIP_VERIFY_PRESENT_FILES | true | If false, hashes files present in Plex upon metadata updates to ensure they are the latest/wanted versions. |
🍏 PIPELINE_SKIP_VERIFY_NOT_FOR_EXTENDED | false | If true, PIPELINE_SKIP_VERIFY_PRESENT_FILES only applies to episodes without extended or alternate versions |
🍏 PIPELINE_SKIP_ORGANIZE_PRESENT_FILES | true | If false, makes sure the files existing on your Library are in the correct folder and named correctly. |
🍏 PIPELINE_SKIP_UPDATE_METADATA_PRESENT_FILES | true | If false, automatically updates metadata for files already in your Library, otherwise only does so for new downloads. |
🍏 PIPELINE_SKIP_DOWNLOADS | false | If true, skips download. Use if you only want to organize your current files. |
🍏 PIPELINE_SKIP_DOWNLOADS_IMPORTS | false | If true, skips updating posters when updating metadata. |
PIPELINE_FORCE_REDOWNLOAD | false | If true, downloads and imports files even if already present. |
PIPELINE_SKIP_POSTERS | false | If true, skips updating posters when updating metadata. |
| --- | --- | --- |
PIPELINE_INCLUDE_SPECIALS | false | Set to true to also process specials. |
PIPELINE_PREFER_EXTENDED | false | Set to true to prioritize extended cuts over standard releases. |
PIPELINE_PREFER_ALTERNATE | false | Set to true to prefer the G-8 cut at the end of Skypiea. |
| --- | --- | --- |
PIPELINE_FILTERS_INCLUDE | None | Only process seasons/episodes that match these filters. |
PIPELINE_FILTERS_EXCLUDE | None | Only process seasons/episodes that don't match these filters. |
PIPELINE_RETRY_INTERVAL | 10 | Seconds to wait before re-running pipeline after failures. |
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:
PIPELINE_FILTERS_INCLUDE=S16E09PIPELINE_FILTERS_EXCLUDE=S35,S36PIPELINE_FILTERS_INCLUDE=E01PIPELINE_FILTERS_INCLUDE=E01PIPELINE_FILTERS_EXCLUDE=S35,S36In order for an episode to be Monitored (processed/downloaded/updated/etc), it has to match BOTH filters.
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.
| Library Variables | Default | Description |
|---|---|---|
⭐ LIBRARY_MEDIA_SERVER | plex | Media server, can be either plex, jellyfin, emby or none if you just want to organize files in a folder. |
🍤 LIBRARY_SERIES_NAME | One Pace | Name of the Series in Media Server. |
LIBRARY_SERIES_FOLDER_NAME | $LIBRARY_SERIES_NAME | Override if Media Server folder needs to be called differently from LIBRARY_SERIES_NAME. |
LIBRARY_FILENAME_FORMAT | {SERIES_NAME} - S{ARC}E{EPISODE} - {TITLE}.mkv | Overrides the filename each file should have, {SERIES_NAME}, {ARC}, {EPISODE} and {TITLE} will be replaced with values. .mkv automatically added if not specified. |
LIBRARY_CREATE_SHOW_IF_NOT_FOUND | true | If false, the app crashes if "LIBRARY_SERIES_NAME" isn't already a Show in your Media Server (useful for catching typos on first setup). Leave true to auto-create the show. |
LIBRARY_USE_HARDLINKS | false | If true, imports create a hardlink instead of copying, so the file only takes up space once and the torrent keeps seeding, and library renames move the file instead of copying it. Falls back to copying when the download and library folders are on different filesystems, which under Docker means anything not inside the same volume mount. Defaults to false (copy), which preserves the previous behaviour; set to true to enable hardlinks. |
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 - None | Default | Description |
|---|---|---|
🍤 LIBRARY_NONE_ROOT_FOLDER | C:\\OnePacerr | The root folder where your Library should be saved (Do not Include LIBRARY_SERIES_FOLDER_NAME). |
| 💭 Library - Plex Variables | Default | Description |
|---|---|---|
⭐ PLEX_URL | http://localhost:32400 | Plex URL. |
⭐ PLEX_TOKEN | None | Your Plex Token. |
🍤 PLEX_LIBRARY_NAME | TV Shows | Name of the Library in Plex. |
PLEX_SKIP_METADATA_FILES | true | If false, will generate .nfo and poster pngs even when Media Server is Plex. |
PLEX_PLEXMATCH_EVEN_IF_NOT | false | If true, will generate .plexmatch file even when using a different Media Sever. |
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 Variables | Default | Description |
|---|---|---|
⭐ JELLYFIN_URL | http://localhost:8096 | Jellyfin URL. |
⭐ JELLYFIN_USERNAME | None | Your Jellyfin username. |
⭐ JELLYFIN_PASSWORD | None | Your Jellyfin password. |
🍤 JELLYFIN_LIBRARY_NAME | Shows | Name of the Library in Jellyfin. |
| 💭 Library - Emby Variables | Default | Description |
|---|---|---|
⭐ EMBY_URL | http://localhost:8096 | Emby URL. |
⭐ EMBY_USERNAME | None | Your Emby username. |
⭐ EMBY_PASSWORD | None | Your Emby password. |
🍤 EMBY_LIBRARY_NAME | TV Shows | Name of the Library in Emby. |
| Torrent Variables | Default | Description |
|---|---|---|
🍤 TORRENT_CLIENT | qbittorrent | Your torrent client between: qbittorrent, deluge, transmisson or utorrent. |
⭐ TORRENT_URL | http://localhost:8080 | Your torrent API URL. |
⭐ TORRENT_USER | None | Your torrent API username. |
⭐ TORRENT_PASSWORD | None | Your torrent API password. |
TORRENT_CLIENT_TIMEOUT | 10 | Seconds to wait for torrent client to respond to requests, increase if you have a LOT of torrents. |
TORRENT_CATEGORY_FORCE | false | If true, when trying to add a torrent also forces a category update if torrent already exists with a different category. |
TORRENT_CATEGORY | onepacerr | Creates downloads with this category, also filters completed torrents using this. |
TORRENT_CATEGORY_ONCE_COMPLETED | completed | After processing completed downloads, changes the torrent category to this one. |
TORRENT_CHECK_INTERVAL | 60 | Seconds between checking for completed downloads. |
| Mount Configuration Variables | Default | Description |
|---|---|---|
MOUNT_LIBRARY_MEDIA_SERVER | None | Use these mapping variables if your Media Server uses different mount paths than the OnePacerr container. |
MOUNT_LIBRARY_ONEPACERR | None | Use these mapping variables if your Media Server uses different mount paths than the OnePacerr container. |
MOUNT_DOWNLOADS_TORRENT | None | Use these mapping variables if your Torrent Client uses different mount paths than the OnePacerr container. |
MOUNT_DOWNLOADS_ONEPACERR | None | Use these mapping variables if your Torrent Client uses different mount paths than the OnePacerr container. |
If you're not sure what Mount Path Mappings are you can have a read on TRaSH Guides.
| Metadata Variables | Default | Description |
|---|---|---|
METADATA_URL | https://onepacerr.com/api/v1 | Metadata API url (untested with different ones). |
METADATA_LANGUAGE | en | Currently only language supported. |
METADATA_POSTER_SET | default | Currently default equals piratezekk. There are also official and mizzoufan523 available. If a set is missing a poster it uses default. |
METADATA_DISABLE_WEBSOCKET | false | If true, disables WebSocket mode. NOT recommended but available if your setup doesn't allow WebSockets or Long Polling (also supported). |
METADATA_CHECK_INTERVAL | 3600 | Ignored if METADATA_DISABLE_WEBSOCKET is false (default). Seconds between checking for new metadata. |
You can preview all of the custom poster sets at the following links:
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.
If you want to contribute to the posters or create an entire new set, first of all I love you, then please read this.
The following diagram synthesizes the pipeline:
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)
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.
mizzoufan523by /u/Mizzoufan523.officialby One Pace's Team
- One Pace public API
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.