Skip to content

tissla/opforjellyfin

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

89 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

🏴‍☠️ OpforJellyfin

OpforJellyfin-logo

CLI-tool to automate download and organisation of One Pace episodes for Jellyfin!

✨ Torrent downloads
✨ Placement after Jellyfin standards
✨ Matched to metadata shamelessly stolen from SpykerNZ/one-pace-for-plex


📢 NEWS

Opfor 1.1.0 release!

I've taken the time to finally update! Notable new features/bugfixes:

  1. Seeder-mode
  2. Quality filters
  3. Search-result caching
  4. Further concurrency issue fixes
  5. A bug where 'sync' would spam missing metadata shamelessly
  6. Download progress bars would sometimes swap places mid-download, making the CLI look glitchy

And more! Don't hesitate to post issues as you find them.

Future plans:

  1. 'sort' command - To target a directory containing files, and renaming/sorting them into your metadata directory.

📸 Examples

  1. Example command:

    ./opfor list -t wano

    List view example

  2. Downloading episodes:

    ./opfor download 1 3

    Download view example

  3. Finished download shows file placement:

    Finished download

  4. Keep track of what you have:

    ./opfor info

    Info

  5. And much more!

🔧 Installation

You can choose to either use one of the released versions or build from source yourself.

For this program to work, you need to have 'git' installed.

MacOS / Linux:

  1. Download the file for your system.

  2. Run chmod +x opfor to make the file runnable.

  3. Run with ./opfor --help to get started.

Windows:

  1. Download the .exe file.

  2. Run the file in Powershell or Windows Terminal with .\opfor.exe --help to get started.

A terminal that supports unicode-characters is heavily recommended for best experience.

Build from source

  1. Install Go (version ≥ 1.23)

  2. Clone repo:

    git clone https://github.com/tissla/opforjellyfin.git
    cd opforjellyfin
  3. Build binary:

    go build -o opfor

🚀 Usage (Start Here!)

  1. Set your download directory before doing anything else. All your metadata will be stored here, and downloads will be matched to their proper folders.

    ./opfor setDir "/media/One Piece/One Pace"
  2. Find all available episodes with 'list', or use the -t flag to specify a title, or -r flag to specify a chapter-range.

    ./opfor list
    ./opfor list -t Wano
    ./opfor list -r 15-20
  3. Download a torrent by using the downloadkey, displayed in front of the title. You can download one or multiple at the same time.

    ./opfor download 15 16 17

📦 Metadata

I hope to continually update metadata here!

The 'sync' command allows the user to stay up to date with new additions to the metadata-repo.

Steps to make sure Jellyfin doesn't mess with the metadata

  1. Create a library with no metadata-fetchers active just for One Pace. Disable all of them!

  2. Make sure the show is unlocked for changes.

  3. Run ./opfor sync again if Jellyfin messed up your .nfo files before this.

  4. Rescan library with unlocked metadata and no fetchers active.

🤝 Contributions

All pull requests are welcome. All criticisms are welcome. I'm here to build and to learn and to get better.

❤️ Acknowledgements

  • SpykerNZ for his metadata
  • Anacrolix awesome torrent lib
  • Charm team for cool stuff that I should use more
  • One Pace team for their amazing work!

⚠️ Disclaimer

This tool is provided as-is with no guarantees or warranties.
Use it at your own risk.

While care has been taken to avoid destructive behavior, this tool manipulates files and downloads torrents – always review the source code and test cautiously.
The author is not responsible for any damage to your system, loss of data, or violation of terms of service related to the use of this software.

Also note:
This project is not affiliated with One Pace, Jellyfin, or any content providers. Please respect local laws and copyright regulations.

About

Fetches One Pace downloads and metadata

Resources

License

Stars

99 stars

Watchers

4 watching

Forks

Packages

 
 
 

Contributors

Languages