PyPI - upload-assistant - Versions diffs - 4.4__tar.gz → 4.6__tar.gz - Mend

upload-assistant 4.4tar.gz → 4.6tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (1156) hide show

upload_assistant-4.6/PKG-INFO ADDED Viewed

@@ -0,0 +1,409 @@
+Metadata-Version: 2.4
+Name: upload-assistant
+Version: 4.6
+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: typing-extensions==4.15.0
+Requires-Dist: unidecode==1.4.0
+Requires-Dist: urllib3==2.8.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)
+---
+<img width="1920" height="946" alt="image" src="https://github.com/user-attachments/assets/aaea8cec-28fd-42fb-ab73-d11c16f4832e" />
+---
+<img width="1920" height="946" alt="image" src="https://github.com/user-attachments/assets/9704ab62-3bec-4e12-9223-3c0331505687" />
+</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. Upload Order & qBittorrent Bandwidth Control](#3-upload-order--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)
+  - [Install](#install)
+  - [Configure the Assistant](#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.
+  - **GazelleGames, IGDB & Steam Metadata APIs**: Uses exact GazelleGames torrent comments or a guarded title search for game metadata, then fills missing fields and artwork through Twitch/IGDB and Steam.
+  - **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.
+- **Adult Video (`XXX` Category)**:
+  - **Automatic Detection & Metadata**: Recognizes supported adult-platform release names, extracts common title, studio, and date fields, and builds descriptive keywords.
+  - **Contact Sheets & Artwork**: Generates one configurable contact sheet per video and creates a fallback cover from the source when artwork is not supplied.
+  - **Workflow Guide**: See the dedicated [XXX category upload guide](docs/xxx-upload.md) for naming, overrides, WebUI usage, and supported destinations.
+### 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. Upload Order & qBittorrent Bandwidth Control
+Sequence Usenet and torrent tracker uploads while limiting contention with qBittorrent. See the dedicated [upload order and bandwidth control guide](docs/upload-order-and-bandwidth-control.md) for configuration and every supported workflow.
+### 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, GazelleGames, 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`).
+- **Private Local Statistics**: A dedicated Stats workspace tracks daily upload outcomes, cache efficiency, logical API operations, torrent/NZB creation, destinations, and categories without storing media names, paths, external IDs, URLs, or credentials.
+- **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" alt="" width="16" height="16" />         | AlphaRatio             | ALPHARATIO             | MOVIE, TV                    |
+| <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, MUSIC             |
+| <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" alt="" width="16" height="16" />           | BeyondHD               | 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" alt="" width="16" height="16" />            | BJ-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" alt="" 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" alt="" width="16" height="16" />    | Great Poster Wall      | 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" alt="" width="16" height="16" />      | Polish Torrent         | 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" alt="" 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/qingwa.png" width="16" height="16" />                    | QingWa                 | QINGWA                 | 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" alt="" width="16" height="16" />    | Retro Movies Club      | 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" alt="" width="16" height="16" /> | SkipTheCommerials      | SKIPTHECOMMERCIALS     | MOVIE (Documentary only), 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" alt="" width="16" height="16" />       | The Old School         | 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" alt="" width="16" height="16" />          | TV Chaos UK            | 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 |
+| <img src="web_ui/static/img/trackers/nzbnest.png" width="16" height="16" />     | NzbNest     | NZBNEST     | MOVIE, TV, BOOK, GAME, MUSIC |
+</details>
+## **Setup Guide**
+These instructions cover Windows, Linux, and macOS.
+### Install
+1. Install [`uv`](https://docs.astral.sh/uv/getting-started/installation/) for your operating system.
+2. Install Upload Assistant:
+   ```bash
+   uv tool install upload-assistant
+   ```
+`uv` creates an isolated environment and installs a compatible Python version (3.14 or newer) if needed. It makes the `ua` command available from any directory. If the command is not found, run `uv tool update-shell` and open a new terminal.
+**Linux and macOS:** Install FFmpeg through your system's package manager (for example, `sudo apt install ffmpeg` on Debian/Ubuntu, `sudo pacman -S ffmpeg` on Arch, `sudo dnf install ffmpeg` on Fedora, or `brew install ffmpeg` on macOS). See the [FFmpeg troubleshooting guide](docs/ffmpeg-max-workers-issues.md) if needed.
+To install the latest development version from GitHub instead of the published release, use:
+```bash
+uv tool install git+https://github.com/wastaken7/Upload-Assistant.git
+```
+---
+### 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 CLI
+On the first CLI upload command, Upload Assistant creates `config.py` from the bundled example and stops so you can configure it. The file is created in:
+- **Windows:** `%LOCALAPPDATA%\Upload-Assistant\data`
+- **Linux / macOS:** `$XDG_DATA_HOME/Upload-Assistant/data` (normally `~/.local/share/Upload-Assistant/data`). If `Upload-Assistant` does not exist but the legacy `upload-assistant` directory does, use `$XDG_DATA_HOME/upload-assistant/data` (normally `~/.local/share/upload-assistant/data`).
+- **Custom location:** `%UA_DATA_DIR%\data` (Windows Command Prompt), `$env:UA_DATA_DIR\data` (PowerShell), or `$UA_DATA_DIR/data` (Linux/macOS) when `UA_DATA_DIR` is set
+Open the generated `config.py` in a text editor (like Notepad++, VS Code, or TextEdit) and fill in your information, then run the upload command again.
+- 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).
+- 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:**
+Run `uv tool upgrade upload-assistant` to update the published installation. If you installed the development version from GitHub, run `uv tool install --force git+https://github.com/wastaken7/Upload-Assistant.git` to fetch it again. On the next start, Upload Assistant adds missing general settings from [`data/example_config.py`](data/example_config.py) without changing existing values. Tracker/client sections and optional cache-service/tag overrides are left untouched so omitted settings continue to inherit their defaults. Add new tracker/client options manually when needed. A timestamped backup is created beside `config.py` whenever this automatic update changes the file.
+## **CLI Usage:**
+Run the assistant from any directory:
+```bash
+ua "/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)
+- Upload order and bandwidth control: [docs/upload-order-and-bandwidth-control.md](docs/upload-order-and-bandwidth-control.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)

upload-assistant 4.4__tar.gz → 4.6__tar.gz

upload-assistant 4.4tar.gz → 4.6tar.gz