Fix blacklist synchronizer docs (#307)

https://cleanuparr.github.io/Cleanuparr/docs/installation/detailed

.github/FUNDING.yml

@@ -0,0 +1 @@
+github: Flaminel

.github/ISSUE_TEMPLATE/1-bug.yml

@@ -6,7 +6,7 @@ body:
   - type: markdown
     attributes:
       value: |
-        Thanks for taking the time to improve cleanuperr!
+        Thanks for taking the time to improve Cleanuparr!
   - type: checkboxes
     id: init
     attributes:
@@ -14,8 +14,12 @@ body:
       options:
         - label: Reviewed the documentation.
           required: true
+        - label: Ensured I am using ghcr.io/cleanuparr/cleanuparr docker repository.
+          required: true
         - label: Ensured I am using the latest version.
           required: true
+        - label: Enabled verbose logging.
+          required: true
   - type: textarea
     id: what-happened
     attributes:
@@ -23,14 +27,6 @@ body:
       description: If applicable, mention what you expected to happen.
     validations:
       required: true
-  - type: input
-    id: version
-    attributes:
-      label: Version
-      description: What version of our software are you running?
-      placeholder: e.g. 1.3.0 or latest
-    validations:
-      required: true
   - type: dropdown
     id: os
     attributes:

.github/ISSUE_TEMPLATE/2-feature.yml

@@ -6,7 +6,7 @@ body:
   - type: markdown
     attributes:
       value: |
-        Thanks for taking the time to improve cleanuperr!
+        Thanks for taking the time to improve Cleanuparr!
   - type: textarea
     id: description
     attributes:

.github/ISSUE_TEMPLATE/3-help.yml

@@ -7,6 +7,19 @@ body:
     attributes:
       value: |
         If you are experiencing unexpected behavior, please consider submitting a bug report instead.
+  - type: checkboxes
+    id: init
+    attributes:
+      label: "Before submitting a help request, I have:"
+      options:
+        - label: Reviewed the documentation.
+          required: true
+        - label: Ensured I am using ghcr.io/cleanuparr/cleanuparr docker repository.
+          required: true
+        - label: Ensured I am using the latest version.
+          required: true
+        - label: Enabled verbose logging.
+          required: true
   - type: textarea
     id: description
     attributes:

.github/workflows/build-docker.yml

@@ -0,0 +1,138 @@
+name: Build Docker Images
+
+on:
+  push:
+    tags:
+      - "v*.*.*"
+  pull_request:
+    paths:
+      - 'code/**'
+  workflow_dispatch:
+  workflow_call:
+
+jobs:
+  build_app:
+    runs-on: ubuntu-latest
+    steps:
+
+      - name: Set github context
+        timeout-minutes: 1
+        run: |
+          echo 'githubRepository=${{ github.repository }}' >> $GITHUB_ENV
+          echo 'githubSha=${{ github.sha }}' >> $GITHUB_ENV
+          echo 'githubRef=${{ github.ref }}' >> $GITHUB_ENV
+          echo 'githubHeadRef=${{ github.head_ref }}' >> $GITHUB_ENV
+
+      - name: Initialize build info
+        timeout-minutes: 1
+        run: |
+          githubHeadRef=${{ env.githubHeadRef }}
+          latestDockerTag=""
+          versionDockerTag=""
+          majorVersionDockerTag=""
+          minorVersionDockerTag=""
+          version="0.0.1"
+
+          if [[ "$githubRef" =~ ^"refs/tags/" ]]; then
+            branch=${githubRef##*/}
+            latestDockerTag="latest"
+            versionDockerTag=${branch#v}
+            version=${branch#v}
+            
+            # Extract major and minor versions for additional tags
+            if [[ "$versionDockerTag" =~ ^([0-9]+)\.([0-9]+)\.([0-9]+) ]]; then
+              majorVersionDockerTag="${BASH_REMATCH[1]}"
+              minorVersionDockerTag="${BASH_REMATCH[1]}.${BASH_REMATCH[2]}"
+            fi
+          else
+            # Determine if this run is for the main branch or another branch
+            if [[ -z "$githubHeadRef" ]]; then
+              # Main branch
+              githubRef=${{ env.githubRef }}
+              branch=${githubRef##*/}
+              versionDockerTag="$branch"
+            else
+              # Pull request
+              branch=$githubHeadRef
+              versionDockerTag="$branch"
+            fi
+          fi
+
+          githubTags=""
+
+          if [ -n "$latestDockerTag" ]; then
+            githubTags="$githubTags,ghcr.io/cleanuparr/cleanuparr:$latestDockerTag"
+          fi
+          if [ -n "$versionDockerTag" ]; then
+            githubTags="$githubTags,ghcr.io/cleanuparr/cleanuparr:$versionDockerTag"
+          fi
+          if [ -n "$minorVersionDockerTag" ]; then
+            githubTags="$githubTags,ghcr.io/cleanuparr/cleanuparr:$minorVersionDockerTag"
+          fi
+          if [ -n "$majorVersionDockerTag" ]; then
+            githubTags="$githubTags,ghcr.io/cleanuparr/cleanuparr:$majorVersionDockerTag"
+          fi
+
+          # set env vars
+          echo "branch=$branch" >> $GITHUB_ENV
+          echo "githubTags=$githubTags" >> $GITHUB_ENV
+          echo "versionDockerTag=$versionDockerTag" >> $GITHUB_ENV
+          echo "version=$version" >> $GITHUB_ENV
+
+      - name: Get vault secrets
+        uses: hashicorp/vault-action@v2
+        with:
+          url: ${{ secrets.VAULT_HOST }}
+          method: approle
+          roleId: ${{ secrets.VAULT_ROLE_ID }}
+          secretId: ${{ secrets.VAULT_SECRET_ID }}
+          secrets:
+            secrets/data/docker username | DOCKER_USERNAME;
+            secrets/data/docker password | DOCKER_PASSWORD;
+            secrets/data/github repo_readonly_pat | REPO_READONLY_PAT;
+            secrets/data/github packages_pat | PACKAGES_PAT
+
+      - name: Checkout target repository
+        uses: actions/checkout@v4
+        timeout-minutes: 1
+        with:
+          repository: ${{ env.githubRepository }}
+          ref: ${{ env.branch }}
+          token: ${{ env.REPO_READONLY_PAT }}
+
+      - name: Set up Docker Buildx
+        uses: docker/setup-buildx-action@v3
+        timeout-minutes: 5
+
+      - name: Set up QEMU
+        uses: docker/setup-qemu-action@v3
+
+      - name: Login to GitHub Container Registry
+        uses: docker/login-action@v3
+        with:
+          registry: ghcr.io
+          username: ${{ github.repository_owner }}
+          password: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Build and push docker image
+        timeout-minutes: 15
+        uses: docker/build-push-action@v6
+        with:
+          context: ${{ github.workspace }}/code
+          file: ${{ github.workspace }}/code/Dockerfile
+          provenance: false
+          labels: |
+            commit=sha-${{ env.githubSha }}
+            version=${{ env.versionDockerTag }}
+          build-args: |
+            VERSION=${{ env.version }}
+            PACKAGES_USERNAME=${{ secrets.PACKAGES_USERNAME }}
+            PACKAGES_PAT=${{ env.PACKAGES_PAT }}
+          outputs: |
+            type=image
+          platforms: |
+            linux/amd64
+            linux/arm64
+          push: true
+          tags: |
+            ${{ env.githubTags }}

.github/workflows/build-executable.yml

@@ -0,0 +1,137 @@
+name: Build Executables
+
+on:
+  push:
+    tags:
+      - "v*.*.*"
+  workflow_dispatch:
+  workflow_call:
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+
+      - name: Gate
+        if: ${{ !startsWith(github.ref, 'refs/tags/') && github.event_name != 'workflow_dispatch' }}
+        run: |
+          echo "This workflow only runs on tag events or manual dispatch. Pipeline finished."
+          exit 0
+
+      - name: Set variables
+        run: |
+          repoFullName=${{ github.repository }}
+          ref=${{ github.ref }}
+          
+          # Handle both tag events and manual dispatch
+          if [[ "$ref" =~ ^refs/tags/ ]]; then
+            releaseVersion=${ref##refs/tags/}
+            appVersion=${releaseVersion#v}
+          else
+            # For manual dispatch, use a default version
+            releaseVersion="dev-$(date +%Y%m%d-%H%M%S)"
+            appVersion="0.0.1-dev"
+          fi
+
+          echo "githubRepository=${{ github.repository }}" >> $GITHUB_ENV
+          echo "githubRepositoryName=${repoFullName#*/}" >> $GITHUB_ENV
+          echo "releaseVersion=$releaseVersion" >> $GITHUB_ENV
+          echo "appVersion=$appVersion" >> $GITHUB_ENV
+          echo "executableName=Cleanuparr.Api" >> $GITHUB_ENV
+
+      - name: Get vault secrets
+        uses: hashicorp/vault-action@v2
+        with:
+          url: ${{ secrets.VAULT_HOST }}
+          method: approle
+          roleId: ${{ secrets.VAULT_ROLE_ID }}
+          secretId: ${{ secrets.VAULT_SECRET_ID }}
+          secrets:
+            secrets/data/github repo_readonly_pat | REPO_READONLY_PAT;
+            secrets/data/github packages_pat | PACKAGES_PAT
+
+      - name: Checkout target repository
+        uses: actions/checkout@v4
+        timeout-minutes: 1
+        with:
+          repository: ${{ env.githubRepository }}
+          ref: ${{ github.ref_name }}
+          token: ${{ env.REPO_READONLY_PAT }}
+
+      - name: Setup Node.js for frontend build
+        uses: actions/setup-node@v4
+        with:
+          node-version: '18'
+          cache: 'npm'
+          cache-dependency-path: code/frontend/package-lock.json
+
+      - name: Build frontend
+        run: |
+          cd code/frontend
+          npm ci
+          npm run build
+
+      - name: Setup dotnet
+        uses: actions/setup-dotnet@v4
+        with:
+          dotnet-version: 9.0.x
+      
+      - name: Install dependencies and restore
+        run: |
+          dotnet nuget add source --username ${{ github.repository_owner }} --password ${{ secrets.PACKAGES_PAT }} --store-password-in-clear-text --name Cleanuparr https://nuget.pkg.github.com/Cleanuparr/index.json
+          dotnet restore code/backend/${{ env.executableName }}/${{ env.executableName }}.csproj
+
+      - name: Copy frontend to backend wwwroot
+        run: |
+          mkdir -p code/backend/${{ env.executableName }}/wwwroot
+          cp -r code/frontend/dist/ui/browser/* code/backend/${{ env.executableName }}/wwwroot/
+
+      - name: Build win-x64
+        run: dotnet publish code/backend/${{ env.executableName }}/${{ env.executableName }}.csproj -c Release --runtime win-x64 --self-contained -o artifacts/${{ env.githubRepositoryName }}-${{ env.appVersion }}-win-amd64 /p:PublishSingleFile=true /p:Version=${{ env.appVersion }} /p:DebugSymbols=false
+
+      - name: Build linux-x64
+        run: dotnet publish code/backend/${{ env.executableName }}/${{ env.executableName }}.csproj -c Release --runtime linux-x64 --self-contained -o artifacts/${{ env.githubRepositoryName }}-${{ env.appVersion }}-linux-amd64 /p:PublishSingleFile=true /p:Version=${{ env.appVersion }} /p:DebugSymbols=false
+
+      - name: Build linux-arm64
+        run: dotnet publish code/backend/${{ env.executableName }}/${{ env.executableName }}.csproj -c Release --runtime linux-arm64 --self-contained -o artifacts/${{ env.githubRepositoryName }}-${{ env.appVersion }}-linux-arm64 /p:PublishSingleFile=true /p:Version=${{ env.appVersion }} /p:DebugSymbols=false
+        
+      - name: Build osx-x64
+        run: dotnet publish code/backend/${{ env.executableName }}/${{ env.executableName }}.csproj -c Release --runtime osx-x64 --self-contained -o artifacts/${{ env.githubRepositoryName }}-${{ env.appVersion }}-osx-amd64 /p:PublishSingleFile=true /p:Version=${{ env.appVersion }} /p:DebugSymbols=false
+
+      - name: Build osx-arm64
+        run: dotnet publish code/backend/${{ env.executableName }}/${{ env.executableName }}.csproj -c Release --runtime osx-arm64 --self-contained -o artifacts/${{ env.githubRepositoryName }}-${{ env.appVersion }}-osx-arm64 /p:PublishSingleFile=true /p:Version=${{ env.appVersion }} /p:DebugSymbols=false
+
+      - name: Zip win-x64
+        run: |
+          cd ./artifacts
+          zip -r ./${{ env.githubRepositoryName }}-${{ env.appVersion }}-win-amd64.zip ./${{ env.githubRepositoryName }}-${{ env.appVersion }}-win-amd64/
+
+      - name: Zip linux-x64
+        run: |
+          cd ./artifacts
+          zip -r ./${{ env.githubRepositoryName }}-${{ env.appVersion }}-linux-amd64.zip ./${{ env.githubRepositoryName }}-${{ env.appVersion }}-linux-amd64/
+
+      - name: Zip linux-arm64
+        run: |
+          cd ./artifacts
+          zip -r ./${{ env.githubRepositoryName }}-${{ env.appVersion }}-linux-arm64.zip ./${{ env.githubRepositoryName }}-${{ env.appVersion }}-linux-arm64/
+
+      - name: Zip osx-x64
+        run: |
+          cd ./artifacts
+          zip -r ./${{ env.githubRepositoryName }}-${{ env.appVersion }}-osx-amd64.zip ./${{ env.githubRepositoryName }}-${{ env.appVersion }}-osx-amd64/
+
+      - name: Zip osx-arm64
+        run: |
+          cd ./artifacts
+          zip -r ./${{ env.githubRepositoryName }}-${{ env.appVersion }}-osx-arm64.zip ./${{ env.githubRepositoryName }}-${{ env.appVersion }}-osx-arm64/
+
+      - name: Upload artifacts
+        uses: actions/upload-artifact@v4
+        with:
+          name: cleanuparr-executables
+          path: |
+            ./artifacts/*.zip
+          retention-days: 30
+
+      # Removed individual release step - handled by main release workflow

.github/workflows/build-macos-arm-installer.yml

@@ -0,0 +1,366 @@
+name: Build macOS ARM Installer
+
+permissions:
+  contents: write
+
+on:
+  push:
+    tags:
+      - "v*.*.*"
+  workflow_dispatch:
+  workflow_call:
+
+jobs:
+  build-macos-arm-installer:
+    name: Build macOS ARM Installer
+    runs-on: macos-14  # ARM runner for Apple Silicon
+    
+    steps:
+      - name: Set variables
+        run: |
+          repoFullName=${{ github.repository }}
+          ref=${{ github.ref }}
+          
+          # Handle both tag events and manual dispatch
+          if [[ "$ref" =~ ^refs/tags/ ]]; then
+            releaseVersion=${ref##refs/tags/}
+            appVersion=${releaseVersion#v}
+          else
+            # For manual dispatch, use a default version
+            releaseVersion="dev-$(date +%Y%m%d-%H%M%S)"
+            appVersion="0.0.1-dev"
+          fi
+          
+          repositoryName=${repoFullName#*/}
+          
+          echo "githubRepository=${{ github.repository }}" >> $GITHUB_ENV
+          echo "githubRepositoryName=$repositoryName" >> $GITHUB_ENV
+          echo "releaseVersion=$releaseVersion" >> $GITHUB_ENV
+          echo "appVersion=$appVersion" >> $GITHUB_ENV
+          echo "executableName=Cleanuparr.Api" >> $GITHUB_ENV
+
+      - name: Get vault secrets
+        uses: hashicorp/vault-action@v2
+        with:
+          url: ${{ secrets.VAULT_HOST }}
+          method: approle
+          roleId: ${{ secrets.VAULT_ROLE_ID }}
+          secretId: ${{ secrets.VAULT_SECRET_ID }}
+          secrets:
+            secrets/data/github repo_readonly_pat | REPO_READONLY_PAT;
+            secrets/data/github packages_pat | PACKAGES_PAT
+
+      - name: Checkout repository
+        uses: actions/checkout@v4
+        with:
+          repository: ${{ env.githubRepository }}
+          ref: ${{ github.ref_name }}
+          token: ${{ env.REPO_READONLY_PAT }}
+          fetch-depth: 0
+
+      - name: Setup Node.js for frontend build
+        uses: actions/setup-node@v4
+        with:
+          node-version: '18'
+          cache: 'npm'
+          cache-dependency-path: code/frontend/package-lock.json
+
+      - name: Build frontend
+        run: |
+          cd code/frontend
+          npm ci
+          npm run build
+
+      - name: Setup .NET
+        uses: actions/setup-dotnet@v4
+        with:
+          dotnet-version: 9.0.x
+
+      - name: Restore .NET dependencies
+        run: |
+          dotnet nuget add source --username ${{ github.repository_owner }} --password ${{ env.PACKAGES_PAT }} --store-password-in-clear-text --name Cleanuparr https://nuget.pkg.github.com/Cleanuparr/index.json
+          dotnet restore code/backend/${{ env.executableName }}/${{ env.executableName }}.csproj
+
+      - name: Build macOS ARM executable
+        run: |
+          # Clean any existing output directory
+          rm -rf dist
+          mkdir -p dist/temp
+          
+          # Build to a temporary location
+          dotnet publish code/backend/${{ env.executableName }}/${{ env.executableName }}.csproj \
+            -c Release \
+            --runtime osx-arm64 \
+            --self-contained true \
+            -o dist/temp \
+            /p:PublishSingleFile=true \
+            /p:Version=${{ env.appVersion }} \
+            /p:DebugType=None \
+            /p:DebugSymbols=false \
+            /p:UseAppHost=true \
+            /p:EnableMacOSCodeSign=false \
+            /p:CodeSignOnCopy=false \
+            /p:_CodeSignDuringBuild=false \
+            /p:PublishTrimmed=false \
+            /p:TrimMode=link
+          
+          # Create proper app bundle structure
+          mkdir -p dist/Cleanuparr.app/Contents/MacOS
+          
+          # Copy the built executable (note: AssemblyName is "Cleanuparr" not "Cleanuparr.Api")
+          cp dist/temp/Cleanuparr dist/Cleanuparr.app/Contents/MacOS/Cleanuparr
+          
+          # Copy frontend directly to where it belongs in the app bundle
+          mkdir -p dist/Cleanuparr.app/Contents/MacOS/wwwroot
+          cp -r code/frontend/dist/ui/browser/* dist/Cleanuparr.app/Contents/MacOS/wwwroot/
+          
+          # Copy any additional runtime files if they exist
+          if [ -d "dist/temp" ]; then
+            find dist/temp -name "*.dylib" -exec cp {} dist/Cleanuparr.app/Contents/MacOS/ \; 2>/dev/null || true
+            find dist/temp -name "createdump" -exec cp {} dist/Cleanuparr.app/Contents/MacOS/ \; 2>/dev/null || true
+          fi
+
+      - name: Post-build setup
+        run: |
+          # Make sure the executable is actually executable
+          chmod +x dist/Cleanuparr.app/Contents/MacOS/Cleanuparr
+          
+          # Remove any .pdb files that might have been created
+          find dist/Cleanuparr.app/Contents/MacOS -name "*.pdb" -delete 2>/dev/null || true
+          
+          echo "Checking architecture of built binary:"
+          file dist/Cleanuparr.app/Contents/MacOS/Cleanuparr
+          if command -v lipo >/dev/null 2>&1; then
+            lipo -info dist/Cleanuparr.app/Contents/MacOS/Cleanuparr
+          fi
+          
+          echo "Files in MacOS directory:"
+          ls -la dist/Cleanuparr.app/Contents/MacOS/
+
+      - name: Create macOS app bundle structure
+        run: |
+          # Create proper app bundle structure
+          mkdir -p dist/Cleanuparr.app/Contents/{MacOS,Resources,Frameworks}
+          
+          # Convert ICO to ICNS for macOS app bundle
+          if command -v iconutil >/dev/null 2>&1; then
+            # Create iconset directory structure
+            mkdir -p Cleanuparr.iconset
+            
+            # Use existing PNG files from Logo directory for different sizes
+            cp Logo/16.png Cleanuparr.iconset/icon_16x16.png
+            cp Logo/32.png Cleanuparr.iconset/icon_16x16@2x.png
+            cp Logo/32.png Cleanuparr.iconset/icon_32x32.png
+            cp Logo/64.png Cleanuparr.iconset/icon_32x32@2x.png
+            cp Logo/128.png Cleanuparr.iconset/icon_128x128.png
+            cp Logo/256.png Cleanuparr.iconset/icon_128x128@2x.png
+            cp Logo/256.png Cleanuparr.iconset/icon_256x256.png
+            cp Logo/512.png Cleanuparr.iconset/icon_256x256@2x.png
+            cp Logo/512.png Cleanuparr.iconset/icon_512x512.png
+            cp Logo/1024.png Cleanuparr.iconset/icon_512x512@2x.png
+            
+            # Create ICNS file
+            iconutil -c icns Cleanuparr.iconset -o dist/Cleanuparr.app/Contents/Resources/Cleanuparr.icns
+            
+            # Clean up iconset directory
+            rm -rf Cleanuparr.iconset
+          fi
+          
+          # Create Launch Daemon plist
+          cat > dist/Cleanuparr.app/Contents/Resources/com.cleanuparr.daemon.plist << EOF
+          <?xml version="1.0" encoding="UTF-8"?>
+          <!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+          <plist version="1.0">
+          <dict>
+              <key>Label</key>
+              <string>com.cleanuparr.daemon</string>
+              <key>ProgramArguments</key>
+              <array>
+                  <string>/Applications/Cleanuparr.app/Contents/MacOS/Cleanuparr</string>
+              </array>
+              <key>RunAtLoad</key>
+              <true/>
+              <key>KeepAlive</key>
+              <true/>
+              <key>StandardOutPath</key>
+              <string>/var/log/cleanuparr.log</string>
+              <key>StandardErrorPath</key>
+              <string>/var/log/cleanuparr.error.log</string>
+              <key>WorkingDirectory</key>
+              <string>/Applications/Cleanuparr.app/Contents/MacOS</string>
+              <key>EnvironmentVariables</key>
+              <dict>
+                  <key>HTTP_PORTS</key>
+                  <string>11011</string>
+              </dict>
+          </dict>
+          </plist>
+          EOF
+          
+          # Create Info.plist with proper configuration
+          cat > dist/Cleanuparr.app/Contents/Info.plist << EOF
+          <?xml version="1.0" encoding="UTF-8"?>
+          <!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+          <plist version="1.0">
+          <dict>
+              <key>CFBundleExecutable</key>
+              <string>Cleanuparr</string>
+              <key>CFBundleIdentifier</key>
+              <string>com.Cleanuparr</string>
+              <key>CFBundleName</key>
+              <string>Cleanuparr</string>
+              <key>CFBundleDisplayName</key>
+              <string>Cleanuparr</string>
+              <key>CFBundleVersion</key>
+              <string>${{ env.appVersion }}</string>
+              <key>CFBundleShortVersionString</key>
+              <string>${{ env.appVersion }}</string>
+              <key>CFBundleInfoDictionaryVersion</key>
+              <string>6.0</string>
+              <key>CFBundlePackageType</key>
+              <string>APPL</string>
+              <key>CFBundleSignature</key>
+              <string>CLNR</string>
+              <key>CFBundleIconFile</key>
+              <string>Cleanuparr</string>
+              <key>NSHighResolutionCapable</key>
+              <true/>
+              <key>NSRequiresAquaSystemAppearance</key>
+              <false/>
+              <key>LSMinimumSystemVersion</key>
+              <string>11.0</string>
+              <key>LSApplicationCategoryType</key>
+              <string>public.app-category.productivity</string>
+              <key>NSSupportsAutomaticTermination</key>
+              <false/>
+              <key>NSSupportsSuddenTermination</key>
+              <false/>
+              <key>LSBackgroundOnly</key>
+              <false/>
+              <key>NSAppTransportSecurity</key>
+              <dict>
+                  <key>NSAllowsArbitraryLoads</key>
+                  <true/>
+              </dict>
+          </dict>
+          </plist>
+          EOF
+          
+          # Clean up temp directory
+          rm -rf dist/temp
+
+      - name: Create PKG installer
+        run: |
+          # Create preinstall script to handle existing installations
+          mkdir -p scripts
+          cat > scripts/preinstall << 'EOF'
+          #!/bin/bash
+          
+          # Stop and unload existing launch daemon if it exists
+          if launchctl list | grep -q "com.cleanuparr.daemon"; then
+            launchctl stop com.cleanuparr.daemon 2>/dev/null || true
+            launchctl unload /Library/LaunchDaemons/com.cleanuparr.daemon.plist 2>/dev/null || true
+          fi
+          
+          # Stop any running instances of Cleanuparr
+          pkill -f "Cleanuparr" || true
+          sleep 2
+          
+          # Remove old installation if it exists
+          if [[ -d "/Applications/Cleanuparr.app" ]]; then
+            rm -rf "/Applications/Cleanuparr.app"
+          fi
+          
+          # Remove old launch daemon plist if it exists
+          if [[ -f "/Library/LaunchDaemons/com.cleanuparr.daemon.plist" ]]; then
+            rm -f "/Library/LaunchDaemons/com.cleanuparr.daemon.plist"
+          fi
+          
+          exit 0
+          EOF
+          
+          chmod +x scripts/preinstall
+          
+          # Create postinstall script
+          cat > scripts/postinstall << 'EOF'
+          #!/bin/bash
+          
+          # Set proper permissions for the app bundle
+          chmod -R 755 /Applications/Cleanuparr.app
+          chmod +x /Applications/Cleanuparr.app/Contents/MacOS/Cleanuparr
+          
+          # Install the launch daemon
+          cp /Applications/Cleanuparr.app/Contents/Resources/com.cleanuparr.daemon.plist /Library/LaunchDaemons/
+          chown root:wheel /Library/LaunchDaemons/com.cleanuparr.daemon.plist
+          chmod 644 /Library/LaunchDaemons/com.cleanuparr.daemon.plist
+          
+          # Load and start the service
+          launchctl load /Library/LaunchDaemons/com.cleanuparr.daemon.plist
+          launchctl start com.cleanuparr.daemon
+          
+          # Wait a moment for service to start
+          sleep 3
+          
+          # Display as system notification
+          osascript -e 'display notification "Cleanuparr service started! Visit http://localhost:11011 in your browser." with title "Installation Complete"' 2>/dev/null || true
+          
+          exit 0
+          EOF
+          
+          chmod +x scripts/postinstall
+          
+          # Create uninstall script (optional, for user reference)
+          cat > scripts/uninstall_cleanuparr.sh << 'EOF'
+          #!/bin/bash
+          # Cleanuparr Uninstall Script
+          # Run this script with sudo to completely remove Cleanuparr
+          
+          echo "Stopping Cleanuparr service..."
+          launchctl stop com.cleanuparr.daemon 2>/dev/null || true
+          launchctl unload /Library/LaunchDaemons/com.cleanuparr.daemon.plist 2>/dev/null || true
+          
+          echo "Removing service files..."
+          rm -f /Library/LaunchDaemons/com.cleanuparr.daemon.plist
+          
+          echo "Removing application..."
+          rm -rf /Applications/Cleanuparr.app
+          
+          echo "Removing logs..."
+          rm -f /var/log/cleanuparr.log
+          rm -f /var/log/cleanuparr.error.log
+          
+          echo "Cleanuparr has been completely removed."
+          echo "Note: Configuration files in /Applications/Cleanuparr.app/Contents/MacOS/config/ have been removed with the app."
+          EOF
+          
+          chmod +x scripts/uninstall_cleanuparr.sh
+          
+          # Copy uninstall script to app bundle for user access
+          cp scripts/uninstall_cleanuparr.sh dist/Cleanuparr.app/Contents/Resources/
+          
+          # Determine package name
+          if [[ "${{ github.ref }}" =~ ^refs/tags/ ]]; then
+            pkg_name="Cleanuparr-${{ env.appVersion }}-macos-arm64.pkg"
+          else
+            pkg_name="Cleanuparr-${{ env.appVersion }}-macos-arm64-dev.pkg"
+          fi
+          
+          # Create PKG installer with better metadata
+          pkgbuild --root dist/ \
+                  --scripts scripts/ \
+                  --identifier com.Cleanuparr \
+                  --version ${{ env.appVersion }} \
+                  --install-location /Applications \
+                  --ownership preserve \
+                  ${pkg_name}
+          
+          echo "pkgName=${pkg_name}" >> $GITHUB_ENV
+
+      - name: Upload installer as artifact
+        uses: actions/upload-artifact@v4
+        with:
+          name: Cleanuparr-macos-arm64-installer
+          path: '${{ env.pkgName }}'
+          retention-days: 30
+
+      # Removed individual release step - handled by main release workflow 

.github/workflows/build-macos-intel-installer.yml

@@ -0,0 +1,366 @@
+name: Build macOS Intel Installer
+
+permissions:
+  contents: write
+
+on:
+  push:
+    tags:
+      - "v*.*.*"
+  workflow_dispatch:
+  workflow_call:
+
+jobs:
+  build-macos-intel-installer:
+    name: Build macOS Intel Installer
+    runs-on: macos-13  # Intel runner
+    
+    steps:
+      - name: Set variables
+        run: |
+          repoFullName=${{ github.repository }}
+          ref=${{ github.ref }}
+          
+          # Handle both tag events and manual dispatch
+          if [[ "$ref" =~ ^refs/tags/ ]]; then
+            releaseVersion=${ref##refs/tags/}
+            appVersion=${releaseVersion#v}
+          else
+            # For manual dispatch, use a default version
+            releaseVersion="dev-$(date +%Y%m%d-%H%M%S)"
+            appVersion="0.0.1-dev"
+          fi
+          
+          repositoryName=${repoFullName#*/}
+          
+          echo "githubRepository=${{ github.repository }}" >> $GITHUB_ENV
+          echo "githubRepositoryName=$repositoryName" >> $GITHUB_ENV
+          echo "releaseVersion=$releaseVersion" >> $GITHUB_ENV
+          echo "appVersion=$appVersion" >> $GITHUB_ENV
+          echo "executableName=Cleanuparr.Api" >> $GITHUB_ENV
+
+      - name: Get vault secrets
+        uses: hashicorp/vault-action@v2
+        with:
+          url: ${{ secrets.VAULT_HOST }}
+          method: approle
+          roleId: ${{ secrets.VAULT_ROLE_ID }}
+          secretId: ${{ secrets.VAULT_SECRET_ID }}
+          secrets:
+            secrets/data/github repo_readonly_pat | REPO_READONLY_PAT;
+            secrets/data/github packages_pat | PACKAGES_PAT
+
+      - name: Checkout repository
+        uses: actions/checkout@v4
+        with:
+          repository: ${{ env.githubRepository }}
+          ref: ${{ github.ref_name }}
+          token: ${{ env.REPO_READONLY_PAT }}
+          fetch-depth: 0
+
+      - name: Setup Node.js for frontend build
+        uses: actions/setup-node@v4
+        with:
+          node-version: '18'
+          cache: 'npm'
+          cache-dependency-path: code/frontend/package-lock.json
+
+      - name: Build frontend
+        run: |
+          cd code/frontend
+          npm ci
+          npm run build
+
+      - name: Setup .NET
+        uses: actions/setup-dotnet@v4
+        with:
+          dotnet-version: 9.0.x
+
+      - name: Restore .NET dependencies
+        run: |
+          dotnet nuget add source --username ${{ github.repository_owner }} --password ${{ env.PACKAGES_PAT }} --store-password-in-clear-text --name Cleanuparr https://nuget.pkg.github.com/Cleanuparr/index.json
+          dotnet restore code/backend/${{ env.executableName }}/${{ env.executableName }}.csproj
+
+      - name: Build macOS Intel executable
+        run: |
+          # Clean any existing output directory
+          rm -rf dist
+          mkdir -p dist/temp
+          
+          # Build to a temporary location
+          dotnet publish code/backend/${{ env.executableName }}/${{ env.executableName }}.csproj \
+            -c Release \
+            --runtime osx-x64 \
+            --self-contained true \
+            -o dist/temp \
+            /p:PublishSingleFile=true \
+            /p:Version=${{ env.appVersion }} \
+            /p:DebugType=None \
+            /p:DebugSymbols=false \
+            /p:UseAppHost=true \
+            /p:EnableMacOSCodeSign=false \
+            /p:CodeSignOnCopy=false \
+            /p:_CodeSignDuringBuild=false \
+            /p:PublishTrimmed=false \
+            /p:TrimMode=link
+          
+          # Create proper app bundle structure
+          mkdir -p dist/Cleanuparr.app/Contents/MacOS
+          
+          # Copy the built executable (note: AssemblyName is "Cleanuparr" not "Cleanuparr.Api")
+          cp dist/temp/Cleanuparr dist/Cleanuparr.app/Contents/MacOS/Cleanuparr
+          
+          # Copy frontend directly to where it belongs in the app bundle
+          mkdir -p dist/Cleanuparr.app/Contents/MacOS/wwwroot
+          cp -r code/frontend/dist/ui/browser/* dist/Cleanuparr.app/Contents/MacOS/wwwroot/
+          
+          # Copy any additional runtime files if they exist
+          if [ -d "dist/temp" ]; then
+            find dist/temp -name "*.dylib" -exec cp {} dist/Cleanuparr.app/Contents/MacOS/ \; 2>/dev/null || true
+            find dist/temp -name "createdump" -exec cp {} dist/Cleanuparr.app/Contents/MacOS/ \; 2>/dev/null || true
+          fi
+
+      - name: Post-build setup
+        run: |
+          # Make sure the executable is actually executable
+          chmod +x dist/Cleanuparr.app/Contents/MacOS/Cleanuparr
+          
+          # Remove any .pdb files that might have been created
+          find dist/Cleanuparr.app/Contents/MacOS -name "*.pdb" -delete 2>/dev/null || true
+          
+          echo "Checking architecture of built binary:"
+          file dist/Cleanuparr.app/Contents/MacOS/Cleanuparr
+          if command -v lipo >/dev/null 2>&1; then
+            lipo -info dist/Cleanuparr.app/Contents/MacOS/Cleanuparr
+          fi
+          
+          echo "Files in MacOS directory:"
+          ls -la dist/Cleanuparr.app/Contents/MacOS/
+
+      - name: Create macOS app bundle structure
+        run: |
+          # Create proper app bundle structure
+          mkdir -p dist/Cleanuparr.app/Contents/{MacOS,Resources,Frameworks}
+          
+          # Convert ICO to ICNS for macOS app bundle
+          if command -v iconutil >/dev/null 2>&1; then
+            # Create iconset directory structure
+            mkdir -p Cleanuparr.iconset
+            
+            # Use existing PNG files from Logo directory for different sizes
+            cp Logo/16.png Cleanuparr.iconset/icon_16x16.png
+            cp Logo/32.png Cleanuparr.iconset/icon_16x16@2x.png
+            cp Logo/32.png Cleanuparr.iconset/icon_32x32.png
+            cp Logo/64.png Cleanuparr.iconset/icon_32x32@2x.png
+            cp Logo/128.png Cleanuparr.iconset/icon_128x128.png
+            cp Logo/256.png Cleanuparr.iconset/icon_128x128@2x.png
+            cp Logo/256.png Cleanuparr.iconset/icon_256x256.png
+            cp Logo/512.png Cleanuparr.iconset/icon_256x256@2x.png
+            cp Logo/512.png Cleanuparr.iconset/icon_512x512.png
+            cp Logo/1024.png Cleanuparr.iconset/icon_512x512@2x.png
+            
+            # Create ICNS file
+            iconutil -c icns Cleanuparr.iconset -o dist/Cleanuparr.app/Contents/Resources/Cleanuparr.icns
+            
+            # Clean up iconset directory
+            rm -rf Cleanuparr.iconset
+          fi
+          
+          # Create Launch Daemon plist
+          cat > dist/Cleanuparr.app/Contents/Resources/com.cleanuparr.daemon.plist << EOF
+          <?xml version="1.0" encoding="UTF-8"?>
+          <!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+          <plist version="1.0">
+          <dict>
+              <key>Label</key>
+              <string>com.cleanuparr.daemon</string>
+              <key>ProgramArguments</key>
+              <array>
+                  <string>/Applications/Cleanuparr.app/Contents/MacOS/Cleanuparr</string>
+              </array>
+              <key>RunAtLoad</key>
+              <true/>
+              <key>KeepAlive</key>
+              <true/>
+              <key>StandardOutPath</key>
+              <string>/var/log/cleanuparr.log</string>
+              <key>StandardErrorPath</key>
+              <string>/var/log/cleanuparr.error.log</string>
+              <key>WorkingDirectory</key>
+              <string>/Applications/Cleanuparr.app/Contents/MacOS</string>
+              <key>EnvironmentVariables</key>
+              <dict>
+                  <key>HTTP_PORTS</key>
+                  <string>11011</string>
+              </dict>
+          </dict>
+          </plist>
+          EOF
+          
+          # Create Info.plist with proper configuration
+          cat > dist/Cleanuparr.app/Contents/Info.plist << EOF
+          <?xml version="1.0" encoding="UTF-8"?>
+          <!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+          <plist version="1.0">
+          <dict>
+              <key>CFBundleExecutable</key>
+              <string>Cleanuparr</string>
+              <key>CFBundleIdentifier</key>
+              <string>com.Cleanuparr</string>
+              <key>CFBundleName</key>
+              <string>Cleanuparr</string>
+              <key>CFBundleDisplayName</key>
+              <string>Cleanuparr</string>
+              <key>CFBundleVersion</key>
+              <string>${{ env.appVersion }}</string>
+              <key>CFBundleShortVersionString</key>
+              <string>${{ env.appVersion }}</string>
+              <key>CFBundleInfoDictionaryVersion</key>
+              <string>6.0</string>
+              <key>CFBundlePackageType</key>
+              <string>APPL</string>
+              <key>CFBundleSignature</key>
+              <string>CLNR</string>
+              <key>CFBundleIconFile</key>
+              <string>Cleanuparr</string>
+              <key>NSHighResolutionCapable</key>
+              <true/>
+              <key>NSRequiresAquaSystemAppearance</key>
+              <false/>
+              <key>LSMinimumSystemVersion</key>
+              <string>10.15</string>
+              <key>LSApplicationCategoryType</key>
+              <string>public.app-category.productivity</string>
+              <key>NSSupportsAutomaticTermination</key>
+              <false/>
+              <key>NSSupportsSuddenTermination</key>
+              <false/>
+              <key>LSBackgroundOnly</key>
+              <false/>
+              <key>NSAppTransportSecurity</key>
+              <dict>
+                  <key>NSAllowsArbitraryLoads</key>
+                  <true/>
+              </dict>
+          </dict>
+          </plist>
+          EOF
+          
+          # Clean up temp directory
+          rm -rf dist/temp
+
+      - name: Create PKG installer
+        run: |
+          # Create preinstall script to handle existing installations
+          mkdir -p scripts
+          cat > scripts/preinstall << 'EOF'
+          #!/bin/bash
+          
+          # Stop and unload existing launch daemon if it exists
+          if launchctl list | grep -q "com.cleanuparr.daemon"; then
+            launchctl stop com.cleanuparr.daemon 2>/dev/null || true
+            launchctl unload /Library/LaunchDaemons/com.cleanuparr.daemon.plist 2>/dev/null || true
+          fi
+          
+          # Stop any running instances of Cleanuparr
+          pkill -f "Cleanuparr" || true
+          sleep 2
+          
+          # Remove old installation if it exists
+          if [[ -d "/Applications/Cleanuparr.app" ]]; then
+            rm -rf "/Applications/Cleanuparr.app"
+          fi
+          
+          # Remove old launch daemon plist if it exists
+          if [[ -f "/Library/LaunchDaemons/com.cleanuparr.daemon.plist" ]]; then
+            rm -f "/Library/LaunchDaemons/com.cleanuparr.daemon.plist"
+          fi
+          
+          exit 0
+          EOF
+          
+          chmod +x scripts/preinstall
+          
+          # Create postinstall script
+          cat > scripts/postinstall << 'EOF'
+          #!/bin/bash
+          
+          # Set proper permissions for the app bundle
+          chmod -R 755 /Applications/Cleanuparr.app
+          chmod +x /Applications/Cleanuparr.app/Contents/MacOS/Cleanuparr
+          
+          # Install the launch daemon
+          cp /Applications/Cleanuparr.app/Contents/Resources/com.cleanuparr.daemon.plist /Library/LaunchDaemons/
+          chown root:wheel /Library/LaunchDaemons/com.cleanuparr.daemon.plist
+          chmod 644 /Library/LaunchDaemons/com.cleanuparr.daemon.plist
+          
+          # Load and start the service
+          launchctl load /Library/LaunchDaemons/com.cleanuparr.daemon.plist
+          launchctl start com.cleanuparr.daemon
+          
+          # Wait a moment for service to start
+          sleep 3
+          
+          # Display as system notification
+          osascript -e 'display notification "Cleanuparr service started! Visit http://localhost:11011 in your browser." with title "Installation Complete"' 2>/dev/null || true
+          
+          exit 0
+          EOF
+          
+          chmod +x scripts/postinstall
+          
+          # Create uninstall script (optional, for user reference)
+          cat > scripts/uninstall_cleanuparr.sh << 'EOF'
+          #!/bin/bash
+          # Cleanuparr Uninstall Script
+          # Run this script with sudo to completely remove Cleanuparr
+          
+          echo "Stopping Cleanuparr service..."
+          launchctl stop com.cleanuparr.daemon 2>/dev/null || true
+          launchctl unload /Library/LaunchDaemons/com.cleanuparr.daemon.plist 2>/dev/null || true
+          
+          echo "Removing service files..."
+          rm -f /Library/LaunchDaemons/com.cleanuparr.daemon.plist
+          
+          echo "Removing application..."
+          rm -rf /Applications/Cleanuparr.app
+          
+          echo "Removing logs..."
+          rm -f /var/log/cleanuparr.log
+          rm -f /var/log/cleanuparr.error.log
+          
+          echo "Cleanuparr has been completely removed."
+          echo "Note: Configuration files in /Applications/Cleanuparr.app/Contents/MacOS/config/ have been removed with the app."
+          EOF
+          
+          chmod +x scripts/uninstall_cleanuparr.sh
+          
+          # Copy uninstall script to app bundle for user access
+          cp scripts/uninstall_cleanuparr.sh dist/Cleanuparr.app/Contents/Resources/
+          
+          # Determine package name
+          if [[ "${{ github.ref }}" =~ ^refs/tags/ ]]; then
+            pkg_name="Cleanuparr-${{ env.appVersion }}-macos-intel.pkg"
+          else
+            pkg_name="Cleanuparr-${{ env.appVersion }}-macos-intel-dev.pkg"
+          fi
+          
+          # Create PKG installer with better metadata
+          pkgbuild --root dist/ \
+                  --scripts scripts/ \
+                  --identifier com.Cleanuparr \
+                  --version ${{ env.appVersion }} \
+                  --install-location /Applications \
+                  --ownership preserve \
+                  ${pkg_name}
+          
+          echo "pkgName=${pkg_name}" >> $GITHUB_ENV
+
+      - name: Upload installer as artifact
+        uses: actions/upload-artifact@v4
+        with:
+          name: Cleanuparr-macos-intel-installer
+          path: '${{ env.pkgName }}'
+          retention-days: 30
+
+      # Removed individual release step - handled by main release workflow 

.github/workflows/build-windows-installer.yml

@@ -0,0 +1,148 @@
+name: Build Windows Installer
+
+on:
+  push:
+    tags:
+      - "v*.*.*"
+  workflow_dispatch:
+  workflow_call:
+
+jobs:
+  build-windows-installer:
+    runs-on: windows-latest
+    
+    steps:
+      - name: Set variables
+        shell: pwsh
+        run: |
+          $repoFullName = "${{ github.repository }}"
+          $ref = "${{ github.ref }}"
+          
+          # Handle both tag events and manual dispatch
+          if ($ref -match "^refs/tags/") {
+            $releaseVersion = $ref -replace "refs/tags/", ""
+            $appVersion = $releaseVersion -replace "^v", ""
+          } else {
+            # For manual dispatch, use a default version
+            $releaseVersion = "dev-$(Get-Date -Format 'yyyyMMdd-HHmmss')"
+            $appVersion = "0.0.1-dev"
+          }
+          
+          $repositoryName = $repoFullName.Split("/")[1]
+          
+          echo "githubRepository=${{ github.repository }}" >> $env:GITHUB_ENV
+          echo "githubRepositoryName=$repositoryName" >> $env:GITHUB_ENV
+          echo "releaseVersion=$releaseVersion" >> $env:GITHUB_ENV
+          echo "appVersion=$appVersion" >> $env:GITHUB_ENV
+          echo "executableName=Cleanuparr.Api" >> $env:GITHUB_ENV
+          echo "APP_VERSION=$appVersion" >> $env:GITHUB_ENV
+
+      - name: Get vault secrets
+        uses: hashicorp/vault-action@v2
+        with:
+          url: ${{ secrets.VAULT_HOST }}
+          method: approle
+          roleId: ${{ secrets.VAULT_ROLE_ID }}
+          secretId: ${{ secrets.VAULT_SECRET_ID }}
+          secrets:
+            secrets/data/github repo_readonly_pat | REPO_READONLY_PAT;
+            secrets/data/github packages_pat | PACKAGES_PAT
+
+      - name: Checkout repository
+        uses: actions/checkout@v4
+        with:
+          repository: ${{ env.githubRepository }}
+          ref: ${{ github.ref_name }}
+          token: ${{ env.REPO_READONLY_PAT }}
+
+      - name: Setup Node.js for frontend build
+        uses: actions/setup-node@v4
+        with:
+          node-version: '18'
+          cache: 'npm'
+          cache-dependency-path: code/frontend/package-lock.json
+
+      - name: Build frontend
+        run: |
+          cd code/frontend
+          npm ci
+          npm run build
+
+      - name: Setup .NET
+        uses: actions/setup-dotnet@v4
+        with:
+          dotnet-version: 9.0.x
+
+      - name: Restore .NET dependencies
+        run: |
+          dotnet nuget add source --username ${{ github.repository_owner }} --password ${{ env.PACKAGES_PAT }} --store-password-in-clear-text --name Cleanuparr https://nuget.pkg.github.com/Cleanuparr/index.json
+          dotnet restore code/backend/${{ env.executableName }}/${{ env.executableName }}.csproj
+
+      - name: Copy frontend to backend wwwroot
+        shell: pwsh
+        run: |
+          New-Item -ItemType Directory -Force -Path "code/backend/${{ env.executableName }}/wwwroot"
+          Copy-Item -Path "code/frontend/dist/ui/browser/*" -Destination "code/backend/${{ env.executableName }}/wwwroot/" -Recurse -Force
+
+      - name: Build Windows executable
+        run: |
+          dotnet publish code/backend/${{ env.executableName }}/${{ env.executableName }}.csproj -c Release --runtime win-x64 --self-contained -o dist /p:PublishSingleFile=true /p:Version=${{ env.appVersion }} /p:DebugType=None /p:DebugSymbols=false
+
+      - name: Setup Inno Setup
+        shell: pwsh
+        run: |
+          # Download and install Inno Setup
+          $url = "https://jrsoftware.org/download.php/is.exe"
+          $output = "innosetup-installer.exe"
+          
+          Invoke-WebRequest -Uri $url -OutFile $output
+          Start-Process -FilePath $output -ArgumentList "/VERYSILENT", "/SUPPRESSMSGBOXES", "/NORESTART" -Wait
+          
+          # Add Inno Setup to PATH
+          $innoPath = "C:\Program Files (x86)\Inno Setup 6"
+          echo "$innoPath" >> $env:GITHUB_PATH
+
+      - name: Verify LICENSE file exists
+        shell: pwsh
+        run: |
+          if (-not (Test-Path "LICENSE")) {
+            Write-Error "LICENSE file not found in repository root"
+            exit 1
+          }
+          Write-Host "LICENSE file found successfully"
+
+      - name: Build Windows installer
+        shell: pwsh
+        run: |
+          # Copy installer script to root
+          Copy-Item "installers/windows/cleanuparr-installer.iss" -Destination "cleanuparr-installer.iss"
+          
+          # The installer script has been pre-updated with proper icon and config paths
+          # No dynamic modifications needed as the base script now includes correct references
+          
+          # Run Inno Setup compiler
+          & "C:\Program Files (x86)\Inno Setup 6\ISCC.exe" "cleanuparr-installer.iss"
+          
+          # Check if installer was created
+          if (Test-Path "installer/Cleanuparr_Setup.exe") {
+            Write-Host "Installer created successfully"
+          } else {
+            Write-Error "Installer creation failed"
+            exit 1
+          }
+
+      - name: Rename installer with version
+        shell: pwsh
+        run: |
+          $installerName = "Cleanuparr-${{ env.appVersion }}-Setup.exe"
+          Move-Item "installer/Cleanuparr_Setup.exe" "installer/$installerName"
+          echo "installerName=$installerName" >> $env:GITHUB_ENV
+
+      - name: Upload installer artifact
+        uses: actions/upload-artifact@v4
+        with:
+          name: Cleanuparr-windows-installer
+          path: installer/${{ env.installerName }}
+          retention-days: 30
+
+      # Removed individual release step - handled by main release workflow 

.github/workflows/build.yml

@@ -1,12 +0,0 @@
-on:
-  workflow_dispatch:
-  workflow_call:
-
-jobs:
-  build:
-    uses: flmorg/universal-workflows/.github/workflows/dotnet.build.app.yml@main
-    with:
-      dockerRepository: flaminel/cleanuperr
-      githubContext: ${{ toJSON(github) }}
-      outputName: cleanuperr
-    secrets: inherit

.github/workflows/cloudflare-pages.yml

@@ -0,0 +1,36 @@
+name: Deploy to Cloudflare Pages
+
+on:
+  push:
+    branches:
+      - main
+    paths:
+      - 'Cloudflare/**'
+      - 'blacklist'
+      - 'blacklist_permissive'
+      - 'whitelist'
+      - 'whitelist_with_subtitles'
+  workflow_dispatch:
+
+jobs:
+  deploy:
+    runs-on: ubuntu-latest
+    name: Deploy to Cloudflare Pages
+    
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+      
+      - name: Copy root static files to Cloudflare static directory
+        run: |
+          cp blacklist Cloudflare/static/
+          cp blacklist_permissive Cloudflare/static/
+          cp whitelist Cloudflare/static/
+          cp whitelist_with_subtitles Cloudflare/static/
+      
+      - name: Deploy to Cloudflare Pages
+        uses: cloudflare/wrangler-action@v3
+        with:
+          apiToken: ${{ secrets.CLOUDFLARE_PAGES_TOKEN }}
+          workingDirectory: "Cloudflare"
+          command: pages deploy . --project-name=cleanuparr

.github/workflows/deploy.yml

@@ -1,19 +0,0 @@
-on:
-  workflow_call:
-  workflow_dispatch:
-  push:
-    paths:
-      - 'chart/**'
-    branches: [ main ]
-
-jobs:
-  deploy:
-    uses: flmorg/universal-workflows/.github/workflows/chart.install.yml@main
-    with:
-      githubContext: ${{ toJSON(github) }}
-      chartRepo: oci://ghcr.io/flmorg
-      chartName: universal-chart
-      version: ^1.0.0
-      valuesPath: chart/values.yaml
-      releaseName: main
-    secrets: inherit

.github/workflows/docs.yml

@@ -0,0 +1,49 @@
+name: Deploy Docusaurus to GitHub Pages
+
+on:
+  push:
+    tags:
+      - "v*.*.*"
+  workflow_dispatch: {}
+
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+jobs:
+  deploy:
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: Set up Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: 20.x
+          cache: yarn
+          cache-dependency-path: docs/yarn.lock
+
+      - name: Install dependencies
+        working-directory: docs
+        run: yarn install --frozen-lockfile
+
+      - name: Build Docusaurus
+        working-directory: docs
+        run: yarn build
+
+      - name: Upload artifact
+        uses: actions/upload-pages-artifact@v3
+        with:
+          path: docs/build
+          retention-days: 1
+
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@v4

.github/workflows/pipeline.yml

@@ -1,20 +0,0 @@
-on:
-  push:
-    tags:
-      - "v*.*.*"
-    # paths:
-    #   - 'code/**'
-    # branches: [ main ]
-  pull_request:
-    paths:
-      - 'code/**'
-
-jobs:
-  build:
-    uses: flmorg/cleanuperr/.github/workflows/build.yml@main
-    secrets: inherit
-
-  # deploy:
-  #   needs: [ build ]
-  #   uses: flmorg/cleanuperr/.github/workflows/deploy.yml@main
-  #   secrets: inherit

.github/workflows/release.yml

@@ -1,11 +1,164 @@
+name: Release Build
+
 on:
   push:
     tags:
       - "v*.*.*"
+  workflow_dispatch:
+    inputs:
+      version:
+        description: 'Version to release (e.g., 1.0.0)'
+        required: false
+        default: ''
 
 jobs:
-  release:
-    uses: flmorg/universal-workflows/.github/workflows/dotnet.release.yml@main
-    with:
-      githubContext: ${{ toJSON(github) }}
-    secrets: inherit
+  # Validate release
+  validate:
+    runs-on: ubuntu-latest
+    outputs:
+      app_version: ${{ steps.version.outputs.app_version }}
+      release_version: ${{ steps.version.outputs.release_version }}
+      is_tag: ${{ steps.version.outputs.is_tag }}
+      
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Get version info
+        id: version
+        run: |
+          if [[ "${{ github.ref }}" =~ ^refs/tags/ ]]; then
+            # Tag event
+            release_version=${GITHUB_REF##refs/tags/}
+            app_version=${release_version#v}
+            is_tag=true
+          elif [[ -n "${{ github.event.inputs.version }}" ]]; then
+            # Manual workflow with version
+            app_version="${{ github.event.inputs.version }}"
+            release_version="v$app_version"
+            is_tag=false
+          else
+            # Manual workflow without version
+            app_version="0.0.1-dev-$(date +%Y%m%d-%H%M%S)"
+            release_version="v$app_version"
+            is_tag=false
+          fi
+          
+          echo "app_version=$app_version" >> $GITHUB_OUTPUT
+          echo "release_version=$release_version" >> $GITHUB_OUTPUT
+          echo "is_tag=$is_tag" >> $GITHUB_OUTPUT
+          
+          echo "🏷️ Release Version: $release_version"
+          echo "📱 App Version: $app_version"
+          echo "🔖 Is Tag: $is_tag"
+
+  # Build portable executables
+  build-executables:
+    needs: validate
+    uses: ./.github/workflows/build-executable.yml
+    secrets: inherit
+
+  # Build Windows installer
+  build-windows-installer:
+    needs: validate
+    uses: ./.github/workflows/build-windows-installer.yml
+    secrets: inherit
+
+  # Build macOS Intel installer
+  build-macos-intel:
+    needs: validate
+    uses: ./.github/workflows/build-macos-intel-installer.yml
+    secrets: inherit
+
+  # Build macOS ARM installer
+  build-macos-arm:
+    needs: validate
+    uses: ./.github/workflows/build-macos-arm-installer.yml
+    secrets: inherit
+
+  # Create GitHub release
+  create-release:
+    needs: [validate, build-executables, build-windows-installer, build-macos-intel, build-macos-arm]
+    runs-on: ubuntu-latest
+    if: github.event_name == 'push' && startsWith(github.ref, 'refs/tags/')
+    
+    steps:
+      - name: Get vault secrets
+        uses: hashicorp/vault-action@v2
+        with:
+          url: ${{ secrets.VAULT_HOST }}
+          method: approle
+          roleId: ${{ secrets.VAULT_ROLE_ID }}
+          secretId: ${{ secrets.VAULT_SECRET_ID }}
+          secrets:
+            secrets/data/github repo_readonly_pat | REPO_READONLY_PAT
+
+      - name: Download all artifacts
+        uses: actions/download-artifact@v4
+        with:
+          path: ./artifacts
+
+      - name: List downloaded artifacts
+        run: |
+          echo "📦 Downloaded artifacts:"
+          find ./artifacts -type f -name "*.zip" -o -name "*.pkg" -o -name "*.exe" | sort
+
+      - name: Create release
+        uses: softprops/action-gh-release@v2
+        with:
+          name: ${{ needs.validate.outputs.release_version }}
+          tag_name: ${{ needs.validate.outputs.release_version }}
+          token: ${{ env.REPO_READONLY_PAT }}
+          make_latest: true
+          target_commitish: main
+          generate_release_notes: true
+          files: |
+            ./artifacts/**/*.zip
+            ./artifacts/**/*.pkg
+            ./artifacts/**/*.exe
+
+  # Summary job
+  summary:
+    needs: [validate, build-executables, build-windows-installer, build-macos-intel, build-macos-arm]
+    runs-on: ubuntu-latest
+    if: always()
+    
+    steps:
+      - name: Build Summary
+        run: |
+          echo "## 🏗️ Cleanuparr Build Summary" >> $GITHUB_STEP_SUMMARY
+          echo "" >> $GITHUB_STEP_SUMMARY
+          echo "**Version**: ${{ needs.validate.outputs.release_version }}" >> $GITHUB_STEP_SUMMARY
+          echo "**App Version**: ${{ needs.validate.outputs.app_version }}" >> $GITHUB_STEP_SUMMARY
+          echo "**Is Tag**: ${{ needs.validate.outputs.is_tag }}" >> $GITHUB_STEP_SUMMARY
+          echo "" >> $GITHUB_STEP_SUMMARY
+          echo "### Build Results" >> $GITHUB_STEP_SUMMARY
+          echo "" >> $GITHUB_STEP_SUMMARY
+          
+          # Check job results
+          if [[ "${{ needs.build-executables.result }}" == "success" ]]; then
+            echo "✅ **Portable Executables**: Success" >> $GITHUB_STEP_SUMMARY
+          else
+            echo "❌ **Portable Executables**: ${{ needs.build-executables.result }}" >> $GITHUB_STEP_SUMMARY
+          fi
+          
+          if [[ "${{ needs.build-windows-installer.result }}" == "success" ]]; then
+            echo "✅ **Windows Installer**: Success" >> $GITHUB_STEP_SUMMARY
+          else
+            echo "❌ **Windows Installer**: ${{ needs.build-windows-installer.result }}" >> $GITHUB_STEP_SUMMARY
+          fi
+          
+          if [[ "${{ needs.build-macos-intel.result }}" == "success" ]]; then
+            echo "✅ **macOS Intel Installer**: Success" >> $GITHUB_STEP_SUMMARY
+          else
+            echo "❌ **macOS Intel Installer**: ${{ needs.build-macos-intel.result }}" >> $GITHUB_STEP_SUMMARY
+          fi
+          
+          if [[ "${{ needs.build-macos-arm.result }}" == "success" ]]; then
+            echo "✅ **macOS ARM Installer**: Success" >> $GITHUB_STEP_SUMMARY
+          else
+            echo "❌ **macOS ARM Installer**: ${{ needs.build-macos-arm.result }}" >> $GITHUB_STEP_SUMMARY
+          fi
+          
+          echo "" >> $GITHUB_STEP_SUMMARY
+          echo "🎉 **Build completed!**" >> $GITHUB_STEP_SUMMARY 

.gitignore

@@ -105,7 +105,6 @@ _NCrunch_*
 _TeamCity*
 
 # Sonarr
-config.xml
 nzbdrone.log*txt
 UpdateLogs/
 *workspace.xml

Cloudflare/_headers

@@ -0,0 +1,3 @@
+# Cache static files for 5 minutes
+/static/*
+  Cache-Control: public, max-age=300, s-maxage=300

Cloudflare/static/known_malware_file_name_patterns

@@ -0,0 +1,2 @@
+thepirateheaven.org
+RARBG.work

README.md

@@ -1,241 +1,99 @@
-# <img width="24px" src="./Logo/256.png" alt="cleanuperr"></img> cleanuperr
+_Love this project? Give it a ⭐️ and let others know!_
 
-cleanuperr is a tool for automating the cleanup of unwanted or blocked files in Sonarr, Radarr, and supported download clients like qBittorrent. It removes incomplete or blocked downloads, updates queues, and enforces blacklists or whitelists to manage file selection. After removing blocked content, cleanuperr can also trigger a search to replace the deleted shows/movies.
+# <img width="24px" src="./Logo/256.png" alt="Cleanuparr"></img> Cleanuparr
 
-cleanuperr was created primarily to address malicious files, such as `*.lnk` or `*.zipx`, that were getting stuck in Sonarr/Radarr and required manual intervention. Some of the reddit posts that made cleanuperr come to life can be found [here](https://www.reddit.com/r/sonarr/comments/1gqnx16/psa_sonarr_downloaded_a_virus/), [here](https://www.reddit.com/r/sonarr/comments/1gqwklr/sonar_downloaded_a_mkv_file_which_looked_like_a/), [here](https://www.reddit.com/r/sonarr/comments/1gpw2wa/downloaded_waiting_to_import/) and [here](https://www.reddit.com/r/sonarr/comments/1gpi344/downloads_not_importing_no_files_found/).
+[![Discord](https://img.shields.io/discord/1306721212587573389?color=7289DA&label=Discord&style=for-the-badge&logo=discord)](https://discord.gg/SCtMCgtsc4)
 
-The tool supports both qBittorrent's built-in exclusion features and its own blocklist-based system. Binaries for all platforms are provided, along with Docker images for easy deployment.
+Cleanuparr is a tool for automating the cleanup of unwanted or blocked files in Sonarr, Radarr, and supported download clients like qBittorrent. It removes incomplete or blocked downloads, updates queues, and enforces blacklists or whitelists to manage file selection. After removing blocked content, Cleanuparr can also trigger a search to replace the deleted shows/movies.
 
-Refer to the [Environment variables](#Environment-variables) section for detailed configuration instructions and the [Setup](#Setup) section for an in-depth explanation of the cleanup process.
+Cleanuparr was created primarily to address malicious files, such as `*.lnk` or `*.zipx`, that were getting stuck in Sonarr/Radarr and required manual intervention. Some of the reddit posts that made Cleanuparr come to life can be found [here](https://www.reddit.com/r/sonarr/comments/1gqnx16/psa_sonarr_downloaded_a_virus/), [here](https://www.reddit.com/r/sonarr/comments/1gqwklr/sonar_downloaded_a_mkv_file_which_looked_like_a/), [here](https://www.reddit.com/r/sonarr/comments/1gpw2wa/downloaded_waiting_to_import/) and [here](https://www.reddit.com/r/sonarr/comments/1gpi344/downloads_not_importing_no_files_found/).
 
-## Key features
-- Marks unwanted files as skip/unwanted in the download client.
-- Automatically strikes stalled or stuck downloads. 
-- Removes and blocks downloads that reached the maximum number of strikes or are marked as unwanted by the download client or by cleanuperr and triggers a search for removed downloads.
+> [!IMPORTANT]
+> **Features:**
+> - Strike system to mark bad downloads.
+> - Remove and block downloads that reached a maximum number of strikes.
+> - Remove and block downloads that are **failing to be imported** by the arrs.
+> - Remove and block downloads that are **stalled** or in **metadata downloading** state.
+> - Remove and block downloads that have a **low download speed** or **high estimated completion time**.
+> - Remove and block downloads blocked by qBittorrent or by Cleanuparr's **Malware Blocker**.
+> - Remove and block known malware based on patterns found by the community.
+> - Automatically trigger a search for downloads removed from the arrs.
+> - Clean up downloads that have been **seeding** for a certain amount of time.
+> - Remove downloads that are **orphaned**/have no **hardlinks**/are not referenced by the arrs anymore (with [cross-seed](https://www.cross-seed.org/) support).
+> - Notify on strike or download removal.
+> - Ignore certain torrent hashes, categories, tags or trackers from being processed by Cleanuparr.
 
-## Important note
+## 🎯 Supported Applications
 
-Only the **latest versions** of the following apps are supported, or earlier versions that have the same API as the latest version:
-- qBittorrent
-- Deluge
-- Transmission
-- Sonarr
-- Radarr
+### *Arr Applications
+- **Sonarr**
+- **Radarr**
+- **Lidarr**
+- **Readarr**
+- **Whisparr**
 
-This tool is actively developed and still a work in progress. Join the Discord server if you want to reach out to me quickly (or just stay updated on new releases) so we can squash those pesky bugs together:
+### Download Clients
+- **qBittorrent**
+- **Transmission**
+- **Deluge**
+- **µTorrent**
 
-> https://discord.gg/sWggpnmGNY
+### Platforms
+- **Docker**
+- **Windows**
+- **macOS**
+- **Linux**
+- **Unraid**
 
-# How it works
+## 🚀 Quick Start
 
-1. **Content blocker** will:
-   - Run every 5 minutes (or configured cron).
-   - Process all items in the *arr queue.
-   - Find the corresponding item from the download client for each queue item.
-   - Mark the files that were found in the queue as **unwanted/skipped** if:
-     - They **are listed in the blacklist**, or
-     - They **are not included in the whitelist**.
-2. **Queue cleaner** will:
-   - Run every 5 minutes (or configured cron).
-   - Process all items in the *arr queue.
-   - Check each queue item if it is **stalled (download speed is 0)**, **stuck in matadata downloading** or **failed to be imported**.
-     - If it is, the item receives a **strike** and will continue to accumulate strikes every time it meets any of these conditions.
-   - Check each queue item if it meets one of the following condition in the download client:
-     - **Marked as completed, but 0 bytes have been downloaded** (due to files being blocked by qBittorrent or the **content blocker**).
-     - All associated files of are marked as **unwanted/skipped**.
-   - If the item **DOES NOT** match the above criteria, it will be skipped.
-   - If the item **DOES** match the criteria or has received the **maximum number of strikes**:
-     - It will be removed from the *arr's queue and blocked.
-     - It will be deleted from the download client.
-     - A new search will be triggered for the *arr item.
-
-# Setup
-
-## Using qBittorrent's built-in feature (works only with qBittorrent)
-
-1. Go to qBittorrent -> Options -> Downloads -> make sure `Excluded file names` is checked -> Paste an exclusion list that you have copied.
-   - [blacklist](https://raw.githubusercontent.com/flmorg/cleanuperr/refs/heads/main/blacklist), or
-   - [permissive blacklist](https://raw.githubusercontent.com/flmorg/cleanuperr/refs/heads/main/blacklist_permissive), or
-   - create your own
-2. qBittorrent will block files from being downloaded. In the case of malicious content, **nothing is downloaded and the torrent is marked as complete**.
-3. Start **cleanuperr** with `QUEUECLEANER__ENABLED` set to `true`.
-4. The **queue cleaner** will perform a cleanup process as described in the [How it works](#how-it-works) section.
-
-## Using cleanuperr's blocklist (works with all supported download clients)
-
-1. Set both `QUEUECLEANER__ENABLED` and `CONTENTBLOCKER_ENABLED` to `true` in your environment variables.
-2. Configure and enable either a **blacklist** or a **whitelist** as described in the [Environment variables](#Environment-variables) section.
-3. Once configured, cleanuperr will perform the following tasks:
-   - Execute the **content blocker** job, as explained in the [How it works](#how-it-works) section.
-   - Execute the **queue cleaner** job, as explained in the [How it works](#how-it-works) section.
-
-## Using cleanuperr just for failed *arr imports (works for Usenet users as well)
-
-1. Set `QUEUECLEANER__ENABLED` to `true`.
-2. Set `QUEUECLEANER__IMPORT_FAILED_MAX_STRIKES` to a desired value.
-3. Optionally set failed import message patterns to ignore using `QUEUECLEANER__IMPORT_FAILED_IGNORE_PATTERNS__<NUMBER>`.
-4. Set `DOWNLOAD_CLIENT` to `none`.
-
-**No other action involving a download client would work (e.g. content blocking, removing stalled downloads, excluding private trackers).**
-
-## Usage
-
-### Docker compose yaml
-
-```
-version: "3.3"
-services:
-  cleanuperr:
-    volumes:
-      - ./cleanuperr/logs:/var/logs
-    environment:
-      - LOGGING__LOGLEVEL=Information
-      - LOGGING__FILE__ENABLED=false
-      - LOGGING__FILE__PATH=/var/logs/
-      - LOGGING__ENHANCED=true
-
-      - TRIGGERS__QUEUECLEANER=0 0/5 * * * ?
-      - TRIGGERS__CONTENTBLOCKER=0 0/5 * * * ?
-
-      - QUEUECLEANER__ENABLED=true
-      - QUEUECLEANER__RUNSEQUENTIALLY=true
-      - QUEUECLEANER__IMPORT_FAILED_MAX_STRIKES=5
-      - QUEUECLEANER__IMPORT_FAILED_IGNORE_PRIVATE=false
-      # - QUEUECLEANER__IMPORT_FAILED_IGNORE_PATTERNS__0=title mismatch
-      # - QUEUECLEANER__IMPORT_FAILED_IGNORE_PATTERNS__1=manual import required
-      - QUEUECLEANER__STALLED_MAX_STRIKES=5
-      - QUEUECLEANER__STALLED_IGNORE_PRIVATE=false
-
-      - CONTENTBLOCKER__ENABLED=true
-      - CONTENTBLOCKER__BLACKLIST__ENABLED=true
-      - CONTENTBLOCKER__BLACKLIST__PATH=https://raw.githubusercontent.com/flmorg/cleanuperr/refs/heads/main/blacklist
-      # OR
-      # - CONTENTBLOCKER__WHITELIST__ENABLED=true
-      # - CONTENTBLOCKER__WHITELIST__PATH=https://raw.githubusercontent.com/flmorg/cleanuperr/refs/heads/main/whitelist
-
-      - DOWNLOAD_CLIENT=qBittorrent
-      - QBITTORRENT__URL=http://localhost:8080
-      - QBITTORRENT__USERNAME=user
-      - QBITTORRENT__PASSWORD=pass
-      # OR
-      # - DOWNLOAD_CLIENT=deluge
-      # - DELUGE__URL=http://localhost:8112
-      # - DELUGE__PASSWORD=testing
-      # OR
-      # - DOWNLOAD_CLIENT=transmission
-      # - TRANSMISSION__URL=http://localhost:9091
-      # - TRANSMISSION__USERNAME=test
-      # - TRANSMISSION__PASSWORD=testing
-      # OR
-      # - DOWNLOAD_CLIENT=none
-
-      - SONARR__ENABLED=true
-      - SONARR__SEARCHTYPE=Episode
-      - SONARR__INSTANCES__0__URL=http://localhost:8989
-      - SONARR__INSTANCES__0__APIKEY=secret1
-      - SONARR__INSTANCES__1__URL=http://localhost:8990
-      - SONARR__INSTANCES__1__APIKEY=secret2
-
-      - RADARR__ENABLED=true
-      - RADARR__INSTANCES__0__URL=http://localhost:7878
-      - RADARR__INSTANCES__0__APIKEY=secret3
-      - RADARR__INSTANCES__1__URL=http://localhost:7879
-      - RADARR__INSTANCES__1__APIKEY=secret4
-    image: ghcr.io/flmorg/cleanuperr:latest
-    restart: unless-stopped
+```bash
+docker run -d --name cleanuparr \
+  --restart unless-stopped \
+  -p 11011:11011 \
+  -v /path/to/config:/config \
+  -e PORT=11011 \
+  -e PUID=1000 \
+  -e PGID=1000 \
+  -e TZ=Etc/UTC \
+  ghcr.io/cleanuparr/cleanuparr:latest
 ```
 
-### Environment variables
+For Docker Compose, health checks, and other installation methods, see the [Complete Installation Guide](https://cleanuparr.github.io/Cleanuparr/docs/installation/detailed).
 
-| Variable | Required | Description | Default value |
-|---|---|---|---|
-| LOGGING__LOGLEVEL | No | Can be `Verbose`, `Debug`, `Information`, `Warning`, `Error` or `Fatal` | `Information` |
-| LOGGING__FILE__ENABLED | No | Enable or disable logging to file | false |
-| LOGGING__FILE__PATH | No | Directory where to save the log files | empty |
-| LOGGING__ENHANCED | No | Enhance logs whenever possible<br>A more detailed description is provided [here](variables.md#LOGGING__ENHANCED) | true |
-|||||
-| TRIGGERS__QUEUECLEANER | Yes if queue cleaner is enabled | [Quartz cron trigger](https://www.quartz-scheduler.org/documentation/quartz-2.3.0/tutorials/crontrigger.html)<br>Can be a max of 6h interval<br>**Is ignored if `QUEUECLEANER__RUNSEQUENTIALLY=true` and `CONTENTBLOCKER__ENABLED=true`** | 0 0/5 * * * ? |
-| TRIGGERS__CONTENTBLOCKER | Yes if content blocker is enabled | [Quartz cron trigger](https://www.quartz-scheduler.org/documentation/quartz-2.3.0/tutorials/crontrigger.html)<br>Can be a max of 6h interval | 0 0/5 * * * ? |
-|||||
-| QUEUECLEANER__ENABLED | No | Enable or disable the queue cleaner | true |
-| QUEUECLEANER__RUNSEQUENTIALLY | No | If set to true, the queue cleaner will run after the content blocker instead of running in parallel, streamlining the cleaning process | true |
-| QUEUECLEANER__IMPORT_FAILED_MAX_STRIKES | No | After how many strikes should a failed import be removed<br>0 means never | 0 |
-| QUEUECLEANER__IMPORT_FAILED_IGNORE_PRIVATE | No | Whether to ignore failed imports from private trackers | false |
-| QUEUECLEANER__IMPORT_FAILED_IGNORE_PATTERNS__0 | No | First pattern to look for when an import is failed<br>If the specified message pattern is found, the item is skipped | empty |
-| QUEUECLEANER__STALLED_MAX_STRIKES | No | After how many strikes should a stalled download be removed<br>0 means never | 0 |
-| QUEUECLEANER__STALLED_IGNORE_PRIVATE | No | Whether to ignore stalled downloads from private trackers | false |
-|||||
-| CONTENTBLOCKER__ENABLED | No | Enable or disable the content blocker | false |
-| CONTENTBLOCKER__BLACKLIST__ENABLED | Yes if content blocker is enabled and whitelist is not enabled | Enable or disable the blacklist | false |
-| CONTENTBLOCKER__BLACKLIST__PATH | Yes if blacklist is enabled | Path to the blacklist (local file or url)<br>Needs to be json compatible | empty |
-| CONTENTBLOCKER__WHITELIST__ENABLED | Yes if content blocker is enabled and blacklist is not enabled | Enable or disable the whitelist | false |
-| CONTENTBLOCKER__WHITELIST__PATH | Yes if whitelist is enabled | Path to the whitelist (local file or url)<br>Needs to be json compatible | empty |
-|||||
-| DOWNLOAD_CLIENT | No | Download client that is used by *arrs<br>Can be `qbittorrent`, `deluge`, `transmission` or `none` | `qbittorrent` |
-| QBITTORRENT__URL | No | qBittorrent instance url | http://localhost:8112 |
-| QBITTORRENT__USERNAME | No | qBittorrent user | empty |
-| QBITTORRENT__PASSWORD | No | qBittorrent password | empty |
-|||||
-| DELUGE__URL | No | Deluge instance url | http://localhost:8080 |
-| DELUGE__PASSWORD | No | Deluge password | empty |
-|||||
-| TRANSMISSION__URL | No | Transmission instance url | http://localhost:9091 |
-| TRANSMISSION__USERNAME | No | Transmission user | empty |
-| TRANSMISSION__PASSWORD | No | Transmission password | empty |
-|||||
-| SONARR__ENABLED | No | Enable or disable Sonarr cleanup  | true |
-| SONARR__SEARCHTYPE | No | What to search for after removing a queue item<br>Can be `Episode`, `Season` or `Series` | `Episode` |
-| SONARR__INSTANCES__0__URL | No | First Sonarr instance url | http://localhost:8989 |
-| SONARR__INSTANCES__0__APIKEY | No | First Sonarr instance API key | empty |
-|||||
-| RADARR__ENABLED | No | Enable or disable Radarr cleanup  | false |
-| RADARR__INSTANCES__0__URL | No | First Radarr instance url | http://localhost:8989 |
-| RADARR__INSTANCES__0__APIKEY | No | First Radarr instance API key | empty |
+### 🌐 Access the Web Interface
 
-#
-### To be noted
-
-1. The blacklist and the whitelist can not be both enabled at the same time.
-2. The queue cleaner and content blocker can be enabled or disabled separately, if you want to run only one of them.
-3. Only one download client can be enabled at a time. If you have more than one download client, you should deploy multiple instances of cleanuperr.
-4. The blocklists (blacklist/whitelist) should have a single pattern on each line and supports the following:
+After installation, open your browser and navigate to:
 ```
-*example      // file name ends with "example"
-example*      // file name starts with "example"
-*example*     // file name has "example" in the name
-example       // file name is exactly the word "example"
-regex:<ANY_REGEX>   // regex that needs to be marked at the start of the line with "regex:"
-```
-5. Multiple Sonarr/Radarr instances can be specified using this format, where `<NUMBER>` starts from 0:
-```
-SONARR__INSTANCES__<NUMBER>__URL
-SONARR__INSTANCES__<NUMBER>__APIKEY
-```
-6. Multiple failed import patterns can be specified using this format, where `<NUMBER>` starts from 0:
-```
-QUEUECLEANER__IMPORT_FAILED_IGNORE_PATTERNS__<NUMBER>
+http://localhost:11011
 ```
 
-#
+**Next Steps:** Check out the [📖 Complete Documentation](https://cleanuparr.github.io/Cleanuparr/) for detailed configuration guides and setup instructions.
 
-### Binaries (if you're not using Docker)
+## 📖 Documentation & Support
 
-1. Download the binaries from [releases](https://github.com/flmorg/cleanuperr/releases).
-2. Extract them from the zip file.
-3. Edit **appsettings.json**. The paths from this json file correspond with the docker env vars, as described [above](#environment-variables).
+- **📚 [Complete Documentation](https://cleanuparr.github.io/Cleanuparr/)** - Installation guides, configuration, and troubleshooting
+- **⚙️ [Configuration Guide](https://cleanuparr.github.io/Cleanuparr/docs/category/configuration)** - Set up download clients, *arr apps, and features
+- **🔧 [Setup Scenarios](https://cleanuparr.github.io/Cleanuparr/docs/category/setup-scenarios)** - Common use cases and examples
+- **💬 [Discord Community](https://discord.gg/SCtMCgtsc4)** - Get help and discuss with other users
+- **🔗 [GitHub Releases](https://github.com/Cleanuparr/Cleanuparr/releases)** - Download binaries and view changelog
 
-### Run as a Windows Service
+# <img style="vertical-align: middle;" width="24px" src="./Logo/256.png" alt="Cleanuparr"> <span style="vertical-align: middle;">Cleanuparr</span> <img src="https://raw.githubusercontent.com/FortAwesome/Font-Awesome/6.x/svgs/solid/x.svg" height="24px" width="30px" style="vertical-align: middle;"> <span style="vertical-align: middle;">Huntarr</span> <img style="vertical-align: middle;" width="24px" src="https://github.com/plexguide/Huntarr.io/blob/main/frontend/static/logo/512.png?raw=true" alt Huntarr></img>
 
-Check out this stackoverflow answer on how to do it: https://stackoverflow.com/a/15719678
+Think of **Cleanuparr** as the janitor of your server; it keeps your download queue spotless, removes clutter, and blocks malicious files. Now imagine combining that with **Huntarr**, the compulsive librarian who finds missing and upgradable media to complete your collection
+
+While **Huntarr** fills in the blanks and improves what you already have, **Cleanuparr** makes sure that only clean downloads get through. If you're aiming for a reliable and self-sufficient setup, **Cleanuparr** and **Huntarr** will take your automated media stack to another level.
+
+<span style="font-size:24px"> ➡️ [**Huntarr**](https://github.com/plexguide/Huntarr.io) <span style="vertical-align: middle">![Huntarr](https://img.shields.io/github/stars/plexguide/Huntarr.io?style=social)</span></span> 
 
 # Credits
 Special thanks for inspiration go to:
 - [ThijmenGThN/swaparr](https://github.com/ThijmenGThN/swaparr)
 - [ManiMatter/decluttarr](https://github.com/ManiMatter/decluttarr)
 - [PaeyMoopy/sonarr-radarr-queue-cleaner](https://github.com/PaeyMoopy/sonarr-radarr-queue-cleaner)
-- [Sonarr](https://github.com/Sonarr/Sonarr) & [Radarr](https://github.com/Radarr/Radarr) for the logo
+- [Sonarr](https://github.com/Sonarr/Sonarr) & [Radarr](https://github.com/Radarr/Radarr)
 
 # Buy me a coffee
 If I made your life just a tiny bit easier, consider buying me a coffee!
 
-<a href="https://buymeacoffee.com/flaminel" target="_blank"><img src="https://www.buymeacoffee.com/assets/img/custom_images/orange_img.png" alt="Buy Me A Coffee" style="height: 41px !important;width: 174px !important;box-shadow: 0px 3px 2px 0px rgba(190, 190, 190, 0.5) !important;-webkit-box-shadow: 0px 3px 2px 0px rgba(190, 190, 190, 0.5) !important;" ></a>
+<a href="https://buymeacoffee.com/flaminel" target="_blank"><img src="https://www.buymeacoffee.com/assets/img/custom_images/orange_img.png" alt="Buy Me A Coffee" style="height: 41px !important;width: 174px !important;box-shadow: 0px 3px 2px 0px rgba(190, 190, 190, 0.5) !important;-webkit-box-shadow: 0px 3px 2px 0px rgba(190, 190, 190, 0.5) !important;" ></a>

blacklist

@@ -1,11 +1,27 @@
 *(sample).*
+*sample.avchd
+*sample.avi
+*sample.mkv
+*sample.mov
+*sample.mp4
+*sample.webm
+*sample.wmv
+*.000
+*.001
+*.002
+*.004
 *.0xe
 *.73k
 *.73p
 *.7z
+*.7z.001
+*.7z.002
 *.89k
 *.89z
 *.8ck
+*.a00
+*.a01
+*.a02
 *.a7r
 *.ac
 *.acc
@@ -21,8 +37,11 @@
 *.ahk
 *.ai
 *.aif
+*.ain
 *.air
 *.alz
+*.ana
+*.apex
 *.api
 *.apk
 *.app
@@ -30,15 +49,28 @@
 *.applescript
 *.application
 *.appx
+*.apz
+*.ar
 *.arc
+*.archiver
+*.arduboy
+*.arh
+*.ari
 *.arj
+*.ark
 *.arscript
 *.asb
+*.asice
 *.asp
 *.aspx
 *.aspx-exe
 *.atmx
+*.ayt
 *.azw2
+*.b1
+*.b6z
+*.b64
+*.ba
 *.ba_
 *.bak
 *.bas
@@ -46,26 +78,48 @@
 *.bat
 *.bdjo
 *.bdmv
+*.bdoc
 *.beam
+*.bh
 *.bin
 *.bmp
 *.bms
+*.bndl
 *.bns
+*.boo
 *.bsa
 *.btm
+*.bundle
+*.bz
 *.bz2
+*.bza
+*.bzabw
+*.bzip
+*.bzip2
 *.c
+*.c00
+*.c01
+*.c02
+*.c10
 *.cab
 *.caction
+*.car
+*.cb7
+*.cba
+*.cbr
+*.cbt
+*.cbz
 *.cci
 *.cda
 *.cdb
+*.cdz
 *.cel
 *.celx
 *.cfs
 *.cgi
 *.cheat
 *.chm
+*.cit
 *.ckpt
 *.cla
 *.class
@@ -75,9 +129,15 @@
 *.coffee
 *.com
 *.command
+*.comppkg.hauptwerk.rar
+*.comppkg_hauptwerk_rar
+*.conda
 *.conf
 *.config
+*.cp9
+*.cpgz
 *.cpl
+*.cpt
 *.crt
 *.cs
 *.csh
@@ -85,17 +145,27 @@
 *.csproj
 *.css
 *.csv
+*.ctx
+*.ctz
 *.cue
 *.cur
+*.cxarchive
 *.cyw
+*.czip
 *.daemon
+*.daf
+*.dar
 *.dat
 *.data-00000-of-00001
 *.db
+*.dd
 *.deamon
 *.deb
 *.dek
+*.dgc
+*.dist
 *.diz
+*.dl_
 *.dld
 *.dll
 *.dmc
@@ -112,19 +182,27 @@
 *.dw
 *.dword
 *.dxl
+*.dz
 *.e_e
 *.ear
 *.ebacmd
 *.ebm
 *.ebs
 *.ebs2
+*.ecar
 *.ecf
+*.ecs
+*.ecsbx
+*.edz
+*.efw
+*.egg
 *.eham
 *.elf
 *.elf-so
 *.email
 *.emu
 *.epk
+*.epi
 *.es
 *.esh
 *.etc
@@ -140,36 +218,62 @@
 *.exz
 *.ezs
 *.ezt
+*.f
+*.f3z
 *.fas
 *.fba
+*.fcx
 *.fky
 *.flac
 *.flatpak
 *.flv
+*.fp8
 *.fpi
 *.frs
 *.fxp
+*.fzpz
 *.gadget
+*.gar
 *.gat
+*.gca
 *.gif
 *.gifv
 *.gm9
+*.gmz
 *.gpe
 *.gpu
 *.gs
 *.gz
+*.gz2
+*.gza
+*.gzi
+*.gzip
 *.h5
+*.ha
 *.ham
+*.hbc
+*.hbc2
+*.hbe
 *.hex
+*.hki
+*.hki1
+*.hki2
+*.hki3
 *.hlp
 *.hms
 *.hpf
+*.hpk
+*.hpkg
 *.hta
 *.hta-psh
 *.htaccess
 *.htm
 *.html
+*.htmi
+*.hyp
+*.iadproj
 *.icd
+*.ice
 *.icns
 *.ico
 *.idx
@@ -182,17 +286,27 @@
 *.ins
 *.ipa
 *.ipf
+*.ipg
 *.ipk
 *.ipsw
 *.iqylink
+*.ish
 *.iso
 *.isp
 *.isu
+*.isx
 *.ita
+*.ize
 *.izh
 *.izma ace
+*.j
 *.jar
+*.jar.pack
 *.java
+*.jex
+*.jgz
+*.jhh
+*.jic
 *.jpeg
 *.jpg
 *.js
@@ -201,27 +315,51 @@
 *.jse
 *.jsf
 *.json
+*.jsonlz4
 *.jsp
 *.jsx
+*.kextraction
+*.kgb
 *.kix
 *.ksh
+*.ksp
+*.kwgt
 *.kx
+*.kz
+*.layout
+*.lbr
 *.lck
 *.ldb
+*.lemon
+*.lha
+*.lhzd
 *.lib
+*.libzip
 *.link
 *.lnk
 *.lo
 *.lock
 *.log
 *.loop-vbs
+*.lpkg
+*.lqr
 *.ls
+*.lz
+*.lz4
+*.lzh
+*.lzm
+*.lzma
+*.lzo
+*.lzr
+*.lzx
 *.m3u
 *.m4a
 *.mac
 *.macho
 *.mamc
 *.manifest
+*.mar
+*.mbz
 *.mcr
 *.md
 *.mda
@@ -232,22 +370,29 @@
 *.mdt
 *.mel
 *.mem
+*.memo
 *.meta
 *.mgm
 *.mhm
 *.mht
 *.mhtml
 *.mid
+*.mint
 *.mio
 *.mlappinstall
+*.mlproj
 *.mlx
 *.mm
 *.mobileconfig
 *.model
 *.moo
+*.mou
+*.movpkg
+*.mozlz4
 *.mp3
 *.mpa
 *.mpk
+*.mpkg
 *.mpls
 *.mrc
 *.mrp
@@ -266,41 +411,79 @@
 *.msp
 *.mst
 *.msu
+*.mxc
 *.mxe
+*.mzp
 *.n
+*.nar
 *.ncl
 *.net
+*.nex
 *.nexe
 *.nfo
+*.npk
 *.nrg
 *.num
+*.nz
 *.nzb.bz2
 *.nzb.gz
 *.nzbs
+*.oar
 *.ocx
+*.odlgz
 *.odt
+*.opk
 *.ore
+*.osf
 *.ost
 *.osx
 *.osx-app
 *.otm
 *.out
 *.ova
+*.oz
 *.p
+*.p01
+*.p19
+*.p7z
+*.pa
+*.pack.gz
+*.package
+*.pae
 *.paf
 *.pak
+*.paq6
+*.paq7
+*.paq8
+*.paq8f
+*.paq8l
+*.paq8p
+*.par
+*.par2
+*.pax
 *.pb
+*.pbi
 *.pcd
+*.pcv
 *.pdb
 *.pdf
 *.pea
 *.perl
+*.pet
 *.pex
+*.pf
 *.phar
 *.php
 *.php5
 *.pif
+*.pim
+*.pima
+*.pit
+*.piz
 *.pkg
+*.pkg.tar.xz
+*.pkg.tar.zst
+*.pkz
 *.pl
 *.plsc
 *.plx
@@ -318,6 +501,7 @@
 *.pptx
 *.prc
 *.prg
+*.prs
 *.ps
 *.ps1
 *.ps1xml
@@ -333,9 +517,16 @@
 *.psh-reflection
 *.psm1
 *.pst
+*.psz
 *.pt
+*.pup
+*.puz
 *.pvd
+*.pvmp
+*.pvmz
+*.pwa
 *.pwc
+*.pxl
 *.pxo
 *.py
 *.pyc
@@ -343,8 +534,20 @@
 *.pyo
 *.python
 *.pyz
+*.q
+*.qda
 *.qit
 *.qpx
+*.r0
+*.r00
+*.r01
+*.r02
+*.r03
+*.r04
+*.r1
+*.r2
+*.r21
+*.r30
 *.ram
 *.rar
 *.raw
@@ -355,22 +558,35 @@
 *.reg
 *.resources
 *.resx
+*.rev
 *.rfs
 *.rfu
 *.rgs
+*.rk
 *.rm
+*.rnc
 *.rox
+*.rp9
 *.rpg
 *.rpj
 *.rpm
+*.rss
 *.ruby
 *.run
 *.rxe
+*.rz
+*.s00
+*.s01
+*.s02
+*.s09
 *.s2a
+*.s7z
 *.sample
 *.sapk
+*.sar
 *.savedmodel
 *.sbs
+*.sbx
 *.sca
 *.scar
 *.scb
@@ -380,42 +596,86 @@
 *.scr
 *.script
 *.sct
+*.sdc
+*.sdn
+*.sdoc
+*.sdocx
+*.sea
 *.seed
+*.sen
 *.server
 *.service
+*.sfg
+*.sfm
+*.sfs
 *.sfv
+*.sfx
 *.sh
+*.shar
 *.shb
 *.shell
+*.shk
 *.shortcut
+*.shr
 *.shs
 *.shtml
+*.sifz
+*.sipa
 *.sit
 *.sitx
 *.sk
 *.sldm
 *.sln
 *.smm
+*.smpf
 *.snap
+*.snagitstamps
+*.snappy
+*.snb
 *.snd
+*.snz
+*.spa
+*.spd
+*.spl
+*.spm
 *.spr
+*.spt
 *.sql
+*.sqf
 *.sqx
+*.sqz
 *.srec
+*.srep
 *.srt
 *.ssm
+*.stg
+*.stkdoodlz
+*.stproj
 *.sts
 *.sub
 *.svg
 *.swf
+*.sy_
 *.sys
 *.tar
+*.tar.bz2
 *.tar.gz
+*.tar.gz2
+*.tar.lz
+*.tar.lzma
+*.tar.xz
+*.tar.z
+*.tar.zip
+*.taz
 *.tbl
 *.tbz
+*.tbz2
 *.tcp
+*.tcx
 *.text
 *.tf
+*.tg
+*.tgs
 *.tgz
 *.thm
 *.thmx
@@ -424,19 +684,35 @@
 *.tif
 *.tiff
 *.tipa
+*.tlz
+*.tlzma
 *.tmp
 *.tms
 *.toast
 *.torrent
 *.tpk
+*.tpsr
+*.trs
 *.txt
+*.tx_
+*.txz
+*.tz
+*.tzst
 *.u3p
+*.ubz
+*.uc2
 *.udf
+*.ufdr
+*.ufs.uzip
+*.uha
 *.upk
 *.upx
 *.url
+*.uue
 *.uvm
 *.uw8
+*.uzed
+*.uzip
 *.vb
 *.vba
 *.vba-exe
@@ -448,26 +724,46 @@
 *.vbscript 
 *.vcd
 *.vdo
+*.vem
 *.vexe
+*.vfs
 *.vhd
 *.vhdx
+*.vib
+*.vip
 *.vlx
 *.vm
+*.vmcz
 *.vmdk
+*.vms
 *.vob
 *.vocab
+*.voca
+*.vpk
 *.vpm
+*.vrpackage
+*.vsi
+*.vwi
 *.vxp
+*.wa
+*.wacz
+*.waff
 *.war
+*.wastickers
 *.wav
 *.wbk
 *.wcm
+*.wdz
 *.webm
+*.whl
+*.wick
 *.widget
 *.wim
 *.wiz
+*.wlb
 *.wma
 *.workflow
+*.wot
 *.wpk
 *.wpl
 *.wpm
@@ -476,14 +772,26 @@
 *.wsc
 *.wsf
 *.wsh
+*.wux
 *.x86
 *.x86_64
 *.xaml
 *.xap
+*.xapk
+*.xar
 *.xbap
 *.xbe
+*.xcf.bz2
+*.xcf.gz
+*.xcf.xz
+*.xcfbz2
+*.xcfgz
+*.xcfxz
 *.xex
+*.xez
+*.xfp
 *.xig
+*.xip
 *.xla
 *.xlam
 *.xll
@@ -496,24 +804,47 @@
 *.xltb
 *.xltm
 *.xlw
+*.xmcdz
 *.xml
+*.xoj
+*.xopp
 *.xqt
 *.xrt
+*.xx
 *.xys
 *.xz
+*.xzm
+*.y
+*.yc
 *.ygh
+*.yz1
 *.z
+*.z00
+*.z01
+*.z02
+*.z03
+*.z04
+*.zabw
+*.zap
+*.zed
+*.zfsendtotarget
+*.zhelp
+*.zi
+*.zi_
+*.zim
 *.zip
 *.zipx
+*.zix
+*.zl
 *.zl9
 *.zoo
-*sample.avchd
-*sample.avi
-*sample.mkv
-*sample.mov
-*sample.mp4
-*sample.webm
-*sample.wmv
+*.zpaq
+*.zpi
+*.zsplit
+*.zst
+*.zw
+*.zwi
+*.zz
 Trailer.*
 VOSTFR
 api

blacklist_permissive

@@ -1,51 +1,410 @@
+*.000
+*.001
+*.002
+*.004
+*.7z
+*.7z.001
+*.7z.002
+*.a00
+*.a01
+*.a02
+*.ace
+*.ain
+*.alz
+*.ana
+*.apex
 *.apk
+*.apz
+*.ar
+*.arc
+*.archiver
+*.arduboy
+*.arh
+*.ari
+*.arj
+*.ark
+*.asice
+*.ayt
+*.b1
+*.b6z
+*.b64
+*.ba
 *.bat
+*.bdoc
+*.bh
 *.bin
 *.bmp
+*.bndl
+*.boo
+*.bundle
+*.bz
+*.bz2
+*.bza
+*.bzabw
+*.bzip
+*.bzip2
+*.c00
+*.c01
+*.c02
+*.c10
+*.car
+*.cb7
+*.cba
+*.cbr
+*.cbt
+*.cbz
+*.cdz
+*.cit
 *.cmd
 *.com
+*.comppkg.hauptwerk.rar
+*.comppkg_hauptwerk_rar
+*.conda
+*.cp9
+*.cpgz
+*.cpt
+*.ctx
+*.ctz
+*.cxarchive
+*.czip
+*.daf
+*.dar
 *.db
+*.dd
+*.deb
+*.dgc
+*.dist
 *.diz
+*.dl_
 *.dll
 *.dmg
+*.dz
+*.ecar
+*.ecs
+*.ecsbx
+*.edz
+*.efw
+*.egg
+*.epi
 *.etc
 *.exe
+*.f
+*.f3z
+*.fcx
+*.fp8
+*.fzpz
+*.gar
+*.gca
 *.gif
+*.gmz
+*.gz
+*.gz2
+*.gza
+*.gzi
+*.gzip
+*.ha
+*.hbc
+*.hbc2
+*.hbe
+*.hki
+*.hki1
+*.hki2
+*.hki3
+*.hpk
+*.hpkg
 *.htm
 *.html
+*.htmi
+*.hyp
+*.iadproj
+*.ice
 *.ico
 *.ini
+*.ipg
+*.ipk
+*.ish
 *.iso
+*.isx
+*.ita
+*.ize
+*.j
 *.jar
+*.jar.pack
+*.jex
+*.jgz
+*.jhh
+*.jic
 *.jpg
 *.js
+*.jsonlz4
+*.kextraction
+*.kgb
+*.ksp
+*.kwgt
+*.kz
+*.layout
+*.lbr
+*.lemon
+*.lha
+*.lhzd
+*.libzip
 *.link
 *.lnk
+*.lpkg
+*.lqr
+*.lz
+*.lz4
+*.lzh
+*.lzm
+*.lzma
+*.lzo
+*.lzr
+*.lzx
+*.mar
+*.mbz
+*.md
+*.memo
+*.mint
+*.mlproj
+*.mou
+*.movpkg
+*.mozlz4
+*.mpkg
 *.msi
+*.mxc
+*.mzp
+*.nar
+*.nex
 *.nfo
+*.npk
+*.nz
+*.oar
+*.odlgz
+*.opk
+*.osf
+*.oz
+*.p01
+*.p19
+*.p7z
+*.pa
+*.pack.gz
+*.package
+*.pae
+*.pak
+*.paq6
+*.paq7
+*.paq8
+*.paq8f
+*.paq8l
+*.paq8p
+*.par
+*.par2
+*.pax
+*.pbi
+*.pcv
+*.pea
 *.perl
+*.pet
+*.pf
 *.php
+*.pim
+*.pima
+*.pit
+*.piz
+*.pkg
+*.pkg.tar.xz
+*.pkg.tar.zst
+*.pkz
 *.pl
 *.png
+*.prs
 *.ps1
 *.psc1
 *.psd1
 *.psm1
+*.psz
+*.pup
+*.puz
+*.pvmp
+*.pvmz
+*.pwa
+*.pxl
 *.py
 *.pyd
+*.q
+*.qda
+*.r0
+*.r00
+*.r01
+*.r02
+*.r03
+*.r04
+*.r1
+*.r2
+*.r21
+*.r30
+*.rar
 *.rb
 *.readme
 *.reg
+*.rev
+*.rk
+*.rnc
+*.rp9
+*.rpm
+*.rss
 *.run
+*.rz
+*.s00
+*.s01
+*.s02
+*.s09
+*.s7z
+*.sar
+*.sbx
 *.scr
+*.sdc
+*.sdn
+*.sdoc
+*.sdocx
+*.sea
+*.sen
+*.sfg
+*.sfm
+*.sfs
+*.sfx
 *.sh
+*.shar
+*.shk
+*.shr
+*.sifz
+*.sipa
+*.sit
+*.sitx
+*.smpf
+*.snagitstamps
+*.snappy
+*.snb
+*.snz
+*.spa
+*.spd
+*.spl
+*.spm
+*.spt
 *.sql
+*.sqf
+*.sqx
+*.sqz
+*.srep
+*.stg
+*.stkdoodlz
+*.stproj
+*.sy_
+*.tar.bz2
+*.tar.gz
+*.tar.gz2
+*.tar.lz
+*.tar.lzma
+*.tar.xz
+*.tar.z
+*.tar.zip
+*.taz
+*.tbz
+*.tbz2
+*.tcx
 *.text
+*.tg
+*.tgs
+*.tgz
 *.thumb
+*.tlz
+*.tlzma
 *.torrent
+*.tpsr
+*.trs
 *.txt
+*.tx_
+*.txz
+*.tz
+*.tzst
+*.ubz
+*.uc2
+*.ufdr
+*.ufs.uzip
+*.uha
 *.url
+*.uue
+*.uvm
+*.uzed
+*.uzip
 *.vbs
+*.vem
+*.vfs
+*.vib
+*.vip
+*.vmcz
+*.vms
+*.voca
+*.vpk
+*.vrpackage
+*.vsi
+*.vwi
+*.wa
+*.wacz
+*.waff
+*.war
+*.wastickers
+*.wdz
+*.whl
+*.wick
+*.wlb
+*.wot
 *.wsf
+*.wux
+*.xapk
+*.xar
+*.xcf.bz2
+*.xcf.gz
+*.xcf.xz
+*.xcfbz2
+*.xcfgz
+*.xcfxz
+*.xez
+*.xfp
+*.xip
 *.xml
-*.zipx
+*.xmcdz
+*.xoj
+*.xopp
+*.xx
+*.xz
+*.xzm
+*.y
+*.yc
+*.yz1
+*.z
+*.z00
+*.z01
+*.z02
+*.z03
+*.z04
+*.zabw
+*.zap
+*.zed
+*.zfsendtotarget
+*.zhelp
+*.zi
+*.zi_
+*.zim
+*.zip
+*.zipx
+*.zix
+*.zl
+*.zoo
+*.zpaq
+*.zpi
+*.zsplit
+*.zst
+*.zw
+*.zwi
+*.zz

chart/values.yaml

@@ -1,115 +0,0 @@
-deployment:
-  replicas: 1
-  strategy:
-    type: RollingUpdate
-    maxSurge: 1
-    maxUnavailable: 0
-  containers:
-    - name: qbit
-      image:
-        repository: ghcr.io/flmorg/cleanuperr
-        tag: latest
-      env:
-        - name: LOGGING__LOGLEVEL
-          value: Information
-        - name: LOGGING__FILE__ENABLED
-          value: "true"
-        - name: LOGGING__FILE__PATH
-          value: /var/logs
-        - name: LOGGING__ENHANCED
-          value: "true"
-        - name: TRIGGERS__QUEUECLEANER
-          value: 0 0/5 * * * ?
-        - name: TRIGGERS__CONTENTBLOCKER
-          value: 0 0/5 * * * ?
-        - name: QUEUECLEANER__ENABLED
-          value: "true"
-        - name: QUEUECLEANER__RUNSEQUENTIALLY
-          value: "true"
-        - name: QUEUECLEANER__IMPORT_FAILED_MAX_STRIKES
-          value: "3"
-        - name: QUEUECLEANER__STALLED_MAX_STRIKES
-          value: "3"
-        - name: CONTENTBLOCKER__ENABLED
-          value: "true"
-        - name: CONTENTBLOCKER__BLACKLIST__ENABLED
-          value: "true"
-        - name: CONTENTBLOCKER__BLACKLIST__PATH
-          value: https://raw.githubusercontent.com/flmorg/cleanuperr/refs/heads/main/blacklist
-        - name: DOWNLOAD_CLIENT
-          value: qbittorrent
-        - name: QBITTORRENT__URL
-          value: http://service.qbittorrent-videos.svc.cluster.local
-        - name: SONARR__ENABLED
-          value: "true"
-        - name: SONARR__SEARCHTYPE
-          value: Episode
-        - name: SONARR__INSTANCES__0__URL
-          value: http://service.sonarr-low-res.svc.cluster.local
-        - name: SONARR__INSTANCES__1__URL
-          value: http://service.sonarr-high-res.svc.cluster.local
-        - name: RADARR__ENABLED
-          value: "true"
-        - name: RADARR__INSTANCES__0__URL
-          value: http://service.radarr-low-res.svc.cluster.local
-        - name: RADARR__INSTANCES__1__URL
-          value: http://service.radarr-high-res.svc.cluster.local
-      envFromSecret:
-        - secretName: qbit-auth
-          envs:
-            - name: QBITTORRENT__USERNAME
-              key: QBIT_USER
-            - name: QBITTORRENT__PASSWORD
-              key: QBIT_PASS
-        - secretName: sonarr-auth
-          envs:
-            - name: SONARR__INSTANCES__0__APIKEY
-              key: SNRL_API_KEY
-            - name: SONARR__INSTANCES__1__APIKEY
-              key: SNRH_API_KEY
-        - secretName: radarr-auth
-          envs:
-            - name: RADARR__INSTANCES__0__APIKEY
-              key: RDRL_API_KEY
-            - name: RADARR__INSTANCES__1__APIKEY
-              key: RDRH_API_KEY
-      resources:
-        requests:
-          cpu: 0m
-          memory: 0Mi
-        limits:
-          cpu: 1000m
-          memory: 1000Mi
-      volumeMounts:
-        - name: storage
-          mountPath: /var/logs
-          subPath: cleanuperr/logs
-  volumes:
-    - name: storage
-      type: pvc
-      typeName: storage-pvc
-
-pvcs:
-  - name: storage-pvc
-    storageClassName: local-path-persistent
-    accessModes:
-      - ReadWriteOnce
-    size: 1Gi
-    volumeMode: Filesystem
-
-vaultSecrets:
-  - name: qbit-auth
-    path: secrets/qbittorrent
-    templates:
-      QBIT_USER: "{% .Secrets.username %}"
-      QBIT_PASS: "{% .Secrets.password %}"
-  - name: radarr-auth
-    path: secrets/radarr
-    templates:
-      RDRL_API_KEY: "{% .Secrets.low_api_key %}"
-      RDRH_API_KEY: "{% .Secrets.high_api_key %}"
-  - name: sonarr-auth
-    path: secrets/sonarr
-    templates:
-      SNRL_API_KEY: "{% .Secrets.low_api_key %}"
-      SNRH_API_KEY: "{% .Secrets.high_api_key %}"

code/.dockerignore

@@ -0,0 +1,41 @@
+# Documentation
+*.md
+docs/
+
+# Version control
+.git/
+.gitignore
+
+# IDE files
+.vscode/
+.idea/
+*.swp
+*.swo
+
+# OS files
+.DS_Store
+Thumbs.db
+
+# Node.js
+frontend/node_modules/
+frontend/dist/
+frontend/.angular/
+
+# .NET
+backend/bin/
+backend/obj/
+backend/*/bin/
+backend/*/obj/
+backend/.vs/
+
+# Build artifacts
+artifacts/
+dist/
+
+# Test files
+backend/**/*Tests/
+backend/**/Tests/
+
+# Development files
+docker-compose*.yml
+test/ 

code/Common/Configuration/Arr/ArrConfig.cs

@@ -1,8 +0,0 @@
-namespace Common.Configuration.Arr;
-
-public abstract record ArrConfig
-{
-    public required bool Enabled { get; init; }
-    
-    public required List<ArrInstance> Instances { get; init; }
-}

code/Common/Configuration/Arr/ArrInstance.cs

@@ -1,8 +0,0 @@
-namespace Common.Configuration.Arr;
-
-public sealed class ArrInstance
-{
-    public required Uri Url { get; set; }
-    
-    public required string ApiKey { get; set; }
-}

code/Common/Configuration/Arr/RadarrConfig.cs

@@ -1,6 +0,0 @@
-namespace Common.Configuration.Arr;
-
-public sealed record RadarrConfig : ArrConfig
-{
-    public const string SectionName = "Radarr";
-}

code/Common/Configuration/Arr/SonarrConfig.cs

@@ -1,8 +0,0 @@
-namespace Common.Configuration.Arr;
-
-public sealed record SonarrConfig : ArrConfig
-{
-    public const string SectionName = "Sonarr";
-    
-    public SonarrSearchType SearchType { get; init; }
-}

code/Common/Configuration/Arr/SonarrSearchType.cs

@@ -1,8 +0,0 @@
-namespace Common.Configuration.Arr;
-
-public enum SonarrSearchType
-{
-    Episode,
-    Season,
-    Series
-}

code/Common/Configuration/ContentBlocker/ContentBlockerConfig.cs

@@ -1,40 +0,0 @@
-namespace Common.Configuration.ContentBlocker;
-
-public sealed record ContentBlockerConfig : IJobConfig
-{
-    public const string SectionName = "ContentBlocker";
-    
-    public required bool Enabled { get; init; }
-    
-    public PatternConfig? Blacklist { get; init; }
-    
-    public PatternConfig? Whitelist { get; init; }
-
-    public void Validate()
-    {
-        if (!Enabled)
-        {
-            return;
-        }
-
-        if (Blacklist is null && Whitelist is null)
-        {
-            throw new Exception("content blocker is enabled, but both blacklist and whitelist are missing");
-        }
-
-        if (Blacklist?.Enabled is true && Whitelist?.Enabled is true)
-        {
-            throw new Exception("only one exclusion (blacklist/whitelist) list is allowed");
-        }
-
-        if (Blacklist?.Enabled is true && string.IsNullOrEmpty(Blacklist.Path))
-        {
-            throw new Exception("blacklist path is required");
-        }
-        
-        if (Whitelist?.Enabled is true && string.IsNullOrEmpty(Whitelist.Path))
-        {
-            throw new Exception("blacklist path is required");
-        }
-    }
-}

code/Common/Configuration/ContentBlocker/PatternConfig.cs

@@ -1,8 +0,0 @@
-namespace Common.Configuration.ContentBlocker;
-
-public sealed record PatternConfig
-{
-    public bool Enabled { get; init; }
-    
-    public string? Path { get; init; }
-}

code/Common/Configuration/DownloadClient/DelugeConfig.cs

@@ -1,18 +0,0 @@
-namespace Common.Configuration.DownloadClient;
-
-public sealed record DelugeConfig : IConfig
-{
-    public const string SectionName = "Deluge";
-    
-    public Uri? Url { get; init; }
-    
-    public string? Password { get; init; }
-    
-    public void Validate()
-    {
-        if (Url is null)
-        {
-            throw new ArgumentNullException(nameof(Url));
-        }
-    }
-}

code/Common/Configuration/DownloadClient/DownloadClientConfig.cs

@@ -1,9 +0,0 @@
-using Microsoft.Extensions.Configuration;
-
-namespace Common.Configuration.DownloadClient;
-
-public sealed record DownloadClientConfig
-{
-    [ConfigurationKeyName("DOWNLOAD_CLIENT")]
-    public Enums.DownloadClient DownloadClient { get; init; } = Enums.DownloadClient.QBittorrent;
-}

code/Common/Configuration/DownloadClient/QBitConfig.cs

@@ -1,20 +0,0 @@
-namespace Common.Configuration.DownloadClient;
-
-public sealed class QBitConfig : IConfig
-{
-    public const string SectionName = "qBittorrent";
-    
-    public Uri? Url { get; init; }
-    
-    public string? Username { get; init; }
-    
-    public string? Password { get; init; }
-    
-    public void Validate()
-    {
-        if (Url is null)
-        {
-            throw new ArgumentNullException(nameof(Url));
-        }
-    }
-}

code/Common/Configuration/DownloadClient/TransmissionConfig.cs

@@ -1,20 +0,0 @@
-namespace Common.Configuration.DownloadClient;
-
-public record TransmissionConfig : IConfig
-{
-    public const string SectionName = "Transmission";
-    
-    public Uri? Url { get; init; }
-    
-    public string? Username { get; init; }
-    
-    public string? Password { get; init; }
-    
-    public void Validate()
-    {
-        if (Url is null)
-        {
-            throw new ArgumentNullException(nameof(Url));
-        }
-    }
-}

code/Common/Configuration/IConfig.cs

@@ -1,6 +0,0 @@
-namespace Common.Configuration;
-
-public interface IConfig
-{
-    void Validate();
-}

code/Common/Configuration/IJobConfig.cs

@@ -1,6 +0,0 @@
-namespace Common.Configuration;
-
-public interface IJobConfig : IConfig
-{
-    bool Enabled { get; init; }
-}

code/Common/Configuration/Logging/FileLogConfig.cs

@@ -1,12 +0,0 @@
-namespace Common.Configuration.Logging;
-
-public class FileLogConfig : IConfig
-{
-    public bool Enabled { get; set; }
-    
-    public string Path { get; set; } = string.Empty;
-    
-    public void Validate()
-    {
-    }
-}

code/Common/Configuration/Logging/LoggingConfig.cs

@@ -1,18 +0,0 @@
-using Serilog.Events;
-
-namespace Common.Configuration.Logging;
-
-public class LoggingConfig : IConfig
-{
-    public const string SectionName = "Logging";
-    
-    public LogEventLevel LogLevel { get; set; }
-    
-    public bool Enhanced { get; set; }
-    
-    public FileLogConfig? File { get; set; }
-    
-    public void Validate()
-    {
-    }
-}

code/Common/Configuration/QueueCleaner/QueueCleanerConfig.cs

@@ -1,31 +0,0 @@
-using Microsoft.Extensions.Configuration;
-
-namespace Common.Configuration.QueueCleaner;
-
-public sealed record QueueCleanerConfig : IJobConfig
-{
-    public const string SectionName = "QueueCleaner";
-    
-    public required bool Enabled { get; init; }
-    
-    public required bool RunSequentially { get; init; }
-    
-    [ConfigurationKeyName("IMPORT_FAILED_MAX_STRIKES")]
-    public ushort ImportFailedMaxStrikes { get; init; }
-    
-    [ConfigurationKeyName("IMPORT_FAILED_IGNORE_PRIVATE")]
-    public bool ImportFailedIgnorePrivate { get; init; }
-    
-    [ConfigurationKeyName("IMPORT_FAILED_IGNORE_PATTERNS")]
-    public List<string>? ImportFailedIgnorePatterns { get; init; }
-    
-    [ConfigurationKeyName("STALLED_MAX_STRIKES")]
-    public ushort StalledMaxStrikes { get; init; }
-    
-    [ConfigurationKeyName("STALLED_IGNORE_PRIVATE")]
-    public bool StalledIgnorePrivate { get; init; }
-
-    public void Validate()
-    {
-    }
-}

code/Common/Configuration/TriggersConfig.cs

@@ -1,10 +0,0 @@
-namespace Common.Configuration;
-
-public sealed class TriggersConfig
-{
-    public const string SectionName = "Triggers";
-    
-    public required string QueueCleaner { get; init; }
-    
-    public required string ContentBlocker { get; init; }
-}

code/Common/Enums/DownloadClient.cs

@@ -1,9 +0,0 @@
-namespace Common.Enums;
-
-public enum DownloadClient
-{
-    QBittorrent,
-    Deluge,
-    Transmission,
-    None
-}

code/Common/Helpers/Constants.cs

@@ -1,7 +0,0 @@
-namespace Common.Helpers;
-
-public static class Constants
-{
-    public static readonly TimeSpan TriggerMaxLimit  = TimeSpan.FromHours(6);
-    public static readonly TimeSpan CacheLimitBuffer = TimeSpan.FromHours(2);
-}

code/Dockerfile

@@ -0,0 +1,73 @@
+# Build Angular frontend
+FROM --platform=$BUILDPLATFORM node:18-alpine AS frontend-build
+WORKDIR /app
+
+# Copy package files first for better layer caching
+COPY frontend/package*.json ./
+RUN npm ci && npm install -g @angular/cli
+
+# Copy source code
+COPY frontend/ .
+
+# Build with appropriate base-href and deploy-url
+RUN npm run build
+
+# Build .NET backend
+FROM --platform=$BUILDPLATFORM mcr.microsoft.com/dotnet/sdk:9.0-bookworm-slim AS build
+ARG TARGETARCH
+ARG VERSION=0.0.1
+ARG PACKAGES_USERNAME
+ARG PACKAGES_PAT
+WORKDIR /app
+EXPOSE 11011
+
+# Copy solution and project files first for better layer caching
+# COPY backend/*.sln ./backend/
+# COPY backend/*/*.csproj ./backend/*/
+
+# Copy source code
+COPY backend/ ./backend/
+
+# Restore dependencies
+RUN dotnet nuget add source --username ${PACKAGES_USERNAME} --password ${PACKAGES_PAT} --store-password-in-clear-text --name Cleanuparr https://nuget.pkg.github.com/Cleanuparr/index.json
+
+# Build and publish
+RUN dotnet publish ./backend/Cleanuparr.Api/Cleanuparr.Api.csproj \
+    -a $TARGETARCH \
+    -c Release \
+    -o /app/publish \
+    /p:Version=${VERSION} \
+    /p:PublishSingleFile=true \
+    /p:DebugSymbols=false
+
+# Runtime stage
+FROM mcr.microsoft.com/dotnet/aspnet:9.0-bookworm-slim
+
+# Install required packages for user management and timezone support
+RUN apt-get update && apt-get install -y \
+    curl \
+    tzdata \
+    gosu \
+    && rm -rf /var/lib/apt/lists/*
+
+ENV PUID=1000 \
+    PGID=1000 \
+    UMASK=022 \
+    TZ=Etc/UTC \
+    HTTP_PORTS=11011
+
+# Fix FileSystemWatcher in Docker: https://github.com/dotnet/dotnet-docker/issues/3546
+ENV DOTNET_USE_POLLING_FILE_WATCHER=true
+
+WORKDIR /app
+
+# Copy backend
+COPY --from=build /app/publish .
+# Copy frontend to wwwroot
+COPY --from=frontend-build /app/dist/ui/browser ./wwwroot
+# Copy entrypoint script
+COPY entrypoint.sh /entrypoint.sh
+RUN chmod +x /entrypoint.sh
+
+ENTRYPOINT ["/entrypoint.sh"]
+CMD ["./Cleanuparr"]

code/Domain/Enums/InstanceType.cs

@@ -1,9 +0,0 @@
-namespace Domain.Enums;
-
-public enum InstanceType
-{
-    Sonarr,
-    Radarr,
-    Lidarr,
-    Readarr
-}

code/Domain/Enums/StrikeType.cs

@@ -1,7 +0,0 @@
-namespace Domain.Enums;
-
-public enum StrikeType
-{
-    Stalled,
-    ImportFailed
-}

code/Domain/Models/Arr/Queue/QueueRecord.cs

@@ -1,17 +0,0 @@
-namespace Domain.Models.Arr.Queue;
-
-public sealed record QueueRecord
-{
-    public int SeriesId { get; init; }
-    public int EpisodeId { get; init; }
-    public int SeasonNumber { get; init; }
-    public int MovieId { get; init; }
-    public required string Title { get; init; }
-    public string Status { get; init; }
-    public string TrackedDownloadStatus { get; init; }
-    public string TrackedDownloadState { get; init; }
-    public List<TrackedDownloadStatusMessage>? StatusMessages { get; init; }
-    public required string DownloadId { get; init; }
-    public required string Protocol { get; init; }
-    public required int Id { get; init; }
-}

code/Domain/Models/Deluge/Response/TorrentStatus.cs

@@ -1,14 +0,0 @@
-namespace Domain.Models.Deluge.Response;
-
-public sealed record TorrentStatus
-{
-    public string? Hash { get; init; }
-    
-    public string? State { get; init; }
-    
-    public string? Name { get; init; }
-    
-    public ulong Eta { get; init; }
-    
-    public bool Private { get; init; }
-}

code/Executable/DependencyInjection/ConfigurationDI.cs

@@ -1,24 +0,0 @@
-using Common.Configuration;
-using Common.Configuration.Arr;
-using Common.Configuration.ContentBlocker;
-using Common.Configuration.DownloadClient;
-using Common.Configuration.Logging;
-using Common.Configuration.QueueCleaner;
-using Domain.Enums;
-
-namespace Executable.DependencyInjection;
-
-public static class ConfigurationDI
-{
-    public static IServiceCollection AddConfiguration(this IServiceCollection services, IConfiguration configuration) =>
-        services
-            .Configure<QueueCleanerConfig>(configuration.GetSection(QueueCleanerConfig.SectionName))
-            .Configure<ContentBlockerConfig>(configuration.GetSection(ContentBlockerConfig.SectionName))
-            .Configure<DownloadClientConfig>(configuration)
-            .Configure<QBitConfig>(configuration.GetSection(QBitConfig.SectionName))
-            .Configure<DelugeConfig>(configuration.GetSection(DelugeConfig.SectionName))
-            .Configure<TransmissionConfig>(configuration.GetSection(TransmissionConfig.SectionName))
-            .Configure<SonarrConfig>(configuration.GetSection(SonarrConfig.SectionName))
-            .Configure<RadarrConfig>(configuration.GetSection(RadarrConfig.SectionName))
-            .Configure<LoggingConfig>(configuration.GetSection(LoggingConfig.SectionName));
-}

code/Executable/DependencyInjection/LoggingDI.cs

@@ -1,67 +0,0 @@
-using Common.Configuration.Logging;
-using Infrastructure.Verticals.ContentBlocker;
-using Infrastructure.Verticals.QueueCleaner;
-using Serilog;
-using Serilog.Events;
-using Serilog.Templates;
-using Serilog.Templates.Themes;
-
-namespace Executable.DependencyInjection;
-
-public static class LoggingDI
-{
-    public static ILoggingBuilder AddLogging(this ILoggingBuilder builder, IConfiguration configuration)
-    {
-        LoggingConfig? config = configuration.GetSection(LoggingConfig.SectionName).Get<LoggingConfig>();
-
-        if (!string.IsNullOrEmpty(config?.File?.Path) && !Directory.Exists(config.File.Path))
-        {
-            try
-            {
-                Directory.CreateDirectory(config.File.Path);
-            }
-            catch (Exception exception)
-            {
-                throw new Exception($"log file path is not a valid directory | {config.File.Path}", exception);
-            }
-        }
-        
-        LoggerConfiguration logConfig = new();
-        const string consoleOutputTemplate = "[{@t:yyyy-MM-dd HH:mm:ss.fff} {@l:u3}]{#if JobName is not null} {Concat('[',JobName,']'),PAD}{#end} {@m}\n{@x}";
-        const string fileOutputTemplate = "{@t:yyyy-MM-dd HH:mm:ss.fff zzz} [{@l:u3}]{#if JobName is not null} {Concat('[',JobName,']'),PAD}{#end} {@m:lj}\n{@x}";
-        LogEventLevel level = LogEventLevel.Information;
-        List<string> jobNames = [nameof(ContentBlocker), nameof(QueueCleaner)];
-        int padding = jobNames.Max(x => x.Length) + 2;
-
-        if (config is not null)
-        {
-            level = config.LogLevel;
-
-            if (config.File?.Enabled is true)
-            {
-                logConfig.WriteTo.File(
-                    path: Path.Combine(config.File.Path, "cleanuperr-.txt"),
-                    formatter: new ExpressionTemplate(fileOutputTemplate.Replace("PAD", padding.ToString())),
-                    fileSizeLimitBytes: 10L * 1024 * 1024,
-                    rollingInterval: RollingInterval.Day,
-                    rollOnFileSizeLimit: true
-                );
-            }
-        }
-
-        Log.Logger = logConfig
-            .MinimumLevel.Is(level)
-            .MinimumLevel.Override("Microsoft.Hosting.Lifetime", LogEventLevel.Information)
-            .MinimumLevel.Override("Microsoft.Extensions.Http", LogEventLevel.Warning)
-            .MinimumLevel.Override("Quartz", LogEventLevel.Warning)
-            .MinimumLevel.Override("System.Net.Http.HttpClient", LogEventLevel.Error)
-            .WriteTo.Console(new ExpressionTemplate(consoleOutputTemplate.Replace("PAD", padding.ToString())))
-            .Enrich.FromLogContext()
-            .Enrich.WithProperty("ApplicationName", "cleanuperr")
-            .CreateLogger();
-        
-        return builder
-            .ClearProviders()
-            .AddSerilog();
-    }
-}

code/Executable/DependencyInjection/MainDI.cs

@@ -1,51 +0,0 @@
-using System.Net;
-using Common.Configuration;
-using Common.Configuration.ContentBlocker;
-using Executable.Jobs;
-using Infrastructure.Verticals.Arr;
-using Infrastructure.Verticals.ContentBlocker;
-using Infrastructure.Verticals.DownloadClient;
-using Infrastructure.Verticals.DownloadClient.Deluge;
-using Infrastructure.Verticals.DownloadClient.QBittorrent;
-using Infrastructure.Verticals.DownloadClient.Transmission;
-using Infrastructure.Verticals.QueueCleaner;
-
-namespace Executable.DependencyInjection;
-
-public static class MainDI
-{
-    public static IServiceCollection AddInfrastructure(this IServiceCollection services, IConfiguration configuration) =>
-        services
-            .AddLogging(builder => builder.ClearProviders().AddConsole())
-            .AddHttpClients()
-            .AddConfiguration(configuration)
-            .AddMemoryCache()
-            .AddServices()
-            .AddQuartzServices(configuration);
-    
-    private static IServiceCollection AddHttpClients(this IServiceCollection services)
-    {
-        // add default HttpClient
-        services.AddHttpClient();
-
-        // add Deluge HttpClient
-        services
-            .AddHttpClient(nameof(DelugeService), x =>
-            {
-                x.Timeout = TimeSpan.FromSeconds(5);
-            })
-            .ConfigurePrimaryHttpMessageHandler(_ =>
-            {
-                return new HttpClientHandler
-                {
-                    AllowAutoRedirect = true,
-                    UseCookies = true,
-                    CookieContainer = new CookieContainer(),
-                    AutomaticDecompression = DecompressionMethods.GZip | DecompressionMethods.Deflate,
-                    ServerCertificateCustomValidationCallback = (_, _, _, _) => true
-                };
-            });
-
-        return services;
-    }
-}

code/Executable/DependencyInjection/QuartzDI.cs

@@ -1,135 +0,0 @@
-using Common.Configuration;
-using Common.Configuration.ContentBlocker;
-using Common.Configuration.QueueCleaner;
-using Common.Helpers;
-using Executable.Jobs;
-using Infrastructure.Verticals.ContentBlocker;
-using Infrastructure.Verticals.Jobs;
-using Infrastructure.Verticals.QueueCleaner;
-using Quartz;
-using Quartz.Spi;
-
-namespace Executable.DependencyInjection;
-
-public static class QuartzDI
-{
-    public static IServiceCollection AddQuartzServices(this IServiceCollection services, IConfiguration configuration) =>
-        services
-            .AddQuartz(q =>
-            {
-                TriggersConfig? config = configuration
-                    .GetRequiredSection(TriggersConfig.SectionName)
-                    .Get<TriggersConfig>();
-
-                if (config is null)
-                {
-                    throw new NullReferenceException("triggers configuration is null");
-                }
-
-                q.AddJobs(configuration, config);
-            })
-            .AddQuartzHostedService(opt =>
-            {
-                opt.WaitForJobsToComplete = true;
-            });
-
-    private static void AddJobs(
-        this IServiceCollectionQuartzConfigurator q,
-        IConfiguration configuration,
-        TriggersConfig triggersConfig
-    )
-    {
-        ContentBlockerConfig? contentBlockerConfig = configuration
-            .GetRequiredSection(ContentBlockerConfig.SectionName)
-            .Get<ContentBlockerConfig>();
-        
-        q.AddJob<ContentBlocker>(contentBlockerConfig, triggersConfig.ContentBlocker);
-        
-        QueueCleanerConfig? queueCleanerConfig = configuration
-            .GetRequiredSection(QueueCleanerConfig.SectionName)
-            .Get<QueueCleanerConfig>();
-
-        if (contentBlockerConfig?.Enabled is true && queueCleanerConfig is { Enabled: true, RunSequentially: true })
-        {
-            q.AddJob<QueueCleaner>(queueCleanerConfig, string.Empty);
-            q.AddJobListener(new JobChainingListener(nameof(QueueCleaner)));
-        }
-        else
-        {
-            q.AddJob<QueueCleaner>(queueCleanerConfig, triggersConfig.QueueCleaner);
-        }
-    }
-    
-    private static void AddJob<T>(
-        this IServiceCollectionQuartzConfigurator q,
-        IJobConfig? config,
-        string trigger
-    ) where T: GenericHandler
-    {
-        string typeName = typeof(T).Name;
-        
-        if (config is null)
-        {
-            throw new NullReferenceException($"{typeName} configuration is null");
-        }
-
-        if (!config.Enabled)
-        {
-            return;
-        }
-
-        bool hasTrigger = trigger.Length > 0;
-
-        q.AddJob<GenericJob<T>>(opts =>
-        {
-            opts.WithIdentity(typeName);
-
-            if (!hasTrigger)
-            {
-                // jobs with no triggers need to be stored durably
-                opts.StoreDurably();
-            }
-        });
-
-        // skip empty triggers
-        if (!hasTrigger)
-        {
-            return;
-        }
-        
-        IOperableTrigger triggerObj = (IOperableTrigger)TriggerBuilder.Create()
-            .WithIdentity("ExampleTrigger")
-            .StartNow()
-            .WithCronSchedule(trigger)
-            .Build();
-
-        IReadOnlyList<DateTimeOffset> nextFireTimes = TriggerUtils.ComputeFireTimes(triggerObj, null, 2);
-        TimeSpan triggerValue = nextFireTimes[1] - nextFireTimes[0];
-        
-        if (triggerValue > Constants.TriggerMaxLimit)
-        {
-            throw new Exception($"{trigger} should have a fire time of maximum 1 hour");
-        }
-
-        if (triggerValue > StaticConfiguration.TriggerValue)
-        {
-            StaticConfiguration.TriggerValue = triggerValue;
-        }
-        
-        q.AddTrigger(opts =>
-        {
-            opts.ForJob(typeName)
-                .WithIdentity($"{typeName}-trigger")
-                .WithCronSchedule(trigger, x =>x.WithMisfireHandlingInstructionDoNothing())
-                .StartNow();
-        });
-        
-        // Startup trigger
-        q.AddTrigger(opts =>
-        {
-            opts.ForJob(typeName)
-                .WithIdentity($"{typeName}-startup-trigger")
-                .StartNow();
-        });
-    }
-}

code/Executable/DependencyInjection/ServicesDI.cs

@@ -1,29 +0,0 @@
-using Infrastructure.Verticals.Arr;
-using Infrastructure.Verticals.ContentBlocker;
-using Infrastructure.Verticals.DownloadClient;
-using Infrastructure.Verticals.DownloadClient.Deluge;
-using Infrastructure.Verticals.DownloadClient.QBittorrent;
-using Infrastructure.Verticals.DownloadClient.Transmission;
-using Infrastructure.Verticals.ItemStriker;
-using Infrastructure.Verticals.QueueCleaner;
-
-namespace Executable.DependencyInjection;
-
-public static class ServicesDI
-{
-    public static IServiceCollection AddServices(this IServiceCollection services) =>
-        services
-            .AddTransient<SonarrClient>()
-            .AddTransient<RadarrClient>()
-            .AddTransient<QueueCleaner>()
-            .AddTransient<ContentBlocker>()
-            .AddTransient<FilenameEvaluator>()
-            .AddTransient<DummyDownloadService>()
-            .AddTransient<QBitService>()
-            .AddTransient<DelugeService>()
-            .AddTransient<TransmissionService>()
-            .AddTransient<ArrQueueIterator>()
-            .AddTransient<DownloadServiceFactory>()
-            .AddSingleton<BlocklistProvider>()
-            .AddSingleton<Striker>();
-}

code/Executable/Executable.csproj

@@ -1,30 +0,0 @@
-<Project Sdk="Microsoft.NET.Sdk.Worker">
-
-    <PropertyGroup>
-        <AssemblyName>cleanuperr</AssemblyName>
-        <TargetFramework>net9.0</TargetFramework>
-        <Version Condition="'$(Version)' == ''">0.0.1</Version>
-        <Nullable>enable</Nullable>
-        <ImplicitUsings>enable</ImplicitUsings>
-        <UserSecretsId>dotnet-Executable-6108b2ba-f035-47bc-addf-aaf5e20da4b8</UserSecretsId>
-    </PropertyGroup>
-
-    <ItemGroup>
-        <PackageReference Include="Microsoft.Extensions.Hosting" Version="9.0.0" />
-        <PackageReference Include="Microsoft.Extensions.Http" Version="9.0.0" />
-        <PackageReference Include="Quartz" Version="3.13.1" />
-        <PackageReference Include="Quartz.Extensions.DependencyInjection" Version="3.13.1" />
-        <PackageReference Include="Quartz.Extensions.Hosting" Version="3.13.1" />
-        <PackageReference Include="Serilog" Version="4.2.0" />
-        <PackageReference Include="Serilog.Expressions" Version="5.0.0" />
-        <PackageReference Include="Serilog.Extensions.Hosting" Version="9.0.0" />
-        <PackageReference Include="Serilog.Settings.Configuration" Version="9.0.0" />
-        <PackageReference Include="Serilog.Sinks.Console" Version="6.0.0" />
-        <PackageReference Include="Serilog.Sinks.File" Version="6.0.0" />
-    </ItemGroup>
-
-    <ItemGroup>
-      <ProjectReference Include="..\Common\Common.csproj" />
-      <ProjectReference Include="..\Infrastructure\Infrastructure.csproj" />
-    </ItemGroup>
-</Project>

code/Executable/Program.cs

@@ -1,21 +0,0 @@
-using System.Reflection;
-using Executable.DependencyInjection;
-
-var builder = Host.CreateApplicationBuilder(args);
-
-builder.Services.AddInfrastructure(builder.Configuration);
-builder.Logging.AddLogging(builder.Configuration);
-
-var host = builder.Build();
-
-var logger = host.Services.GetRequiredService<ILogger<Program>>();
-
-var version = Assembly.GetExecutingAssembly().GetName().Version;
-
-logger.LogInformation(
-    version is null
-        ? "cleanuperr version not detected"
-        : $"cleanuperr v{version.Major}.{version.Minor}.{version.Build}"
-);
-
-host.Run();

code/Executable/appsettings.Development.json

@@ -1,70 +0,0 @@
-{
-  "Logging": {
-    "LogLevel": "Debug",
-    "Enhanced": true,
-    "File": {
-      "Enabled": false,
-      "Path": ""
-    }
-  },
-  "Triggers": {
-    "QueueCleaner": "0/10 * * * * ?",
-    "ContentBlocker": "0/10 * * * * ?"
-  },
-  "ContentBlocker": {
-    "Enabled": true,
-    "Blacklist": {
-      "Enabled": false,
-      "Path": "https://raw.githubusercontent.com/flmorg/cleanuperr/refs/heads/main/blacklist"
-    },
-    "Whitelist": {
-      "Enabled": false,
-      "Path": "https://raw.githubusercontent.com/flmorg/cleanuperr/refs/heads/main/whitelist"
-    }
-  },
-  "QueueCleaner": {
-    "Enabled": true,
-    "RunSequentially": true,
-    "IMPORT_FAILED_MAX_STRIKES": 5,
-    "IMPORT_FAILED_IGNORE_PRIVATE": true,
-    "IMPORT_FAILED_IGNORE_PATTERNS": [
-      "file is a sample"
-    ],
-    "STALLED_MAX_STRIKES": 5,
-    "STALLED_IGNORE_PRIVATE": true
-  },
-  "DOWNLOAD_CLIENT": "qbittorrent",
-  "qBittorrent": {
-    "Url": "http://localhost:8080",
-    "Username": "test",
-    "Password": "testing"
-  },
-  "Deluge": {
-    "Url": "http://localhost:8112",
-    "Password": "testing"
-  },
-  "Transmission": {
-    "Url": "http://localhost:9091",
-    "Username": "test",
-    "Password": "testing"
-  },
-  "Sonarr": {
-    "Enabled": true,
-    "SearchType": "Episode",
-    "Instances": [
-      {
-        "Url": "http://localhost:8989",
-        "ApiKey": "96736c3eb3144936b8f1d62d27be8cee"
-      }
-    ]
-  },
-  "Radarr": {
-    "Enabled": true,
-    "Instances": [
-      {
-        "Url": "http://localhost:7878",
-        "ApiKey": "705b553732ab4167ab23909305d60600"
-      }
-    ]
-  }
-}

code/Executable/appsettings.json

@@ -1,68 +0,0 @@
-{
-  "Logging": {
-    "LogLevel": "Information",
-    "Enhanced": true,
-    "File": {
-      "Enabled": false,
-      "Path": ""
-    }
-  },
-  "Triggers": {
-    "QueueCleaner": "0 0/5 * * * ?",
-    "ContentBlocker": "0 0/5 * * * ?"
-  },
-  "ContentBlocker": {
-    "Enabled": false,
-    "Blacklist": {
-      "Enabled": false,
-      "Path": ""
-    },
-    "Whitelist": {
-      "Enabled": false,
-      "Path": ""
-    }
-  },
-  "QueueCleaner": {
-    "Enabled": true,
-    "RunSequentially": true,
-    "IMPORT_FAILED_MAX_STRIKES": 5,
-    "IMPORT_FAILED_IGNORE_PRIVATE": false,
-    "IMPORT_FAILED_IGNORE_PATTERNS": [],
-    "STALLED_MAX_STRIKES": 5,
-    "STALLED_IGNORE_PRIVATE": false
-  },
-  "DOWNLOAD_CLIENT": "qbittorrent",
-  "qBittorrent": {
-    "Url": "http://localhost:8080",
-    "Username": "",
-    "Password": ""
-  },
-  "Deluge": {
-    "Url": "http://localhost:8112",
-    "Password": "testing"
-  },
-  "Transmission": {
-    "Url": "http://localhost:9091",
-    "Username": "test",
-    "Password": "testing"
-  },
-  "Sonarr": {
-    "Enabled": true,
-    "SearchType": "Episode",
-    "Instances": [
-      {
-        "Url": "http://localhost:8989",
-        "ApiKey": ""
-      }
-    ]
-  },
-  "Radarr": {
-    "Enabled": false,
-    "Instances": [
-      {
-        "Url": "http://localhost:7878",
-        "ApiKey": ""
-      }
-    ]
-  }
-}

code/Infrastructure/Infrastructure.csproj

@@ -1,22 +0,0 @@
-<Project Sdk="Microsoft.NET.Sdk">
-
-    <PropertyGroup>
-        <TargetFramework>net9.0</TargetFramework>
-        <ImplicitUsings>enable</ImplicitUsings>
-        <Nullable>enable</Nullable>
-    </PropertyGroup>
-
-    <ItemGroup>
-      <ProjectReference Include="..\Common\Common.csproj" />
-      <ProjectReference Include="..\Domain\Domain.csproj" />
-    </ItemGroup>
-
-    <ItemGroup>
-      <PackageReference Include="FLM.Transmission" Version="1.0.0" />
-      <PackageReference Include="Microsoft.Extensions.Caching.Memory" Version="9.0.0" />
-      <PackageReference Include="Microsoft.Extensions.Http" Version="9.0.0" />
-      <PackageReference Include="QBittorrent.Client" Version="1.9.24285.1" />
-      <PackageReference Include="Quartz" Version="3.13.1" />
-    </ItemGroup>
-
-</Project>

code/Infrastructure/Verticals/Arr/ArrClient.cs

@@ -1,178 +0,0 @@
-using Common.Configuration.Arr;
-using Common.Configuration.Logging;
-using Common.Configuration.QueueCleaner;
-using Domain.Enums;
-using Domain.Models.Arr;
-using Domain.Models.Arr.Queue;
-using Infrastructure.Verticals.ItemStriker;
-using Microsoft.Extensions.Logging;
-using Microsoft.Extensions.Options;
-using Newtonsoft.Json;
-
-namespace Infrastructure.Verticals.Arr;
-
-public abstract class ArrClient
-{
-    protected readonly ILogger<ArrClient> _logger;
-    protected readonly HttpClient _httpClient;
-    protected readonly LoggingConfig _loggingConfig;
-    protected readonly QueueCleanerConfig _queueCleanerConfig;
-    protected readonly Striker _striker;
-    
-    protected ArrClient(
-        ILogger<ArrClient> logger,
-        IHttpClientFactory httpClientFactory,
-        IOptions<LoggingConfig> loggingConfig,
-        IOptions<QueueCleanerConfig> queueCleanerConfig,
-        Striker striker
-    )
-    {
-        _logger = logger;
-        _striker = striker;
-        _httpClient = httpClientFactory.CreateClient();
-        _loggingConfig = loggingConfig.Value;
-        _queueCleanerConfig = queueCleanerConfig.Value;
-        _striker = striker;
-    }
-
-    public virtual async Task<QueueListResponse> GetQueueItemsAsync(ArrInstance arrInstance, int page)
-    {
-        Uri uri = new(arrInstance.Url, GetQueueUrlPath(page));
-
-        using HttpRequestMessage request = new(HttpMethod.Get, uri);
-        SetApiKey(request, arrInstance.ApiKey);
-        
-        using HttpResponseMessage response = await _httpClient.SendAsync(request);
-
-        try
-        {
-            response.EnsureSuccessStatusCode();
-        }
-        catch
-        {
-            _logger.LogError("queue list failed | {uri}", uri);
-            throw;
-        }
-        
-        string responseBody = await response.Content.ReadAsStringAsync();
-        QueueListResponse? queueResponse = JsonConvert.DeserializeObject<QueueListResponse>(responseBody);
-
-        if (queueResponse is null)
-        {
-            throw new Exception($"unrecognized queue list response | {uri} | {responseBody}");
-        }
-
-        return queueResponse;
-    }
-
-    public virtual bool ShouldRemoveFromQueue(QueueRecord record, bool isPrivateDownload)
-    {
-        if (_queueCleanerConfig.ImportFailedIgnorePrivate && isPrivateDownload)
-        {
-            // ignore private trackers
-            _logger.LogDebug("skip failed import check | download is private | {name}", record.Title);
-            return false;
-        }
-        
-        bool hasWarn() => record.TrackedDownloadStatus
-            .Equals("warning", StringComparison.InvariantCultureIgnoreCase);
-        bool isImportBlocked() => record.TrackedDownloadState
-            .Equals("importBlocked", StringComparison.InvariantCultureIgnoreCase);
-        bool isImportPending() => record.TrackedDownloadState
-            .Equals("importPending", StringComparison.InvariantCultureIgnoreCase);
-        
-        if (hasWarn() && (isImportBlocked() || isImportPending()))
-        {
-            if (HasIgnoredPatterns(record))
-            {
-                _logger.LogDebug("skip failed import check | contains ignored pattern | {name}", record.Title);
-                return false;
-            }
-            
-            return _striker.StrikeAndCheckLimit(
-                record.DownloadId,
-                record.Title,
-                _queueCleanerConfig.ImportFailedMaxStrikes,
-                StrikeType.ImportFailed
-            );
-        }
-
-        return false;
-    }
-    
-    public virtual async Task DeleteQueueItemAsync(ArrInstance arrInstance, QueueRecord queueRecord)
-    {
-        Uri uri = new(arrInstance.Url, $"/api/v3/queue/{queueRecord.Id}?removeFromClient=true&blocklist=true&skipRedownload=true&changeCategory=false");
-        
-        using HttpRequestMessage request = new(HttpMethod.Delete, uri);
-        SetApiKey(request, arrInstance.ApiKey);
-
-        using HttpResponseMessage response = await _httpClient.SendAsync(request);
-
-        try
-        {
-            response.EnsureSuccessStatusCode();
-            
-            _logger.LogInformation("queue item deleted | {url} | {title}", arrInstance.Url, queueRecord.Title);
-        }
-        catch
-        {
-            _logger.LogError("queue delete failed | {uri} | {title}", uri, queueRecord.Title);
-            throw;
-        }
-    }
-
-    public abstract Task RefreshItemsAsync(ArrInstance arrInstance, ArrConfig config, HashSet<SearchItem>? items);
-
-    public virtual bool IsRecordValid(QueueRecord record)
-    {
-        if (string.IsNullOrEmpty(record.DownloadId))
-        {
-            _logger.LogDebug("skip | download id is null for {title}", record.Title);
-            return false;
-        }
-
-        if (record.DownloadId.Equals(record.Title, StringComparison.InvariantCultureIgnoreCase))
-        {
-            _logger.LogDebug("skip | item is not ready yet | {title}", record.Title);
-            return false;
-        }
-
-        return true;
-    }
-    
-    protected abstract string GetQueueUrlPath(int page);
-    
-    protected virtual void SetApiKey(HttpRequestMessage request, string apiKey)
-    {
-        request.Headers.Add("x-api-key", apiKey);
-    }
-
-    private bool HasIgnoredPatterns(QueueRecord record)
-    {
-        if (_queueCleanerConfig.ImportFailedIgnorePatterns?.Count is null or 0)
-        {
-            // no patterns are configured
-            return false;
-        }
-            
-        if (record.StatusMessages?.Count is null or 0)
-        {
-            // no status message found
-            return false;
-        }
-        
-        HashSet<string> messages = record.StatusMessages
-            .SelectMany(x => x.Messages ?? Enumerable.Empty<string>())
-            .ToHashSet();
-        record.StatusMessages.Select(x => x.Title)
-            .ToList()
-            .ForEach(x => messages.Add(x));
-        
-        return messages.Any(
-            m => _queueCleanerConfig.ImportFailedIgnorePatterns.Any(
-                p => !string.IsNullOrWhiteSpace(p.Trim()) && m.Contains(p, StringComparison.InvariantCultureIgnoreCase)
-            )
-        );
-    }
-}

code/Infrastructure/Verticals/ContentBlocker/BlocklistProvider.cs

@@ -1,134 +0,0 @@
-using System.Collections.Concurrent;
-using System.Diagnostics;
-using System.Text.RegularExpressions;
-using Common.Configuration.ContentBlocker;
-using Domain.Enums;
-using Microsoft.Extensions.Logging;
-using Microsoft.Extensions.Options;
-
-namespace Infrastructure.Verticals.ContentBlocker;
-
-public sealed class BlocklistProvider
-{
-    private readonly ILogger<BlocklistProvider> _logger;
-    private readonly ContentBlockerConfig _config;
-    private readonly HttpClient _httpClient;
-    
-    public BlocklistType BlocklistType { get; }
-
-    public ConcurrentBag<string> Patterns { get; } = [];
-
-    public ConcurrentBag<Regex> Regexes { get; } = [];
-
-    public BlocklistProvider(
-        ILogger<BlocklistProvider> logger,
-        IOptions<ContentBlockerConfig> config,
-        IHttpClientFactory httpClientFactory)
-    {
-        _logger = logger;
-        _config = config.Value;
-        _httpClient = httpClientFactory.CreateClient();
-        
-        _config.Validate();
-        
-        if (_config.Blacklist?.Enabled is true)
-        {
-            BlocklistType = BlocklistType.Blacklist;
-        }
-
-        if (_config.Whitelist?.Enabled is true)
-        {
-            BlocklistType = BlocklistType.Whitelist;
-        }
-    }
-
-    public async Task LoadBlocklistAsync()
-    {
-        if (Patterns.Count > 0 || Regexes.Count > 0)
-        {
-            _logger.LogDebug("blocklist already loaded");
-            return;
-        }
-        
-        try
-        {
-            await LoadPatternsAndRegexesAsync();
-        }
-        catch
-        {
-            _logger.LogError("failed to load {type}", BlocklistType.ToString());
-            throw;
-        }
-    }
-
-    private async Task LoadPatternsAndRegexesAsync()
-    {
-        string[] patterns;
-        
-        if (BlocklistType is BlocklistType.Blacklist)
-        {
-            patterns = await ReadContentAsync(_config.Blacklist.Path);
-        }
-        else
-        {
-            patterns = await ReadContentAsync(_config.Whitelist.Path);
-        }
-        
-        long startTime = Stopwatch.GetTimestamp();
-        ParallelOptions options = new() { MaxDegreeOfParallelism = 5 };
-        const string regexId = "regex:";
-        
-        Parallel.ForEach(patterns, options, pattern =>
-        {
-            if (!pattern.StartsWith(regexId))
-            {
-                Patterns.Add(pattern);
-                return;
-            }
-            
-            pattern = pattern[regexId.Length..];
-            
-            try
-            {
-                Regex regex = new(pattern, RegexOptions.Compiled);
-                Regexes.Add(regex);
-            }
-            catch (ArgumentException)
-            {
-                _logger.LogWarning("invalid regex | {pattern}", pattern);
-            }
-        });
-
-        TimeSpan elapsed = Stopwatch.GetElapsedTime(startTime);
-        
-        _logger.LogDebug("loaded {count} patterns", Patterns.Count);
-        _logger.LogDebug("loaded {count} regexes", Regexes.Count);
-        _logger.LogDebug("blocklist loaded in {elapsed} ms", elapsed.TotalMilliseconds);
-    }
-    
-    private async Task<string[]> ReadContentAsync(string path)
-    {
-        if (Uri.TryCreate(path, UriKind.Absolute, out var uri) && (uri.Scheme == Uri.UriSchemeHttp || uri.Scheme == Uri.UriSchemeHttps))
-        {
-            // http(s) url
-            return await ReadFromUrlAsync(path);
-        }
-
-        if (File.Exists(path))
-        {
-            // local file path
-            return await File.ReadAllLinesAsync(path);
-        }
-
-        throw new ArgumentException($"blocklist not found | {path}");
-    }
-
-    private async Task<string[]> ReadFromUrlAsync(string url)
-    {
-        using HttpResponseMessage response = await _httpClient.GetAsync(url);
-        response.EnsureSuccessStatusCode();
-        
-        return (await response.Content.ReadAsStringAsync())
-            .Split(['\r','\n'], StringSplitOptions.RemoveEmptyEntries);
-    }
-}

code/Infrastructure/Verticals/ContentBlocker/ContentBlocker.cs

@@ -1,68 +0,0 @@
-using Common.Configuration.Arr;
-using Common.Configuration.DownloadClient;
-using Domain.Enums;
-using Domain.Models.Arr.Queue;
-using Infrastructure.Verticals.Arr;
-using Infrastructure.Verticals.DownloadClient;
-using Infrastructure.Verticals.Jobs;
-using Microsoft.Extensions.Logging;
-using Microsoft.Extensions.Options;
-
-namespace Infrastructure.Verticals.ContentBlocker;
-
-public sealed class ContentBlocker : GenericHandler
-{
-    private readonly BlocklistProvider _blocklistProvider;
-    
-    public ContentBlocker(
-        ILogger<ContentBlocker> logger,
-        IOptions<DownloadClientConfig> downloadClientConfig,
-        IOptions<SonarrConfig> sonarrConfig,
-        IOptions<RadarrConfig> radarrConfig,
-        SonarrClient sonarrClient,
-        RadarrClient radarrClient,
-        ArrQueueIterator arrArrQueueIterator,
-        BlocklistProvider blocklistProvider,
-        DownloadServiceFactory downloadServiceFactory
-    ) : base(logger, downloadClientConfig, sonarrConfig.Value, radarrConfig.Value, sonarrClient, radarrClient, arrArrQueueIterator, downloadServiceFactory)
-    {
-        _blocklistProvider = blocklistProvider;
-    }
-
-    public override async Task ExecuteAsync()
-    {
-        if (_downloadClientConfig.DownloadClient is Common.Enums.DownloadClient.None)
-        {
-            _logger.LogWarning("download client is set to none");
-            return;
-        }
-        
-        await _blocklistProvider.LoadBlocklistAsync();
-        await base.ExecuteAsync();
-    }
-
-    protected override async Task ProcessInstanceAsync(ArrInstance instance, InstanceType instanceType)
-    {
-        ArrClient arrClient = GetClient(instanceType);
-
-        await _arrArrQueueIterator.Iterate(arrClient, instance, async items =>
-        {
-            foreach (QueueRecord record in items)
-            {
-                if (record.Protocol is not "torrent")
-                {
-                    continue;
-                }
-                
-                if (string.IsNullOrEmpty(record.DownloadId))
-                {
-                    _logger.LogDebug("skip | download id is null for {title}", record.Title);
-                    continue;
-                }
-                
-                _logger.LogDebug("searching unwanted files for {title}", record.Title);
-                await _downloadService.BlockUnwantedFilesAsync(record.DownloadId);
-            }
-        });
-    }
-}

code/Infrastructure/Verticals/ContentBlocker/FilenameEvaluator.cs

@@ -1,81 +0,0 @@
-using Domain.Enums;
-using Microsoft.Extensions.Logging;
-
-namespace Infrastructure.Verticals.ContentBlocker;
-
-public sealed class FilenameEvaluator
-{
-    private readonly ILogger<FilenameEvaluator> _logger;
-    private readonly BlocklistProvider _blocklistProvider;
-    
-    public FilenameEvaluator(ILogger<FilenameEvaluator> logger, BlocklistProvider blocklistProvider)
-    {
-        _logger = logger;
-        _blocklistProvider = blocklistProvider;
-    }
-    
-    // TODO create unit tests
-    public bool IsValid(string filename)
-    {
-        return IsValidAgainstPatterns(filename) && IsValidAgainstRegexes(filename);
-    }
-
-    private bool IsValidAgainstPatterns(string filename)
-    {
-        if (_blocklistProvider.Patterns.Count is 0)
-        {
-            return true;
-        }
-
-        return _blocklistProvider.BlocklistType switch
-        {
-            BlocklistType.Blacklist => !_blocklistProvider.Patterns.Any(pattern => MatchesPattern(filename, pattern)),
-            BlocklistType.Whitelist => _blocklistProvider.Patterns.Any(pattern => MatchesPattern(filename, pattern)),
-            _ => true
-        };
-    }
-
-    private bool IsValidAgainstRegexes(string filename)
-    {
-        if (_blocklistProvider.Regexes.Count is 0)
-        {
-            return true;
-        }
-        
-        return _blocklistProvider.BlocklistType switch
-        {
-            BlocklistType.Blacklist => !_blocklistProvider.Regexes.Any(regex => regex.IsMatch(filename)),
-            BlocklistType.Whitelist => _blocklistProvider.Regexes.Any(regex => regex.IsMatch(filename)),
-            _ => true
-        };
-    }
-    
-    private static bool MatchesPattern(string filename, string pattern)
-    {
-        bool hasStartWildcard = pattern.StartsWith('*');
-        bool hasEndWildcard = pattern.EndsWith('*');
-
-        if (hasStartWildcard && hasEndWildcard)
-        {
-            return filename.Contains(
-                pattern.Substring(1, pattern.Length - 2),
-                StringComparison.InvariantCultureIgnoreCase
-            );
-        }
-
-        if (hasStartWildcard)
-        {
-            return filename.EndsWith(pattern.Substring(1), StringComparison.InvariantCultureIgnoreCase);
-        }
-
-        if (hasEndWildcard)
-        {
-            return filename.StartsWith(
-                pattern.Substring(0, pattern.Length - 1),
-                StringComparison.InvariantCultureIgnoreCase
-            );
-        }
-
-        return filename == pattern;
-    }
-}

code/Infrastructure/Verticals/DownloadClient/Deluge/DelugeService.cs

@@ -1,189 +0,0 @@
-using Common.Configuration.DownloadClient;
-using Common.Configuration.QueueCleaner;
-using Domain.Models.Deluge.Response;
-using Infrastructure.Verticals.ContentBlocker;
-using Infrastructure.Verticals.ItemStriker;
-using Microsoft.Extensions.Logging;
-using Microsoft.Extensions.Options;
-
-namespace Infrastructure.Verticals.DownloadClient.Deluge;
-
-public sealed class DelugeService : DownloadServiceBase
-{
-    private readonly DelugeClient _client;
-    
-    public DelugeService(
-        ILogger<DelugeService> logger,
-        IOptions<DelugeConfig> config,
-        IHttpClientFactory httpClientFactory,
-        IOptions<QueueCleanerConfig> queueCleanerConfig,
-        FilenameEvaluator filenameEvaluator,
-        Striker striker
-    ) : base(logger, queueCleanerConfig, filenameEvaluator, striker)
-    {
-        config.Value.Validate();
-        _client = new (config, httpClientFactory);
-    }
-    
-    public override async Task LoginAsync()
-    {
-        await _client.LoginAsync();
-    }
-
-    public override async Task<RemoveResult> ShouldRemoveFromArrQueueAsync(string hash)
-    {
-        hash = hash.ToLowerInvariant();
-        
-        DelugeContents? contents = null;
-        RemoveResult result = new();
-
-        TorrentStatus? status = await GetTorrentStatus(hash);
-        
-        if (status?.Hash is null)
-        {
-            _logger.LogDebug("failed to find torrent {hash} in the download client", hash);
-            return result;
-        }
-
-        try
-        {
-            contents = await _client.GetTorrentFiles(hash);
-        }
-        catch (Exception exception)
-        {
-            _logger.LogDebug(exception, "failed to find torrent {hash} in the download client", hash);
-        }
-
-        bool shouldRemove = contents?.Contents?.Count > 0;
-        
-        ProcessFiles(contents.Contents, (_, file) =>
-        {
-            if (file.Priority > 0)
-            {
-                shouldRemove = false;
-            }
-        });
-
-        result.ShouldRemove = shouldRemove || IsItemStuckAndShouldRemove(status);
-        result.IsPrivate = status.Private;
-        
-        return result;
-    }
-
-    public override async Task BlockUnwantedFilesAsync(string hash)
-    {
-        hash = hash.ToLowerInvariant();
-
-        TorrentStatus? status = await GetTorrentStatus(hash);
-        
-        if (status?.Hash is null)
-        {
-            _logger.LogDebug("failed to find torrent {hash} in the download client", hash);
-            return;
-        }
-        
-        DelugeContents? contents = null;
-
-        try
-        {
-            contents = await _client.GetTorrentFiles(hash);
-        }
-        catch (Exception exception)
-        {
-            _logger.LogDebug(exception, "failed to find torrent {hash} in the download client", hash);
-        }
-
-        if (contents is null)
-        {
-            return;
-        }
-        
-        Dictionary<int, int> priorities = [];
-        bool hasPriorityUpdates = false;
-
-        ProcessFiles(contents.Contents, (name, file) =>
-        {
-            int priority = file.Priority;
-
-            if (file.Priority is not 0 && !_filenameEvaluator.IsValid(name))
-            {
-                priority = 0;
-                hasPriorityUpdates = true;
-                _logger.LogInformation("unwanted file found | {file}", file.Path);
-            }
-            
-            priorities.Add(file.Index, priority);
-        });
-
-        if (!hasPriorityUpdates)
-        {
-            return;
-        }
-        
-        _logger.LogDebug("changing priorities | torrent {hash}", hash);
-
-        List<int> sortedPriorities = priorities
-            .OrderBy(x => x.Key)
-            .Select(x => x.Value)
-            .ToList();
-
-        await _client.ChangeFilesPriority(hash, sortedPriorities);
-    }
-    
-    private bool IsItemStuckAndShouldRemove(TorrentStatus status)
-    {
-        if (_queueCleanerConfig.StalledMaxStrikes is 0)
-        {
-            return false;
-        }
-        
-        if (_queueCleanerConfig.StalledIgnorePrivate && status.Private)
-        {
-            // ignore private trackers
-            _logger.LogDebug("skip stalled check | download is private | {name}", status.Name);
-            return false;
-        }
-        
-        if (status.State is null || !status.State.Equals("Downloading", StringComparison.InvariantCultureIgnoreCase))
-        {
-            return false;
-        }
-
-        if (status.Eta > 0)
-        {
-            return false;
-        }
-
-        return StrikeAndCheckLimit(status.Hash!, status.Name!);
-    }
-
-    private async Task<TorrentStatus?> GetTorrentStatus(string hash)
-    {
-        return await _client.SendRequest<TorrentStatus?>(
-            "web.get_torrent_status",
-            hash,
-            new[] { "hash", "state", "name", "eta", "private" }
-        );
-    }
-    
-    private static void ProcessFiles(Dictionary<string, DelugeFileOrDirectory> contents, Action<string, DelugeFileOrDirectory> processFile)
-    {
-        foreach (var (name, data) in contents)
-        {
-            switch (data.Type)
-            {
-                case "file":
-                    processFile(name, data);
-                    break;
-                case "dir" when data.Contents is not null:
-                    // Recurse into subdirectories
-                    ProcessFiles(data.Contents, processFile);
-                    break;
-            }
-        }
-    }
-
-    public override void Dispose()
-    {
-    }
-}

code/Infrastructure/Verticals/DownloadClient/DownloadServiceBase.cs

@@ -1,42 +0,0 @@
-using Common.Configuration.QueueCleaner;
-using Domain.Enums;
-using Infrastructure.Verticals.ContentBlocker;
-using Infrastructure.Verticals.ItemStriker;
-using Microsoft.Extensions.Logging;
-using Microsoft.Extensions.Options;
-
-namespace Infrastructure.Verticals.DownloadClient;
-
-public abstract class DownloadServiceBase : IDownloadService
-{
-    protected readonly ILogger<DownloadServiceBase> _logger;
-    protected readonly QueueCleanerConfig _queueCleanerConfig;
-    protected readonly FilenameEvaluator _filenameEvaluator;
-    protected readonly Striker _striker;
-    
-    protected DownloadServiceBase(
-        ILogger<DownloadServiceBase> logger,
-        IOptions<QueueCleanerConfig> queueCleanerConfig,
-        FilenameEvaluator filenameEvaluator,
-        Striker striker
-    )
-    {
-        _logger = logger;
-        _queueCleanerConfig = queueCleanerConfig.Value;
-        _filenameEvaluator = filenameEvaluator;
-        _striker = striker;
-    }
-
-    public abstract void Dispose();
-
-    public abstract Task LoginAsync();
-
-    public abstract Task<RemoveResult> ShouldRemoveFromArrQueueAsync(string hash);
-
-    public abstract Task BlockUnwantedFilesAsync(string hash);
-
-    protected bool StrikeAndCheckLimit(string hash, string itemName)
-    {
-        return _striker.StrikeAndCheckLimit(hash, itemName, _queueCleanerConfig.StalledMaxStrikes, StrikeType.Stalled);
-    }
-}

code/Infrastructure/Verticals/DownloadClient/DownloadServiceFactory.cs

@@ -1,30 +0,0 @@
-using Common.Configuration.DownloadClient;
-using Infrastructure.Verticals.DownloadClient.Deluge;
-using Infrastructure.Verticals.DownloadClient.QBittorrent;
-using Infrastructure.Verticals.DownloadClient.Transmission;
-using Microsoft.Extensions.DependencyInjection;
-using Microsoft.Extensions.Options;
-
-namespace Infrastructure.Verticals.DownloadClient;
-
-public sealed class DownloadServiceFactory
-{
-    private readonly IServiceProvider _serviceProvider;
-    private readonly Common.Enums.DownloadClient _downloadClient;
-    
-    public DownloadServiceFactory(IServiceProvider serviceProvider, IOptions<DownloadClientConfig> downloadClientConfig)
-    {
-        _serviceProvider = serviceProvider;
-        _downloadClient = downloadClientConfig.Value.DownloadClient;
-    }
-
-    public IDownloadService CreateDownloadClient() =>
-        _downloadClient switch
-        {
-            Common.Enums.DownloadClient.QBittorrent => _serviceProvider.GetRequiredService<QBitService>(),
-            Common.Enums.DownloadClient.Deluge => _serviceProvider.GetRequiredService<DelugeService>(),
-            Common.Enums.DownloadClient.Transmission => _serviceProvider.GetRequiredService<TransmissionService>(),
-            Common.Enums.DownloadClient.None => _serviceProvider.GetRequiredService<DummyDownloadService>(),
-            _ => throw new ArgumentOutOfRangeException()
-        };
-}

code/Infrastructure/Verticals/DownloadClient/DummyDownloadService.cs

@@ -1,33 +0,0 @@
-using Common.Configuration.QueueCleaner;
-using Infrastructure.Verticals.ContentBlocker;
-using Infrastructure.Verticals.ItemStriker;
-using Microsoft.Extensions.Logging;
-using Microsoft.Extensions.Options;
-
-namespace Infrastructure.Verticals.DownloadClient;
-
-public sealed class DummyDownloadService : DownloadServiceBase
-{
-    public DummyDownloadService(ILogger<DownloadServiceBase> logger, IOptions<QueueCleanerConfig> queueCleanerConfig, FilenameEvaluator filenameEvaluator, Striker striker) : base(logger, queueCleanerConfig, filenameEvaluator, striker)
-    {
-    }
-
-    public override void Dispose()
-    {
-    }
-
-    public override Task LoginAsync()
-    {
-        return Task.CompletedTask;
-    }
-
-    public override Task<RemoveResult> ShouldRemoveFromArrQueueAsync(string hash)
-    {
-        throw new NotImplementedException();
-    }
-
-    public override Task BlockUnwantedFilesAsync(string hash)
-    {
-        throw new NotImplementedException();
-    }
-}

code/Infrastructure/Verticals/DownloadClient/IDownloadService.cs

@@ -1,10 +0,0 @@
-namespace Infrastructure.Verticals.DownloadClient;
-
-public interface IDownloadService : IDisposable
-{
-    public Task LoginAsync();
-
-    public Task<RemoveResult> ShouldRemoveFromArrQueueAsync(string hash);
-
-    public Task BlockUnwantedFilesAsync(string hash);
-}

code/Infrastructure/Verticals/DownloadClient/QBittorrent/QBitService.cs

@@ -1,138 +0,0 @@
-using Common.Configuration.DownloadClient;
-using Common.Configuration.QueueCleaner;
-using Infrastructure.Verticals.ContentBlocker;
-using Infrastructure.Verticals.ItemStriker;
-using Microsoft.Extensions.Logging;
-using Microsoft.Extensions.Options;
-using QBittorrent.Client;
-
-namespace Infrastructure.Verticals.DownloadClient.QBittorrent;
-
-public sealed class QBitService : DownloadServiceBase
-{
-    private readonly QBitConfig _config;
-    private readonly QBittorrentClient _client;
-
-    public QBitService(
-        ILogger<QBitService> logger,
-        IOptions<QBitConfig> config,
-        IOptions<QueueCleanerConfig> queueCleanerConfig,
-        FilenameEvaluator filenameEvaluator,
-        Striker striker
-    ) : base(logger, queueCleanerConfig, filenameEvaluator, striker)
-    {
-        _config = config.Value;
-        _config.Validate();
-        _client = new(_config.Url);
-    }
-
-    public override async Task LoginAsync()
-    {
-        if (string.IsNullOrEmpty(_config.Username) && string.IsNullOrEmpty(_config.Password))
-        {
-            return;
-        }
-        
-        await _client.LoginAsync(_config.Username, _config.Password);
-    }
-
-    public override async Task<RemoveResult> ShouldRemoveFromArrQueueAsync(string hash)
-    {
-        RemoveResult result = new();
-        TorrentInfo? torrent = (await _client.GetTorrentListAsync(new TorrentListQuery { Hashes = [hash] }))
-            .FirstOrDefault();
-
-        if (torrent is null)
-        {
-            _logger.LogDebug("failed to find torrent {hash} in the download client", hash);
-            return result;
-        }
-
-        TorrentProperties? torrentProperties = await _client.GetTorrentPropertiesAsync(hash);
-
-        if (torrentProperties is null)
-        {
-            _logger.LogDebug("failed to find torrent properties {hash} in the download client", hash);
-            return result;
-        }
-
-        result.IsPrivate = torrentProperties.AdditionalData.TryGetValue("is_private", out var dictValue) &&
-                           bool.TryParse(dictValue?.ToString(), out bool boolValue)
-                           && boolValue;
-
-        // if all files were blocked by qBittorrent
-        if (torrent is { CompletionOn: not null, Downloaded: null or 0 })
-        {
-            result.ShouldRemove = true;
-            return result;
-        }
-
-        IReadOnlyList<TorrentContent>? files = await _client.GetTorrentContentsAsync(hash);
-
-        // if all files are marked as skip
-        if (files?.Count is > 0 && files.All(x => x.Priority is TorrentContentPriority.Skip))
-        {
-            result.ShouldRemove = true;
-            return result;
-        }
-
-        result.ShouldRemove = IsItemStuckAndShouldRemove(torrent, result.IsPrivate);
-
-        return result;
-    }
-
-    public override async Task BlockUnwantedFilesAsync(string hash)
-    {
-        IReadOnlyList<TorrentContent>? files = await _client.GetTorrentContentsAsync(hash);
-
-        if (files is null)
-        {
-            return;
-        }
-        
-        foreach (TorrentContent file in files)
-        {
-            if (!file.Index.HasValue)
-            {
-                continue;
-            }
-
-            if (file.Priority is TorrentContentPriority.Skip || _filenameEvaluator.IsValid(file.Name))
-            {
-                continue;
-            }
-            
-            _logger.LogInformation("unwanted file found | {file}", file.Name);
-            await _client.SetFilePriorityAsync(hash, file.Index.Value, TorrentContentPriority.Skip);
-        }
-    }
-
-    public override void Dispose()
-    {
-        _client.Dispose();
-    }
-    
-    private bool IsItemStuckAndShouldRemove(TorrentInfo torrent, bool isPrivate)
-    {
-        if (_queueCleanerConfig.StalledMaxStrikes is 0)
-        {
-            return false;
-        }
-        
-        if (_queueCleanerConfig.StalledIgnorePrivate && isPrivate)
-        {
-            // ignore private trackers
-            _logger.LogDebug("skip stalled check | download is private | {name}", torrent.Name);
-            return false;
-        }
-        
-        if (torrent.State is not TorrentState.StalledDownload and not TorrentState.FetchingMetadata
-            and not TorrentState.ForcedFetchingMetadata)
-        {
-            // ignore other states
-            return false;
-        }
-
-        return StrikeAndCheckLimit(torrent.Hash, torrent.Name);
-    }
-}

code/Infrastructure/Verticals/DownloadClient/Transmission/TransmissionService.cs

@@ -1,186 +0,0 @@
-using Common.Configuration.DownloadClient;
-using Common.Configuration.QueueCleaner;
-using Infrastructure.Verticals.ContentBlocker;
-using Infrastructure.Verticals.ItemStriker;
-using Microsoft.Extensions.Logging;
-using Microsoft.Extensions.Options;
-using Transmission.API.RPC;
-using Transmission.API.RPC.Arguments;
-using Transmission.API.RPC.Entity;
-
-namespace Infrastructure.Verticals.DownloadClient.Transmission;
-
-public sealed class TransmissionService : DownloadServiceBase
-{
-    private readonly TransmissionConfig _config;
-    private readonly Client _client;
-    private TorrentInfo[]? _torrentsCache;
-
-    public TransmissionService(
-        ILogger<TransmissionService> logger,
-        IOptions<TransmissionConfig> config,
-        IOptions<QueueCleanerConfig> queueCleanerConfig,
-        FilenameEvaluator filenameEvaluator,
-        Striker striker
-    ) : base(logger, queueCleanerConfig, filenameEvaluator, striker)
-    {
-        _config = config.Value;
-        _config.Validate();
-        _client = new(
-            new Uri(_config.Url, "/transmission/rpc").ToString(),
-            login: _config.Username,
-            password: _config.Password
-        );
-    }
-
-    public override async Task LoginAsync()
-    {
-        await _client.GetSessionInformationAsync();
-    }
-
-    public override async Task<RemoveResult> ShouldRemoveFromArrQueueAsync(string hash)
-    {
-        RemoveResult result = new();
-        TorrentInfo? torrent = await GetTorrentAsync(hash);
-
-        if (torrent is null)
-        {
-            _logger.LogDebug("failed to find torrent {hash} in the download client", hash);
-            return result;
-        }
-        
-        bool shouldRemove = torrent.FileStats?.Length > 0;
-        result.IsPrivate = torrent.IsPrivate ?? false;
-
-        foreach (TransmissionTorrentFileStats? stats in torrent.FileStats ?? [])
-        {
-            if (!stats.Wanted.HasValue)
-            {
-                // if any files stats are missing, do not remove
-                shouldRemove = false;
-            }
-            
-            if (stats.Wanted.HasValue && stats.Wanted.Value)
-            {
-                // if any files are wanted, do not remove
-                shouldRemove = false;
-            }
-        }
-
-        // remove if all files are unwanted or download is stuck
-        result.ShouldRemove = shouldRemove || IsItemStuckAndShouldRemove(torrent);
-        
-        return result;
-    }
-
-    public override async Task BlockUnwantedFilesAsync(string hash)
-    {
-        TorrentInfo? torrent = await GetTorrentAsync(hash);
-
-        if (torrent?.FileStats is null || torrent.Files is null)
-        {
-            return;
-        }
-
-        List<long> unwantedFiles = [];
-        
-        for (int i = 0; i < torrent.Files.Length; i++)
-        {
-            if (torrent.FileStats?[i].Wanted == null)
-            {
-                continue;
-            }
-            
-            if (!torrent.FileStats[i].Wanted.Value || _filenameEvaluator.IsValid(torrent.Files[i].Name))
-            {
-                continue;
-            }
-            
-            _logger.LogInformation("unwanted file found | {file}", torrent.Files[i].Name);
-            unwantedFiles.Add(i);
-        }
-
-        if (unwantedFiles.Count is 0)
-        {
-            return;
-        }
-        
-        _logger.LogDebug("changing priorities | torrent {hash}", hash);
-        
-        await _client.TorrentSetAsync(new TorrentSettings
-        {
-            Ids = [ torrent.Id ],
-            FilesUnwanted = unwantedFiles.ToArray(),
-        });
-    }
-
-    public override void Dispose()
-    {
-    }
-    
-    private bool IsItemStuckAndShouldRemove(TorrentInfo torrent)
-    {
-        if (_queueCleanerConfig.StalledMaxStrikes is 0)
-        {
-            return false;
-        }
-        
-        if (_queueCleanerConfig.StalledIgnorePrivate && (torrent.IsPrivate ?? false))
-        {
-            // ignore private trackers
-            _logger.LogDebug("skip stalled check | download is private | {name}", torrent.Name);
-            return false;
-        }
-        
-        if (torrent.Status is not 4)
-        {
-            // not in downloading state
-            return false;
-        }
-
-        if (torrent.Eta > 0)
-        {
-            return false;
-        }
-
-        return StrikeAndCheckLimit(torrent.HashString!, torrent.Name!);
-    }
-
-    private async Task<TorrentInfo?> GetTorrentAsync(string hash)
-    {
-        TorrentInfo? torrent = _torrentsCache?
-            .FirstOrDefault(x => x.HashString.Equals(hash, StringComparison.InvariantCultureIgnoreCase));
-        
-        if (_torrentsCache is null || torrent is null)
-        {
-            string[] fields = [
-                TorrentFields.FILES,
-                TorrentFields.FILE_STATS,
-                TorrentFields.HASH_STRING,
-                TorrentFields.ID,
-                TorrentFields.ETA,
-                TorrentFields.NAME,
-                TorrentFields.STATUS,
-                TorrentFields.IS_PRIVATE
-            ];
-            
-            // refresh cache
-            _torrentsCache = (await _client.TorrentGetAsync(fields))
-                ?.Torrents;
-        }
-        
-        if (_torrentsCache?.Length is null or 0)
-        {
-            _logger.LogDebug("could not list torrents | {url}", _config.Url);
-        }
-        
-        torrent = _torrentsCache?.FirstOrDefault(x => x.HashString.Equals(hash, StringComparison.InvariantCultureIgnoreCase));
-
-        if (torrent is null)
-        {
-            _logger.LogDebug("could not find torrent | {hash} | {url}", hash, _config.Url);
-        }
-
-        return torrent;
-    }
-}

code/Infrastructure/Verticals/Jobs/GenericHandler.cs

@@ -1,129 +0,0 @@
-using Common.Configuration.Arr;
-using Common.Configuration.DownloadClient;
-using Domain.Enums;
-using Domain.Models.Arr;
-using Domain.Models.Arr.Queue;
-using Infrastructure.Verticals.Arr;
-using Infrastructure.Verticals.DownloadClient;
-using Microsoft.Extensions.Logging;
-using Microsoft.Extensions.Options;
-
-namespace Infrastructure.Verticals.Jobs;
-
-public abstract class GenericHandler : IDisposable
-{
-    protected readonly ILogger<GenericHandler> _logger;
-    protected readonly DownloadClientConfig _downloadClientConfig;
-    protected readonly SonarrConfig _sonarrConfig;
-    protected readonly RadarrConfig _radarrConfig;
-    protected readonly SonarrClient _sonarrClient;
-    protected readonly RadarrClient _radarrClient;
-    protected readonly ArrQueueIterator _arrArrQueueIterator;
-    protected readonly IDownloadService _downloadService;
-
-    protected GenericHandler(
-        ILogger<GenericHandler> logger,
-        IOptions<DownloadClientConfig> downloadClientConfig,
-        SonarrConfig sonarrConfig,
-        RadarrConfig radarrConfig,
-        SonarrClient sonarrClient,
-        RadarrClient radarrClient,
-        ArrQueueIterator arrArrQueueIterator,
-        DownloadServiceFactory downloadServiceFactory
-    )
-    {
-        _logger = logger;
-        _downloadClientConfig = downloadClientConfig.Value;
-        _sonarrConfig = sonarrConfig;
-        _radarrConfig = radarrConfig;
-        _sonarrClient = sonarrClient;
-        _radarrClient = radarrClient;
-        _arrArrQueueIterator = arrArrQueueIterator;
-        _downloadService = downloadServiceFactory.CreateDownloadClient();
-    }
-
-    public virtual async Task ExecuteAsync()
-    {
-        await _downloadService.LoginAsync();
-
-        await ProcessArrConfigAsync(_sonarrConfig, InstanceType.Sonarr);
-        await ProcessArrConfigAsync(_radarrConfig, InstanceType.Radarr);
-    }
-
-    public virtual void Dispose()
-    {
-        _downloadService.Dispose();
-    }
-
-    protected abstract Task ProcessInstanceAsync(ArrInstance instance, InstanceType instanceType);
-    
-    private async Task ProcessArrConfigAsync(ArrConfig config, InstanceType instanceType)
-    {
-        if (!config.Enabled)
-        {
-            return;
-        }
-
-        foreach (ArrInstance arrInstance in config.Instances)
-        {
-            try
-            {
-                await ProcessInstanceAsync(arrInstance, instanceType);
-            }
-            catch (Exception exception)
-            {
-                _logger.LogError(exception, "failed to clean {type} instance | {url}", instanceType, arrInstance.Url);
-            }
-        }
-    }
-    
-    protected ArrClient GetClient(InstanceType type) =>
-        type switch
-        {
-            InstanceType.Sonarr => _sonarrClient,
-            InstanceType.Radarr => _radarrClient,
-            _ => throw new NotImplementedException($"instance type {type} is not yet supported")
-        };
-
-    protected ArrConfig GetConfig(InstanceType type) =>
-        type switch
-        {
-            InstanceType.Sonarr => _sonarrConfig,
-            InstanceType.Radarr => _radarrConfig,
-            _ => throw new NotImplementedException($"instance type {type} is not yet supported")
-        };
-    
-    protected SearchItem GetRecordSearchItem(InstanceType type, QueueRecord record, bool isPack = false)
-    {
-        return type switch
-        {
-            InstanceType.Sonarr when _sonarrConfig.SearchType is SonarrSearchType.Episode && !isPack => new SonarrSearchItem
-            {
-                Id = record.EpisodeId,
-                SeriesId = record.SeriesId,
-                SearchType = SonarrSearchType.Episode
-            },
-            InstanceType.Sonarr when _sonarrConfig.SearchType is SonarrSearchType.Episode && isPack => new SonarrSearchItem
-            {
-                Id = record.SeasonNumber,
-                SeriesId = record.SeriesId,
-                SearchType = SonarrSearchType.Season
-            },
-            InstanceType.Sonarr when _sonarrConfig.SearchType is SonarrSearchType.Season => new SonarrSearchItem
-            {
-                Id = record.SeasonNumber,
-                SeriesId = record.SeriesId,
-                SearchType = SonarrSearchType.Series
-            },
-            InstanceType.Sonarr when _sonarrConfig.SearchType is SonarrSearchType.Series => new SonarrSearchItem
-            {
-                Id = record.SeriesId,
-            },
-            InstanceType.Radarr => new SearchItem
-            {
-                Id = record.MovieId,
-            },
-            _ => throw new NotImplementedException($"instance type {type} is not yet supported")
-        };
-    }
-}

code/Infrastructure/Verticals/QueueCleaner/QueueCleaner.cs

@@ -1,83 +0,0 @@
-using Common.Configuration.Arr;
-using Common.Configuration.DownloadClient;
-using Domain.Enums;
-using Domain.Models.Arr;
-using Domain.Models.Arr.Queue;
-using Infrastructure.Verticals.Arr;
-using Infrastructure.Verticals.DownloadClient;
-using Infrastructure.Verticals.Jobs;
-using Microsoft.Extensions.Logging;
-using Microsoft.Extensions.Options;
-
-namespace Infrastructure.Verticals.QueueCleaner;
-
-public sealed class QueueCleaner : GenericHandler
-{
-    public QueueCleaner(
-        ILogger<QueueCleaner> logger,
-        IOptions<DownloadClientConfig> downloadClientConfig,
-        IOptions<SonarrConfig> sonarrConfig,
-        IOptions<RadarrConfig> radarrConfig,
-        SonarrClient sonarrClient,
-        RadarrClient radarrClient,
-        ArrQueueIterator arrArrQueueIterator,
-        DownloadServiceFactory downloadServiceFactory
-    ) : base(logger, downloadClientConfig, sonarrConfig.Value, radarrConfig.Value, sonarrClient, radarrClient, arrArrQueueIterator, downloadServiceFactory)
-    {
-    }
-    
-    protected override async Task ProcessInstanceAsync(ArrInstance instance, InstanceType instanceType)
-    {
-        HashSet<SearchItem> itemsToBeRefreshed = [];
-        ArrClient arrClient = GetClient(instanceType);
-        ArrConfig arrConfig = GetConfig(instanceType);
-
-        await _arrArrQueueIterator.Iterate(arrClient, instance, async items =>
-        {
-            var groups = items
-                .GroupBy(x => x.DownloadId)
-                .ToList();
-            
-            foreach (var group in groups)
-            {
-                if (group.Any(x => !arrClient.IsRecordValid(x)))
-                {
-                    continue;
-                }
-                
-                QueueRecord record = group.First();
-                
-                if (record.Protocol is not "torrent")
-                {
-                    continue;
-                }
-
-                if (!arrClient.IsRecordValid(record))
-                {
-                    continue;
-                }
-
-                RemoveResult removeResult = new();
-
-                if (_downloadClientConfig.DownloadClient is not Common.Enums.DownloadClient.None)
-                {
-                    removeResult = await _downloadService.ShouldRemoveFromArrQueueAsync(record.DownloadId);
-                }
-                
-                bool shouldRemoveFromArr = arrClient.ShouldRemoveFromQueue(record, removeResult.IsPrivate);
-
-                if (!shouldRemoveFromArr && !removeResult.ShouldRemove)
-                {
-                    _logger.LogInformation("skip | {title}", record.Title);
-                    continue;
-                }
-                
-                itemsToBeRefreshed.Add(GetRecordSearchItem(instanceType, record, group.Count() > 1));
-
-                await arrClient.DeleteQueueItemAsync(instance, record);
-            }
-        });
-        
-        await arrClient.RefreshItemsAsync(instance, arrConfig, itemsToBeRefreshed);
-    }
-}

code/Makefile

@@ -0,0 +1,16 @@
+.DEFAULT_GOAL := no-default
+
+no-default:
+	$(error You must specify a make target)
+
+migrate-data:
+ifndef name
+	$(error name is required. Usage: make migrate-data name=YourMigrationName)
+endif
+	dotnet ef migrations add $(name) --context DataContext --project backend/Cleanuparr.Persistence/Cleanuparr.Persistence.csproj --startup-project backend/Cleanuparr.Api/Cleanuparr.Api.csproj --output-dir Migrations/Data
+
+migrate-events:
+ifndef name
+	$(error name is required. Usage: make migrate-events name=YourMigrationName)
+endif
+	dotnet ef migrations add $(name) --context EventsContext --project backend/Cleanuparr.Persistence/Cleanuparr.Persistence.csproj --startup-project backend/Cleanuparr.Api/Cleanuparr.Api.csproj --output-dir Migrations/Events

code/backend/Cleanuparr.Api/Cleanuparr.Api.csproj

@@ -0,0 +1,49 @@
+<Project Sdk="Microsoft.NET.Sdk.Web">
+
+    <PropertyGroup>
+        <AssemblyName>Cleanuparr</AssemblyName>
+        <Version Condition="'$(Version)' == ''">0.0.1</Version>
+        <TargetFramework>net9.0</TargetFramework>
+        <Nullable>enable</Nullable>
+        <ImplicitUsings>enable</ImplicitUsings>
+        <PublishReadyToRun>true</PublishReadyToRun>
+        <EnableMacOSCodeSign>false</EnableMacOSCodeSign>
+        <CodeSignOnCopy>false</CodeSignOnCopy>
+        <_CodeSignDuringBuild>false</_CodeSignDuringBuild>
+        <CodesignDisableTimestamp>true</CodesignDisableTimestamp>
+        <CodesignKeychain></CodesignKeychain>
+    </PropertyGroup>
+
+    <ItemGroup>
+      <Folder Include="wwwroot\" />
+    </ItemGroup>
+
+    <ItemGroup>
+      <ProjectReference Include="..\Cleanuparr.Application\Cleanuparr.Application.csproj" />
+      <ProjectReference Include="..\Cleanuparr.Infrastructure\Cleanuparr.Infrastructure.csproj" />
+    </ItemGroup>
+
+    <ItemGroup>
+        <PackageReference Include="Microsoft.EntityFrameworkCore.Design" Version="9.0.6">
+          <PrivateAssets>all</PrivateAssets>
+          <IncludeAssets>runtime; build; native; contentfiles; analyzers; buildtransitive</IncludeAssets>
+        </PackageReference>
+        <PackageReference Include="Microsoft.Extensions.Hosting" Version="9.0.6" />
+        <PackageReference Include="Microsoft.Extensions.Hosting.WindowsServices" Version="9.0.6" />
+        <PackageReference Include="Microsoft.Extensions.Http" Version="9.0.6" />
+        <PackageReference Include="Microsoft.Extensions.Http.Polly" Version="9.0.6" />
+        <PackageReference Include="Quartz" Version="3.14.0" />
+        <PackageReference Include="Quartz.Extensions.DependencyInjection" Version="3.14.0" />
+        <PackageReference Include="Quartz.Extensions.Hosting" Version="3.14.0" />
+        <PackageReference Include="Serilog" Version="4.3.0" />
+        <PackageReference Include="Serilog.Expressions" Version="5.0.0" />
+        <PackageReference Include="Serilog.Extensions.Hosting" Version="9.0.0" />
+        <PackageReference Include="Serilog.Settings.Configuration" Version="9.0.0" />
+        <PackageReference Include="Serilog.Sinks.Console" Version="6.0.0" />
+        <PackageReference Include="Serilog.Sinks.File" Version="7.0.0" />
+        <!-- API-related packages -->
+        <PackageReference Include="Microsoft.AspNetCore.OpenApi" Version="9.0.2" />
+        <PackageReference Include="Swashbuckle.AspNetCore" Version="6.5.0" />
+    </ItemGroup>
+
+</Project>

code/backend/Cleanuparr.Api/Controllers/ApiDocumentationController.cs

@@ -0,0 +1,14 @@
+using Microsoft.AspNetCore.Mvc;
+
+namespace Cleanuparr.Api.Controllers;
+
+[ApiController]
+[Route("api")]
+public class ApiDocumentationController : ControllerBase
+{
+    [HttpGet]
+    public IActionResult RedirectToSwagger()
+    {
+        return Redirect("/api/swagger");
+    }
+}

code/backend/Cleanuparr.Api/Controllers/EventsController.cs

@@ -0,0 +1,236 @@
+using System.Text.Json.Serialization;
+using Cleanuparr.Domain.Enums;
+using Cleanuparr.Persistence;
+using Cleanuparr.Persistence.Models.Events;
+using Microsoft.AspNetCore.Mvc;
+using Microsoft.EntityFrameworkCore;
+
+namespace Cleanuparr.Api.Controllers;
+
+[ApiController]
+[Route("api/[controller]")]
+public class EventsController : ControllerBase
+{
+    private readonly EventsContext _context;
+
+    public EventsController(EventsContext context)
+    {
+        _context = context;
+    }
+
+    /// <summary>
+    /// Gets events with pagination and filtering
+    /// </summary>
+    [HttpGet]
+    public async Task<ActionResult<PaginatedResult<AppEvent>>> GetEvents(
+        [FromQuery] int page = 1,
+        [FromQuery] int pageSize = 100,
+        [FromQuery] string? severity = null,
+        [FromQuery] string? eventType = null,
+        [FromQuery] DateTime? fromDate = null,
+        [FromQuery] DateTime? toDate = null,
+        [FromQuery] string? search = null)
+    {
+        // Validate pagination parameters
+        if (page < 1) page = 1;
+        if (pageSize < 1) pageSize = 100;
+        if (pageSize > 1000) pageSize = 1000; // Cap at 1000 for performance
+        
+        var query = _context.Events.AsQueryable();
+
+        // Apply filters
+        if (!string.IsNullOrWhiteSpace(severity))
+        {
+            if (Enum.TryParse<EventSeverity>(severity, true, out var severityEnum))
+                query = query.Where(e => e.Severity == severityEnum);
+        }
+
+        if (!string.IsNullOrWhiteSpace(eventType))
+        {
+            if (Enum.TryParse<EventType>(eventType, true, out var eventTypeEnum))
+                query = query.Where(e => e.EventType == eventTypeEnum);
+        }
+        
+        // Apply date range filters
+        if (fromDate.HasValue)
+        {
+            query = query.Where(e => e.Timestamp >= fromDate.Value);
+        }
+        
+        if (toDate.HasValue)
+        {
+            query = query.Where(e => e.Timestamp <= toDate.Value);
+        }
+
+        // Apply search filter if provided
+        if (!string.IsNullOrWhiteSpace(search))
+        {
+            string pattern = EventsContext.GetLikePattern(search);
+            query = query.Where(e =>
+                EF.Functions.Like(e.Message, pattern) ||
+                EF.Functions.Like(e.Data, pattern) ||
+                EF.Functions.Like(e.TrackingId.ToString(), pattern)
+            );
+        }
+
+        // Count total matching records for pagination
+        var totalCount = await query.CountAsync();
+        
+        // Calculate pagination
+        var totalPages = (int)Math.Ceiling(totalCount / (double)pageSize);
+        var skip = (page - 1) * pageSize;
+        
+        // Get paginated data
+        var events = await query
+            .OrderByDescending(e => e.Timestamp)
+            .Skip(skip)
+            .Take(pageSize)
+            .ToListAsync();
+
+        // Return paginated result
+        var result = new PaginatedResult<AppEvent>
+        {
+            Items = events,
+            Page = page,
+            PageSize = pageSize,
+            TotalCount = totalCount,
+            TotalPages = totalPages
+        };
+        
+        return Ok(result);
+    }
+
+    /// <summary>
+    /// Gets a specific event by ID
+    /// </summary>
+    [HttpGet("{id}")]
+    public async Task<ActionResult<AppEvent>> GetEvent(Guid id)
+    {
+        var eventEntity = await _context.Events.FindAsync(id);
+        
+        if (eventEntity == null)
+            return NotFound();
+
+        return Ok(eventEntity);
+    }
+
+    /// <summary>
+    /// Gets events by tracking ID
+    /// </summary>
+    [HttpGet("tracking/{trackingId}")]
+    public async Task<ActionResult<List<AppEvent>>> GetEventsByTracking(Guid trackingId)
+    {
+        var events = await _context.Events
+            .Where(e => e.TrackingId == trackingId)
+            .OrderBy(e => e.Timestamp)
+            .ToListAsync();
+
+        return Ok(events);
+    }
+
+    /// <summary>
+    /// Gets event statistics
+    /// </summary>
+    [HttpGet("stats")]
+    public async Task<ActionResult<object>> GetEventStats()
+    {
+        var stats = new
+        {
+            TotalEvents = await _context.Events.CountAsync(),
+            EventsBySeverity = await _context.Events
+                .GroupBy(e => e.Severity)
+                .Select(g => new { Severity = g.Key.ToString(), Count = g.Count() })
+                .ToListAsync(),
+            EventsByType = await _context.Events
+                .GroupBy(e => e.EventType)
+                .Select(g => new { EventType = g.Key.ToString(), Count = g.Count() })
+                .OrderByDescending(x => x.Count)
+                .Take(10)
+                .ToListAsync(),
+            RecentEventsCount = await _context.Events
+                .Where(e => e.Timestamp > DateTime.UtcNow.AddHours(-24))
+                .CountAsync()
+        };
+
+        return Ok(stats);
+    }
+
+    /// <summary>
+    /// Manually triggers cleanup of old events
+    /// </summary>
+    [HttpPost("cleanup")]
+    public async Task<ActionResult<object>> CleanupOldEvents([FromQuery] int retentionDays = 30)
+    {
+        var cutoffDate = DateTime.UtcNow.AddDays(-retentionDays);
+        
+        await _context.Events
+            .Where(e => e.Timestamp < cutoffDate)
+            .ExecuteDeleteAsync();
+        
+        return Ok();
+    }
+
+    /// <summary>
+    /// Gets unique event types
+    /// </summary>
+    [HttpGet("types")]
+    public async Task<ActionResult<List<string>>> GetEventTypes()
+    {
+        var types = Enum.GetNames(typeof(EventType)).ToList();
+        return Ok(types);
+    }
+
+    /// <summary>
+    /// Gets unique severities
+    /// </summary>
+    [HttpGet("severities")]
+    public async Task<ActionResult<List<string>>> GetSeverities()
+    {
+        var severities = Enum.GetNames(typeof(EventSeverity)).ToList();
+        return Ok(severities);
+    }
+} 
+
+/// <summary>
+/// Represents a paginated result set
+/// </summary>
+/// <typeparam name="T">Type of items in the result</typeparam>
+public class PaginatedResult<T>
+{
+    /// <summary>
+    /// The items in the current page
+    /// </summary>
+    public List<T> Items { get; set; } = new();
+    
+    /// <summary>
+    /// Current page number (1-based)
+    /// </summary>
+    public int Page { get; set; }
+    
+    /// <summary>
+    /// Number of items per page
+    /// </summary>
+    public int PageSize { get; set; }
+    
+    /// <summary>
+    /// Total number of items across all pages
+    /// </summary>
+    public int TotalCount { get; set; }
+    
+    /// <summary>
+    /// Total number of pages
+    /// </summary>
+    public int TotalPages { get; set; }
+    
+    /// <summary>
+    /// Whether there is a previous page
+    /// </summary>
+    [JsonIgnore]
+    public bool HasPrevious => Page > 1;
+    
+    /// <summary>
+    /// Whether there is a next page
+    /// </summary>
+    [JsonIgnore]
+    public bool HasNext => Page < TotalPages;
+}

code/backend/Cleanuparr.Api/Controllers/HealthCheckController.cs

@@ -0,0 +1,103 @@
+using Cleanuparr.Infrastructure.Health;
+using Microsoft.AspNetCore.Mvc;
+
+namespace Cleanuparr.Api.Controllers;
+
+/// <summary>
+/// Controller for checking the health of download clients
+/// </summary>
+[ApiController]
+[Route("api/health")]
+public class HealthCheckController : ControllerBase
+{
+    private readonly ILogger<HealthCheckController> _logger;
+    private readonly IHealthCheckService _healthCheckService;
+
+    /// <summary>
+    /// Initializes a new instance of the <see cref="HealthCheckController"/> class
+    /// </summary>
+    public HealthCheckController(
+        ILogger<HealthCheckController> logger,
+        IHealthCheckService healthCheckService)
+    {
+        _logger = logger;
+        _healthCheckService = healthCheckService;
+    }
+
+    /// <summary>
+    /// Gets the health status of all download clients
+    /// </summary>
+    [HttpGet]
+    public IActionResult GetAllHealth()
+    {
+        try
+        {
+            var healthStatuses = _healthCheckService.GetAllClientHealth();
+            return Ok(healthStatuses);
+        }
+        catch (Exception ex)
+        {
+            _logger.LogError(ex, "Error retrieving client health statuses");
+            return StatusCode(500, new { Error = "An error occurred while retrieving client health statuses" });
+        }
+    }
+
+    /// <summary>
+    /// Gets the health status of a specific download client
+    /// </summary>
+    [HttpGet("{id:guid}")]
+    public IActionResult GetClientHealth(Guid id)
+    {
+        try
+        {
+            var healthStatus = _healthCheckService.GetClientHealth(id);
+            if (healthStatus == null)
+            {
+                return NotFound(new { Message = $"Health status for client with ID '{id}' not found" });
+            }
+
+            return Ok(healthStatus);
+        }
+        catch (Exception ex)
+        {
+            _logger.LogError(ex, "Error retrieving health status for client {id}", id);
+            return StatusCode(500, new { Error = "An error occurred while retrieving the client health status" });
+        }
+    }
+
+    /// <summary>
+    /// Triggers a health check for all download clients
+    /// </summary>
+    [HttpPost("check")]
+    public async Task<IActionResult> CheckAllHealth()
+    {
+        try
+        {
+            var results = await _healthCheckService.CheckAllClientsHealthAsync();
+            return Ok(results);
+        }
+        catch (Exception ex)
+        {
+            _logger.LogError(ex, "Error checking health for all clients");
+            return StatusCode(500, new { Error = "An error occurred while checking client health" });
+        }
+    }
+
+    /// <summary>
+    /// Triggers a health check for a specific download client
+    /// </summary>
+    [HttpPost("check/{id:guid}")]
+    public async Task<IActionResult> CheckClientHealth(Guid id)
+    {
+        try
+        {
+            var result = await _healthCheckService.CheckClientHealthAsync(id);
+            return Ok(result);
+        }
+        catch (Exception ex)
+        {
+            _logger.LogError(ex, "Error checking health for client {id}", id);
+            return StatusCode(500, new { Error = "An error occurred while checking client health" });
+        }
+    }
+}

code/backend/Cleanuparr.Api/Controllers/HealthController.cs

@@ -0,0 +1,125 @@
+using Microsoft.AspNetCore.Mvc;
+using Microsoft.Extensions.Diagnostics.HealthChecks;
+
+namespace Cleanuparr.Api.Controllers;
+
+/// <summary>
+/// Health check endpoints for Docker and Kubernetes
+/// </summary>
+[ApiController]
+[Route("[controller]")]
+public class HealthController : ControllerBase
+{
+    private readonly HealthCheckService _healthCheckService;
+    private readonly ILogger<HealthController> _logger;
+
+    public HealthController(HealthCheckService healthCheckService, ILogger<HealthController> logger)
+    {
+        _healthCheckService = healthCheckService;
+        _logger = logger;
+    }
+
+    /// <summary>
+    /// Basic liveness probe - checks if the application is running
+    /// Used by Docker HEALTHCHECK and Kubernetes liveness probes
+    /// </summary>
+    [HttpGet]
+    [Route("/health")]
+    public async Task<IActionResult> GetHealth()
+    {
+        try
+        {
+            var result = await _healthCheckService.CheckHealthAsync(
+                registration => registration.Tags.Contains("liveness"));
+            
+            return result.Status == HealthStatus.Healthy 
+                ? Ok(new { status = "healthy", timestamp = DateTime.UtcNow })
+                : StatusCode(503, new { status = "unhealthy", timestamp = DateTime.UtcNow });
+        }
+        catch (Exception ex)
+        {
+            _logger.LogError(ex, "Health check failed");
+            return StatusCode(503, new { status = "unhealthy", error = "Health check failed", timestamp = DateTime.UtcNow });
+        }
+    }
+
+    /// <summary>
+    /// Readiness probe - checks if the application is ready to serve traffic
+    /// Used by Kubernetes readiness probes
+    /// </summary>
+    [HttpGet]
+    [Route("/health/ready")]
+    public async Task<IActionResult> GetReadiness()
+    {
+        try
+        {
+            var result = await _healthCheckService.CheckHealthAsync(
+                registration => registration.Tags.Contains("readiness"));
+            
+            if (result.Status == HealthStatus.Healthy)
+            {
+                return Ok(new { status = "ready", timestamp = DateTime.UtcNow });
+            }
+            
+            // For readiness, we consider degraded as not ready
+            return StatusCode(503, new { 
+                status = "not_ready", 
+                timestamp = DateTime.UtcNow,
+                details = result.Entries.Where(e => e.Value.Status != HealthStatus.Healthy)
+                    .ToDictionary(e => e.Key, e => new { 
+                        status = e.Value.Status.ToString().ToLowerInvariant(),
+                        description = e.Value.Description 
+                    })
+            });
+        }
+        catch (Exception ex)
+        {
+            _logger.LogError(ex, "Readiness check failed");
+            return StatusCode(503, new { status = "not_ready", error = "Readiness check failed", timestamp = DateTime.UtcNow });
+        }
+    }
+
+    /// <summary>
+    /// Detailed health status - for monitoring and debugging
+    /// </summary>
+    [HttpGet]
+    [Route("/health/detailed")]
+    public async Task<IActionResult> GetDetailedHealth()
+    {
+        try
+        {
+            var result = await _healthCheckService.CheckHealthAsync();
+            
+            var response = new
+            {
+                status = result.Status.ToString().ToLowerInvariant(),
+                timestamp = DateTime.UtcNow,
+                totalDuration = result.TotalDuration.TotalMilliseconds,
+                entries = result.Entries.ToDictionary(
+                    e => e.Key,
+                    e => new
+                    {
+                        status = e.Value.Status.ToString().ToLowerInvariant(),
+                        description = e.Value.Description,
+                        duration = e.Value.Duration.TotalMilliseconds,
+                        tags = e.Value.Tags,
+                        data = e.Value.Data,
+                        exception = e.Value.Exception?.Message
+                    })
+            };
+
+            return result.Status == HealthStatus.Healthy 
+                ? Ok(response)
+                : StatusCode(503, response);
+        }
+        catch (Exception ex)
+        {
+            _logger.LogError(ex, "Detailed health check failed");
+            return StatusCode(503, new { 
+                status = "unhealthy", 
+                error = "Detailed health check failed", 
+                timestamp = DateTime.UtcNow 
+            });
+        }
+    }
+} 

code/backend/Cleanuparr.Api/Controllers/JobsController.cs

@@ -0,0 +1,163 @@
+using Cleanuparr.Api.Models;
+using Cleanuparr.Infrastructure.Models;
+using Cleanuparr.Infrastructure.Services.Interfaces;
+using Microsoft.AspNetCore.Mvc;
+
+namespace Cleanuparr.Api.Controllers;
+
+[ApiController]
+[Route("api/[controller]")]
+public class JobsController : ControllerBase
+{
+    private readonly IJobManagementService _jobManagementService;
+    private readonly ILogger<JobsController> _logger;
+
+    public JobsController(IJobManagementService jobManagementService, ILogger<JobsController> logger)
+    {
+        _jobManagementService = jobManagementService;
+        _logger = logger;
+    }
+
+    [HttpGet]
+    public async Task<IActionResult> GetAllJobs()
+    {
+        try
+        {
+            var result = await _jobManagementService.GetAllJobs();
+            return Ok(result);
+        }
+        catch (Exception ex)
+        {
+            _logger.LogError(ex, "Error getting all jobs");
+            return StatusCode(500, "An error occurred while retrieving jobs");
+        }
+    }
+
+    [HttpGet("{jobType}")]
+    public async Task<IActionResult> GetJob(JobType jobType)
+    {
+        try
+        {
+            var jobInfo = await _jobManagementService.GetJob(jobType);
+            
+            if (jobInfo.Status == "Not Found")
+            {
+                return NotFound($"Job '{jobType}' not found");
+            }
+            return Ok(jobInfo);
+        }
+        catch (Exception ex)
+        {
+            _logger.LogError(ex, "Error getting job {jobType}", jobType);
+            return StatusCode(500, $"An error occurred while retrieving job '{jobType}'");
+        }
+    }
+
+    [HttpPost("{jobType}/start")]
+    public async Task<IActionResult> StartJob(JobType jobType, [FromBody] ScheduleRequest scheduleRequest = null)
+    {
+        try
+        {
+            // Get the schedule from the request body if provided
+            JobSchedule jobSchedule = scheduleRequest.Schedule;
+            
+            var result = await _jobManagementService.StartJob(jobType, jobSchedule);
+            
+            if (!result)
+            {
+                return BadRequest($"Failed to start job '{jobType}'");
+            }
+            return Ok(new { Message = $"Job '{jobType}' started successfully" });
+        }
+        catch (Exception ex)
+        {
+            _logger.LogError(ex, "Error starting job {jobType}", jobType);
+            return StatusCode(500, $"An error occurred while starting job '{jobType}'");
+        }
+    }
+
+    [HttpPost("{jobType}/stop")]
+    public async Task<IActionResult> StopJob(JobType jobType)
+    {
+        try
+        {
+            var result = await _jobManagementService.StopJob(jobType);
+            
+            if (!result)
+            {
+                return BadRequest($"Failed to stop job '{jobType}'");
+            }
+            return Ok(new { Message = $"Job '{jobType}' stopped successfully" });
+        }
+        catch (Exception ex)
+        {
+            _logger.LogError(ex, "Error stopping job {jobType}", jobType);
+            return StatusCode(500, $"An error occurred while stopping job '{jobType}'");
+        }
+    }
+
+    [HttpPost("{jobType}/pause")]
+    public async Task<IActionResult> PauseJob(JobType jobType)
+    {
+        try
+        {
+            var result = await _jobManagementService.PauseJob(jobType);
+            
+            if (!result)
+            {
+                return BadRequest($"Failed to pause job '{jobType}'");
+            }
+            return Ok(new { Message = $"Job '{jobType}' paused successfully" });
+        }
+        catch (Exception ex)
+        {
+            _logger.LogError(ex, "Error pausing job {jobType}", jobType);
+            return StatusCode(500, $"An error occurred while pausing job '{jobType}'");
+        }
+    }
+
+    [HttpPost("{jobType}/resume")]
+    public async Task<IActionResult> ResumeJob(JobType jobType)
+    {
+        try
+        {
+            var result = await _jobManagementService.ResumeJob(jobType);
+            
+            if (!result)
+            {
+                return BadRequest($"Failed to resume job '{jobType}'");
+            }
+            return Ok(new { Message = $"Job '{jobType}' resumed successfully" });
+        }
+        catch (Exception ex)
+        {
+            _logger.LogError(ex, "Error resuming job {jobType}", jobType);
+            return StatusCode(500, $"An error occurred while resuming job '{jobType}'");
+        }
+    }
+
+    [HttpPut("{jobType}/schedule")]
+    public async Task<IActionResult> UpdateJobSchedule(JobType jobType, [FromBody] ScheduleRequest scheduleRequest)
+    {
+        if (scheduleRequest?.Schedule == null)
+        {
+            return BadRequest("Schedule is required");
+        }
+
+        try
+        {
+            var result = await _jobManagementService.UpdateJobSchedule(jobType, scheduleRequest.Schedule);
+            
+            if (!result)
+            {
+                return BadRequest($"Failed to update schedule for job '{jobType}'");
+            }
+            return Ok(new { Message = $"Job '{jobType}' schedule updated successfully" });
+        }
+        catch (Exception ex)
+        {
+            _logger.LogError(ex, "Error updating job {jobType} schedule", jobType);
+            return StatusCode(500, $"An error occurred while updating schedule for job '{jobType}'");
+        }
+    }
+}

code/backend/Cleanuparr.Api/Controllers/StatusController.cs

@@ -0,0 +1,278 @@
+using System.Diagnostics;
+using Cleanuparr.Domain.Enums;
+using Cleanuparr.Infrastructure.Features.Arr;
+using Cleanuparr.Infrastructure.Features.DownloadClient;
+using Cleanuparr.Persistence;
+using Microsoft.AspNetCore.Mvc;
+using Microsoft.EntityFrameworkCore;
+
+namespace Cleanuparr.Api.Controllers;
+
+[ApiController]
+[Route("api/[controller]")]
+public class StatusController : ControllerBase
+{
+    private readonly ILogger<StatusController> _logger;
+    private readonly DataContext _dataContext;
+    private readonly DownloadServiceFactory _downloadServiceFactory;
+    private readonly ArrClientFactory _arrClientFactory;
+
+    public StatusController(
+        ILogger<StatusController> logger,
+        DataContext dataContext,
+        DownloadServiceFactory downloadServiceFactory,
+        ArrClientFactory arrClientFactory)
+    {
+        _logger = logger;
+        _dataContext = dataContext;
+        _downloadServiceFactory = downloadServiceFactory;
+        _arrClientFactory = arrClientFactory;
+    }
+
+    [HttpGet]
+    public async Task<IActionResult> GetSystemStatus()
+    {
+        try
+        {
+            var process = Process.GetCurrentProcess();
+            
+            // Get configuration
+            var downloadClients = await _dataContext.DownloadClients
+                .AsNoTracking()
+                .ToListAsync();
+            var sonarrConfig = await _dataContext.ArrConfigs
+                .Include(x => x.Instances)
+                .AsNoTracking()
+                .FirstAsync(x => x.Type == InstanceType.Sonarr);
+            var radarrConfig = await _dataContext.ArrConfigs
+                .Include(x => x.Instances)
+                .AsNoTracking()
+                .FirstAsync(x => x.Type == InstanceType.Radarr);
+            var lidarrConfig = await _dataContext.ArrConfigs
+                .Include(x => x.Instances)
+                .AsNoTracking()
+                .FirstAsync(x => x.Type == InstanceType.Lidarr);
+            var readarrConfig = await _dataContext.ArrConfigs
+                .Include(x => x.Instances)
+                .AsNoTracking()
+                .FirstAsync(x => x.Type == InstanceType.Readarr);
+            
+            var status = new
+            {
+                Application = new
+                {
+                    Version = GetType().Assembly.GetName().Version?.ToString() ?? "Unknown",
+                    process.StartTime,
+                    UpTime = DateTime.Now - process.StartTime,
+                    MemoryUsageMB = Math.Round(process.WorkingSet64 / 1024.0 / 1024.0, 2),
+                    ProcessorTime = process.TotalProcessorTime
+                },
+                DownloadClient = new
+                {
+                    // TODO
+                },
+                MediaManagers = new
+                {
+                    Sonarr = new
+                    {
+                        InstanceCount = sonarrConfig.Instances.Count
+                    },
+                    Radarr = new
+                    {
+                        InstanceCount = radarrConfig.Instances.Count
+                    },
+                    Lidarr = new
+                    {
+                        InstanceCount = lidarrConfig.Instances.Count
+                    },
+                    Readarr = new
+                    {
+                        InstanceCount = readarrConfig.Instances.Count
+                    }
+                }
+            };
+
+            return Ok(status);
+        }
+        catch (Exception ex)
+        {
+            _logger.LogError(ex, "Error retrieving system status");
+            return StatusCode(500, "An error occurred while retrieving system status");
+        }
+    }
+
+    [HttpGet("download-client")]
+    public async Task<IActionResult> GetDownloadClientStatus()
+    {
+        try
+        {
+            var downloadClients = await _dataContext.DownloadClients
+                .AsNoTracking()
+                .ToListAsync();
+            var result = new Dictionary<string, object>();
+            
+            // Check for configured clients
+            if (downloadClients.Count > 0)
+            {
+                var clientsStatus = new List<object>();
+                foreach (var client in downloadClients)
+                {
+                    clientsStatus.Add(new
+                    {
+                        client.Id,
+                        client.Name,
+                        Type = client.TypeName,
+                        client.Host,
+                        client.Enabled,
+                        IsConnected = client.Enabled, // We can't check connection status without implementing test methods
+                    });
+                }
+                
+                result["Clients"] = clientsStatus;
+            }
+
+            return Ok(result);
+        }
+        catch (Exception ex)
+        {
+            _logger.LogError(ex, "Error retrieving download client status");
+            return StatusCode(500, "An error occurred while retrieving download client status");
+        }
+    }
+
+    [HttpGet("arrs")]
+    public async Task<IActionResult> GetMediaManagersStatus()
+    {
+        try
+        {
+            var status = new Dictionary<string, object>();
+            
+            // Get configurations
+            var enabledSonarrInstances = await _dataContext.ArrConfigs
+                .Include(x => x.Instances)
+                .Where(x => x.Type == InstanceType.Sonarr)
+                .SelectMany(x => x.Instances)
+                .Where(x => x.Enabled)
+                .AsNoTracking()
+                .ToListAsync();
+            var enabledRadarrInstances = await _dataContext.ArrConfigs
+                .Include(x => x.Instances)
+                .Where(x => x.Type == InstanceType.Radarr)
+                .SelectMany(x => x.Instances)
+                .Where(x => x.Enabled)
+                .AsNoTracking()
+                .ToListAsync();
+            var enabledLidarrInstances = await _dataContext.ArrConfigs
+                .Include(x => x.Instances)
+                .Where(x => x.Type == InstanceType.Lidarr)
+                .SelectMany(x => x.Instances)
+                .Where(x => x.Enabled)
+                .AsNoTracking()
+                .ToListAsync();;
+
+            
+            // Check Sonarr instances
+            var sonarrStatus = new List<object>();
+            
+            foreach (var instance in enabledSonarrInstances)
+            {
+                try
+                {
+                    var sonarrClient = _arrClientFactory.GetClient(InstanceType.Sonarr);
+                    await sonarrClient.TestConnectionAsync(instance);
+                    
+                    sonarrStatus.Add(new
+                    {
+                        instance.Name,
+                        instance.Url,
+                        IsConnected = true,
+                        Message = "Successfully connected"
+                    });
+                }
+                catch (Exception ex)
+                {
+                    sonarrStatus.Add(new
+                    {
+                        instance.Name,
+                        instance.Url,
+                        IsConnected = false,
+                        Message = $"Connection failed: {ex.Message}"
+                    });
+                }
+            }
+
+            status["Sonarr"] = sonarrStatus;
+
+            // Check Radarr instances
+            var radarrStatus = new List<object>();
+            
+            foreach (var instance in enabledRadarrInstances)
+            {
+                try
+                {
+                    var radarrClient = _arrClientFactory.GetClient(InstanceType.Radarr);
+                    await radarrClient.TestConnectionAsync(instance);
+                    
+                    radarrStatus.Add(new
+                    {
+                        instance.Name,
+                        instance.Url,
+                        IsConnected = true,
+                        Message = "Successfully connected"
+                    });
+                }
+                catch (Exception ex)
+                {
+                    radarrStatus.Add(new
+                    {
+                        instance.Name,
+                        instance.Url,
+                        IsConnected = false,
+                        Message = $"Connection failed: {ex.Message}"
+                    });
+                }
+            }
+
+            status["Radarr"] = radarrStatus;
+
+            // Check Lidarr instances
+            var lidarrStatus = new List<object>();
+            
+            foreach (var instance in enabledLidarrInstances)
+            {
+                try
+                {
+                    var lidarrClient = _arrClientFactory.GetClient(InstanceType.Lidarr);
+                    await lidarrClient.TestConnectionAsync(instance);
+                    
+                    lidarrStatus.Add(new
+                    {
+                        instance.Name,
+                        instance.Url,
+                        IsConnected = true,
+                        Message = "Successfully connected"
+                    });
+                }
+                catch (Exception ex)
+                {
+                    lidarrStatus.Add(new
+                    {
+                        instance.Name,
+                        instance.Url,
+                        IsConnected = false,
+                        Message = $"Connection failed: {ex.Message}"
+                    });
+                }
+            }
+
+            status["Lidarr"] = lidarrStatus;
+
+            return Ok(status);
+        }
+        catch (Exception ex)
+        {
+            _logger.LogError(ex, "Error retrieving media managers status");
+            return StatusCode(500, "An error occurred while retrieving media managers status");
+        }
+    }
+}

code/backend/Cleanuparr.Api/DependencyInjection/ApiDI.cs

@@ -0,0 +1,177 @@
+using System.Text.Json.Serialization;
+using Cleanuparr.Api.Middleware;
+using Cleanuparr.Infrastructure.Health;
+using Cleanuparr.Infrastructure.Hubs;
+using Cleanuparr.Infrastructure.Logging;
+using Microsoft.AspNetCore.Http.Json;
+using Microsoft.OpenApi.Models;
+using System.Text;
+
+namespace Cleanuparr.Api.DependencyInjection;
+
+public static class ApiDI
+{
+    public static IServiceCollection AddApiServices(this IServiceCollection services)
+    {
+        services.Configure<JsonOptions>(options =>
+        {
+            options.SerializerOptions.Converters.Add(new JsonStringEnumConverter());
+            options.SerializerOptions.ReferenceHandler = ReferenceHandler.IgnoreCycles;
+        });
+        
+        // Add API-specific services
+        services
+            .AddControllers()
+            .AddJsonOptions(options =>
+            {
+                options.JsonSerializerOptions.Converters.Add(new JsonStringEnumConverter());
+                options.JsonSerializerOptions.ReferenceHandler = ReferenceHandler.IgnoreCycles;
+            });
+        services.AddEndpointsApiExplorer();
+        
+        // Add SignalR for real-time updates
+        services
+            .AddSignalR()
+            .AddJsonProtocol(options =>
+            {
+                options.PayloadSerializerOptions.Converters.Add(new JsonStringEnumConverter());
+            });
+        
+        // Add health status broadcaster
+        services.AddHostedService<HealthStatusBroadcaster>();
+        
+        services.AddSwaggerGen(options =>
+        {
+            options.SwaggerDoc("v1", new OpenApiInfo
+            {
+                Title = "Cleanuparr API",
+                Version = "v1",
+                Description = "API for managing media downloads and cleanups",
+                Contact = new OpenApiContact
+                {
+                    Name = "Cleanuparr Team"
+                }
+            });
+        });
+
+        return services;
+    }
+
+    public static WebApplication ConfigureApi(this WebApplication app)
+    {
+        ILogger<Program> logger = app.Services.GetRequiredService<ILogger<Program>>();
+        
+        // Enable compression
+        app.UseResponseCompression();
+        
+        // Serve static files with caching
+        app.UseStaticFiles(new StaticFileOptions
+        {
+            OnPrepareResponse = ctx =>
+            {
+                // Cache static assets for 30 days
+                // if (ctx.File.Name.EndsWith(".js") || ctx.File.Name.EndsWith(".css"))
+                // {
+                //     ctx.Context.Response.Headers.CacheControl = "public,max-age=2592000";
+                // }
+            }
+        });
+        
+        // Add the global exception handling middleware first
+        app.UseMiddleware<ExceptionMiddleware>();
+        
+        app.UseCors("Any");
+        app.UseRouting();
+
+        if (app.Environment.IsDevelopment())
+        {
+            app.UseSwagger();
+            app.UseSwaggerUI(options =>
+            {
+                options.SwaggerEndpoint("v1/swagger.json", "Cleanuparr API v1");
+                options.RoutePrefix = "swagger";
+                options.DocumentTitle = "Cleanuparr API Documentation";
+            });
+        }
+
+        app.UseAuthorization();
+        app.MapControllers();
+        
+        // Custom SPA fallback to inject base path
+        app.MapFallback(async context =>
+        {
+            var basePath = app.Configuration.GetValue<string>("BASE_PATH") ?? "/";
+            
+            // Normalize the base path (remove trailing slash if not root)
+            if (basePath != "/" && basePath.EndsWith("/"))
+            {
+                basePath = basePath.TrimEnd('/');
+            }
+            
+            var webRoot = app.Environment.WebRootPath ?? Path.Combine(app.Environment.ContentRootPath, "wwwroot");
+            var indexPath = Path.Combine(webRoot, "index.html");
+            
+            if (!File.Exists(indexPath))
+            {
+                context.Response.StatusCode = 404;
+                await context.Response.WriteAsync("index.html not found");
+                return;
+            }
+            
+            var indexContent = await File.ReadAllTextAsync(indexPath);
+            
+            // Inject the base path into the HTML
+            var scriptInjection = $@"
+    <script>
+      window['_server_base_path'] = '{basePath}';
+    </script>";
+            
+            // Insert the script right before the existing script tag
+            indexContent = indexContent.Replace(
+                "  <script>",
+                scriptInjection + "\n  <script>"
+            );
+            
+            context.Response.ContentType = "text/html";
+            await context.Response.WriteAsync(indexContent, Encoding.UTF8);
+        });
+        
+        // Map SignalR hubs
+        app.MapHub<HealthStatusHub>("/api/hubs/health");
+        app.MapHub<AppHub>("/api/hubs/app");
+        
+        app.MapGet("/manifest.webmanifest", (HttpContext context) =>
+        {
+            var basePath = context.Request.PathBase.HasValue
+                ? context.Request.PathBase.Value
+                : "/";
+
+            var manifest = new
+            {
+                name = "Cleanuparr",
+                short_name = "Cleanuparr",
+                start_url = basePath,
+                display = "standalone",
+                background_color = "#ffffff",
+                theme_color = "#ffffff",
+                icons = new[]
+                {
+                    new {
+                        src = "assets/icons/icon-192x192.png",
+                        sizes = "192x192",
+                        type = "image/png"
+                    },
+                    new {
+                        src = "assets/icons/icon-512x512.png",
+                        sizes = "512x512",
+                        type = "image/png"
+                    }
+                }
+            };
+
+            return Results.Json(manifest, contentType: "application/manifest+json");
+        });
+
+        return app;
+    }
+}

code/backend/Cleanuparr.Api/DependencyInjection/LoggingDI.cs

@@ -0,0 +1,16 @@
+using Cleanuparr.Infrastructure.Logging;
+using Serilog;
+
+namespace Cleanuparr.Api.DependencyInjection;
+
+public static class LoggingDI
+{
+    public static ILoggingBuilder AddLogging(this ILoggingBuilder builder)
+    {
+        Log.Logger = LoggingConfigManager
+            .CreateLoggerConfiguration()
+            .CreateLogger();
+        
+        return builder.ClearProviders().AddSerilog();
+    }
+}

code/backend/Cleanuparr.Api/DependencyInjection/MainDI.cs

@@ -0,0 +1,114 @@
+using System.Text.Json.Serialization;
+using Cleanuparr.Domain.Entities.Arr;
+using Cleanuparr.Infrastructure.Features.DownloadHunter.Consumers;
+using Cleanuparr.Infrastructure.Features.DownloadRemover.Consumers;
+using Cleanuparr.Infrastructure.Features.Notifications.Consumers;
+using Cleanuparr.Infrastructure.Features.Notifications.Models;
+using Cleanuparr.Infrastructure.Health;
+using Cleanuparr.Infrastructure.Http;
+using Cleanuparr.Infrastructure.Http.DynamicHttpClientSystem;
+using Data.Models.Arr;
+using MassTransit;
+using Microsoft.Extensions.Caching.Memory;
+
+namespace Cleanuparr.Api.DependencyInjection;
+
+public static class MainDI
+{
+    public static IServiceCollection AddInfrastructure(this IServiceCollection services, IConfiguration configuration) =>
+        services
+            .AddHttpClients(configuration)
+            .AddSingleton<MemoryCache>()
+            .AddSingleton<IMemoryCache>(serviceProvider => serviceProvider.GetRequiredService<MemoryCache>())
+            .AddServices()
+            .AddHealthServices()
+            .AddQuartzServices(configuration)
+            .AddNotifications()
+            .AddMassTransit(config =>
+            {
+                config.DisableUsageTelemetry();
+                
+                config.AddConsumer<DownloadRemoverConsumer<SearchItem>>();
+                config.AddConsumer<DownloadRemoverConsumer<SeriesSearchItem>>();
+                config.AddConsumer<DownloadHunterConsumer<SearchItem>>();
+                config.AddConsumer<DownloadHunterConsumer<SeriesSearchItem>>();
+                
+                config.AddConsumer<NotificationConsumer<FailedImportStrikeNotification>>();
+                config.AddConsumer<NotificationConsumer<StalledStrikeNotification>>();
+                config.AddConsumer<NotificationConsumer<SlowSpeedStrikeNotification>>();
+                config.AddConsumer<NotificationConsumer<SlowTimeStrikeNotification>>();
+                config.AddConsumer<NotificationConsumer<QueueItemDeletedNotification>>();
+                config.AddConsumer<NotificationConsumer<DownloadCleanedNotification>>();
+                config.AddConsumer<NotificationConsumer<CategoryChangedNotification>>();
+
+                config.UsingInMemory((context, cfg) =>
+                {
+                    cfg.ConfigureJsonSerializerOptions(options =>
+                    {
+                        options.Converters.Add(new JsonStringEnumConverter());
+                        options.ReferenceHandler = ReferenceHandler.IgnoreCycles;
+
+                        return options;
+                    });
+                    
+                    cfg.ReceiveEndpoint("download-remover-queue", e =>
+                    {
+                        e.ConfigureConsumer<DownloadRemoverConsumer<SearchItem>>(context);
+                        e.ConfigureConsumer<DownloadRemoverConsumer<SeriesSearchItem>>(context);
+                        e.ConcurrentMessageLimit = 2;
+                        e.PrefetchCount = 2;
+                    });
+                    
+                    cfg.ReceiveEndpoint("download-hunter-queue", e =>
+                    {
+                        e.ConfigureConsumer<DownloadHunterConsumer<SearchItem>>(context);
+                        e.ConfigureConsumer<DownloadHunterConsumer<SeriesSearchItem>>(context);
+                        e.ConcurrentMessageLimit = 1;
+                        e.PrefetchCount = 1;
+                    });
+                    
+                    cfg.ReceiveEndpoint("notification-queue", e =>
+                    {
+                        e.ConfigureConsumer<NotificationConsumer<FailedImportStrikeNotification>>(context);
+                        e.ConfigureConsumer<NotificationConsumer<StalledStrikeNotification>>(context);
+                        e.ConfigureConsumer<NotificationConsumer<SlowSpeedStrikeNotification>>(context);
+                        e.ConfigureConsumer<NotificationConsumer<SlowTimeStrikeNotification>>(context);
+                        e.ConfigureConsumer<NotificationConsumer<QueueItemDeletedNotification>>(context);
+                        e.ConfigureConsumer<NotificationConsumer<DownloadCleanedNotification>>(context);
+                        e.ConfigureConsumer<NotificationConsumer<CategoryChangedNotification>>(context);
+                        e.ConcurrentMessageLimit = 1;
+                        e.PrefetchCount = 1;
+                    });
+                });
+            });
+    
+    private static IServiceCollection AddHttpClients(this IServiceCollection services, IConfiguration configuration)
+    {
+        // Add the dynamic HTTP client system - this replaces all the previous static configurations
+        services.AddDynamicHttpClients();
+        
+        // Add the dynamic HTTP client provider that uses the new system
+        services.AddSingleton<IDynamicHttpClientProvider, DynamicHttpClientProvider>();
+        
+        return services;
+    }
+
+    /// <summary>
+    /// Adds health check services to the service collection
+    /// </summary>
+    private static IServiceCollection AddHealthServices(this IServiceCollection services) =>
+        services
+            // Register the existing health check service for download clients
+            .AddSingleton<IHealthCheckService, HealthCheckService>()
+            
+            // Register the background service for periodic health checks
+            .AddHostedService<HealthCheckBackgroundService>()
+            
+            // Add ASP.NET Core health checks
+            .AddHealthChecks()
+                .AddCheck<ApplicationHealthCheck>("application", tags: ["liveness"])
+                .AddCheck<DatabaseHealthCheck>("database", tags: ["readiness"])
+                .AddCheck<FileSystemHealthCheck>("filesystem", tags: ["readiness"])
+                .AddCheck<DownloadClientsHealthCheck>("download_clients", tags: ["readiness"])
+            .Services;
+}

code/backend/Cleanuparr.Api/DependencyInjection/NotificationsDI.cs

@@ -0,0 +1,20 @@
+using Cleanuparr.Infrastructure.Features.Notifications;
+using Cleanuparr.Infrastructure.Features.Notifications.Apprise;
+using Cleanuparr.Infrastructure.Features.Notifications.Notifiarr;
+using Cleanuparr.Infrastructure.Features.Notifications.Ntfy;
+
+namespace Cleanuparr.Api.DependencyInjection;
+
+public static class NotificationsDI
+{
+    public static IServiceCollection AddNotifications(this IServiceCollection services) =>
+        services
+            .AddScoped<INotifiarrProxy, NotifiarrProxy>()
+            .AddScoped<IAppriseProxy, AppriseProxy>()
+            .AddScoped<INtfyProxy, NtfyProxy>()
+            .AddScoped<INotificationConfigurationService, NotificationConfigurationService>()
+            .AddScoped<INotificationProviderFactory, NotificationProviderFactory>()
+            .AddScoped<NotificationProviderFactory>()
+            .AddScoped<INotificationPublisher, NotificationPublisher>()
+            .AddScoped<NotificationService>();
+}

code/backend/Cleanuparr.Api/DependencyInjection/QuartzDI.cs

@@ -0,0 +1,20 @@
+using Cleanuparr.Api.Jobs;
+using Quartz;
+
+namespace Cleanuparr.Api.DependencyInjection;
+
+public static class QuartzDI
+{
+    public static IServiceCollection AddQuartzServices(this IServiceCollection services, IConfiguration configuration) =>
+        services
+            .AddQuartz()
+            .AddQuartzHostedService(opt =>
+            {
+                opt.WaitForJobsToComplete = true;
+            })
+            // Register BackgroundJobManager as a hosted service
+            .AddSingleton<BackgroundJobManager>()
+            .AddHostedService(provider => provider.GetRequiredService<BackgroundJobManager>());
+
+    // Jobs are now managed by BackgroundJobManager
+}

code/backend/Cleanuparr.Api/DependencyInjection/ServicesDI.cs

@@ -0,0 +1,60 @@
+using Cleanuparr.Application.Features.BlacklistSync;
+using Cleanuparr.Application.Features.DownloadCleaner;
+using Cleanuparr.Application.Features.DownloadClient;
+using Cleanuparr.Application.Features.MalwareBlocker;
+using Cleanuparr.Application.Features.QueueCleaner;
+using Cleanuparr.Infrastructure.Events;
+using Cleanuparr.Infrastructure.Features.Arr;
+using Cleanuparr.Infrastructure.Features.DownloadClient;
+using Cleanuparr.Infrastructure.Features.DownloadHunter;
+using Cleanuparr.Infrastructure.Features.DownloadHunter.Interfaces;
+using Cleanuparr.Infrastructure.Features.DownloadRemover;
+using Cleanuparr.Infrastructure.Features.DownloadRemover.Interfaces;
+using Cleanuparr.Infrastructure.Features.Files;
+using Cleanuparr.Infrastructure.Features.ItemStriker;
+using Cleanuparr.Infrastructure.Features.MalwareBlocker;
+using Cleanuparr.Infrastructure.Features.Security;
+using Cleanuparr.Infrastructure.Helpers;
+using Cleanuparr.Infrastructure.Interceptors;
+using Cleanuparr.Infrastructure.Services;
+using Cleanuparr.Infrastructure.Services.Interfaces;
+using Cleanuparr.Persistence;
+using Infrastructure.Verticals.Files;
+
+namespace Cleanuparr.Api.DependencyInjection;
+
+public static class ServicesDI
+{
+    public static IServiceCollection AddServices(this IServiceCollection services) =>
+        services
+            .AddScoped<IEncryptionService, AesEncryptionService>()
+            .AddScoped<SensitiveDataJsonConverter>()
+            .AddScoped<EventsContext>()
+            .AddScoped<DataContext>()
+            .AddScoped<EventPublisher>()
+            .AddHostedService<EventCleanupService>()
+            .AddScoped<IDryRunInterceptor, DryRunInterceptor>()
+            .AddScoped<CertificateValidationService>()
+            .AddScoped<SonarrClient>()
+            .AddScoped<RadarrClient>()
+            .AddScoped<LidarrClient>()
+            .AddScoped<ReadarrClient>()
+            .AddScoped<WhisparrClient>()
+            .AddScoped<ArrClientFactory>()
+            .AddScoped<QueueCleaner>()
+            .AddScoped<BlacklistSynchronizer>()
+            .AddScoped<MalwareBlocker>()
+            .AddScoped<DownloadCleaner>()
+            .AddScoped<IQueueItemRemover, QueueItemRemover>()
+            .AddScoped<IDownloadHunter, DownloadHunter>()
+            .AddScoped<IFilenameEvaluator, FilenameEvaluator>()
+            .AddScoped<IHardLinkFileService, HardLinkFileService>()
+            .AddScoped<UnixHardLinkFileService>()
+            .AddScoped<WindowsHardLinkFileService>()
+            .AddScoped<ArrQueueIterator>()
+            .AddScoped<DownloadServiceFactory>()
+            .AddScoped<IStriker, Striker>()
+            .AddScoped<FileReader>()
+            .AddSingleton<IJobManagementService, JobManagementService>()
+            .AddSingleton<BlocklistProvider>();
+}

code/backend/Cleanuparr.Api/HealthCheckResponseWriter.cs

@@ -0,0 +1,28 @@
+using Microsoft.Extensions.Diagnostics.HealthChecks;
+using System.Text;
+
+namespace Cleanuparr.Api;
+
+/// <summary>
+/// Custom health check response writers for different formats
+/// </summary>
+public static class HealthCheckResponseWriter
+{
+    /// <summary>
+    /// Writes a minimal plain text response suitable for Docker health checks
+    /// </summary>
+    public static async Task WriteMinimalPlaintext(HttpContext context, HealthReport report)
+    {
+        context.Response.ContentType = "text/plain";
+        
+        var status = report.Status switch
+        {
+            HealthStatus.Healthy => "healthy",
+            HealthStatus.Degraded => "degraded", 
+            HealthStatus.Unhealthy => "unhealthy",
+            _ => "unknown"
+        };
+
+        await context.Response.WriteAsync(status, Encoding.UTF8);
+    }
+} 

code/backend/Cleanuparr.Api/HostExtensions.cs

@@ -0,0 +1,44 @@
+using System.Reflection;
+using Cleanuparr.Persistence;
+using Microsoft.EntityFrameworkCore;
+
+namespace Cleanuparr.Api;
+
+public static class HostExtensions
+{
+    public static async Task<IHost> InitAsync(this WebApplication app)
+    {
+        ILogger<Program> logger = app.Services.GetRequiredService<ILogger<Program>>();
+
+        Version? version = Assembly.GetExecutingAssembly().GetName().Version;
+
+        logger.LogInformation(
+            version is null
+                ? "Cleanuparr version not detected"
+                : $"Cleanuparr v{version.Major}.{version.Minor}.{version.Build}"
+        );
+        
+        logger.LogInformation("timezone: {tz}", TimeZoneInfo.Local.DisplayName);
+        
+        return app;
+    }
+
+    public static async Task<WebApplicationBuilder> InitAsync(this WebApplicationBuilder builder)
+    {
+        // Apply events db migrations
+        await using var eventsContext = EventsContext.CreateStaticInstance();
+        if ((await eventsContext.Database.GetPendingMigrationsAsync()).Any())
+        {
+            await eventsContext.Database.MigrateAsync();
+        }
+
+        // Apply data db migrations
+        await using var configContext = DataContext.CreateStaticInstance();
+        if ((await configContext.Database.GetPendingMigrationsAsync()).Any())
+        {
+            await configContext.Database.MigrateAsync();
+        }
+        
+        return builder;
+    }
+}

code/backend/Cleanuparr.Api/Jobs/BackgroundJobManager.cs

@@ -0,0 +1,279 @@
+using Cleanuparr.Application.Features.BlacklistSync;
+using Cleanuparr.Application.Features.DownloadCleaner;
+using Cleanuparr.Application.Features.DownloadClient;
+using Cleanuparr.Application.Features.MalwareBlocker;
+using Cleanuparr.Application.Features.QueueCleaner;
+using Cleanuparr.Domain.Exceptions;
+using Cleanuparr.Infrastructure.Features.Jobs;
+using Cleanuparr.Persistence;
+using Cleanuparr.Persistence.Models.Configuration;
+using Cleanuparr.Persistence.Models.Configuration.DownloadCleaner;
+using Cleanuparr.Persistence.Models.Configuration.MalwareBlocker;
+using Cleanuparr.Persistence.Models.Configuration.QueueCleaner;
+using Cleanuparr.Persistence.Models.Configuration.General;
+using Cleanuparr.Persistence.Models.Configuration.BlacklistSync;
+using Cleanuparr.Shared.Helpers;
+using Microsoft.EntityFrameworkCore;
+using Quartz;
+using Quartz.Spi;
+
+namespace Cleanuparr.Api.Jobs;
+
+/// <summary>
+/// Manages background jobs in the application.
+/// This class is responsible for reading configurations and scheduling jobs.
+/// </summary>
+public class BackgroundJobManager : IHostedService
+{
+    private readonly ISchedulerFactory _schedulerFactory;
+    private readonly IServiceScopeFactory _scopeFactory;
+    private readonly ILogger<BackgroundJobManager> _logger;
+    private IScheduler? _scheduler;
+
+    public BackgroundJobManager(
+        ISchedulerFactory schedulerFactory,
+        IServiceScopeFactory scopeFactory,
+        ILogger<BackgroundJobManager> logger
+    )
+    {
+        _schedulerFactory = schedulerFactory;
+        _scopeFactory = scopeFactory;
+        _logger = logger;
+    }
+
+    /// <summary>
+    /// Starts the background job manager.
+    /// This method is called when the application starts.
+    /// </summary>
+    public async Task StartAsync(CancellationToken cancellationToken)
+    {
+        try
+        {
+            _logger.LogDebug("Starting BackgroundJobManager");
+            _scheduler = await _schedulerFactory.GetScheduler(cancellationToken);
+        
+            await InitializeJobsFromConfiguration(cancellationToken);
+        
+            _logger.LogDebug("BackgroundJobManager started");
+        }
+        catch (Exception ex)
+        {
+            _logger.LogError(ex, "Failed to start BackgroundJobManager");
+        }
+    }
+
+    /// <summary>
+    /// Stops the background job manager.
+    /// This method is called when the application stops.
+    /// </summary>
+    public async Task StopAsync(CancellationToken cancellationToken)
+    {
+        _logger.LogDebug("Stopping BackgroundJobManager");
+        
+        if (_scheduler != null)
+        {
+            // Don't shut down the scheduler as it's managed by QuartzHostedService
+            await _scheduler.Standby(cancellationToken);
+        }
+        
+        _logger.LogDebug("BackgroundJobManager stopped");
+    }
+    
+    /// <summary>
+    /// Initializes jobs based on current configuration settings.
+    /// Always registers jobs in the scheduler, but only adds triggers for enabled jobs.
+    /// </summary>
+    private async Task InitializeJobsFromConfiguration(CancellationToken cancellationToken = default)
+    {
+        if (_scheduler == null)
+        {
+            throw new InvalidOperationException("Scheduler not initialized");
+        }
+        
+        await using var scope = _scopeFactory.CreateAsyncScope();
+        await using var dataContext = scope.ServiceProvider.GetRequiredService<DataContext>();
+        
+        // Get configurations from db
+        QueueCleanerConfig queueCleanerConfig = await dataContext.QueueCleanerConfigs
+            .AsNoTracking()
+            .FirstAsync(cancellationToken);
+        ContentBlockerConfig malwareBlockerConfig = await dataContext.ContentBlockerConfigs
+            .AsNoTracking()
+            .FirstAsync(cancellationToken);
+        DownloadCleanerConfig downloadCleanerConfig = await dataContext.DownloadCleanerConfigs
+            .AsNoTracking()
+            .FirstAsync(cancellationToken);
+        BlacklistSyncConfig blacklistSyncConfig = await dataContext.BlacklistSyncConfigs
+            .AsNoTracking()
+            .FirstAsync(cancellationToken);
+        
+        // Always register jobs, regardless of enabled status
+        await RegisterQueueCleanerJob(queueCleanerConfig, cancellationToken);
+        await RegisterMalwareBlockerJob(malwareBlockerConfig, cancellationToken);
+        await RegisterDownloadCleanerJob(downloadCleanerConfig, cancellationToken);
+        await RegisterBlacklistSyncJob(blacklistSyncConfig, cancellationToken);
+    }
+    
+    /// <summary>
+    /// Registers the QueueCleaner job and optionally adds triggers based on configuration.
+    /// </summary>
+    public async Task RegisterQueueCleanerJob(
+        QueueCleanerConfig config, 
+        CancellationToken cancellationToken = default)
+    {
+        // Always register the job definition
+        await AddJobWithoutTrigger<QueueCleaner>(cancellationToken);
+        
+        // Only add triggers if the job is enabled
+        if (config.Enabled)
+        {
+            await AddTriggersForJob<QueueCleaner>(config.CronExpression, cancellationToken);
+        }
+    }
+    
+    /// <summary>
+    /// Registers the QueueCleaner job and optionally adds triggers based on configuration.
+    /// </summary>
+    public async Task RegisterMalwareBlockerJob(
+        ContentBlockerConfig config, 
+        CancellationToken cancellationToken = default)
+    {
+        // Always register the job definition
+        await AddJobWithoutTrigger<MalwareBlocker>(cancellationToken);
+        
+        // Only add triggers if the job is enabled
+        if (config.Enabled)
+        {
+            await AddTriggersForJob<MalwareBlocker>(config.CronExpression, cancellationToken);
+        }
+    }
+    
+    /// <summary>
+    /// Registers the DownloadCleaner job and optionally adds triggers based on configuration.
+    /// </summary>
+    public async Task RegisterDownloadCleanerJob(DownloadCleanerConfig config, CancellationToken cancellationToken = default)
+    {
+        // Always register the job definition
+        await AddJobWithoutTrigger<DownloadCleaner>(cancellationToken);
+        
+        // Only add triggers if the job is enabled
+        if (config.Enabled)
+        {
+            await AddTriggersForJob<DownloadCleaner>(config.CronExpression, cancellationToken);
+        }
+    }
+
+    /// <summary>
+    /// Registers the BlacklistSync job and optionally adds triggers based on general configuration.
+    /// </summary>
+    public async Task RegisterBlacklistSyncJob(BlacklistSyncConfig config, CancellationToken cancellationToken = default)
+    {
+        // Always register the job definition
+        await AddJobWithoutTrigger<BlacklistSynchronizer>(cancellationToken);
+
+        if (config.Enabled)
+        {
+            await AddTriggersForJob<BlacklistSynchronizer>(config.CronExpression, cancellationToken);
+        }
+    }
+    
+    /// <summary>
+    /// Helper method to add triggers for an existing job.
+    /// </summary>
+    private async Task AddTriggersForJob<T>(
+        string cronExpression,
+        CancellationToken cancellationToken = default) 
+        where T : IHandler
+    {
+        if (_scheduler == null)
+        {
+            throw new InvalidOperationException("Scheduler not initialized");
+        }
+        
+        string typeName = typeof(T).Name;
+        var jobKey = new JobKey(typeName);
+        
+        // Validate the cron expression
+        if (!string.IsNullOrEmpty(cronExpression))
+        {
+            IOperableTrigger triggerObj = (IOperableTrigger)TriggerBuilder.Create()
+                .WithIdentity("ValidationTrigger")
+                .StartNow()
+                .WithCronSchedule(cronExpression, x => x.WithMisfireHandlingInstructionDoNothing())
+                .Build();
+
+            IReadOnlyList<DateTimeOffset> nextFireTimes = TriggerUtils.ComputeFireTimes(triggerObj, null, 2);
+            TimeSpan triggerValue = nextFireTimes[1] - nextFireTimes[0];
+            
+            if (triggerValue > Constants.TriggerMaxLimit)
+            {
+                throw new ValidationException($"{cronExpression} should have a fire time of maximum {Constants.TriggerMaxLimit.TotalHours} hours");
+            }
+            
+            if (typeof(T) != typeof(MalwareBlocker) && triggerValue < Constants.TriggerMinLimit)
+            {
+                throw new ValidationException($"{cronExpression} should have a fire time of minimum {Constants.TriggerMinLimit.TotalSeconds} seconds");
+            }
+
+            if (triggerValue > StaticConfiguration.TriggerValue)
+            {
+                StaticConfiguration.TriggerValue = triggerValue;
+            }
+        }
+        
+        // Create main cron trigger with consistent naming (matches JobManagementService)
+        var trigger = TriggerBuilder.Create()
+            .WithIdentity($"{typeName}-trigger")
+            .ForJob(jobKey)
+            .WithCronSchedule(cronExpression, x => x.WithMisfireHandlingInstructionDoNothing())
+            .Build();
+        
+        // Schedule the main trigger
+        await _scheduler.ScheduleJob(trigger, cancellationToken);
+        
+        // Trigger immediate execution for startup using a one-time trigger
+        var startupTrigger = TriggerBuilder.Create()
+            .WithIdentity($"{typeName}-startup-{DateTimeOffset.UtcNow.Ticks}")
+            .ForJob(jobKey)
+            .StartNow()
+            .Build();
+        
+        await _scheduler.ScheduleJob(startupTrigger, cancellationToken);
+        
+        _logger.LogInformation("Added trigger for job {name} with cron expression {CronExpression} and immediate startup execution", 
+            typeName, cronExpression);
+    }
+    
+    /// <summary>
+    /// Helper method to add a job without a trigger (for chained jobs).
+    /// </summary>
+    private async Task AddJobWithoutTrigger<T>(CancellationToken cancellationToken = default) 
+        where T : IHandler
+    {
+        if (_scheduler == null)
+        {
+            throw new InvalidOperationException("Scheduler not initialized");
+        }
+        
+        string typeName = typeof(T).Name;
+        var jobKey = new JobKey(typeName);
+        
+        // Check if job already exists
+        if (await _scheduler.CheckExists(jobKey, cancellationToken))
+        {
+            _logger.LogDebug("Job {name} already exists, skipping registration", typeName);
+            return;
+        }
+        
+        // Create job detail that is durable (can exist without triggers)
+        var jobDetail = JobBuilder.Create<GenericJob<T>>()
+            .WithIdentity(jobKey)
+            .StoreDurably()
+            .Build();
+        
+        // Add job to scheduler
+        await _scheduler.AddJob(jobDetail, true, cancellationToken);
+        
+        _logger.LogDebug("Registered job {name} without trigger", typeName);
+    }
+}

code/backend/Cleanuparr.Api/Jobs/GenericJob.cs

@@ -1,20 +1,20 @@
-using Infrastructure.Verticals.Jobs;
+using Cleanuparr.Infrastructure.Features.Jobs;
 using Quartz;
 using Serilog.Context;
 
-namespace Executable.Jobs;
+namespace Cleanuparr.Api.Jobs;
 
 [DisallowConcurrentExecution]
 public sealed class GenericJob<T> : IJob
-    where T : GenericHandler
+    where T : IHandler
 {
     private readonly ILogger<GenericJob<T>> _logger;
-    private readonly T _handler;
-
-    public GenericJob(ILogger<GenericJob<T>> logger, T handler)
+    private readonly IServiceScopeFactory _scopeFactory;
+    
+    public GenericJob(ILogger<GenericJob<T>> logger, IServiceScopeFactory scopeFactory)
     {
         _logger = logger;
-        _handler = handler;
+        _scopeFactory = scopeFactory;
     }
     
     public async Task Execute(IJobExecutionContext context)
@@ -23,7 +23,9 @@ public sealed class GenericJob<T> : IJob
         
         try
         {
-            await _handler.ExecuteAsync();
+            await using var scope = _scopeFactory.CreateAsyncScope();
+            var handler = scope.ServiceProvider.GetRequiredService<T>();
+            await handler.ExecuteAsync();
         }
         catch (Exception ex)
         {

code/backend/Cleanuparr.Api/Middleware/ExceptionMiddleware.cs

@@ -0,0 +1,77 @@
+using System.Net;
+using System.Text.Json;
+using Cleanuparr.Api.Models;
+using Cleanuparr.Domain.Exceptions;
+
+namespace Cleanuparr.Api.Middleware;
+
+public class ExceptionMiddleware
+{
+    private readonly RequestDelegate _next;
+    private readonly ILogger<ExceptionMiddleware> _logger;
+
+    public ExceptionMiddleware(RequestDelegate next, ILogger<ExceptionMiddleware> logger)
+    {
+        _next = next;
+        _logger = logger;
+    }
+
+    public async Task InvokeAsync(HttpContext context)
+    {
+        try
+        {
+            await _next(context);
+        }
+        catch (Exception ex)
+        {
+            await HandleExceptionAsync(context, ex);
+        }
+    }
+
+    private async Task HandleExceptionAsync(HttpContext context, Exception exception)
+    {
+        // Generate a unique identifier for this error
+        string traceId = Guid.NewGuid().ToString();
+        
+        // Default status code and message
+        int statusCode = (int)HttpStatusCode.InternalServerError;
+        string message = "An unexpected error occurred";
+
+        switch (exception)
+        {
+            // Handle different exception types
+            case ValidationException:
+                statusCode = (int)HttpStatusCode.BadRequest;
+                message = exception.Message; // Use the validation message directly
+            
+                _logger.LogWarning(exception, 
+                    "Validation error {TraceId} occurred during request to {Path}", 
+                    traceId, context.Request.Path);
+                break;
+            
+            default:
+                // Log other exceptions as errors with more details
+                _logger.LogError(exception, 
+                    "Error {TraceId} occurred during request to {Path}: {Message}", 
+                    traceId, context.Request.Path, exception.Message);
+                break;
+        }
+        
+        // Create the error response
+        ErrorResponse errorResponse = new()
+        {
+            TraceId = traceId,
+            Error = message
+        };
+        
+        // Set the response
+        context.Response.ContentType = "application/json";
+        context.Response.StatusCode = statusCode;
+        
+        // Write the response
+        await context.Response.WriteAsync(JsonSerializer.Serialize(errorResponse, new JsonSerializerOptions
+        {
+            PropertyNamingPolicy = JsonNamingPolicy.CamelCase
+        }));
+    }
+}

code/backend/Cleanuparr.Api/Models/ErrorResponse.cs

@@ -0,0 +1,17 @@
+namespace Cleanuparr.Api.Models;
+
+/// <summary>
+/// Standardized error response model for API endpoints
+/// </summary>
+public class ErrorResponse
+{
+    /// <summary>
+    /// User-friendly error message
+    /// </summary>
+    public required string Error { get; set; }
+    
+    /// <summary>
+    /// Trace ID for error tracking (GUID)
+    /// </summary>
+    public required string TraceId { get; set; }
+}

code/backend/Cleanuparr.Api/Models/NotificationProviders/CreateAppriseProviderDto.cs

@@ -0,0 +1,10 @@
+namespace Cleanuparr.Api.Models.NotificationProviders;
+
+public sealed record CreateAppriseProviderDto : CreateNotificationProviderBaseDto
+{
+    public string Url { get; init; } = string.Empty;
+    
+    public string Key { get; init; } = string.Empty;
+    
+    public string Tags { get; init; } = string.Empty;
+}

code/backend/Cleanuparr.Api/Models/NotificationProviders/CreateNotifiarrProviderDto.cs

@@ -0,0 +1,8 @@
+namespace Cleanuparr.Api.Models.NotificationProviders;
+
+public sealed record CreateNotifiarrProviderDto : CreateNotificationProviderBaseDto
+{
+    public string ApiKey { get; init; } = string.Empty;
+    
+    public string ChannelId { get; init; } = string.Empty;
+}

code/backend/Cleanuparr.Api/Models/NotificationProviders/CreateNotificationProviderBaseDto.cs

@@ -0,0 +1,20 @@
+namespace Cleanuparr.Api.Models.NotificationProviders;
+
+public abstract record CreateNotificationProviderBaseDto
+{
+    public string Name { get; init; } = string.Empty;
+    
+    public bool IsEnabled { get; init; } = true;
+    
+    public bool OnFailedImportStrike { get; init; }
+    
+    public bool OnStalledStrike { get; init; }
+    
+    public bool OnSlowStrike { get; init; }
+    
+    public bool OnQueueItemDeleted { get; init; }
+    
+    public bool OnDownloadCleaned { get; init; }
+    
+    public bool OnCategoryChanged { get; init; }
+}

code/backend/Cleanuparr.Api/Models/NotificationProviders/CreateNtfyProviderDto.cs

@@ -0,0 +1,22 @@
+using Cleanuparr.Domain.Enums;
+
+namespace Cleanuparr.Api.Models.NotificationProviders;
+
+public sealed record CreateNtfyProviderDto : CreateNotificationProviderBaseDto
+{
+    public string ServerUrl { get; init; } = string.Empty;
+
+    public List<string> Topics { get; init; } = [];
+    
+    public NtfyAuthenticationType AuthenticationType { get; init; } = NtfyAuthenticationType.None;
+    
+    public string Username { get; init; } = string.Empty;
+    
+    public string Password { get; init; } = string.Empty;
+    
+    public string AccessToken { get; init; } = string.Empty;
+    
+    public NtfyPriority Priority { get; init; } = NtfyPriority.Default;
+
+    public List<string> Tags { get; init; } = [];
+}

code/backend/Cleanuparr.Api/Models/NotificationProviders/TestAppriseProviderDto.cs

@@ -0,0 +1,10 @@
+namespace Cleanuparr.Api.Models.NotificationProviders;
+
+public sealed record TestAppriseProviderDto
+{
+    public string Url { get; init; } = string.Empty;
+    
+    public string Key { get; init; } = string.Empty;
+    
+    public string Tags { get; init; } = string.Empty;
+}

code/backend/Cleanuparr.Api/Models/NotificationProviders/TestNotifiarrProviderDto.cs

@@ -0,0 +1,8 @@
+namespace Cleanuparr.Api.Models.NotificationProviders;
+
+public sealed record TestNotifiarrProviderDto
+{
+    public string ApiKey { get; init; } = string.Empty;
+    
+    public string ChannelId { get; init; } = string.Empty;
+}

code/backend/Cleanuparr.Api/Models/NotificationProviders/TestNtfyProviderDto.cs

@@ -0,0 +1,22 @@
+using Cleanuparr.Domain.Enums;
+
+namespace Cleanuparr.Api.Models.NotificationProviders;
+
+public sealed record TestNtfyProviderDto
+{
+    public string ServerUrl { get; init; } = string.Empty;
+
+    public List<string> Topics { get; init; } = [];
+    
+    public NtfyAuthenticationType AuthenticationType { get; init; } = NtfyAuthenticationType.None;
+    
+    public string Username { get; init; } = string.Empty;
+    
+    public string Password { get; init; } = string.Empty;
+    
+    public string AccessToken { get; init; } = string.Empty;
+    
+    public NtfyPriority Priority { get; init; } = NtfyPriority.Default;
+
+    public List<string> Tags { get; init; } = [];
+}