https://github.com/jesterr0/nfoforge

A powerful media upload assistant
https://github.com/jesterr0/nfoforge

assistant forge format gui imdb modern nfo nfoforge pyqt6 pyside6 rename tmdb ui upload wizard

Last synced: 3 months ago
JSON representation

A powerful media upload assistant

Host: GitHub
URL: https://github.com/jesterr0/nfoforge
Owner: jesterr0
License: gpl-3.0
Created: 2024-12-25T21:44:08.000Z (10 months ago)
Default Branch: main
Last Pushed: 2025-04-07T15:17:57.000Z (6 months ago)
Last Synced: 2025-04-11T00:42:05.714Z (6 months ago)
Topics: assistant, forge, format, gui, imdb, modern, nfo, nfoforge, pyqt6, pyside6, rename, tmdb, ui, upload, wizard
Language: Python
Homepage:
Size: 23 MB
Stars: 34
Watchers: 2
Forks: 0
Open Issues: 26
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE

Awesome Lists containing this project

README

# NfoForge

A powerful media upload assistant.

## Information

NfoForge is currently under active development, and I’m excited to share it with the community now that it has reached a stable stage.

At present, **Movies** are the only supported media type. However, support for **TV shows** and **Anime** is already planned and will be added in the near future.

Comprehensive documentation is on the way and will be available soon.

## Key Features

- Token system for advanced media file renaming.
- Integration with TMDB, IMDb, TVDB, and MAL for title parsing.
- Flexible Jinja-based template system for .NFO file generation.
- Screenshot generation and upload, including comparisons.
- Output file organization, saving .torrent and .NFO files to disk.
- Torrent cloning support for multi-tracker releases without re-generation.
- Duplicate release checker - checks trackers for duplicates pre-upload.
- Integration with Deluge, qBittorrent, Transmission, rTorrent, and watch folders, as well as fast resume support.
- Plugin support for Python (.py) and compiled (.pyd) files (.pyd compiled files require the same Python version as NfoForge).
- Support for movie files in MKV and MP4 format.
- Automatic detection for light/dark mode (with a manual override if desired) _Windows only_.
- Additional format support and features coming soon!

## Supported Trackers

- BeyondHD
- MoreThanTV
- TorrentLeech
- PassThePopcorn
- ReelFliX
- Aither
- HUNO
- LST

_Supported trackers will be added overtime, if you'd like a tracker added open an [issue](https://github.com/jesterr0/NfoForge/issues/new) and it will be considered_

## Supported Operating Systems

- Windows 8.1+
- Linux (tested on Ubuntu 24.04.1 LTS)

## Supported Image Hosts

- Chevereto v3/v4
- ImageBox
- ImageBB
- PTPIMG

## Requirements

- TMDB Api [key (v3)](https://www.themoviedb.org/settings/api)
- TVDB Api [key](https://thetvdb.com/api-information)
- FFMPEG and/or [FrameForge **1.4.0**](https://github.com/jessielw/FrameForge/) depending on your preferred image generation type

## Thanks and Credits

- aiohttp
- beautifulsoup4
- cinemagoer
- deluge-web-client
- Guessit
- iso639-lang
- jinja2
- L4G's Upload Assistant, for inspiration
- pymediainfo
- pyimgbox
- PySide6
- qbittorrent-api
- requests
- tomlkit
- torf
- transmission-rpc

## Basic Setup Guide

- Download the current latest release, extract, and run the executable (or run it in your python environment).
- You should go through **Settings** and setup a few required things.
- Create a template, when you select the button to create a new one you'll be presented with a very basic starting template.

- You are **required** to have a TMDB Api Key (v3), set this below.

- You'll of course want to enable you desired tracker(s).
enable trackers
- Ensure you expand the tracker and fill out the required details.
tracker details
- You can simply save your settings, open a file and walk through the wizard to complete your upload.