Unit3Dup — Fork G3MINI

Fork de Unit3Dup adapté et pensé pour le G3MINI Tracker.

Ce fork intègre des automatisations spécifiques (normalisation sémantique, tags personnels), un nettoyeur autonome (purge silencieuse), ainsi qu'une toute nouvelle Interface Web d'Administration propulsée au sein d'une architecture Docker robuste clé en main.

---

🔒 Audit de Sécurité (Validé Sûr ✅)

Ce dépôt a été entièrement audité logiciellement afin de garantir la non-compromission de vos identifiants ou serveurs hôtes :

• Protection de vos identifiants : Gemini_APIKEY et Gemini_PID naviguent exclusivement sur l'URL d'information du tracker défini.
• Droits d'Infrastructure (Docker) : Le conteneur bride toutes ses écritures non nécessaires. Vos fichiers téléchargés (volume source) sont parcourus en strict Read-Only, ce qui annule toute chance de corruption ou suppression fortuite des fichiers originaux. Par ailleurs, l'exécution s'effectue via abaissement des privilèges Linux internes (utilitaire gosu).
• Anticiper l'Interface Web : Le portail est géré par du HTTP classique, ce qui est parfait pour un réseau local. Si vous l'exposez sur internet public, veillez à lui interposer un Reverse Proxy en HTTPs/SSL. Plus d'informations dans SECURITY_AUDIT.md.

---

✨ Fonctionnalités clés et ajouts

• 🆕 Interface Web Centralisée : Pilotez le statut du bot via un portail Dashboard moderne avec authentification. Vous pourrez lancer l'arrêt dynamique de fond, suivre la Console Logs en direct (temps réel HTTP direct) ou déclencher un scan forcé d'un simple clic.
• Normalisation des noms de release : Les titres sont passés à la moulinette officielle G3MINI (Titre.Année.Langue.Résolution.HDR.Source.Audio.Codec-TEAM).
• Détection Tag personal_release : Basée sur vos balises de nom (-KFL, -TEAM), le robot identifie s'il doit cocher la validation Personal Release.
• Nettoyage Automatique : Le "watcher" vient supprimer automatiquement ses seuls fichiers .nfo orphelins (technique) après sa tournée.

---

🐳 Déploiement Express via Docker (Recommandé)

Pour vous libérer des interférences (version de Python et paquets venv), propulsez un conteneur tout compris.

1. Paramétrer et préparer (Le docker-compose.yml)

Tout se configure désormais via ce fichier centralisé à la racine du github :

services:
  unit3dup-g3mini:
    build: .
    environment:
      - PUID=1000  # 💡 À remplacer par l'UID de l'usager hôte Linux (tapez 'id' dans votre OS)
      - PGID=1000  
      - TZ=Europe/Paris
      - ENABLE_GUI=true           # Active/Désactive la Web-UI dynamique (bascule sinon le conteneur en mode pur CLI)
      - GUI_USER=admin            # Nom d'accès à l'interface
      - GUI_PASSWORD=supersecret  # MDP accès interface
    ports:
      - "8080:8080"               # Port d'accès ->  HOST:CONTAINER
    volumes:
      - ./config:/config          # Mappez le Json d'accès et log files ici
      - /chemin/films:/data/watch:ro # ⚠️ Read-Only absolu et sécuritaire sur le répertoire à "Scanner"
      - /chemin/uploads:/data/upload # Éventuel lieu d'écriture finale du bot
    restart: unless-stopped

2. Ignition

Dans ce répertoire de dossier, ouvrez le terminal pour construire silencieusement l'mage Web/Python custom et la lancer :

docker-compose up -d --build

🚀 Connectez-vous ensuite à http://votre-ip-machine:8080

---

💻 Installation Traditionnelle (Script Natif)

Si vous privilégiez un contexte Root System Install sans conteneurisation :

1. Prérequis Système

Python 3.13.5 nécessaire, en plus d'une grappe de paquets de traitement média.

sudo apt install ffmpeg python3 python3-pip python3-venv poppler-utils git

2. Construction de l'environnement Virtuel (venv)

git clone https://github.com/lantiumBot/Unit3Dup-G3MINI ~/unit3dup
cd ~/unit3dup
python3 -m venv .venv
source .venv/bin/activate
pip install -e .

L'option -e (editable) permet de se tenir automatiquement à jour sur les prochaines évolutions du repo en tapant un simple git pull.

3. Wrapper (Mode Gobal / Optionnel)

Pour lancer globalement unit3dup dans la machine sans pointer vers ".venv/bin/activate" à chaque session :

chmod +x ~/unit3dup/unit3dup-wrapper.sh
sudo ln -s ~/unit3dup/unit3dup-wrapper.sh /usr/local/bin/unit3dup

---

⚙️ Configuration Interne de Connexion (JSON)

Que ce soit le volume de Docker (/config) ou un path local (~/Unit3Dup_config/), au premier lancement le framework cherchera ou générera un fichier d'architecture Unit3Dbot.json. Vous devrez le rempir depuis un classique éditeur comme nano ou autre :

Champ Vital	Utilité	Requis
Gemini_URL	URL Racine globale de G3MINI	✅
Gemini_APIKEY	Clé token API de communication (profil)	✅
Gemini_PID	Votre Passkey tracker privé	✅
TMDB_APIKEY / IMGBB_KEY	Clés pour récupération métadonnées TheMovieDB et Uploads Image	✅

Lier votre groupe d'upload

Cette section uploader_tag n'est quant à elle pas pré-écrite automatiquement, à vous de la forcer dans le fichier Unit3Dbot.json :

"uploader_tag": {
    "TAGS_TEAM": ["MONTAG", "AUTRE_TEAM"]
}

---

🚀 Utilisation de Terrain (Mode Lignes de Commande CLI)

(Pour ceux ayant désactivé l'UI Web sous Docker (ENABLE_GUI=false), ou tournant en local.)

# Force l'envoi d'un seul et unique dossier média au tracker et referme l'instance
unit3dup -f /chemin/vers/dossier

# Initialise une fouille profonde et asynchrone pour traiter un arbre de films en volume global
unit3dup -scan /chemin/global/watch

---

Ce fork maintient une base souscrite initialement dans les travaux Unit3Dup.