Skip to content

Frequently Asked Questions

Jump to bottom
isatis edited this page Oct 13, 2025 · 2 revisions

Is Pixeldrain supported?

Any that are separated into "English Subtitles" and "English Dub" are unsupported as there's too many to create CRC32 metadata files for, and no automatic way to tell which video files from Pixeldrain correspond to which episode. You're welcome to download the episodes folder from the metadata repository and put it inside the metadata folder, search for the corresponding episode file and copy its contents using the instructions here, however that may take a lot of time compared to just grabbing the video files the non-Pixeldrain way.

However, and especially for new One Pace releases, there is the option for Direct Download of episodes from Pixeldrain that do NOT contain "English Subtitles" or "English Dub" in the filename. Direct Download files are supported.

How do I download this?

If you are new to One Pace and new to Jellyfin/Plex, or you want something more straightforward, you probably want to download the "GUI" variant of this program. This one will provide you with an actual program to run on your desktop PC, especially if Plex or Jellyfin is hosted on the same machine.

If you're running Plex/Jellyfin on a server, and the server is separate from the computer you're reading this from (like on a desktop PC), then you're most likely going to need to run One Pace Organizer on said server because it'll be faster, and you'll need all of the One Pace .mkv/.mp4 files.

The latest release is located here. The best way is to download any of the .zip files:

  • Windows: OnePaceOrganizer-windows-x86_64.zip
  • macOS: OnePaceOrganizer-macos-arm64.zip
  • Linux: OnePaceOrganizer-linux-x86_64.zip

Inside the zip, there's the "GUI" and "CLI" versions. Use the "GUI" if you are a beginner or want it as a desktop program, especially if you host Plex or Jellyfin locally, or use the "CLI" version if you're an advanced user or want it as a program that runs in the console or Terminal.

If you want something more portable, then these can be downloaded instead:

  • GUI:
    • Windows: OnePaceOrganizer-gui-windows-x86_64.exe
    • macOS: OnePaceOrganizer-gui-macos-arm64
    • Linux: OnePaceOrganizer-gui-linux-x86_64
  • CLI:
    • Windows: OnePaceOrganizer-cli-windows-x86_64.exe
    • macOS: OnePaceOrganizer-cli-macos-arm64
    • Linux: OnePaceOrganizer-cli-linux-x86_64

The posters.zip file is for if you want to download the portable version, but don't want to spend time downloading the posters one by one via the automatic downloader located inside the program.

How do I run this?

If you're running on Windows: double click the .exe you wish to run. It may take anywhere from 5-15 seconds to launch, but it'll run. If you get a blue "Windows protected your PC" that says "Microsoft Defender SmartScreen prevented an unrecognized app from starting", click "More info" and then "Run anyway". (It's safe to do so, and the reason you get this is that Microsoft wants $400 for a developer certificate to "sign" the program that I can't afford to pay.)

If you're running from Mac or Linux, this gets a little more trickier but not awful. In most cases, double clicking it will also open it. If it doesn't... in your Apps/Programs list, find Terminal. If you've downloaded the file and it's sitting in Downloads, type cd Downloads and hit Enter, and then (on Mac) chmod +x OnePaceOrganizer-gui-macos-arm64 or (on Linux) chmod +x OnePaceOrganizer-gui-linux-x86_64 to make it runnable, and this only needs to be done once. Finally, when you want to start the program, type (on Mac) ./OnePaceOrganizer-gui-macos-arm64 or (on Linux) ./OnePaceOrganizer-gui-linux-x86_64 and hit Enter.

Can I rename the program?

Yes.

It's opened, now how do I use this?

The first thing to do, especially if you're new to One Pace and haven't uploaded it yet, is to grab all of the .mkv and/or .mp4 (the latter is very rare) and put them into a folder. For example, you might want to create a folder named "in" and put all hundreds of One Pace files in there.

If your Jellyfin or Plex library folders have sections e.g. "Anime", "TV Shows", "Movies", and all of the folders inside there are the names of the shows/movies/etc., your library ("output") folder might look something like:

  • Windows: C:\Plex_or_Jellyfin\Anime\One Pace
  • Mac/Linux: /mnt/harddrive/Anime/One Pace

This is going to be the folder that Season 01, Season 02, ...and so on and all of the subsequent video files will be put into.

So the "input" folder is going to be that folder with the hundreds of One Pace files, and the "output" will be where your One Pace library will end up that Jellyfin or Plex will be reading from.

If you're using Plex: the way it'll set the season and episode titles, descriptions, posters, and so on will be through the Plex API, so you'll need to log in to Plex via the Organizer program. This avoids having to install addons that are hit or miss on whether they apply the information to the episode or not. If you're having connection issues or you don't see your Plex server listed, you can go to Configuration > Edit Plex Server URL and set the Plex server, e.g. http://127.0.0.1:32400 if you're hosting it locally, or replacing 127.0.0.1 with the IP that the Plex server is running on.

After everything is set and configured, click "Start".

On Jellyfin: the files should automatically be moved and renamed by the program, and metadata, like episode titles, descriptions, and so on, will be going alongside it, and Jellyfin should be able to automatically pick it up. Once it's done, exit out of the program.

On Plex, this is a two-step process where it'll tell you to upload what's moved and renamed to Plex (especially if Plex isn't on the same computer you're running it from), and wait for the episodes to show up in the library. The second step will be the one that contacts Plex and renames the season and episode titles and descriptions for you.

If you're using the CLI version, it should present these steps akin to a wizard that will guide you through this. If the screen goes dark at any point, it's most likely working and you don't need to exit out.

I've already uploaded my One Pace collection to Jellyfin/Plex, how do I get episode titles/descriptions generated?

If this is the first time running it, just head to Configuration > Action after Scanning > Generate metadata only (in the GUI) or choose the "Metadata only" option (in the CLI). This will check and update it for each item in your library, so it may take awhile, and only needs to be done once.

This program is more geared toward setting up One Pace for the first time before anything has been uploaded to Jellyfin/Plex as a library manager, so it's recommended to do that instead, so it avoids having to generate the metadata for all hundreds of episodes. In the future, there may be an option to generate it for one or a few, but this would be down the road.

What about for new One Pace episode releases?

The great thing about One Pace Organizer is that it does not need all One Pace releases to get season/episode titles and descriptions working. In your input folder, e.g. that folder where it'll read the directory of "unsorted" One Pace files, put any number of the new releases in there, with your Plex/Jellyfin library as the output folder.

Can I set my own season or episode posters or backgrounds?

Yes, see the Posters and Backgrounds page.

How do I run this from source?

Install the uv package manager.

  1. If you do not have Python installed, you can install Python via uv python install which will lead into the next steps.
  2. Create a folder containing nothing except the .mkv (or .mp4) files.
  3. Open PowerShell (Windows) or Terminal (Mac/Linux) and cd to the One Pace Organizer folder where main.py resides, then run the program via one of three ways:
  • Qt GUI: uv run main.py gui
  • Console UI: uv run main.py console
  • Headless/Non-Interactive: uv run main.py headless

Note that running this from the main branch can have a lot of bugs, and while beta testing is appreciated, you may want to stick with the releases instead as they will be stable.

Why does it say "Skipping" for one or all of the releases?

If it's saying "Skipping", it's more than likely you have very old releases that the program is unaware of, and you'll need to get the newer versions of the one it is skipping.

Less likely culprit is that the file may be corrupt. Check to see that it plays. If it's not corrupt, file a bug in the Issues tab with the name of the filename and the CRC32.

How do I run the "headless" version?

For the non-interactive "headless" version, it's recommended to do ./OnePaceOrganizer-cli headless in Terminal, or uv run main.py headless if you're running from source. This is for very advanced users who know what they're doing with system administration.

Options can be found by supplying the --help flag at the end, and/or seeing the Environment Variables and Command Line Arguments page.

I ran into a bug, how do I report it?

Please report all bugs in the Issues tab, and search beforehand to make sure it hasn't been reported.

What is the source of the season and episode titles, descriptions, etc.?

The metadata is all gathered from these:

Am I able to use the metadata in my program?

Yes, no need to ask! See the one-pace-metadata GitHub project for more information. The format should stay consistent barring any feature updates, but given that there's a couple of projects that already depend on that, I do not expect the JSON/YAML format to change at all, or if it does, it'll be as a separate JSON file.

What if I want to provide my own episode title/description?

Metadata for custom episodes, e.g. non-One Pace episodes like Muhn Pace or Onigashima Paced, can be added if you know the CRC32 of the file, by making a .yml file for it in the metadata/episodes folder. This page has more details on it.

What happens if there's 2 CRC32's?

I hope this doesn't happen, because it means One Pace has actually put out 800,000 episodes, but in case there's two clashing CRC32 IDs, the metadata has a blake2 option that is the first 16 characters of the Blake2s hash. (Why Blake2? It's one of the fastest file hash algorithms, which is better for evaluating large files like a One Pace release.)

In Linux, the hash can be retrieved by: b2sum -l 16 <file_path>

Clone this wiki locally