G3MINI: web dashboard, validators, watcher state, compliance scanner & Docker

.dockerignore

@@ -0,0 +1,18 @@
+.git
+.gitignore
+__pycache__
+*.py[cod]
+*.egg-info
+dist/
+build/
+.venv/
+tests/
+.github/
+.claude/
+CLAUDE.md
+README.md
+README.rst
+LICENSE
+.readthedocs.yaml
+.DS_Store
+Docker/

.github/workflows/auto-tag.yml

@@ -0,0 +1,71 @@
+name: Auto Tag on Version Change
+
+on:
+  push:
+    branches:
+      - main
+    paths:
+      - 'VERSION'
+
+permissions:
+  contents: write
+
+jobs:
+  check-version:
+    name: Check for version change and create tag
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: Get current version
+        id: current
+        run: |
+          VERSION=$(cat VERSION | tr -d '[:space:]')
+          echo "version=$VERSION" >> $GITHUB_OUTPUT
+          echo "Current version: $VERSION"
+
+      - name: Get previous version
+        id: previous
+        run: |
+          git checkout HEAD^1 -- VERSION 2>/dev/null || echo "0.0.0" > VERSION
+          PREV_VERSION=$(cat VERSION | tr -d '[:space:]')
+          git checkout HEAD -- VERSION
+          echo "version=$PREV_VERSION" >> $GITHUB_OUTPUT
+          echo "Previous version: $PREV_VERSION"
+
+      - name: Check if version changed
+        id: changed
+        run: |
+          if [ "${{ steps.current.outputs.version }}" != "${{ steps.previous.outputs.version }}" ]; then
+            echo "changed=true" >> $GITHUB_OUTPUT
+            echo "Version changed: ${{ steps.previous.outputs.version }} -> ${{ steps.current.outputs.version }}"
+          else
+            echo "changed=false" >> $GITHUB_OUTPUT
+            echo "Version unchanged"
+          fi
+
+      - name: Check if tag exists
+        id: tag_exists
+        if: steps.changed.outputs.changed == 'true'
+        run: |
+          TAG="v${{ steps.current.outputs.version }}"
+          if git rev-parse "$TAG" >/dev/null 2>&1; then
+            echo "exists=true" >> $GITHUB_OUTPUT
+            echo "Tag $TAG already exists"
+          else
+            echo "exists=false" >> $GITHUB_OUTPUT
+          fi
+
+      - name: Create and push tag
+        if: steps.changed.outputs.changed == 'true' && steps.tag_exists.outputs.exists == 'false'
+        run: |
+          VERSION="${{ steps.current.outputs.version }}"
+          TAG="v$VERSION"
+          git config user.name "github-actions[bot]"
+          git config user.email "github-actions[bot]@users.noreply.github.com"
+          git tag -a "$TAG" -m "Release $VERSION"
+          git push origin "$TAG"
+          echo "Created tag: $TAG"

.github/workflows/docker-publish.yml

@@ -0,0 +1,178 @@
+name: Build and Push Docker Image
+
+on:
+  push:
+    branches:
+      - main
+      - develop
+    paths:
+      - "unit3dup/**"
+      - "common/**"
+      - "view/**"
+      - "requirements.txt"
+      - "pyproject.toml"
+      - "Docker/dockerfile"
+      - "VERSION"
+      - ".github/workflows/docker-publish.yml"
+  workflow_dispatch:
+    inputs:
+      tag:
+        description: "Image tag (default: latest)"
+        required: false
+        default: "latest"
+
+env:
+  GHCR_IMAGE: ghcr.io/${{ vars.GHCR_USERNAME }}/${{ vars.REPO_NAME }}
+
+jobs:
+  build:
+    runs-on: ${{ matrix.runner }}
+    permissions:
+      contents: read
+      packages: write
+
+    strategy:
+      fail-fast: false
+      matrix:
+        include:
+          - platform: linux/amd64
+            runner: ubuntu-24.04
+            cache-scope: amd64
+          # Uncomment to enable ARM64 builds (slower, uses native ARM runner)
+          # - platform: linux/arm64
+          #   runner: ubuntu-24.04-arm
+          #   cache-scope: arm64
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Set up Docker Buildx
+        uses: docker/setup-buildx-action@v3
+
+      - name: Log in to GHCR
+        uses: docker/login-action@v3
+        with:
+          registry: ghcr.io
+          username: ${{ github.actor }}
+          password: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Extract metadata
+        id: meta
+        uses: docker/metadata-action@v5
+        with:
+          images: ${{ env.GHCR_IMAGE }}
+
+      - name: Build and push by digest
+        id: build
+        uses: docker/build-push-action@v6
+        with:
+          context: .
+          file: Docker/dockerfile
+          platforms: ${{ matrix.platform }}
+          labels: ${{ steps.meta.outputs.labels }}
+          outputs: type=image,name=${{ env.GHCR_IMAGE }},push-by-digest=true,name-canonical=true,push=true
+          cache-from: type=gha,scope=${{ matrix.cache-scope }}
+          cache-to: type=gha,scope=${{ matrix.cache-scope }},mode=max
+          provenance: false
+
+      - name: Export digest
+        run: |
+          mkdir -p /tmp/digests
+          digest="${{ steps.build.outputs.digest }}"
+          touch "/tmp/digests/${digest#sha256:}"
+
+      - name: Upload digest
+        uses: actions/upload-artifact@v4
+        with:
+          name: digests-${{ matrix.cache-scope }}
+          path: /tmp/digests/*
+          if-no-files-found: error
+          retention-days: 1
+
+  merge:
+    runs-on: ubuntu-latest
+    needs: build
+    permissions:
+      contents: read
+      packages: write
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Download digests
+        uses: actions/download-artifact@v4
+        with:
+          path: /tmp/digests
+          pattern: digests-*
+          merge-multiple: true
+
+      - name: Set up Docker Buildx
+        uses: docker/setup-buildx-action@v3
+
+      - name: Log in to GHCR
+        uses: docker/login-action@v3
+        with:
+          registry: ghcr.io
+          username: ${{ github.actor }}
+          password: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Log in to Docker Hub
+        uses: docker/login-action@v3
+        with:
+          username: ${{ secrets.DOCKERHUB_USERNAME }}
+          password: ${{ secrets.DOCKERHUB_TOKEN }}
+
+      - name: Read VERSION file
+        id: version
+        run: |
+          VERSION=$(cat VERSION | tr -d '[:space:]')
+          echo "version=$VERSION" >> $GITHUB_OUTPUT
+
+      - name: Extract GHCR metadata
+        id: meta-ghcr
+        uses: docker/metadata-action@v5
+        with:
+          images: ${{ env.GHCR_IMAGE }}
+          tags: |
+            type=raw,value=latest,enable={{is_default_branch}}
+            type=raw,value=${{ steps.version.outputs.version }},enable={{is_default_branch}}
+            type=ref,event=branch
+            type=sha,prefix=
+            type=raw,value=${{ github.event.inputs.tag }},enable=${{ github.event_name == 'workflow_dispatch' }}
+
+      - name: Extract Docker Hub metadata
+        id: meta-dockerhub
+        uses: docker/metadata-action@v5
+        with:
+          images: ${{ secrets.DOCKERHUB_USERNAME }}/${{ vars.REPO_NAME }}
+          tags: |
+            type=raw,value=latest,enable={{is_default_branch}}
+            type=raw,value=${{ steps.version.outputs.version }},enable={{is_default_branch}}
+            type=ref,event=branch
+            type=sha,prefix=
+            type=raw,value=${{ github.event.inputs.tag }},enable=${{ github.event_name == 'workflow_dispatch' }}
+
+      - name: Create GHCR manifest list and push
+        working-directory: /tmp/digests
+        run: |
+          docker buildx imagetools create \
+            $(jq -cr '.tags | map("-t " + .) | join(" ")' <<< '${{ steps.meta-ghcr.outputs.json }}') \
+            $(printf '${{ env.GHCR_IMAGE }}@sha256:%s ' *)
+
+      # Copy multi-arch manifest from GHCR to Docker Hub without rebuilding
+      - name: Copy manifest to Docker Hub
+        run: |
+          GHCR_SOURCE="${{ env.GHCR_IMAGE }}:$(echo '${{ github.sha }}' | cut -c1-7)"
+          docker buildx imagetools create \
+            $(jq -cr '.tags | map("-t " + .) | join(" ")' <<< '${{ steps.meta-dockerhub.outputs.json }}') \
+            "$GHCR_SOURCE"
+
+      - name: Inspect GHCR image
+        run: |
+          docker buildx imagetools inspect ${{ env.GHCR_IMAGE }}:${{ steps.meta-ghcr.outputs.version }}
+
+      - name: Inspect Docker Hub image
+        run: |
+          docker buildx imagetools inspect ${{ secrets.DOCKERHUB_USERNAME }}/${{ vars.REPO_NAME }}:${{ steps.meta-dockerhub.outputs.version }}

Docker/dockerfile

@@ -1,13 +1,12 @@
-# 02/05/2025
-# Build "docker build -t unit3dup ." inside the Docker folder first
-# Remove "docker images", "docker rmi -f unit3dup:latest"
+# Build from repo root: docker build -t unit3dup -f Docker/dockerfile .
 
 FROM python:3.11-slim
 
 # Set the username as your Host
 ARG USERNAME=pc
 
 # environment
+ENV HOME=/home/$USERNAME
 ENV VIRTUAL_ENV=/home/$USERNAME/venv
 ENV PATH="$VIRTUAL_ENV/bin:$PATH"
 
@@ -33,21 +32,17 @@ RUN groupadd -g 1000 $USERNAME && \
 USER $USERNAME
 WORKDIR /home/$USERNAME
 
-# Upgrade pip
-RUN pip install --upgrade pip
+# Create virtual env and upgrade pip
+RUN python3 -m venv $VIRTUAL_ENV && \
+    pip install --upgrade pip
 
-# A new virtual env
-RUN python3 -m venv $VIRTUAL_ENV
-
-# Activate virtual
-RUN . $VIRTUAL_ENV/bin/activate
-
-# Copy .whl in the container
-# COPY unit3dup-0.8.6-py3-none-any.whl /app/
-
-# Install .whl
-# RUN pip install --no-cache-dir /app/unit3dup-0.8.6-py3-none-any.whl
-RUN pip install --no-cache-dir unit3dup
+# Copy source and install from source
+COPY --chown=$USERNAME:$USERNAME . /home/$USERNAME/app
+WORKDIR /home/$USERNAME/app
+RUN pip install --no-cache-dir ".[web]" && \
+    chmod o+rx /home/$USERNAME && \
+    chmod -R o+rX $VIRTUAL_ENV
+WORKDIR /home/$USERNAME
 
 # Set the entry point ( see pyproject.toml)
 ENTRYPOINT ["unit3dup"]

README.md

@@ -36,7 +36,8 @@ cd ~/unit3dup
 ```bash
 python3 -m venv .venv
 source .venv/bin/activate
-pip install -e .
+pip install -e .          # CLI only
+pip install -e ".[web]"   # CLI + web dashboard
 ```
 
 L'option `-e` (editable) permet de recevoir les mises à jour du fork simplement avec un `git pull`, sans réinstaller.
@@ -146,7 +147,8 @@ Pas besoin de réinstaller grâce au mode `-e`. Si des nouvelles dépendances on
 
 ```bash
 source .venv/bin/activate
-pip install -e .
+pip install -e .          # CLI only
+pip install -e ".[web]"   # CLI + web dashboard
 ```
 
 ---

VERSION

@@ -0,0 +1 @@
+0.16.0

common/bittorrent.py

@@ -7,8 +7,10 @@
 
 @dataclass
 class BittorrentData:
-    tracker_response: str
+    tracker_response: str | None
     torrent_response: Mytorrent | None
     content: Media
-    tracker_message: dict
+    tracker_message: dict | str
     archive_path: str
+    release_name: str = ""
+    qbit_category: str | None = None

common/command.py

@@ -44,8 +44,12 @@ def __init__(self):
         parser.add_argument("-personal", "--personal", action="store_true", help="Set to personal release")
         parser.add_argument("-confirm", "--confirm", action="store_true",
                             help="Demande une validation manuelle du release_name avant chaque upload")
+        parser.add_argument("-skipval", "--skip_validation", action="store_true",
+                            help="Skip tracker rule validation checks")
 
         parser.add_argument("-ftp", "--ftp", action="store_true", help="Connect to FTP")
+        parser.add_argument("-web", "--web", action="store_true",
+                            help="Start web dashboard (use with -watcher for full mode)")
 
         # optional
         parser.add_argument("-dump", "--dump", action="store_true", help="Download all torrent titles")
@@ -118,7 +122,11 @@ def __init__(self):
             if self.args.force.lower() not in [ System.category_list[System.MOVIE],
                                         System.category_list[System.GAME],
                                         System.category_list[System.TV_SHOW],
-                                        System.category_list[System.DOCUMENTARY]]:
+                                        System.category_list[System.DOCUMENTARY],
+                                        System.category_list[System.ANIMATION],
+                                        System.category_list[System.TV_ANIMATION],
+                                        System.category_list[System.DOCUMENTARY_FILM],
+                                        System.category_list[System.TV_DOCUMENTARY]]:
                 self.args.force = None
                 print("Invalid -force category")
                 exit()

common/external_services/ftpx/client.py

@@ -255,7 +255,11 @@ def change_path(self, selected_folder: str):
 
     def user_input_search(self):
         custom_console.print("Search '->' ", end='', style='violet bold')
-        keyword = input()
+        try:
+            keyword = input()
+        except EOFError:
+            custom_console.bot_warning_log("No interactive input available, skipping search")
+            return
         for item in self.page.get_items():
             if keyword.lower() in item.name.lower():
                 custom_console.bot_question_log(