upload-assistant 3.9__tar.gz

upload_assistant-3.9/LICENSE

@@ -0,0 +1,116 @@
+# Upload Assistant Public License (UAPL) v1.0
+Copyright © Audionut & wastaken7
+
+Permission is hereby granted to any person obtaining a copy of this software and
+associated documentation files (the “Software”) to use, copy, modify, merge,
+publish, and distribute the Software, subject to the following conditions:
+
+---
+
+## 1. Branding and Attribution Protection
+
+**1.1.**  
+The names **“Upload Assistant”**, **“Audionut”**, and any confusingly similar
+variants **may not** be used in derivative works in a manner that suggests the
+derivative is an official version, endorsed version, approved continuation, or
+authorized build of the original project.
+
+**1.2.**  
+Derivative works **must not** replace, modify, rename, or repurpose:
+- Any identifiers, markers, strings, signatures, metadata blocks, timestamps, 
+  or other automated output branding generated by the Software, **except to remove such identifiers entirely**;  
+- **Any license headers or attribution notices in source files must be preserved**.
+
+
+**1.3.**
+Derivative works **may not** introduce new identifiers, branding, promotional
+markings, or tool-generated labels or HTTP/S links that imply the derivative is:
+- an **upload tool**,  
+- a replacement or continuation of **Upload Assistant**,  
+- or any other tool intended to performing the same function or role,  
+by **reusing or adapting the original branding mechanisms, output structures,
+or auto-generated identifiers** provided by the Software.
+
+**1.4.**
+The Software and derivative works **must not** misrepresent authorship,
+affiliation, origin, identity, project lineage, or repository linkage.
+
+---
+
+## 2. Fork Disclosure Requirement
+
+Any distributed derivative work **must disclose** that it is a fork or
+modification of the original “Upload Assistant” project and must include a clear
+notice that it is **not** the official version.
+
+---
+
+## 3. Credential and Key Restrictions
+
+**3.1.**  
+The embedded, obfuscated key included with the Software is licensed
+**solely for use in the official “Upload Assistant” project**.
+
+**3.2.**  
+You may **not**:
+- extract, reuse, modify, deobfuscate, or redistribute the key;  
+- use the key in forks, derivative works, modified builds, or alternative tools;  
+- circumvent or attempt to circumvent any obfuscation or protective measures.
+
+**3.3.**  
+Any use of the key outside the official project is strictly prohibited and
+terminates all rights granted by this license.
+
+---
+
+## 4. Modification and Distribution
+
+You may modify the Software and distribute such modifications, provided that:
+
+**4.1.**  
+You comply with all branding and credential restrictions in Sections 1 and 3.
+
+**4.2.**  
+You retain this license text in full.
+
+**4.3.**  
+You include a notice stating:  
+*“This is a modified version of the Upload Assistant project and is not
+affiliated with or endorsed by Audionut.”*
+
+**4.4.**  
+You do not imply that the upstream project or author endorses your modifications.
+
+---
+
+## 5. No Warranty
+
+THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE, AND NON-INFRINGEMENT.
+
+THE AUTHOR SHALL NOT BE LIABLE FOR ANY CLAIM, DAMAGES, OR OTHER LIABILITY
+ARISING FROM THE SOFTWARE OR ITS USE.
+
+---
+
+## 6. Termination
+
+Any breach of Sections **1**, **2**, or **3** results in **automatic and immediate
+termination** of all rights granted under this license.
+
+Upon termination, you must cease all distribution and delete all copies of the
+Software and derivative works in your possession.
+
+---
+
+## 7. Compatibility
+
+This license is **not** an OSI-approved license.  
+Software licensed under this license may not be combined with code under
+licenses that require unrestricted modification or removal of branding or
+identification clauses.
+
+---
+
+**END OF LICENSE**

upload_assistant-3.9/PKG-INFO

@@ -0,0 +1,503 @@
+Metadata-Version: 2.4
+Name: upload-assistant
+Version: 3.9
+Summary: A simple tool to take the work out of uploading.
+Author: wastaken7
+Maintainer: wastaken7
+Project-URL: Homepage, https://github.com/wastaken7/Upload-Assistant
+Project-URL: Documentation, https://github.com/wastaken7/Upload-Assistant/tree/master/docs
+Project-URL: Issues, https://github.com/wastaken7/Upload-Assistant/issues
+Project-URL: Source, https://github.com/wastaken7/Upload-Assistant
+Keywords: media,torrent,upload-assistant
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Environment :: Console
+Classifier: Intended Audience :: End Users/Desktop
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: Multimedia
+Classifier: Topic :: Utilities
+Requires-Python: >=3.14
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: aiofiles==25.1.0
+Requires-Dist: aiohttp==3.14.3
+Requires-Dist: anitopy==2.1.1
+Requires-Dist: argcomplete>=3.7.2
+Requires-Dist: argon2-cffi==25.1.0
+Requires-Dist: babel==2.17.0
+Requires-Dist: bbcode==1.1.0
+Requires-Dist: beautifulsoup4==4.14.2
+Requires-Dist: bencode-py==4.0.0
+Requires-Dist: cachelib==0.13.0
+Requires-Dist: certifi==2026.1.4
+Requires-Dist: cli-ui==0.19.0
+Requires-Dist: click==8.4.2
+Requires-Dist: cloudscraper==1.2.71
+Requires-Dist: cryptography==50.0.0
+Requires-Dist: defusedxml==0.7.1
+Requires-Dist: deluge-client==1.10.2
+Requires-Dist: discord-py==2.6.4
+Requires-Dist: ffmpeg-python==0.2.0
+Requires-Dist: flask==3.1.3
+Requires-Dist: flask-cors==6.0.2
+Requires-Dist: flask-limiter==3.11.0
+Requires-Dist: flask-session==0.8.0
+Requires-Dist: guessit==3.8.0
+Requires-Dist: httpx==0.28.1
+Requires-Dist: jinja2==3.1.6
+Requires-Dist: keyring==25.6.0
+Requires-Dist: langcodes==3.5.1
+Requires-Dist: language-data==1.4.0
+Requires-Dist: librosa>=1.0.0
+Requires-Dist: lxml==6.1.0
+Requires-Dist: matplotlib>=3.10.9
+Requires-Dist: mobi==0.4.1
+Requires-Dist: mutagen==1.47.0
+Requires-Dist: nest-asyncio==1.6.0
+Requires-Dist: numpy==2.4.4
+Requires-Dist: packaging<25,>=21
+Requires-Dist: pillow==12.3.0
+Requires-Dist: psutil==7.2.2
+Requires-Dist: pycountry==24.6.1
+Requires-Dist: pyimgbox==1.0.7
+Requires-Dist: pymediainfo==7.0.1
+Requires-Dist: pymupdf==1.28.0
+Requires-Dist: pyotp==2.9.0
+Requires-Dist: pywinpty==3.0.5; sys_platform == "win32"
+Requires-Dist: qbittorrent-api==2026.6.0
+Requires-Dist: rarfile==4.2
+Requires-Dist: regex==2025.11.3
+Requires-Dist: requests==2.33.0
+Requires-Dist: resvg-py==0.3.3
+Requires-Dist: rich==13.9.4
+Requires-Dist: setuptools==83.0.0
+Requires-Dist: tmdbsimple==2.9.1
+Requires-Dist: torf==4.3.0
+Requires-Dist: tqdm==4.67.1
+Requires-Dist: transmission-rpc==7.0.11
+Requires-Dist: tvdb-v4-official==1.1.0
+Requires-Dist: typing-extensions==4.15.0
+Requires-Dist: unidecode==1.4.0
+Requires-Dist: urllib3==2.7.0
+Requires-Dist: waitress==3.0.2
+Dynamic: license-file
+
+<div align="center">
+  <img src="docs/assets/logo.svg" alt="Upload Assistant Logo" width="160" height="160" />
+  <h1>Upload-Assistant</h1>
+  <p>Streamline media preparation and uploads across private trackers & usenet indexers.</p>
+
+[![Python Version](https://img.shields.io/badge/Python-3.14%2B-blue?logo=python&logoColor=white)](https://www.python.org/) [![License](https://img.shields.io/badge/License-UAPL%20v1.0-orange)](LICENSE) [![Ruff](https://img.shields.io/badge/Ruff-000000?logo=ruff&logoColor=white)](https://github.com/astral-sh/ruff) [![Pyright](https://img.shields.io/badge/Pyright-strict-brightgreen)](https://github.com/microsoft/pyright) [![code style: prettier](https://img.shields.io/badge/code%20style-prettier-ff69b4.svg)](https://prettier.io) [![Docker Image CI](https://github.com/wastaken7/Upload-Assistant/actions/workflows/docker-image.yml/badge.svg)](https://github.com/wastaken7/Upload-Assistant/actions/workflows/docker-image.yml)
+
+</div>
+
+> [!IMPORTANT]
+> **This is a modified version of the Upload Assistant project and is not affiliated with or endorsed by Audionut.**
+
+## Table of Contents
+
+- [Fork Features & Differences from Upstream (Audionut/Upload-Assistant)](#fork-features--differences-from-upstream-audionutupload-assistant)
+  - [1. New Media Category Support](#1-new-media-category-support)
+  - [2. Audio Stream Spectrogram Generation](#2-audio-stream-spectrogram-generation)
+  - [3. qBittorrent Bandwidth Control](#3-qbittorrent-bandwidth-control)
+  - [4. Argument-Embedded Text Queue](#4-argument-embedded-text-queue)
+  - [5. Usenet & Indexer Posting](#5-usenet--indexer-posting)
+  - [6. Interactive Screenshot Review Workflow](#6-interactive-screenshot-review-workflow)
+  - [7. Persistent TTL-Based Metadata Cache](#7-persistent-ttl-based-metadata-cache)
+  - [8. Modern Web UI & Real-Time Engine](#8-modern-web-ui--real-time-engine)
+- [Supported Sites](#supported-sites)
+- [Setup Guide](#setup-guide)
+  - [Step 1: Install Required Tools](#step-1-install-required-tools)
+  - [Step 2: Download Upload Assistant](#step-2-download-upload-assistant-linuxmacos)
+  - [Step 3: Install Python Packages](#step-3-install-python-packages-linuxmacos)
+  - [Step 4: Configure the Assistant](#step-4-configure-the-assistant)
+- [Updating](#updating)
+- [CLI Usage](#cli-usage)
+- [Shell Completions](docs/shell-completions.md)
+- [Docker Usage](#docker-usage)
+- [Seedbox / Linux Install](docs/seedbox.md)
+- [Attributions](#attributions)
+- [Contributors](#contributors)
+
+## Fork Features & Differences from Upstream (Audionut/Upload-Assistant)
+
+This branch introduces new media categories and automation features not present in the upstream Audionut repository:
+
+### 1. New Media Category Support
+
+- **Ebook & Audiobook (`BOOK` Category)**:
+  - **Automatic Type Detection**: Classifies uploads into Ebooks (PDF, EPUB, MOBI), Comics/Manga (CBR, CBZ), Newspapers, or Audiobooks.
+  - **Local Metadata Extraction**: Reads metadata from OPF files in EPUB/MOBI, `ComicInfo.xml` in CBR/CBZ, parses tags via Mutagen for audiobooks, and uses PyMuPDF (`fitz`) with checksum-validated regex to extract ISBNs from PDFs.
+  - **API Integrations**: Queries **MyAnonamouse (MAM) API**, **Google Books API**, and **OpenLibrary API** for automated metadata lookup.
+  - **Artwork & Screenshot Generation**: Renders gallery screenshots from PDF/EPUB pages, extracts cover artwork, and auto-generates `POSTER.png`.
+  - **Smart Duplicate Checking**: Custom rules distinguishing formats (e.g., EPUB vs PDF) and audiobooks vs ebooks, with tracker-specific overrides.
+- **Video Game (`GAME` Category)**:
+  - **Game Directory Parsing**: Priority scans for executables (`.exe`), disc images (`.iso`), or archives (`.rar`, `.zip`, etc.) in the upload path.
+  - **IGDB & Steam Metadata API**: Queries Twitch/IGDB API for storyline, ratings, involved companies, release year, genre mapping, and downloads cover images. Fetches PC system requirements via Steam Store API.
+  - **Platform Detection**: Identifies systems (PC, PS5, Switch, Xbox Series X|S, etc.) and enforces platform-group duplicate checks (so Switch uploads aren't blocked by PC dupes).
+  - **Platform-specific Prompts**: Attended prompts for console TV standard (NTSC/PAL) and region codes (USA/EUR/JPN) for trackers like BJSHARE.
+- **Music (`MUSIC` Category)**:
+  - **Local Tag & Metadata Extraction**: Parses audio tags, cue sheets, and rip logs (EAC, XLD, etc.) using Mutagen to extract tracklists, artists, and audio metadata.
+  - **Discogs & MusicBrainz APIs**: Optionally queries external APIs (Discogs via release/master ID or URL, and MusicBrainz) for metadata enrichment.
+  - **Artwork & Cover Extraction**: Automatically searches for local cover images or extracts embedded artwork from FLAC/MP3/M4A tags to upload to image hosts.
+  - **Preflight & Rule Validation**: Enforces mechanical validation for audio formats, sample/bit rates, track counts, and hybrid setups before uploading.
+
+### 2. Audio Stream Spectrogram Generation
+
+- **Spectrogram Extraction & Plotting**: Use `-as` / `--audio-spectrogram` to automatically extract audio streams from MKVs, Blu-ray BDInfo, music tracks, or audiobook chapters using FFmpeg and plot frequency/time graphs (inferno theme) via `librosa` and `matplotlib`. Music and audiobook processing is capped by `audio_spectrogram_max_files`.
+- **Dynamic HDR Metadata Plots**: Use `--dynamic-hdr-plot` to create and upload separate Dolby Vision and HDR10+ metadata plots. The required `dovi_tool` and `hdr10plus_tool` binaries are downloaded automatically for the current platform on first use.
+- **Automated Upload**: Automatically uploads generated spectrograms along with your screenshots for release verification.
+- **Stream Selection**: Supports targeting specific tracks using `-ast` / `--audio-spectrogram-tracks` (e.g., track indexes or `all`).
+
+### 3. qBittorrent Bandwidth Control
+
+- **Traffic Control**: Prevents overloading your connection during uploads using `-qbcon` / `--qbit-bw-control`.
+- **Dynamic Wait**: Pauses uploading if your active client upload speed exceeds a threshold (`qbit_bandwidth_threshold` KB/s) and resumes once it stays below the limit for a set time (`qbit_bandwidth_time` seconds).
+- **Safe Rechecking**: Performs a second duplicate check after the bandwidth wait to ensure a duplicate wasn't posted while the client was waiting.
+
+### 4. Argument-Embedded Text Queue
+
+- **Custom Parameter Queues**: When running batch uploads with a `.txt` queue file, each line is treated as an independent execution command.
+- **shlex-Split Parsing**: Allows specifying unique CLI arguments (e.g., different IMDB IDs, tags, or tracker targets) for each file/folder on its respective line.
+- **Resume Capability**: Logs processed lines to prevent reprocessing completed uploads if a queue run is interrupted.
+
+### 5. Usenet & Indexer Posting
+
+- **Usenet Upload Support**: Automatically archives and splits files/folders (via `7z`), generates parity recovery blocks (via `par2`), and uploads them to Usenet (via `nyuu`).
+- **Anonymity & Privacy**: Generates randomized poster details and obfuscates post subject lines to protect privacy.
+- **Indexer Integration**: Automatically uploads the generated `.nzb` file to configured Usenet indexers.
+
+### 6. Interactive Screenshot Review Workflow
+
+- **Manual Screenshot Review**: Inspect, add, delete, or replace/recapture individual frames before uploading through the interactive Web UI.
+
+### 7. Persistent TTL-Based Metadata Cache
+
+- **Provider-Scoped API Caching**: Disk-cached metadata for TMDb, IMDb, TVDB, TVmaze, OpenLibrary, IGDB, Discogs, and MusicBrainz.
+- **Performance & Rate Limit Protection**: Configurable TTL and negative caching reuse fetched metadata across runs, avoiding redundant API calls and preventing rate-limiting bans.
+
+### 8. Modern Web UI & Real-Time Engine
+
+- **Full Parity Web UI**: Modern interface providing full feature parity with CLI options (`--webui`).
+- **Real-Time Execution & Presets**: Live log streams, real-time preparation preview, preset saving, and interactive screenshot management.
+
+## Supported Sites
+
+<details>
+<summary><strong>Click to view Supported Torrent Trackers</strong></summary>
+
+|                                                                                            | Site                   | Usage                  | Supported Categories         |
+| ------------------------------------------------------------------------------------------ | ---------------------- | ---------------------- | ---------------------------- |
+| <img src="web_ui/static/img/trackers/1ptba.png" width="16" height="16" />                  | 1PTBA                  | 1PTBA                  | MOVIE, TV                    |
+| <img src="web_ui/static/img/trackers/aither.png" width="16" height="16" />                 | Aither                 | AITHER                 | MOVIE, TV                    |
+| <img src="web_ui/static/img/trackers/alpharatio.png" width="16" height="16" />             | Alpharatio             | ALPHARATIO             | MOVIE, TV                    |
+| <img src="web_ui/static/img/trackers/amigosshare.png" width="16" height="16" />            | Amigos-Share           | AMIGOSSHARE            | MOVIE, TV, BOOK, GAME        |
+| <img src="web_ui/static/img/trackers/anthelion.png" width="16" height="16" />              | Anthelion              | ANTHELION              | MOVIE                        |
+| <img src="web_ui/static/img/trackers/asiancinema.png" width="16" height="16" />            | AsianCinema            | ASIANCINEMA            | MOVIE, TV                    |
+| <img src="web_ui/static/img/trackers/avistaz.png" width="16" height="16" />                | AvistaZ                | AVISTAZ                | MOVIE, TV                    |
+| <img src="web_ui/static/img/trackers/beyondhd.png" width="16" height="16" />               | Beyond-HD              | BEYONDHD               | MOVIE, TV                    |
+| <img src="web_ui/static/img/trackers/bithdtv.png" width="16" height="16" />                | BitHDTV                | BITHDTV                | MOVIE, TV                    |
+| <img src="web_ui/static/img/trackers/bitporn.png" width="16" height="16" />                | BitPorn                | BITPORN                | XXX                          |
+| <img src="web_ui/static/img/trackers/blutopia.png" width="16" height="16" />               | Blutopia               | BLUTOPIA               | MOVIE, TV                    |
+| <img src="web_ui/static/img/trackers/bjshare.png" width="16" height="16" />                | BrasilJapão-Share      | BJSHARE                | MOVIE, TV, BOOK, GAME, XXX   |
+| <img src="web_ui/static/img/trackers/brasiltracker.png" width="16" height="16" />          | BrasilTracker          | BRASILTRACKER          | MOVIE, TV, BOOK, GAME        |
+| <img src="web_ui/static/img/trackers/broadcasthenet.png" width="16" height="16" />         | BroadcasTheNet         | BROADCASTHENET         | TV                           |
+| <img src="web_ui/static/img/trackers/capybarabr.png" width="16" height="16" />             | CapybaraBR             | CAPYBARABR             | MOVIE, TV, BOOK, GAME        |
+| <img src="web_ui/static/img/trackers/cathoderaytube.png" width="16" height="16" />         | Cathode-Ray.Tube       | CATHODERAYTUBE         | MOVIE, TV, GAME              |
+| <img src="web_ui/static/img/trackers/cinematik.png" width="16" height="16" />              | Cinematik              | CINEMATIK              | MOVIE, TV                    |
+| <img src="web_ui/static/img/trackers/cinemaz.png" width="16" height="16" />                | CinemaZ                | CINEMAZ                | MOVIE, TV                    |
+| <img src="web_ui/static/img/trackers/darkpeers.png" width="16" height="16" />              | DarkPeers              | DARKPEERS              | MOVIE, TV, BOOK, GAME, MUSIC |
+| <img src="web_ui/static/img/trackers/desitorrents.png" width="16" height="16" />           | DesiTorrents           | DESITORRENTS           | MOVIE, TV                    |
+| <img src="web_ui/static/img/trackers/digitalcore.png" width="16" height="16" />            | DigitalCore            | DIGITALCORE            | MOVIE, TV, BOOK, GAME, MUSIC |
+| <img src="web_ui/static/img/trackers/dreadvault.png" alt="" width="16" height="16" />      | DreadVault             | DREADVAULT             | MOVIE, TV                    |
+| <img src="web_ui/static/img/trackers/emuwarez.png" width="16" height="16" />               | Emuwarez               | EMUWAREZ               | MOVIE, TV                    |
+| <img src="web_ui/static/img/trackers/filelist.png" width="16" height="16" />               | FileList               | FILELIST               | MOVIE, TV                    |
+| <img src="web_ui/static/img/trackers/flood.png" width="16" height="16" />                  | Flood                  | FLOOD                  | MOVIE, TV                    |
+| <img src="web_ui/static/img/trackers/funfile.png" width="16" height="16" />                | FunFile                | FUNFILE                | MOVIE, TV                    |
+| <img src="web_ui/static/img/trackers/greatposterwall.png" width="16" height="16" />        | GreatPosterWall        | GREATPOSTERWALL        | MOVIE                        |
+| <img src="web_ui/static/img/trackers/hawkeuno.png" width="16" height="16" />               | hawke-uno              | HAWKEUNO               | MOVIE, TV                    |
+| <img src="web_ui/static/img/trackers/hdbits.png" width="16" height="16" />                 | HDBits                 | HDBITS                 | MOVIE, TV                    |
+| <img src="web_ui/static/img/trackers/hdspace.png" width="16" height="16" />                | HD-Space               | HDSPACE                | MOVIE, TV                    |
+| <img src="web_ui/static/img/trackers/hdtorrents.png" width="16" height="16" />             | HD-Torrents            | HDTORRENTS             | MOVIE, TV                    |
+| <img src="web_ui/static/img/trackers/homiehelpdesk.png" width="16" height="16" />          | HomieHelpDesk          | HOMIEHELPDESK          | MOVIE, TV, BOOK, GAME, MUSIC |
+| <img src="web_ui/static/img/trackers/immortalseed.png" width="16" height="16" />           | ImmortalSeed           | IMMORTALSEED           | MOVIE, TV, BOOK, MUSIC, GAME |
+| <img src="web_ui/static/img/trackers/infinityhd.png" width="16" height="16" />             | InfinityHD             | INFINITYHD             | MOVIE, TV                    |
+| <img src="web_ui/static/img/trackers/iptorrents.png" width="16" height="16" />             | IPTorrents             | IPTORRENTS             | MOVIE, TV, BOOK, GAME, MUSIC |
+| <img src="web_ui/static/img/trackers/itatorrents.png" width="16" height="16" />            | ItaTorrents            | ITATORRENTS            | MOVIE, TV                    |
+| <img src="web_ui/static/img/trackers/lajidui.png" width="16" height="16" />                | lajidui                | LAJIDUI                | MOVIE, TV                    |
+| <img src="web_ui/static/img/trackers/lemonhd.png" width="16" height="16" />                | LemonHD                | LEMONHD                | MOVIE, TV                    |
+| <img src="web_ui/static/img/trackers/lastdigitalunderground.png" width="16" height="16" /> | LastDigitalUnderground | LASTDIGITALUNDERGROUND | MOVIE, TV, BOOK              |
+| <img src="web_ui/static/img/trackers/latteam.png" width="16" height="16" />                | Lat-Team               | LATTEAM                | MOVIE, TV, BOOK              |
+| <img src="web_ui/static/img/trackers/locadora.png" width="16" height="16" />               | Locadora               | LOCADORA               | MOVIE, TV                    |
+| <img src="web_ui/static/img/trackers/longpt.png" width="16" height="16" />                 | LongPT                 | LONGPT                 | MOVIE, TV                    |
+| <img src="web_ui/static/img/trackers/lst.png" width="16" height="16" />                    | LST                    | LST                    | MOVIE, TV, BOOK, MUSIC, XXX  |
+| <img src="web_ui/static/img/trackers/luminarr.png" width="16" height="16" />               | Luminarr               | LUMINARR               | MOVIE, TV                    |
+| <img src="web_ui/static/img/trackers/makingoff.png" width="16" height="16" />              | MakingOff              | MAKINGOFF              | MOVIE                        |
+| <img src="web_ui/static/img/trackers/midnightscene.png" width="16" height="16" />          | MidnightScene          | MIDNIGHTSCENE          | MOVIE, TV, GAME, MUSIC       |
+| <img src="web_ui/static/img/trackers/mteam.png" width="16" height="16" />                  | M-Team                 | MTEAM                  | MOVIE, TV                    |
+| <img src="web_ui/static/img/trackers/nebulance.png" width="16" height="16" />              | Nebulance              | NEBULANCE              | TV                           |
+| <img src="web_ui/static/img/trackers/nordicquality.png" width="16" height="16" />          | NordicQuality          | NORDICQUALITY          | MOVIE, TV, MUSIC, BOOK, GAME |
+| <img src="web_ui/static/img/trackers/oldtoonsworld.png" width="16" height="16" />          | OldToonsWorld          | OLDTOONSWORLD          | MOVIE, TV                    |
+| <img src="web_ui/static/img/trackers/onlyencodes.png" width="16" height="16" />            | OnlyEncodes+           | ONLYENCODES            | MOVIE, TV                    |
+| <img src="web_ui/static/img/trackers/orpheus.png" width="16" height="16" />                | Orpheus                | ORPHEUS                | MUSIC                        |
+| <img src="web_ui/static/img/trackers/passthepopcorn.png" width="16" height="16" />         | PassThePopcorn         | PASSTHEPOPCORN         | MOVIE                        |
+| <img src="web_ui/static/img/trackers/peergarden.png" width="16" height="16" />             | PeerGarden             | PEERGARDEN             | MOVIE, TV, GAME, BOOK, MUSIC |
+| <img src="web_ui/static/img/trackers/polishtorrent.png" width="16" height="16" />          | PolishTorrent          | POLISHTORRENT          | MOVIE, TV                    |
+| <img src="web_ui/static/img/trackers/portugas.png" width="16" height="16" />               | Portugas               | PORTUGAS               | MOVIE, TV                    |
+| <img src="web_ui/static/img/trackers/privatehd.png" width="16" height="16" />              | PrivateHD              | PRIVATEHD              | MOVIE, TV                    |
+| <img src="web_ui/static/img/trackers/ptgtk.png" width="16" height="16" />                  | PT GTK                 | PTGTK                  | MOVIE, TV                    |
+| <img src="web_ui/static/img/trackers/ptzone.png" width="16" height="16" />                 | PTZone                 | PTZONE                 | MOVIE, TV                    |
+| <img src="web_ui/static/img/trackers/ptcafe.png" width="16" height="16" />                 | ptcafe                 | PTCAFE                 | MOVIE, TV                    |
+| <img src="web_ui/static/img/trackers/pterclub.png" width="16" height="16" />               | PTerClub               | PTERCLUB               | MOVIE, TV                    |
+| <img src="web_ui/static/img/trackers/ptfans.png" width="16" height="16" />                 | PTFans                 | PTFANS                 | MOVIE, TV                    |
+| <img src="web_ui/static/img/trackers/ptskit.png" width="16" height="16" />                 | PTSKIT                 | PTSKIT                 | MOVIE, TV                    |
+| <img src="web_ui/static/img/trackers/racing4everyone.png" width="16" height="16" />        | Racing4Everyone        | RACING4EVERYONE        | MOVIE, TV                    |
+| <img src="web_ui/static/img/trackers/railgunpt.png" width="16" height="16" />              | RailgunPT              | RAILGUNPT              | MOVIE, TV                    |
+| <img src="web_ui/static/img/trackers/rastastugan.png" width="16" height="16" />            | Rastastugan            | RASTASTUGAN            | MOVIE, TV, BOOK, GAME, MUSIC |
+| <img src="web_ui/static/img/trackers/reelflix.png" width="16" height="16" />               | ReelFLiX               | REELFLIX               | MOVIE                        |
+| <img src="web_ui/static/img/trackers/retroflix.png" width="16" height="16" />              | RetroFlix              | RETROFLIX              | MOVIE, TV                    |
+| <img src="web_ui/static/img/trackers/retromoviesclub.png" width="16" height="16" />        | RetroMoviesClub        | RETROMOVIESCLUB        | MOVIE                        |
+| <img src="web_ui/static/img/trackers/rockethd.png" width="16" height="16" />               | RocketHD               | ROCKETHD               | MOVIE, TV                    |
+| <img src="web_ui/static/img/trackers/samaritano.png" width="16" height="16" />             | Samaritano             | SAMARITANO             | MOVIE, TV, BOOK, GAME        |
+| <img src="web_ui/static/img/trackers/seedpool.png" width="16" height="16" />               | seedpool               | SEEDPOOL               | MOVIE, TV, BOOK, GAME, MUSIC |
+| <img src="web_ui/static/img/trackers/shareisland.png" width="16" height="16" />            | ShareIsland            | SHAREISLAND            | MOVIE, TV                    |
+| <img src="web_ui/static/img/trackers/skipthecommercials.png" width="16" height="16" />     | SkipTheCommerials      | SKIPTHECOMMERCIALS     | MOVIE, TV                    |
+| <img src="web_ui/static/img/trackers/speedapp.png" width="16" height="16" />               | SpeedApp               | SPEEDAPP               | MOVIE, TV, BOOK, GAME, MUSIC |
+| <img src="web_ui/static/img/trackers/swarmazon.png" width="16" height="16" />              | Swarmazon              | SWARMAZON              | MOVIE, TV                    |
+| <img src="web_ui/static/img/trackers/theleachzone.png" width="16" height="16" />           | The Leach Zone         | THELEACHZONE           | MOVIE, TV                    |
+| <img src="web_ui/static/img/trackers/theoldschool.png" width="16" height="16" />           | TheOldSchool           | THEOLDSCHOOL           | MOVIE, TV                    |
+| <img src="web_ui/static/img/trackers/torrenteros.png" width="16" height="16" />            | Torrenteros            | TORRENTEROS            | MOVIE, TV                    |
+| <img src="web_ui/static/img/trackers/torrenthr.png" width="16" height="16" />              | TorrentHR              | TORRENTHR              | MOVIE, TV                    |
+| <img src="web_ui/static/img/trackers/torrentleech.png" width="16" height="16" />           | TorrentLeech           | TORRENTLEECH           | MOVIE, TV, BOOK, GAME, MUSIC |
+| <img src="web_ui/static/img/trackers/totheglory.png" width="16" height="16" />             | ToTheGlory             | TOTHEGLORY             | MOVIE, TV                    |
+| <img src="web_ui/static/img/trackers/tvchaosuk.png" width="16" height="16" />              | TVChaosUK              | TVCHAOSUK              | MOVIE, TV                    |
+| <img src="web_ui/static/img/trackers/xingyungept.png" width="16" height="16" />            | XingyungePT            | XINGYUNGEPT            | MOVIE, TV                    |
+| <img src="web_ui/static/img/trackers/ulcx.png" width="16" height="16" />                   | ULCX                   | ULCX                   | MOVIE, TV                    |
+| <img src="web_ui/static/img/trackers/utopia.png" width="16" height="16" />                 | UTOPIA                 | UTOPIA                 | MOVIE, TV                    |
+| <img src="web_ui/static/img/trackers/yuscene.png" width="16" height="16" />                | YUSCENE                | YUSCENE                | MOVIE, TV, BOOK, GAME, MUSIC |
+| <img src="web_ui/static/img/trackers/zenith.png" width="16" height="16" />                 | Zenith                 | ZENITH                 | MOVIE, TV, BOOK, GAME, MUSIC |
+
+</details>
+
+<details>
+<summary><strong>Click to view Supported Usenet Indexers</strong></summary>
+
+|                                                                                 | Site        | Usage       | Supported Categories         |
+| ------------------------------------------------------------------------------- | ----------- | ----------- | ---------------------------- |
+| <img src="web_ui/static/img/trackers/curupira.png" width="16" height="16" />    | Curupira    | CURUPIRA    | MOVIE, TV, BOOK, GAME        |
+| <img src="web_ui/static/img/trackers/drunkenslug.png" width="16" height="16" /> | DrunkenSlug | DRUNKENSLUG | MOVIE, TV, BOOK, GAME        |
+| <img src="web_ui/static/img/trackers/nzbgeek.png" width="16" height="16" />     | NZBGeek     | NZBGEEK     | MOVIE, TV, BOOK, GAME, MUSIC |
+
+</details>
+
+## **Setup Guide**
+
+Setting up Upload Assistant is straightforward, even if you are not a developer. Follow these steps to get up and running:
+
+### Step 1: Install Required Tools
+
+Windows users should install Upload Assistant with the [Windows `.exe` installer](docs/windows-install.md). It includes everything needed to run the assistant.
+
+For a manual Linux/macOS/Windows installation, Upload Assistant needs a few tools to process media and run:
+
+1. **Python (version 3.14 or newer)**:
+   - Download and install it from the [official Python website](https://www.python.org/downloads/).
+2. **MediaInfo & FFmpeg**:
+   - These are helper tools used to scan files and generate screenshots/spectrograms.
+   - The official MediaInfo CLI is downloaded and checksum-verified automatically on supported Windows, Linux, and macOS systems. Android/Termux uses its native `mediainfo` package (`pkg install mediainfo`).
+   - Install FFmpeg using your system's software manager:
+     - Debian/Ubuntu: `sudo apt install ffmpeg`
+     - Arch Linux: `sudo pacman -S ffmpeg`
+     - RedHat/Fedora: `sudo dnf install ffmpeg`
+   - _Having issues with FFmpeg? Check out our [FFmpeg troubleshooting guide](docs/ffmpeg-max-workers-issues.md)._
+
+---
+
+### Install from PyPI with `uv` (Windows, Linux, or macOS)
+
+The recommended command-line installation uses the published PyPI package. It automatically manages the virtual environment and exposes the `ua` and `ua-config` commands on your system path:
+
+```bash
+uv tool install upload-assistant
+```
+
+If `uv` reports that its tool directory is not on your `PATH`, run `uv tool update-shell`, then open a new terminal.
+
+### Install the latest development version with `uv`
+
+If you have [uv](https://github.com/astral-sh/uv) installed, you can install Upload Assistant directly from the repository as a globally available standalone CLI tool. This automatically manages the virtual environment and exposes the `ua` and `ua-config` commands directly to your system path. This method resolves dependencies from `pyproject.toml`; skip Steps 2 and 3 below.
+
+```bash
+uv tool install git+https://github.com/wastaken7/Upload-Assistant.git
+```
+
+If `uv` reports that its tool directory is not on your `PATH`, run `uv tool update-shell`, then open a new terminal.
+
+---
+
+### Step 2: Download Upload Assistant (Linux/macOS)
+
+Choose **one** of the two options below to get the files onto your computer:
+
+#### Option A: Clone using Git (Recommended)
+
+Using Git is the recommended method because it makes updating the assistant in the future extremely easy.
+
+1. **Install Git** (if you don't already have it):
+   - **Linux:** Install it via your package manager.
+   - **macOS:** Install it via Homebrew or Xcode Command Line Tools.
+2. **Clone the project**:
+   Open your command prompt or terminal, navigate to the folder where you want to keep the assistant, and run:
+
+   ```bash
+   git clone https://github.com/wastaken7/Upload-Assistant.git
+   cd Upload-Assistant
+   ```
+
+#### Option B: Download as a ZIP file (Alternative)
+
+If you do not want to install Git, you can download a copy of the files directly:
+
+1. Go to the [GitHub Repository Page](https://github.com/wastaken7/Upload-Assistant).
+2. Click the green **Code** button near the top right, and click **Download ZIP**.
+3. Extract the ZIP file to a folder of your choice on your computer.
+
+---
+
+### Step 3: Install Python Packages (Linux/macOS)
+
+On Linux/macOS, open a terminal, navigate to the folder where you downloaded Upload Assistant, and run:
+
+```bash
+pip3 install --user -U -r requirements.txt
+```
+
+> [!TIP]
+> **Getting an "externally managed environment" error?**
+> This means your system prefers keeping Python packages separated. You can set up a "Virtual Environment" (a private workspace for this tool) by running:
+>
+> - **Linux / macOS:**
+>
+>   ```bash
+>   python3 -m venv venv
+>   source venv/bin/activate
+>   pip install -r requirements.txt
+>   ```
+
+---
+
+### Step 4: Configure the Assistant
+
+You need to add your API keys (like TMDb) and tracker credentials so the tool knows where to upload.
+
+#### Method A: Use the Web UI (Easiest)
+
+If you plan to use the Web UI, **your configuration file will be generated automatically** when you launch and configure it for the first time.
+
+#### Method B: Use the Interactive Generator
+
+In your terminal, run the command for your operating system and follow the on-screen prompts:
+
+- **Windows:** Install with the [`.exe` installer](docs/windows-install.md), then run `ua-config` in a new terminal.
+- **Linux / macOS (Standard):**
+
+  ```bash
+  python3 config-generator.py
+  ```
+
+- **Linux / macOS (uv installation):**
+
+  ```bash
+  ua-config
+  ```
+
+#### Method C: Manual Configuration
+
+1. Go to the `data/` folder inside the project.
+2. Copy `example_config.py` and rename the copy to `config.py` (leave the original `example_config.py` file as-is).
+3. Open `config.py` in a text editor (like Notepad, VS Code, or TextEdit) and fill in your information.
+   - For detailed info on what each setting does, see [Example Config Docs](docs/example-config.md).
+   - Get a free TMDb API key from [TheMovieDB API settings](https://www.themoviedb.org/settings/api).
+
+---
+
+**Additional Resources:**
+
+- Check out our [Wiki Help Page](docs/home.md).
+- Windows installation and basic commands: see [Windows Install](docs/windows-install.md).
+- Need a no-root Linux or seedbox setup? See [Seedbox / Linux Install](docs/seedbox.md).
+- Found an issue or need help? Please [open a GitHub Issue](https://github.com/wastaken7/Upload-Assistant/issues) so we can track and resolve it. If you prefer not to create a GitHub account for privacy reasons, join our [Signal group](https://signal.group/#CjQKILmkUCLe5mZULkQGI6B5knmX1ytrIBFicpJ_NZGAHmOrEhDD5F7ctp-obLeLOsa0yCoJ) instead.
+
+## **Updating:**
+
+- To update a Git installation, navigate into the Upload-Assistant directory and pull the latest changes:
+
+  ```bash
+  cd Upload-Assistant
+  git pull
+  ```
+
+- Or, if you downloaded the ZIP file, download a fresh ZIP from GitHub and overwrite your existing files.
+- For the Windows installation, run `ua-update`.
+- For the `uv` standalone installation, run: `uv tool upgrade upload-assistant`
+- Run the command to update dependencies:
+  - **Linux / macOS:** `python3 -m pip install --user -U -r requirements.txt`
+- Run the configuration generator to fetch any new settings:
+  - **Windows / uv installations:** run `ua-config` from any folder.
+  - **Linux / macOS (Standard):** `python3 config-generator.py`
+
+## **CLI Usage:**
+
+To run the assistant, use the command for your system:
+
+- **Windows / uv installations:**
+
+  ```cmd
+  ua "/path/to/content" --args
+  ```
+
+- **Linux / macOS (Standard):**
+
+  ```bash
+  python3 upload.py "/path/to/content" --args
+  ```
+
+Arguments are optional and normally follow the path. Input modes such as `--paths-from-stdin` may omit the positional path. For a list of all available arguments, pass `--help`.
+The file/folder path works best enclosed in double quotes.
+
+- CLI arguments: [docs/cli-args.md](docs/cli-args.md)
+- Usenet uploading: [docs/usenet.md](docs/usenet.md)
+
+## **Docker Usage:**
+
+Visit our wonderful [docker usage](docs/docker.md)
+
+Also see this excellent video put together by a community member <https://videos.badkitty.zone/ua>
+
+Web UI setup (Docker GUI / Unraid): [docs/docker-gui.md](docs/docker-gui.md)
+Web UI docs: [docs/web-ui.md](docs/web-ui.md)
+
+## **Attributions:**
+
+Built with [autobrr/go-bdinfo](https://github.com/autobrr/go-bdinfo)
+
+Features automated binary managers for:
+
+- [nyuu](https://github.com/animetosho/nyuu)
+- [par2cmdline-turbo](https://github.com/animetosho/par2cmdline-turbo)
+- [pesto](https://github.com/franzopl/pesto)
+- [7-Zip](https://www.7-zip.org/)
+
+<p>
+  <a href="https://github.com/autobrr/mkbrr"><img src="https://github.com/autobrr/mkbrr/blob/main/.github/assets/mkbrr-dark.png?raw=true" alt="mkbrr" height="40px;"></a>&nbsp;&nbsp;
+  <a href="https://github.com/autobrr/qui"><img src="https://github.com/autobrr/qui/blob/develop/documentation/static/img/qui.png?raw=true" alt="qui" height="40px;"></a>&nbsp;&nbsp;
+  <a href="https://ffmpeg.org/"><img src="https://i.postimg.cc/xdj3BS7S/FFmpeg-Logo-new-svg.png" alt="FFmpeg" height="40px;"></a>&nbsp;&nbsp;
+  <a href="https://mediaarea.net/en/MediaInfo"><img src="https://i.postimg.cc/vTkjXmHh/Media-Info-Logo-svg.png" alt="Mediainfo" height="40px;"></a>&nbsp;&nbsp;
+  <a href="https://www.themoviedb.org/"><img src="https://i.postimg.cc/1tpXHx3k/blue-square-2-d537fb228cf3ded904ef09b136fe3fec72548ebc1fea3fbbd1ad9e36364db38b.png" alt="TMDb" height="40px;"></a>&nbsp;&nbsp;
+  <a href="https://www.imdb.com/"><img src="https://i.postimg.cc/CLVmvwr1/IMDb-Logo-Rectangle-Gold-CB443386186.png" alt="IMDb" height="40px;"></a>&nbsp;&nbsp;
+  <a href="https://thetvdb.com/"><img src="https://i.postimg.cc/Hs1KKqsS/logo1.png" alt="TheTVDB" height="40px;"></a>&nbsp;&nbsp;
+  <a href="https://www.tvmaze.com/"><img src="https://i.postimg.cc/2jdRzkJp/tvm-header-logo.png" alt="TVmaze" height="40px"></a>
+</p>
+
+## **Contributors:**
+[![Contributors](https://contrib.rocks/image?repo=wastaken7/Upload-Assistant)](https://github.com/wastaken7/Upload-Assistant/graphs/contributors)