{"id":26644966,"url":"https://github.com/jesterr0/nfoforge","last_synced_at":"2025-07-04T09:36:31.127Z","repository":{"id":270172897,"uuid":"908363424","full_name":"jesterr0/NfoForge","owner":"jesterr0","description":"A powerful media upload assistant","archived":false,"fork":false,"pushed_at":"2025-04-07T15:17:57.000Z","size":24142,"stargazers_count":34,"open_issues_count":26,"forks_count":0,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-04-11T00:42:05.714Z","etag":null,"topics":["assistant","forge","format","gui","imdb","modern","nfo","nfoforge","pyqt6","pyside6","rename","tmdb","ui","upload","wizard"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/jesterr0.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-12-25T21:44:08.000Z","updated_at":"2025-04-07T15:12:44.000Z","dependencies_parsed_at":"2025-02-18T22:22:52.311Z","dependency_job_id":"67a0bf33-bc72-4467-ab0d-50cd6e9598fc","html_url":"https://github.com/jesterr0/NfoForge","commit_stats":null,"previous_names":["jesterr0/nfoforge"],"tags_count":9,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jesterr0%2FNfoForge","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jesterr0%2FNfoForge/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jesterr0%2FNfoForge/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jesterr0%2FNfoForge/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/jesterr0","download_url":"https://codeload.github.com/jesterr0/NfoForge/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248322601,"owners_count":21084336,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["assistant","forge","format","gui","imdb","modern","nfo","nfoforge","pyqt6","pyside6","rename","tmdb","ui","upload","wizard"],"created_at":"2025-03-24T21:21:07.628Z","updated_at":"2025-07-04T09:36:31.111Z","avatar_url":"https://github.com/jesterr0.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# NfoForge\n\nA powerful media upload assistant.\n\n## Information\n\nNfoForge is currently under active development, and I’m excited to share it with the community now that it has reached a stable stage.\n\nAt 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.\n\nComprehensive documentation is on the way and will be available soon.\n\n## Key Features\n\n- Token system for advanced media file renaming.\n- Integration with TMDB, IMDb, TVDB, and MAL for title parsing.\n- Flexible Jinja-based template system for .NFO file generation.\n- Screenshot generation and upload, including comparisons.\n- Output file organization, saving .torrent and .NFO files to disk.\n- Torrent cloning support for multi-tracker releases without re-generation.\n- Duplicate release checker - checks trackers for duplicates pre-upload.\n- Integration with Deluge, qBittorrent, Transmission, rTorrent, and watch folders, as well as fast resume support.\n- Plugin support for Python (.py) and compiled (.pyd) files (.pyd compiled files require the same Python version as NfoForge).\n- Support for movie files in MKV and MP4 format.\n- Automatic detection for light/dark mode (with a manual override if desired) _Windows only_.\n- Additional format support and features coming soon!\n\n## Supported Trackers\n\n- BeyondHD\n- MoreThanTV\n- TorrentLeech\n- PassThePopcorn\n- ReelFliX\n- Aither\n- HUNO\n- LST\n\n_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_\n\n## Supported Operating Systems\n\n- Windows 8.1+\n- Linux (tested on Ubuntu 24.04.1 LTS)\n\n## Supported Image Hosts\n\n- Chevereto v3/v4\n- ImageBox\n- ImageBB\n- PTPIMG\n\n## Requirements\n\n- TMDB Api [key (v3)](https://www.themoviedb.org/settings/api)\n- TVDB Api [key](https://thetvdb.com/api-information)\n- FFMPEG and/or [FrameForge **1.4.0**](https://github.com/jessielw/FrameForge/) depending on your preferred image generation type\n\n## Thanks and Credits\n\n- aiohttp\n- beautifulsoup4\n- cinemagoer\n- deluge-web-client\n- Guessit\n- iso639-lang\n- jinja2\n- L4G's Upload Assistant, for inspiration\n- pymediainfo\n- pyimgbox\n- PySide6\n- qbittorrent-api\n- requests\n- tomlkit\n- torf\n- transmission-rpc\n\n## Basic Setup Guide\n\n- Download the current latest release, extract, and run the executable (or run it in your python environment).\n- You should go through **Settings** and setup a few required things.\n  - Create a template, when you select the button to create a new one you'll be presented with a very basic starting template.\u003cbr\u003e\u003cimg src=\"https://github.com/user-attachments/assets/083e31d5-8f3e-4b94-a3e2-5acc1672d1e5\" alt=\"template\" width=\"350\"\u003e\n  - You are **required** to have a TMDB Api Key (v3), set this below.\u003cbr\u003e\u003cimg src=\"https://github.com/user-attachments/assets/3839b849-eca6-4ddd-b2b7-611f0d4b5226\" alt=\"tmdb api key\" width=\"350\"\u003e\n  - You'll of course want to enable you desired tracker(s).\u003cbr\u003e\u003cimg src=\"https://github.com/user-attachments/assets/2410b5d6-f771-4d1d-999b-06a739296861\" alt=\"enable trackers\" width=\"350\"\u003e\n    - Ensure you expand the tracker and fill out the required details.\u003cbr\u003e\u003cimg src=\"https://github.com/user-attachments/assets/85c19583-a14e-47f1-8d1c-4026375774f7\" alt=\"tracker details\" width=\"350\"\u003e\n- You can simply save your settings, open a file and walk through the wizard to complete your upload.\n\n_This is a basic setup guide, proper guides/documentation will be added in the near future._\n\n## Support\n\n[Github](https://github.com/jesterr0/NfoForge)\n\n## Donations\n\nNfoForge is a free application. Donations of any size are greatly appreciated and will support NfoForge's active development. Thank you!\n\n#### Bitcoin\n\n\u003cimg src=\"https://github.com/user-attachments/assets/88b7643f-8567-4d6d-ade4-13d725490062\" alt=\"bitcoin:bc1qwkhxfea0zmnuatt9fe784q87w0mwl72wd24xxc\" width=\"140\"\u003e\\\nBTC: `bc1qwkhxfea0zmnuatt9fe784q87w0mwl72wd24xxc`\n\n#### Ethereum\n\n\u003cimg src=\"https://github.com/user-attachments/assets/e34fa9d4-531f-4586-9deb-47413861279a\" alt=\"ethereum:0x86a726C7158b852C8001Fb6762f3a263742529e6\" width=\"140\"\u003e\\\nETH: `0x86a726C7158b852C8001Fb6762f3a263742529e6`\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjesterr0%2Fnfoforge","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjesterr0%2Fnfoforge","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjesterr0%2Fnfoforge/lists"}