Bump docker/setup-buildx-action from 3 to 4

Bumps [docker/setup-buildx-action](https://github.com/docker/setup-buildx-action) from 3 to 4.
- [Release notes](https://github.com/docker/setup-buildx-action/releases)
- [Commits](https://github.com/docker/setup-buildx-action/compare/v3...v4)

---
updated-dependencies:
- dependency-name: docker/setup-buildx-action
  dependency-version: '4'
  dependency-type: direct:production
  update-type: version-update:semver-major
...

Signed-off-by: dependabot[bot] <support@github.com>

.github/FUNDING.yml

@@ -0,0 +1,2 @@
+github: maxdorninger
+buy_me_a_coffee: maxdorninger

.github/ISSUE_TEMPLATE/bug_report.md

@@ -1,8 +1,8 @@
 ---
 name: Bug report
 about: Create a report to help us improve
-title: ''
-labels: ''
+title: '[BUG] '
+labels: 'bug'
 assignees: ''
 
 ---
@@ -23,9 +23,35 @@ A clear and concise description of what you expected to happen.
 **Screenshots**
 If applicable, add screenshots to help explain your problem.
 
+**Server Logs**
+If applicable, add logs to help explain your problem.
+
+**Browser Logs**
+If applicable, add logs to help explain your problem.
+
 **Version**
-Frontend vX.X
-Frontend vX.X
+vX.X
 
 **Additional context**
 Add any other context about the problem here.
+
+
+**docker-compose.yaml**
+
+```yaml
+
+YOUR DOCKER-COMPOSE HERE
+
+```
+
+**config.toml**
+
+```toml
+
+YOUR CONFIG HERE
+
+```
+
+ - [ ] I understand, that without logs and/or screenshots and a detailed description of the problem, it is very hard to fix bugs.
+ - [ ] I have checked the [documentation](https://maxdorninger.github.io/MediaManager/) for help.
+ - [ ] I have searched the [issues](https://github.com/maxdorninger/MediaManager/issues) for similar issues and found none.

.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1 @@
+blank_issues_enabled: false

.github/dependabot.yml

@@ -0,0 +1,31 @@
+# To get started with Dependabot version updates, you'll need to specify which
+# package ecosystems to update and where the package manifests are located.
+# Please see the documentation for all configuration options:
+# https://docs.github.com/code-security/dependabot/dependabot-version-updates/configuration-options-for-the-dependabot.yml-file
+
+version: 2
+updates:
+  - package-ecosystem: "github-actions"
+    directory: "/"
+    schedule:
+      interval: "weekly"
+    open-pull-requests-limit: 5
+
+  - package-ecosystem: "npm"
+    directory: "/web"
+    schedule:
+      interval: "weekly"
+    open-pull-requests-limit: 5
+
+  - package-ecosystem: "uv"
+    directory: "/"
+    schedule:
+      interval: "weekly"
+    open-pull-requests-limit: 5
+
+  - package-ecosystem: "uv"
+    directory: "/metadata_relay"
+    schedule:
+      interval: "weekly"
+    open-pull-requests-limit: 5
+

.github/workflows/build-docs.yml

@@ -1,107 +0,0 @@
-name: Build documentation
-
-on:
-  push:
-    branches: [ "master" ]
-    paths:
-      - 'Writerside/**'
-      - '.github/workflows/build-docs.yml'
-  workflow_dispatch:
-
-permissions:
-  contents: read
-  id-token: write
-  pages: write
-
-env:
-  INSTANCE: 'Writerside/mm'
-  DOCKER_VERSION: '2025.04.8412'
-
-jobs:
-  build:
-    runs-on: ubuntu-latest
-    outputs:
-      algolia_artifact: ${{ steps.define-ids.outputs.algolia_artifact }}
-      artifact: ${{ steps.define-ids.outputs.artifact }}
-    steps:
-      - name: Checkout repository
-        uses: actions/checkout@v4
-        with:
-          fetch-depth: 0
-
-      - name: Define instance id and artifacts
-        id: define-ids
-        run: |
-          INSTANCE=${INSTANCE#*/}
-          INSTANCE_ID_UPPER=$(echo "$INSTANCE" | tr '[:lower:]' '[:upper:]')
-          ARTIFACT="webHelp${INSTANCE_ID_UPPER}2-all.zip"
-          ALGOLIA_ARTIFACT="algolia-indexes-${INSTANCE_ID_UPPER}.zip"
-
-          # Print the values
-          echo "INSTANCE_ID_UPPER: $INSTANCE_ID_UPPER"
-          echo "ARTIFACT: $ARTIFACT"
-          echo "ALGOLIA_ARTIFACT: $ALGOLIA_ARTIFACT"
-
-          # Set the environment variables and outputs
-          echo "INSTANCE_ID_UPPER=$INSTANCE_ID_UPPER" >> $GITHUB_ENV
-          echo "ARTIFACT=$ARTIFACT" >> $GITHUB_ENV
-          echo "ALGOLIA_ARTIFACT=$ALGOLIA_ARTIFACT" >> $GITHUB_ENV
-          echo "artifact=$ARTIFACT" >> $GITHUB_OUTPUT
-          echo "algolia_artifact=$ALGOLIA_ARTIFACT" >> $GITHUB_OUTPUT
-
-      - name: Build docs using Writerside Docker builder
-        uses: JetBrains/writerside-github-action@v4
-        with:
-          instance: ${{ env.INSTANCE }}
-          docker-version: ${{ env.DOCKER_VERSION }}
-
-      - name: Save artifact with build results
-        uses: actions/upload-artifact@v4
-        with:
-          name: docs
-          path: |
-            artifacts/${{ steps.define-ids.outputs.artifact }}
-            artifacts/report.json
-            artifacts/${{ steps.define-ids.outputs.algolia_artifact }}
-          retention-days: 7
-  test:
-    needs: build
-    runs-on: ubuntu-latest
-    steps:
-      - name: Download artifacts
-        uses: actions/download-artifact@v4
-        with:
-          name: docs
-          path: artifacts
-
-      - name: Test documentation
-        uses: JetBrains/writerside-checker-action@v1
-        with:
-          instance: ${{ env.INSTANCE }}
-  deploy:
-    environment:
-      name: github-pages
-      url: ${{ steps.deployment.outputs.page_url }}
-    needs: [ build, test ]
-    runs-on: ubuntu-latest
-    steps:
-      - name: Download artifacts
-        uses: actions/download-artifact@v4
-        with:
-          name: docs
-          path: artifacts
-
-      - name: Unzip artifact
-        run: unzip -O UTF-8 -qq "artifacts/${{ needs.build.outputs.artifact }}" -d dir
-
-      - name: Setup Pages
-        uses: actions/configure-pages@v4
-
-      - name: Package and upload Pages artifact
-        uses: actions/upload-pages-artifact@v3
-        with:
-          path: dir
-
-      - name: Deploy to GitHub Pages
-        id: deployment
-        uses: actions/deploy-pages@v4

.github/workflows/build-push-backend.yml

@@ -4,8 +4,6 @@ on:
   push:
     branches:
       - master
-    tags:
-      - 'v*.*.*'
     paths:
       - 'media_manager/**'
       - 'alembic/**'
@@ -15,6 +13,8 @@ on:
       - 'uv.lock'
       - '.github/workflows/build-push-backend.yml'
       - 'tests/**'
+      - 'web/**'
+
   pull_request:
     paths:
       - 'media_manager/**'
@@ -25,53 +25,153 @@ on:
       - 'uv.lock'
       - '.github/workflows/build-push-backend.yml'
       - 'tests/**'
+      - 'web/**'
+
+  release:
+    types: [published]
 
   workflow_dispatch:
 
 jobs:
-  lint-code:
+  lint-backend:
     name: Lint Python Code
     runs-on: ubuntu-latest
-
     steps:
       - uses: actions/checkout@v4
       - uses: astral-sh/ruff-action@v3
         with:
           src: "./media_manager"
 
-  run-tests:
-    needs: lint-code
-    name: Run Python Tests
+  lint-frontend:
+    name: Lint Frontend
     runs-on: ubuntu-latest
-
     steps:
       - uses: actions/checkout@v4
-
-      - name: Install uv
-        uses: astral-sh/setup-uv@v5
-
-      - name: Install the project
-        run: uv sync --locked --all-extras --dev
-
-      - name: Run tests
-        run: uv run pytest tests
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '24'
+          cache: 'npm'
+          cache-dependency-path: './web/package-lock.json'
+      - name: Install dependencies
+        run: npm ci
+        working-directory: ./web
+      - name: Lint code
+        run: npm run lint
+        working-directory: ./web
 
   build-and-push:
-    needs: run-tests
-    runs-on: ubuntu-latest
+    needs: [lint-frontend, lint-backend]
+    strategy:
+      fail-fast: false
+      matrix:
+        include:
+          - arch: amd64
+            runner: ubuntu-24.04
+          - arch: arm64
+            runner: ubuntu-24.04-arm
+    runs-on: ${{ matrix.runner }}
     permissions:
       contents: read
-      packages: write
-
+      packages:  write
+    env:
+      QUAY_ORG: ${{ secrets.QUAY_ORG || github.repository_owner }}
     steps:
       - name: Checkout repository
         uses: actions/checkout@v4
 
-      - name: Set up QEMU
-        uses: docker/setup-qemu-action@v3
+      - name: Set repository name to lowercase
+        id: repo_name
+        run: echo "name=$(echo '${{ github.event.repository.name }}' | tr '[:upper:]' '[:lower:]')" >> $GITHUB_OUTPUT
 
       - name: Set up Docker Buildx
-        uses: docker/setup-buildx-action@v3
+        uses: docker/setup-buildx-action@v4
+        with:
+          install: true
+          driver-opts: image=moby/buildkit:rootless
+
+      - name: Log in to GitHub Container Registry
+        if: github.event_name != 'pull_request' || github.event.pull_request.head.repo.full_name == github.repository
+        uses: docker/login-action@v3
+        with:
+          registry: ghcr.io
+          username: ${{ github.actor }}
+          password: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Log in to Quay
+        if: github.event_name != 'pull_request' || github.event.pull_request.head.repo.full_name == github.repository
+        uses: docker/login-action@v3
+        with:
+          registry: quay.io
+          username: ${{ secrets.QUAY_USERNAME }}
+          password: ${{ secrets.QUAY_PASSWORD }}
+
+      - name: Extract version
+        id: version
+        run: |
+          if [[ "${{ github.event_name }}" == "release" ]]; then
+            VERSION="${{ github.event.release.tag_name }}"
+          elif [[ "${{ github.ref_type }}" == "tag" ]]; then
+            VERSION="${{ github.ref_name }}"
+          else
+            DATE_STAMP=$(date -u +'%Y.%m.%d')
+            VERSION="dev-${DATE_STAMP}-${{ github.run_number }}"
+          fi
+          echo "version=$VERSION" >> $GITHUB_OUTPUT
+          VERSION_NO_V=${VERSION#v}
+          echo "version_no_v=$VERSION_NO_V" >> $GITHUB_OUTPUT
+
+      - name: Extract metadata (tags + labels)
+        id: meta
+        uses: docker/metadata-action@v5
+        with:
+          images: |
+            ghcr.io/${{ github.repository_owner }}/${{ steps.repo_name.outputs.name }}/mediamanager
+            quay.io/${{ env.QUAY_ORG }}/mediamanager
+          tags: |
+            type=raw,value=latest,enable=${{ github.event_name == 'release' }}
+            type=raw,value=${{ steps.version.outputs.version }},enable=${{ github.event_name != 'release' }}
+            type=ref,event=branch
+            type=ref,event=pr
+            type=semver,pattern={{version}}
+            type=semver,pattern={{major}}.{{minor}}
+            type=semver,pattern={{major}}
+            type=sha
+          flavor: |
+            suffix=-${{ matrix.arch }},onlatest=true
+
+      - name: Build and push arch image
+        uses: docker/build-push-action@v6
+        with:
+          context: .
+          file: ./Dockerfile
+          platforms: linux/${{ matrix.arch }}
+          push: ${{ github.event_name != 'pull_request' || github.event.pull_request.head.repo.full_name == github.repository }}
+          tags: ${{ steps.meta.outputs.tags }}
+          labels: ${{ steps.meta.outputs.labels }}
+          build-args: |
+            VERSION=${{ steps.version.outputs.version }}
+            BASE_PATH=
+
+  publish-manifests:
+    needs: build-and-push
+    if: github.event_name != 'pull_request' || github.event.pull_request.head.repo.full_name == github.repository
+    runs-on: ubuntu-24.04
+    permissions:
+      contents: read
+      packages: write
+    env:
+      QUAY_ORG: ${{ secrets.QUAY_ORG }}
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Set repository name to lowercase
+        id: repo_name
+        run: echo "name=$(echo '${{ github.event.repository.name }}' | tr '[:upper:]' '[:lower:]')" >> $GITHUB_OUTPUT
+
+      - name: Set up Docker Buildx
+        uses: docker/setup-buildx-action@v4
 
       - name: Log in to GitHub Container Registry
         uses: docker/login-action@v3
@@ -80,38 +180,60 @@ jobs:
           username: ${{ github.actor }}
           password: ${{ secrets.GITHUB_TOKEN }}
 
-      - name: Extract metadata (tags, labels) for Docker
+      - name: Log in to Quay
+        uses: docker/login-action@v3
+        with:
+          registry: quay.io
+          username: ${{ secrets.QUAY_USERNAME }}
+          password: ${{ secrets.QUAY_PASSWORD }}
+
+      - name: Extract version
+        id: version
+        run: |
+          if [[ "${{ github.event_name }}" == "release" ]]; then
+            VERSION="${{ github.event.release.tag_name }}"
+          elif [[ "${{ github.ref_type }}" == "tag" ]]; then
+            VERSION="${{ github.ref_name }}"
+          else
+            DATE_STAMP=$(date -u +'%Y.%m.%d')
+            VERSION="dev-${DATE_STAMP}-${{ github.run_number }}"
+          fi
+          echo "version=$VERSION" >> $GITHUB_OUTPUT
+          VERSION_NO_V=${VERSION#v}
+          echo "version_no_v=$VERSION_NO_V" >> $GITHUB_OUTPUT
+
+      - name: Extract metadata (tags + labels)
         id: meta
         uses: docker/metadata-action@v5
         with:
-          images: ghcr.io/${{ github.repository_owner }}/${{ github.event.repository.name }}/backend
+          images: |
+            ghcr.io/${{ github.repository_owner }}/${{ steps.repo_name.outputs.name }}/mediamanager
+            quay.io/${{ env.QUAY_ORG }}/mediamanager
           tags: |
-            type=raw,value=latest,enable=${{ github.ref == format('refs/heads/{0}', 'master') }}
-            type=ref,event=tag
+            type=raw,value=latest,enable=${{ github.event_name == 'release' }}
+            type=raw,value=${{ steps.version.outputs.version }},enable=${{ github.event_name != 'release' }}
             type=ref,event=branch
+            type=ref,event=pr
             type=semver,pattern={{version}}
             type=semver,pattern={{major}}.{{minor}}
             type=semver,pattern={{major}}
             type=sha
 
-      - name: Extract version
-        id: version
+      - name: Create and push multi-arch manifests
         run: |
-          if [[ "${{ github.ref }}" == refs/tags/* ]]; then
-            VERSION=${GITHUB_REF#refs/tags/}
-          else
-            VERSION="dev-${GITHUB_SHA::7}"
-          fi
-          echo "version=$VERSION" >> $GITHUB_OUTPUT
+          set -euo pipefail
+          mapfile -t TAGS <<< "${{ steps.meta.outputs.tags }}"
+          for TAG in "${TAGS[@]}"; do
+            docker buildx imagetools create \
+              --tag "${TAG}" \
+              "${TAG}-amd64" \
+              "${TAG}-arm64"
+          done
 
-      - name: Build and push Docker image
-        uses: docker/build-push-action@v6
-        with:
-          context: .
-          file: ./Dockerfile
-          platforms: linux/amd64,linux/arm64
-          push: ${{ github.event_name != 'pull_request' }}
-          tags: ${{ steps.meta.outputs.tags }}
-          labels: ${{ steps.meta.outputs.labels }}
-          build-args: |
-            VERSION=${{ steps.version.outputs.version }}
+      - name: Inspect image (GHCR)
+        run: |
+          docker buildx imagetools inspect ghcr.io/${{ github.repository_owner }}/${{ steps.repo_name.outputs.name }}/mediamanager:${{ steps.version.outputs.version_no_v }}
+
+      - name: Inspect image (Quay)
+        run: |
+          docker buildx imagetools inspect quay.io/${{ env.QUAY_ORG }}/mediamanager:${{ steps.version.outputs.version_no_v }}

.github/workflows/build-push-frontend.yml

@@ -1,93 +0,0 @@
-name: Build and Push Frontend Docker Image
-
-on:
-  push:
-    branches:
-      - master
-    tags:
-      - 'v*.*.*'
-    paths:
-      - 'web/**'
-      - '.github/workflows/build-push-frontend.yml'
-  pull_request:
-    paths:
-      - 'web/**'
-      - '.github/workflows/build-push-frontend.yml'
-
-  workflow_dispatch:
-
-jobs:
-  lint:
-    name: Lint Frontend
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v4
-      - name: Setup Node.js
-        uses: actions/setup-node@v4
-        with:
-          node-version: '20'
-      - name: Install dependencies
-        run: npm install
-        working-directory: ./web
-      - name: Lint code
-        run: npm run lint
-        working-directory: ./web
-  build-and-push:
-    needs: lint
-    runs-on: ubuntu-latest
-    permissions:
-      contents: read
-      packages: write
-
-    steps:
-      - name: Checkout repository
-        uses: actions/checkout@v4
-
-      - name: Set up QEMU
-        uses: docker/setup-qemu-action@v3
-
-      - name: Set up Docker Buildx
-        uses: docker/setup-buildx-action@v3
-
-      - name: Log in to GitHub Container Registry
-        uses: docker/login-action@v3
-        with:
-          registry: ghcr.io
-          username: ${{ github.actor }}
-          password: ${{ secrets.GITHUB_TOKEN }}
-
-      - name: Extract metadata (tags, labels) for Docker
-        id: meta
-        uses: docker/metadata-action@v5
-        with:
-          images: ghcr.io/${{ github.repository_owner }}/${{ github.event.repository.name }}/frontend
-          tags: |
-            type=raw,value=latest,enable=${{ github.ref == format('refs/heads/{0}', 'master') }}
-            type=ref,event=tag
-            type=ref,event=branch
-            type=semver,pattern={{version}}
-            type=semver,pattern={{major}}.{{minor}}
-            type=semver,pattern={{major}}
-            type=sha
-
-      - name: Extract version
-        id: version
-        run: |
-          if [[ "${{ github.ref }}" == refs/tags/* ]]; then
-            VERSION=${GITHUB_REF#refs/tags/}
-          else
-            VERSION="dev-${GITHUB_SHA::7}"
-          fi
-          echo "version=$VERSION" >> $GITHUB_OUTPUT
-
-      - name: Build and push Docker image
-        uses: docker/build-push-action@v6
-        with:
-          context: ./web
-          file: ./web/Dockerfile
-          platforms: linux/amd64,linux/arm64
-          push: ${{ github.event_name != 'pull_request' }}
-          tags: ${{ steps.meta.outputs.tags }}
-          labels: ${{ steps.meta.outputs.labels }}
-          build-args: |
-            VERSION=${{ steps.version.outputs.version }}

.github/workflows/build-push-metadata_relay.yml

@@ -4,74 +4,200 @@ on:
   push:
     branches:
       - master
-    tags:
-      - 'v*.*.*'
     paths:
       - 'metadata_relay/**'
-      - '.github/workflows/python-lint_metadata_relay.yaml'
+      - '.github/workflows/build-push-metadata_relay.yml'
   pull_request:
     paths:
       - 'metadata_relay/**'
-      - '.github/workflows/python-lint_metadata_relay.yaml'
+      - '.github/workflows/build-push-metadata_relay.yml'
+  release:
+    types:  [ published ]
   workflow_dispatch:
 
 jobs:
   lint-code:
-    name: Lint Python Code
+    name:  Lint Python Code
     runs-on: ubuntu-latest
-
     steps:
       - uses: actions/checkout@v4
-      - uses: astral-sh/ruff-action@v3
+      - uses:  astral-sh/ruff-action@v3
         with:
           src: "./metadata_relay"
 
   build-and-push:
     needs: lint-code
-    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        include:
+          - arch: amd64
+            runner: ubuntu-24.04
+          - arch: arm64
+            runner: ubuntu-24.04-arm
+    runs-on: ${{ matrix.runner }}
     permissions:
       contents: read
-      packages: write
-
+      packages:  write
+    env:
+      QUAY_ORG: ${{ secrets.QUAY_ORG || github.repository_owner }}
     steps:
       - name: Checkout repository
         uses: actions/checkout@v4
 
-      - name: Set up QEMU
-        uses: docker/setup-qemu-action@v3
+      - name: Set repository name to lowercase
+        id: repo_name
+        run: echo "name=$(echo '${{ github.event.repository.name }}' | tr '[:upper:]' '[:lower:]')" >> $GITHUB_OUTPUT
 
-      - name: Set up Docker Buildx
-        uses: docker/setup-buildx-action@v3
+      - name:  Set up Docker Buildx
+        uses: docker/setup-buildx-action@v4
+        with:
+          install: true
+          driver-opts: image=moby/buildkit:rootless
+
+      - name: Log in to GitHub Container Registry
+        uses: docker/login-action@v3
+        if:  github.event_name != 'pull_request' || github.event.pull_request.head.repo.full_name == github.repository
+        with:
+          registry:  ghcr.io
+          username: ${{ github.actor }}
+          password: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Log in to Quay
+        uses: docker/login-action@v3
+        if: github.event_name != 'pull_request' || github.event.pull_request.head.repo.full_name == github.repository
+        with:
+          registry: quay.io
+          username: ${{ secrets.QUAY_USERNAME }}
+          password:  ${{ secrets.QUAY_PASSWORD }}
+
+      - name: Extract version
+        id: version
+        run: |
+          if [[ "${{ github.event_name }}" == "release" ]]; then
+            VERSION="${{ github.event.release.tag_name }}"
+          elif [[ "${{ github.ref_type }}" == "tag" ]]; then
+            VERSION="${{ github.ref_name }}"
+          else
+            DATE_STAMP=$(date -u +'%Y.%m.%d')
+            VERSION="dev-${DATE_STAMP}-${{ github.run_number }}"
+          fi
+          echo "version=$VERSION" >> $GITHUB_OUTPUT
+          VERSION_NO_V=${VERSION#v}
+          echo "version_no_v=$VERSION_NO_V" >> $GITHUB_OUTPUT
+
+      - name: Extract metadata (tags + labels)
+        id: meta
+        uses:  docker/metadata-action@v5
+        with:
+          images:  |
+            ghcr.io/${{ github.repository_owner }}/${{ steps.repo_name.outputs.name }}/metadata_relay
+            quay.io/${{ env.QUAY_ORG }}/metadata_relay
+          tags: |
+            type=raw,value=latest,enable=${{ github.event_name == 'release' }}
+            type=raw,value=${{ steps.version.outputs.version }},enable=${{ github.event_name != 'release' }}
+            type=ref,event=branch
+            type=ref,event=pr
+            type=semver,pattern={{version}}
+            type=semver,pattern={{major}}.{{minor}}
+            type=semver,pattern={{major}}
+            type=sha
+          flavor: |
+            suffix=-${{ matrix.arch }},onlatest=true
+
+      - name: Build and push arch image
+        uses: docker/build-push-action@v6
+        with:
+          context:  ./metadata_relay
+          file: ./metadata_relay/Dockerfile
+          platforms: linux/${{ matrix.arch }}
+          push: ${{ github.event_name != 'pull_request' || github.event.pull_request.head.repo.full_name == github.repository }}
+          tags: ${{ steps.meta.outputs.tags }}
+          labels: ${{ steps.meta.outputs.labels }}
+          build-args: |
+            VERSION=${{ steps.version.outputs.version }}
+
+  publish-manifests:
+    needs: build-and-push
+    if: github.event_name != 'pull_request' || github.event.pull_request.head.repo.full_name == github.repository
+    runs-on: ubuntu-24.04
+    permissions:
+      contents: read
+      packages: write
+    env:
+      QUAY_ORG: ${{ secrets.QUAY_ORG || github.repository_owner }}
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Set repository name to lowercase
+        id: repo_name
+        run: echo "name=$(echo '${{ github.event.repository.name }}' | tr '[:upper:]' '[:lower:]')" >> $GITHUB_OUTPUT
+
+      - name:  Set up Docker Buildx
+        uses: docker/setup-buildx-action@v4
 
       - name: Log in to GitHub Container Registry
         uses: docker/login-action@v3
         with:
-          registry: ghcr.io
+          registry:  ghcr.io
           username: ${{ github.actor }}
           password: ${{ secrets.GITHUB_TOKEN }}
 
-      - name: Extract metadata (tags, labels) for Docker
-        id: meta
-        uses: docker/metadata-action@v5
+      - name: Log in to Quay
+        uses: docker/login-action@v3
         with:
-          images: ghcr.io/${{ github.repository_owner }}/${{ github.event.repository.name }}/metadata_relay
+          registry: quay.io
+          username: ${{ secrets.QUAY_USERNAME }}
+          password:  ${{ secrets.QUAY_PASSWORD }}
+
+      - name: Extract version
+        id: version
+        run: |
+          if [[ "${{ github.event_name }}" == "release" ]]; then
+            VERSION="${{ github.event.release.tag_name }}"
+          elif [[ "${{ github.ref_type }}" == "tag" ]]; then
+            VERSION="${{ github.ref_name }}"
+          else
+            DATE_STAMP=$(date -u +'%Y.%m.%d')
+            VERSION="dev-${DATE_STAMP}-${{ github.run_number }}"
+          fi
+          echo "version=$VERSION" >> $GITHUB_OUTPUT
+          VERSION_NO_V=${VERSION#v}
+          echo "version_no_v=$VERSION_NO_V" >> $GITHUB_OUTPUT
+
+      - name: Extract metadata (tags + labels)
+        id: meta
+        uses:  docker/metadata-action@v5
+        with:
+          images:  |
+            ghcr.io/${{ github.repository_owner }}/${{ steps.repo_name.outputs.name }}/metadata_relay
+            quay.io/${{ env.QUAY_ORG }}/metadata_relay
           tags: |
-            type=raw,value=latest,enable=${{ github.ref == format('refs/heads/{0}', 'master') }}
-            type=ref,event=tag
+            type=raw,value=latest,enable=${{ github.event_name == 'release' }}
+            type=raw,value=${{ steps.version.outputs.version }},enable=${{ github.event_name != 'release' }}
             type=ref,event=branch
+            type=ref,event=pr
             type=semver,pattern={{version}}
             type=semver,pattern={{major}}.{{minor}}
             type=semver,pattern={{major}}
             type=sha
 
-      - name: Build and push Docker image
-        uses: docker/build-push-action@v6
-        with:
-          context: ./metadata_relay
-          file: ./metadata_relay/Dockerfile
-          platforms: linux/amd64,linux/arm64
-          push: ${{ github.event_name != 'pull_request' }}
-          tags: ${{ steps.meta.outputs.tags }}
-          labels: ${{ steps.meta.outputs.labels }}
-          build-args: |
-            VERSION=${{ steps.meta.outputs.version }}
+      - name: Create and push multi-arch manifests
+        run: |
+          set -euo pipefail
+          mapfile -t TAGS <<< "${{ steps.meta.outputs.tags }}"
+          for TAG in "${TAGS[@]}"; do
+            docker buildx imagetools create \
+              --tag "${TAG}" \
+              "${TAG}-amd64" \
+              "${TAG}-arm64"
+          done
+
+      - name: Inspect image (GHCR)
+        run: |
+          docker buildx imagetools inspect ghcr.io/${{ github.repository_owner }}/${{ steps.repo_name.outputs.name }}/metadata_relay:${{ steps.version.outputs.version_no_v }}
+
+      - name: Inspect image (Quay)
+        run: |
+          docker buildx imagetools inspect quay.io/${{ env.QUAY_ORG }}/metadata_relay:${{ steps.version.outputs.version_no_v }}

.github/workflows/docs.yml

@@ -0,0 +1,62 @@
+name: Publish docs via GitHub Pages
+on:
+  push:
+    branches:
+      - master
+    tags:
+      - v*
+  workflow_dispatch:
+    inputs:
+      set_default_alias:
+        description: 'Alias to set as default (e.g. latest, master)'
+        required: false
+        default: 'latest'
+
+permissions:
+  contents: write
+
+jobs:
+  deploy:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: Configure Git Credentials
+        run: |
+          git config user.name github-actions[bot]
+          git config user.email 41898282+github-actions[bot]@users.noreply.github.com
+
+      - uses: actions/setup-python@v6
+        with:
+          python-version: 3.x
+
+      - run: echo "cache_id=$(date --utc '+%V')" >> $GITHUB_ENV
+
+      - uses: actions/cache@v4
+        with:
+          key: mkdocs-material-${{ env.cache_id }}
+          path: .cache
+          restore-keys: |
+            mkdocs-material-
+
+      - name: Install dependencies
+        run: pip install mkdocs-material mike
+
+      - name: Deploy (master)
+        if: github.ref == 'refs/heads/master'
+        run: |
+          mike deploy --push --update-aliases master
+
+      - name: Deploy (tag)
+        if: startsWith(github.ref, 'refs/tags/v')
+        run: |
+          version=${GITHUB_REF#refs/tags/}
+          mike deploy --push --update-aliases $version latest --title "$version"
+          mike set-default --push latest
+
+      - name: Set Default (Manual)
+        if: github.event_name == 'workflow_dispatch' && github.event.inputs.set_default_alias != ''
+        run: |
+          mike set-default --push ${{ github.event.inputs.set_default_alias }}

.github/workflows/python-lint.yaml

@@ -1,29 +0,0 @@
-name: Ruff
-on:
-  push:
-    branches:
-      - master
-    paths:
-      - 'media_manager/**'
-      - 'alembic/**'
-      - 'pyproject.toml'
-      - 'uv.lock'
-      - '.github/workflows/python-lint.yaml'
-      - 'tests/**'
-  pull_request:
-    paths:
-      - 'media_manager/**'
-      - 'alembic/**'
-      - 'pyproject.toml'
-      - 'uv.lock'
-      - '.github/workflows/python-lint.yaml'
-      - 'tests/**'
-  workflow_dispatch:
-jobs:
-  ruff:
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v4
-      - uses: astral-sh/ruff-action@v3
-        with:
-          src: "./media_manager"

.github/workflows/python-lint_metadata_relay.yaml

@@ -1,21 +0,0 @@
-name: Ruff Metadata Relay
-on:
-  push:
-    branches:
-      - master
-    paths:
-      - 'metadata_relay/**'
-      - '.github/workflows/python-lint_metadata_relay.yaml'
-  pull_request:
-    paths:
-      - 'metadata_relay/**'
-      - '.github/workflows/python-lint_metadata_relay.yaml'
-  workflow_dispatch:
-jobs:
-  ruff:
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v4
-      - uses: astral-sh/ruff-action@v3
-        with:
-          src: "./metadata_relay"

.github/workflows/python-tests.yml

@@ -1,31 +0,0 @@
-name: Run Python Tests
-
-on:
-  pull_request:
-    branches: [ master ]
-    paths:
-      - 'media_manager/**'
-      - 'alembic/**'
-      - 'alembic.ini'
-      - 'pyproject.toml'
-      - 'uv.lock'
-      - '.github/workflows/python-tests.yml'
-      - 'tests/**'
-  workflow_dispatch:
-
-jobs:
-  run-tests:
-    name: Run Python Tests
-    runs-on: ubuntu-latest
-
-    steps:
-      - uses: actions/checkout@v4
-
-      - name: Install uv
-        uses: astral-sh/setup-uv@v5
-
-      - name: Install the project
-        run: uv sync --locked --all-extras --dev
-
-      - name: Run tests
-        run: uv run pytest tests

.github/workflows/web-lint.yml

@@ -1,31 +0,0 @@
-name: Lint Frontend
-
-on:
-  pull_request:
-    paths:
-      - 'web/**'
-      - '.github/workflows/web-lint.yml'
-  push:
-    branches:
-      - master
-    paths:
-      - 'web/**'
-      - '.github/workflows/web-lint.yml'
-
-jobs:
-  lint:
-    name: Lint Frontend
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v4
-      - name: Setup Node.js
-        uses: actions/setup-node@v4
-        with:
-          node-version: '20'
-      - name: Install dependencies
-        run: npm install
-        working-directory: ./web
-      - name: Lint code
-        run: npm run lint
-        working-directory: ./web
-

.gitignore

@@ -9,6 +9,13 @@ tv/*
 log.txt
 res/*
 media_manager/indexer/indexers/prowlarr.http
+*.egg-info
+.env
+config
+images
+data
+res
+
 
 
 web/cache/
@@ -35,3 +42,12 @@ web/!.env.test
 # Vite
 web/vite.config.js.timestamp-*
 web/vite.config.ts.timestamp-*
+
+# pycache
+__pycache__
+
+# Postgres
+/postgres
+
+# MkDocs
+site/

CODE_OF_CONDUCT.md

@@ -0,0 +1,128 @@
+# Contributor Covenant Code of Conduct
+
+## Our Pledge
+
+We as members, contributors, and leaders pledge to make participation in our
+community a harassment-free experience for everyone, regardless of age, body
+size, visible or invisible disability, ethnicity, sex characteristics, gender
+identity and expression, level of experience, education, socio-economic status,
+nationality, personal appearance, race, religion, or sexual identity
+and orientation.
+
+We pledge to act and interact in ways that contribute to an open, welcoming,
+diverse, inclusive, and healthy community.
+
+## Our Standards
+
+Examples of behavior that contributes to a positive environment for our
+community include:
+
+* Demonstrating empathy and kindness toward other people
+* Being respectful of differing opinions, viewpoints, and experiences
+* Giving and gracefully accepting constructive feedback
+* Accepting responsibility and apologizing to those affected by our mistakes,
+  and learning from the experience
+* Focusing on what is best not just for us as individuals, but for the
+  overall community
+
+Examples of unacceptable behavior include:
+
+* The use of sexualized language or imagery, and sexual attention or
+  advances of any kind
+* Trolling, insulting or derogatory comments, and personal or political attacks
+* Public or private harassment
+* Publishing others' private information, such as a physical or email
+  address, without their explicit permission
+* Other conduct which could reasonably be considered inappropriate in a
+  professional setting
+
+## Enforcement Responsibilities
+
+Community leaders are responsible for clarifying and enforcing our standards of
+acceptable behavior and will take appropriate and fair corrective action in
+response to any behavior that they deem inappropriate, threatening, offensive,
+or harmful.
+
+Community leaders have the right and responsibility to remove, edit, or reject
+comments, commits, code, wiki edits, issues, and other contributions that are
+not aligned to this Code of Conduct, and will communicate reasons for moderation
+decisions when appropriate.
+
+## Scope
+
+This Code of Conduct applies within all community spaces, and also applies when
+an individual is officially representing the community in public spaces.
+Examples of representing our community include using an official e-mail address,
+posting via an official social media account, or acting as an appointed
+representative at an online or offline event.
+
+## Enforcement
+
+Instances of abusive, harassing, or otherwise unacceptable behavior may be
+reported to the community leaders responsible for enforcement at
+97409287+maxdorninger@users.noreply.github.com.
+All complaints will be reviewed and investigated promptly and fairly.
+
+All community leaders are obligated to respect the privacy and security of the
+reporter of any incident.
+
+## Enforcement Guidelines
+
+Community leaders will follow these Community Impact Guidelines in determining
+the consequences for any action they deem in violation of this Code of Conduct:
+
+### 1. Correction
+
+**Community Impact**: Use of inappropriate language or other behavior deemed
+unprofessional or unwelcome in the community.
+
+**Consequence**: A private, written warning from community leaders, providing
+clarity around the nature of the violation and an explanation of why the
+behavior was inappropriate. A public apology may be requested.
+
+### 2. Warning
+
+**Community Impact**: A violation through a single incident or series
+of actions.
+
+**Consequence**: A warning with consequences for continued behavior. No
+interaction with the people involved, including unsolicited interaction with
+those enforcing the Code of Conduct, for a specified period of time. This
+includes avoiding interactions in community spaces as well as external channels
+like social media. Violating these terms may lead to a temporary or
+permanent ban.
+
+### 3. Temporary Ban
+
+**Community Impact**: A serious violation of community standards, including
+sustained inappropriate behavior.
+
+**Consequence**: A temporary ban from any sort of interaction or public
+communication with the community for a specified period of time. No public or
+private interaction with the people involved, including unsolicited interaction
+with those enforcing the Code of Conduct, is allowed during this period.
+Violating these terms may lead to a permanent ban.
+
+### 4. Permanent Ban
+
+**Community Impact**: Demonstrating a pattern of violation of community
+standards, including sustained inappropriate behavior,  harassment of an
+individual, or aggression toward or disparagement of classes of individuals.
+
+**Consequence**: A permanent ban from any sort of public interaction within
+the community.
+
+## Attribution
+
+This Code of Conduct is adapted from the [Contributor Covenant][homepage],
+version 2.0, available at
+https://www.contributor-covenant.org/version/2/0/code_of_conduct.html.
+
+Community Impact Guidelines were inspired by [Mozilla's code of conduct
+enforcement ladder](https://github.com/mozilla/diversity).
+
+[homepage]: https://www.contributor-covenant.org
+
+For answers to common questions about this code of conduct, see the FAQ at
+https://www.contributor-covenant.org/faq. Translations are available at
+https://www.contributor-covenant.org/translations.

CONTRIBUTING.md

@@ -0,0 +1,33 @@
+# Contributing to MediaManager
+
+First off, thank you for considering contributing to MediaManager.
+
+## Why
+
+Following this guide helps me merge your PRs faster, prevents unnecessary back-and-forth and wasted effort.
+
+## How to suggest a feature or enhancement
+
+Open an issue which describes the feature you would like to
+see, why you need it, and how it should work.
+There we can discuss its scope and implementation.
+
+## How to contribute
+
+Generally, if you have any questions or need help on the implementation side of MediaManager,
+just ask in the issue, or in a draft PR.
+
+Also, see the contribution guide in the docs for information on how to setup the dev environment:
+https://maxdorninger.github.io/MediaManager/
+
+### For something that is a one or two line fix:
+
+Make the change, and open a PR with a short description of what you changed and why.
+
+### For something that is bigger than a one or two line fix:
+
+Explain why you are making the change.
+Be sure to give a rough overview on how your implementation works, and maybe any design decisions you made.
+Also include any relevant limitations or trade-offs you made.
+
+It's best to also open an issue first to discuss larger changes before you start working on them.

Dockerfile

@@ -1,40 +1,67 @@
-FROM ghcr.io/astral-sh/uv:debian-slim AS builder
-WORKDIR /app
+FROM node:24-alpine AS frontend-build
+WORKDIR /frontend
 
-RUN apt-get update && \
-    apt-get install -y --no-install-recommends ca-certificates gcc python3-dev && \
-    apt-get clean && \
-    rm -rf /var/lib/apt/lists/*
+COPY web/package*.json ./
+RUN npm ci && npm cache clean --force
 
-COPY pyproject.toml uv.lock ./
+COPY web/ ./
 
-RUN uv sync --locked
-
-FROM ghcr.io/astral-sh/uv:debian-slim
 ARG VERSION
-LABEL version=${VERSION}
-LABEL description="Docker image for the backend of MediaManager"
+ARG BASE_PATH=""
+RUN env PUBLIC_VERSION=${VERSION} PUBLIC_API_URL=${BASE_PATH} BASE_PATH=${BASE_PATH}/web npm run build
 
-ENV IMAGE_DIRECTORY=/data/images \
-    TV_SHOW_DIRECTORY=/data/tv \
-    MOVIE_DIRECTORY=/data/movies \
-    TORRENT_DIRECTORY=/data/torrents \
-    OPENID_ENABLED=FALSE \
-    PUBLIC_VERSION=${VERSION}
+FROM ghcr.io/astral-sh/uv:python3.13-trixie-slim AS base 
 
 RUN apt-get update && \
-    apt-get install -y --no-install-recommends ca-certificates && \
+    apt-get install -y ca-certificates bash libtorrent21 gcc bc locales postgresql media-types mailcap curl gzip unzip tar 7zip bzip2 unar gosu && \
     apt-get clean && \
     rm -rf /var/lib/apt/lists/*
 
+RUN sed -i -e 's/# en_US.UTF-8 UTF-8/en_US.UTF-8 UTF-8/' /etc/locale.gen
+RUN locale-gen
+ENV LANG=en_US.UTF-8
+ENV LC_ALL=en_US.UTF-8
+
+# Create a non-root user and group
+RUN groupadd -g 1000 mediamanager && \
+    useradd -m -u 1000 -g mediamanager mediamanager
+
+FROM base AS dependencies
 WORKDIR /app
+# Ensure mediamanager owns /app
+RUN chown -R mediamanager:mediamanager /app
 
-COPY --from=builder /usr/local/lib/python3.*/site-packages /usr/local/lib/python3.*/site-packages/
+USER mediamanager
 
-COPY --chmod=755 mediamanager-backend-startup.sh .
-COPY media_manager ./media_manager
-COPY alembic ./alembic
-COPY alembic.ini .
+ENV UV_CACHE_DIR=/home/mediamanager/.cache/uv \
+    UV_LINK_MODE=copy
 
+COPY --chown=mediamanager:mediamanager pyproject.toml uv.lock ./
+RUN --mount=type=cache,target=/home/mediamanager/.cache/uv,uid=1000,gid=1000 \
+    uv sync --locked
+
+FROM dependencies AS app
+ARG VERSION
+ARG BASE_PATH=""
+LABEL author="github.com/maxdorninger"
+LABEL version=${VERSION}
+LABEL description="Docker image for MediaManager"
+USER root
+
+ENV PUBLIC_VERSION=${VERSION} \
+    CONFIG_DIR="/app/config" \
+    BASE_PATH=${BASE_PATH} \
+    FRONTEND_FILES_DIR="/app/web/build"
+
+COPY --chown=mediamanager:mediamanager --chmod=755 mediamanager-startup.sh .
+COPY --chown=mediamanager:mediamanager config.example.toml .
+COPY --chown=mediamanager:mediamanager media_manager ./media_manager
+COPY --chown=mediamanager:mediamanager alembic ./alembic
+COPY --chown=mediamanager:mediamanager alembic.ini .
+
+HEALTHCHECK CMD curl -f http://localhost:8000${BASE_PATH}/api/v1/health || exit 1
 EXPOSE 8000
-CMD ["/app/mediamanager-backend-startup.sh"]
+CMD ["/app/mediamanager-startup.sh"]
+
+FROM app AS production
+COPY --chown=mediamanager:mediamanager --from=frontend-build /frontend/build /app/web/build

LICENSE

@@ -629,8 +629,8 @@ to attach them to the start of each source file to most effectively
 state the exclusion of warranty; and each file should have at least
 the "copyright" line and a pointer to where the full notice is found.
 
-    <one line to give the program's name and a brief idea of what it does.>
-    Copyright (C) <year>  <name of author>
+    MediaManager, an automatic media downloader and organizer.
+    Copyright (C) 2025  Maximilian Dorninger
 
     This program is free software: you can redistribute it and/or modify
     it under the terms of the GNU Affero General Public License as published

Makefile

@@ -0,0 +1,49 @@
+SHELL := /bin/bash
+
+# Docker Compose command (override if needed)
+COMPOSE ?= docker compose
+DC := $(COMPOSE) -f docker-compose.dev.yaml
+
+# Log args passthrough, e.g.:
+# make logs ARGS="--follow --tail=100"
+ARGS ?=
+
+# Service names (override if your compose uses different names)
+APP_SVC ?= mediamanager
+FRONTEND_SVC ?= frontend
+
+.PHONY: help up down logs ps restartapp frontend
+
+help:
+	@echo "Usage:"
+	@echo "  All commands run using the dev docker compose file ($(DEV_FILE))"
+	@echo ""
+	@echo "  make up                     # Development environment up, runs with --build flag to rebuild if necessary"
+	@echo "  make down                   # Development environment down"
+	@echo "  make logs ARGS=\"...\"        # (Optional) Set ARGS like \"--follow --tail=100\""
+	@echo "  make ps | restart           # Check status or restart containers"
+	@echo "  make app                    # Shell into $(APP_SVC) container"
+	@echo "  make frontend               # Shell into $(FRONTEND_SVC) container"
+
+# Core lifecycle
+up:
+	$(DC) up -d --build
+
+down:
+	$(DC) down
+
+logs:
+	$(DC) logs $(ARGS)
+
+ps:
+	$(DC) ps
+
+restart:
+	$(DC) restart
+
+# Interactive shells (prefer bash, fallback to sh)
+app:
+	@$(DC) exec -it $(APP_SVC) bash 2>/dev/null || $(DC) exec -it $(APP_SVC) sh
+
+frontend:
+	@$(DC) exec -it $(FRONTEND_SVC) bash 2>/dev/null || $(DC) exec -it $(FRONTEND_SVC) sh

README.md

@@ -1,7 +1,7 @@
 <br />
 <div align="center">
-  <a href="https://maxdorninger.github.io/MediaManager">
-    <img src="https://raw.githubusercontent.com/maxdorninger/MediaManager/refs/heads/master/Writerside/images/logo.svg" alt="Logo" width="260" height="260">
+  <a href="https://maxdorninger.github.io/MediaManager/">
+    <img src="https://raw.githubusercontent.com/maxdorninger/MediaManager/refs/heads/master/docs/assets/logo-with-text.svg" alt="Logo" width="800">
   </a>
 
 <h3 align="center">MediaManager</h3>
@@ -9,73 +9,94 @@
   <p align="center">
     Modern management system for your media library
     <br />
-    <a href="https://maxdorninger.github.io/MediaManager/introduction.html"><strong>Explore the docs »</strong></a>
+    <a href="https://maxdorninger.github.io/MediaManager/"><strong>Explore the docs »</strong></a>
     <br />
-    <a href="https://maxdorninger.github.io/MediaManager/issues/new?labels=bug&template=bug-report---.md">Report Bug</a>
+    <a href="https://github.com/maxdorninger/MediaManager/issues/new?labels=bug&template=bug_report.md">Report Bug</a>
     &middot;
-    <a href="https://maxdorninger.github.io/MediaManager/issues/new?labels=enhancement&template=feature-request---.md">Request Feature</a>
+    <a href="https://github.com/maxdorninger/MediaManager/issues/new?template=feature_request.md">Request Feature</a>
   </p>
 </div>
 
 
-MediaManager is modern software to manage your TV and movie library. It is designed to be a replacement for Sonarr,
-Radarr, Overseer, and Jellyseer.
-It supports TVDB and TMDB for metadata, supports OIDC and OAuth 2.0 for authentication and supports Prowlarr and
-Jackett.
-MediaManager is built first and foremost for deployment with Docker, making it easy to set up.
+MediaManager is the modern, easy-to-use successor to the fragmented "Arr" stack. Manage, discover, and automate your TV and movie collection in a single, simple interface.
 
-It also provides an API to interact with the software programmatically, allowing for automation and integration with
-other services.
+Key features:
+- support for OAuth/OIDC
+- support for TVDB and TMDB
+- made to be deployed with Docker
 
 ## Quick Start
 
-```
-   wget -O docker-compose.yaml https://raw.githubusercontent.com/maxdorninger/MediaManager/refs/heads/master/docker-compose.yaml   
-   # Edit docker-compose.yaml to set the environment variables!
-   docker compose up -d
+```sh
+wget -O docker-compose.yaml https://github.com/maxdorninger/MediaManager/releases/latest/download/docker-compose.yaml
+mkdir config
+wget -O ./config/config.toml https://github.com/maxdorninger/MediaManager/releases/latest/download/config.example.toml
+# you probably need to edit the config.toml file in the ./config directory, for more help see the documentation
+docker compose up -d
 ```
 
-### [View the docs for installation instructions and more](https://maxdorninger.github.io/MediaManager/configuration-overview.html#configuration-overview)
+### [View the docs for installation instructions and more](https://maxdorninger.github.io/MediaManager/)
 
-<!-- ROADMAP -->
-## Roadmap
+## Support MediaManager
 
-- [x] support for more torrent indexers
-- [x] fully automatic downloads
-- [x] add tests
-- [x] add more logs/errors
-- [x] make API return proper error codes
-- [x] optimize images for web in the backend
-- [x] responsive ui
-- [x] automatically update metadata of shows
-- [x] automatically download new seasons/episodes of shows
-- [x] add fallback to just copy files if hardlinks don't work
-- [x] add check at startup if hardlinks work
-- [x] create separate metadata relay service, so that api keys for TMDB and TVDB are not strictly needed
-- [x] support for movies
-- [x] expand README with more information and a quickstart guide
-- [x] improve reliability of scheduled tasks
-- [ ] add notification system
-- [ ] add in-depth documentation on the architecture of the codebase
-- [ ] make indexer module multithreaded
-- [ ] add support for deluge and transmission
-- [ ] add delete button for movies/TV shows
-- [ ] rework prowlarr module (select which indexers to use, etc.)
-- [ ] add sequence diagrams to the documentation
-- [ ] _maybe_ rework the logo
-- [ ] _maybe_ add support for configuration via toml config file
+<a href="https://github.com/sponsors/maxdorninger" target="_blank">
+  <img src="https://img.shields.io/badge/Sponsor-Maximilian Dorninger-orange" alt="Sponsor @maxdorninger" />
+</a>
 
-See the [open issues](hhttps://maxdorninger.github.io/MediaManager/issues) for a full list of proposed features (and known issues).
+<a href="https://buymeacoffee.com/maxdorninger" 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>
 
+## Check out the awesome sponsors of MediaManager ❤️
+
+<a href="https://fosstodon.org/@aljazmerzen"><img src="https://github.com/aljazerzen.png" width="80px" alt="Aljaž Mur Eržen" /></a>&nbsp;&nbsp;
+<a href="https://github.com/ldrrp"><img src="https://github.com/ldrrp.png" width="80px" alt="Luis Rodriguez" /></a>&nbsp;&nbsp;
+<a href="https://github.com/brandon-dacrib"><img src="https://github.com/brandon-dacrib.png" width="80px" alt="Brandon P." /></a>&nbsp;&nbsp;
+<a href="https://github.com/SeimusS"><img src="https://github.com/SeimusS.png" width="80px" alt="SeimusS" /></a>&nbsp;&nbsp;
+<a href="https://github.com/HadrienKerlero"><img src="https://github.com/HadrienKerlero.png" width="80px" alt="HadrienKerlero" /></a>&nbsp;&nbsp;
+<a href="https://github.com/keyxmakerx"><img src="https://github.com/keyxmakerx.png" width="80px" alt="keyxmakerx" /></a>&nbsp;&nbsp;
+<a href="https://github.com/LITUATUI"><img src="https://github.com/LITUATUI.png" width="80px" alt="LITUATUI" /></a>&nbsp;&nbsp;
+<a href="https://buymeacoffee.com/maxdorninger"><img src="https://cdn.buymeacoffee.com/uploads/profile_pictures/default/v2/B6CDBD/NI.png" width="80px" alt="Nicolas" /></a>&nbsp;&nbsp;
+<a href="https://buymeacoffee.com/maxdorninger"><img src="https://cdn.buymeacoffee.com/uploads/profile_pictures/default/v2/DEBBB9/JO.png" width="80px" alt="Josh" /></a>&nbsp;&nbsp;
+<a href="https://buymeacoffee.com/maxdorninger"><img src="https://cdn.buymeacoffee.com/uploads/profile_pictures/2025/11/2VeQ8sTGPhj4tiLy.jpg" width="80px" alt="PuppiestDoggo" /></a>&nbsp;&nbsp;
+<a href="https://github.com/seferino-fernandez"><img src="https://avatars.githubusercontent.com/u/5546622" width="80px" alt="Seferino" /></a>&nbsp;&nbsp;
+<a href="https://buymeacoffee.com/maxdorninger"><img src="https://cdn.buymeacoffee.com/uploads/profile_pictures/default/v2/EC9689/SY.png" width="80px" alt="syn" /></a>&nbsp;&nbsp;
+
+## Star History
+
+[![Star History Chart](https://api.star-history.com/svg?repos=maxdorninger/MediaManager&type=Date)](https://www.star-history.com/#maxdorninger/MediaManager&Date)
+
+## Screenshots
+
+<img width="1902" height="887" alt="Screenshot 2025-12-08 at 00 44 26" src="https://github.com/user-attachments/assets/4c3fbc73-6358-44ac-a948-0eb35ab116fd" />
+<img width="1875" height="882" alt="Screenshot 2025-12-08 at 00 46 39" src="https://github.com/user-attachments/assets/75645cb6-236b-4bef-9a21-76bfd6d530f9" />
+
+![Screenshot 2025-07-02 174616](https://github.com/user-attachments/assets/c3af4be8-b873-448c-8a4d-0d5db863aec7)
+
+
+<img width="1883" height="890" alt="Screenshot 2025-12-08 at 00 48 23" src="https://github.com/user-attachments/assets/c5789559-5aa7-4c26-9442-a2b156e99b1c" />
+
+
+![Screenshot 2025-06-28 222908](https://github.com/user-attachments/assets/193e1afd-dabb-42a2-ab28-59f2784371c7)
+
+## Developer Quick Start
+
+For the developer guide see the [Developer Guide](https://maxdorninger.github.io/MediaManager/).
 
 <!-- LICENSE -->
+
 ## License
 
-Distributed under the GPL 3.0. See `LICENSE.txt` for more information.
+Distributed under the AGPL 3.0. See `LICENSE.txt` for more information.
 
 
 <!-- ACKNOWLEDGMENTS -->
+
 ## Acknowledgments
 
+Thanks to DigitalOcean for sponsoring the project!
+
+[![DigitalOcean Referral Badge](https://web-platforms.sfo2.cdn.digitaloceanspaces.com/WWW/Badge%201.svg)](https://www.digitalocean.com/?refcode=4edf05429dca&utm_campaign=Referral_Invite&utm_medium=Referral_Program&utm_source=badge)
+
 * [Thanks to Pawel Czerwinski for the image on the login screen](https://unsplash.com/@pawel_czerwinski)
 

Writerside/Writerside_libraries.tree

@@ -1,9 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<!DOCTYPE instance-profile
-        SYSTEM "https://resources.jetbrains.com/writerside/1.0/product-profile.dtd">
-
-<instance-profile id="Writerside_libraries"
-                  name="Writerside_libraries" is-library="true" start-page="notes.topic">
-
-    <toc-element topic="notes.topic"/>
-</instance-profile>

Writerside/c.list

@@ -1,6 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<!DOCTYPE categories
-        SYSTEM "https://resources.jetbrains.com/writerside/1.0/categories.dtd">
-<categories>
-    <category id="wrs" name="Writerside documentation" order="1"/>
-</categories>

Writerside/cfg/buildprofiles.xml

@@ -1,21 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<!DOCTYPE buildprofiles SYSTEM "https://resources.jetbrains.com/writerside/1.0/build-profiles.dtd">
-<buildprofiles xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
-               xsi:noNamespaceSchemaLocation="https://resources.jetbrains.com/writerside/1.0/build-profiles.xsd">
-
-    <variables></variables>
-    <build-profile instance="mm">
-        <variables>
-            <noindex-content>false</noindex-content>
-            <custom-favicons>favicon.ico</custom-favicons>
-            <header-logo>logo.svg</header-logo>
-
-            <download-title>Buy me a coffee ☕</download-title>
-            <download-page>https://buymeacoffee.com/maxdorninger</download-page>
-            <showDownloadButton>true</showDownloadButton>
-            <product-web-url>https://github.com/maxdorninger/MediaManager</product-web-url>
-
-        </variables>
-    </build-profile>
-
-</buildprofiles>

Writerside/images/logo.svg

@@ -1,158 +0,0 @@
-<?xml version="1.0" encoding="UTF-8" standalone="no"?>
-<!-- Created with Inkscape (http://www.inkscape.org/) -->
-
-<svg
-        xmlns:inkscape="http://www.inkscape.org/namespaces/inkscape"
-        xmlns:sodipodi="http://sodipodi.sourceforge.net/DTD/sodipodi-0.dtd"
-        xmlns:svg="http://www.w3.org/2000/svg"
-        version="1.1"
-        id="svg1"
-        width="2000"
-        height="2000"
-        viewBox="0 0 2000 2000"
-        sodipodi:docname="logo2.svg"
-        inkscape:version="1.4.2 (f4327f4, 2025-05-13)"
-        xmlns="http://www.w3.org/2000/svg">
-    <defs
-            id="defs1">
-        <clipPath
-                clipPathUnits="userSpaceOnUse"
-                id="clipPath1">
-            <path
-                    d="M 0,1500 H 1500 V 0 H 0 Z"
-                    id="path1"/>
-        </clipPath>
-        <clipPath
-                clipPathUnits="userSpaceOnUse"
-                id="clipPath3">
-            <path
-                    d="M 0,0 H 1500 V 1500 H 0 Z"
-                    transform="matrix(1.3333333,0,0,-1.3333333,0,2000)"
-                    id="path3"/>
-        </clipPath>
-        <clipPath
-                clipPathUnits="userSpaceOnUse"
-                id="clipPath4">
-            <path
-                    d="M -17.6886,1032.99 H 1106.27 V 238.53 H -17.6886 Z"
-                    transform="translate(-319.61281,-1032.9941)"
-                    id="path4"/>
-        </clipPath>
-        <clipPath
-                clipPathUnits="userSpaceOnUse"
-                id="clipPath6">
-            <path
-                    d="M 0,0 H 1500 V 1500 H 0 Z"
-                    transform="matrix(1.3333333,0,0,-1.3333333,0,2000)"
-                    id="path6"/>
-        </clipPath>
-        <clipPath
-                clipPathUnits="userSpaceOnUse"
-                id="clipPath7">
-            <path
-                    d="M 223.314,1226.85 H 1182.49 V 548.867 H 223.314 Z"
-                    transform="translate(-894.64255,-548.86681)"
-                    id="path7"/>
-        </clipPath>
-        <clipPath
-                clipPathUnits="userSpaceOnUse"
-                id="clipPath9">
-            <path
-                    d="M 0,0 H 1500 V 1500 H 0 Z"
-                    transform="matrix(1.3333333,0,0,-1.3333333,0,2000)"
-                    id="path9"/>
-        </clipPath>
-        <clipPath
-                clipPathUnits="userSpaceOnUse"
-                id="clipPath10">
-            <path
-                    d="M 301.561,1098.17 H 1517.73 V 238.53 H 301.561 Z"
-                    transform="translate(-666.53282,-1098.1678)"
-                    id="path10"/>
-        </clipPath>
-        <clipPath
-                clipPathUnits="userSpaceOnUse"
-                id="clipPath12">
-            <path
-                    d="M 0,0 H 1500 V 1500 H 0 Z"
-                    transform="matrix(1.3333333,0,0,-1.3333333,0,2000)"
-                    id="path12"/>
-        </clipPath>
-    </defs>
-    <sodipodi:namedview
-            id="namedview1"
-            pagecolor="#ffffff"
-            bordercolor="#000000"
-            borderopacity="0.25"
-            inkscape:showpageshadow="2"
-            inkscape:pageopacity="0.0"
-            inkscape:pagecheckerboard="0"
-            inkscape:deskcolor="#d1d1d1"
-            inkscape:zoom="0.9075"
-            inkscape:cx="999.44904"
-            inkscape:cy="1000"
-            inkscape:window-width="3840"
-            inkscape:window-height="2054"
-            inkscape:window-x="3373"
-            inkscape:window-y="199"
-            inkscape:window-maximized="1"
-            inkscape:current-layer="g1">
-        <inkscape:page
-                x="0"
-                y="0"
-                inkscape:label="1"
-                id="page1"
-                width="2000"
-                height="2000"
-                margin="0"
-                bleed="0"/>
-    </sodipodi:namedview>
-    <g
-            id="g1"
-            inkscape:groupmode="layer"
-            inkscape:label="1">
-        <g
-                id="g2"
-                clip-path="url(#clipPath3)">
-            <path
-                    d="M 0,0 H 1500 V 1500 H 0 Z"
-                    style="fill:#9ed8f7;fill-opacity:0;fill-rule:nonzero;stroke:none"
-                    transform="matrix(1.3333333,0,0,-1.3333333,0,2000)"
-                    clip-path="url(#clipPath1)"
-                    id="path2"/>
-        </g>
-        <g
-                opacity="0.720001"
-                id="g5"
-                clip-path="url(#clipPath6)">
-            <path
-                    d="m 0,0 h 669.787 c 68.994,0 116.873,-68.746 92.95,-133.46 L 542.309,-729.728 c -14.382,-38.904 -51.472,-64.736 -92.95,-64.736 h -669.787 c -68.994,0 -116.873,68.746 -92.949,133.46 L -92.949,-64.736 C -78.567,-25.832 -41.478,0 0,0"
-                    style="fill:#2842fc;fill-opacity:1;fill-rule:nonzero;stroke:none"
-                    transform="matrix(1.3333333,0,0,-1.3333333,426.1504,622.67453)"
-                    clip-path="url(#clipPath4)"
-                    id="path5"/>
-        </g>
-        <g
-                opacity="0.720001"
-                id="g8"
-                clip-path="url(#clipPath9)">
-            <path
-                    d="m 0,0 h -571.59 c -58.879,0 -99.738,58.667 -79.322,113.893 l 188.111,508.849 c 12.274,33.201 43.925,55.246 79.322,55.246 h 571.59 c 58.879,0 99.739,-58.667 79.322,-113.894 L 79.322,55.245 C 67.049,22.045 35.397,0 0,0"
-                    style="fill:#ff5e00;fill-opacity:1;fill-rule:nonzero;stroke:none"
-                    transform="matrix(1.3333333,0,0,-1.3333333,1192.8567,1268.1776)"
-                    clip-path="url(#clipPath7)"
-                    id="path8"/>
-        </g>
-        <g
-                opacity="0.75"
-                id="g11"
-                clip-path="url(#clipPath12)">
-            <path
-                    d="m 0,0 h 724.733 c 74.654,0 126.46,-74.386 100.575,-144.408 L 586.797,-789.591 c -15.562,-42.096 -55.694,-70.047 -100.575,-70.047 h -724.733 c -74.654,0 -126.461,74.386 -100.574,144.409 l 238.511,645.182 C -85.013,-27.952 -44.88,0 0,0"
-                    style="fill:#f20a4c;fill-opacity:1;fill-rule:nonzero;stroke:none"
-                    transform="matrix(1.3333333,0,0,-1.3333333,888.7104,535.77627)"
-                    clip-path="url(#clipPath10)"
-                    id="path11"/>
-        </g>
-    </g>
-</svg>

Writerside/mm.tree

@@ -1,22 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<!DOCTYPE instance-profile
-        SYSTEM "https://resources.jetbrains.com/writerside/1.0/product-profile.dtd">
-
-<instance-profile id="mm"
-                  name="MediaManager"
-                  start-page="introduction.md">
-
-    <toc-element topic="introduction.md"/>
-    <toc-element topic="configuration-overview.md"/>
-    <toc-element topic="User-Guide.md"/>
-    <toc-element topic="Configuration.md">
-        <toc-element topic="authentication-setup.md"/>
-        <toc-element topic="configuration-backend.md">
-        </toc-element>
-        <toc-element topic="Indexer-Settings.md"/>
-        <toc-element topic="configuration-frontend.md"/>
-    </toc-element>
-    <toc-element topic="troubleshooting.md"/>
-    <toc-element topic="developer-guide.md"/>
-    <toc-element topic="api-reference.md"/>
-</instance-profile>

Writerside/redirection-rules.xml

@@ -1,29 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<!DOCTYPE rules SYSTEM "https://resources.jetbrains.com/writerside/1.0/redirection-rules.dtd">
-<rules>
-    <!-- format is as follows
-    <rule id="<unique id>">
-        <accepts>page.html</accepts>
-    </rule>
-    -->
-    <rule id="63c34f28">
-        <description>Created after removal of "Installation" from MediaManager</description>
-        <accepts>installation.html</accepts>
-    </rule>
-    <rule id="440cb672">
-        <description>Created after removal of "About MediaManager" from MediaManager</description>
-        <accepts>starter-topic.html</accepts>
-    </rule>
-    <rule id="666c8c31">
-        <description>Created after removal of "User Guide" from MediaManager</description>
-        <accepts>user-guide.html</accepts>
-    </rule>
-    <rule id="6822e619">
-        <description>Created after removal of "Quick Start Guide" from MediaManager</description>
-        <accepts>Quick-Start-Guide.html</accepts>
-    </rule>
-    <rule id="570cb9d1">
-        <description>Created after removal of "user-guide" from MediaManager</description>
-        <accepts>user-guide.html</accepts>
-    </rule>
-</rules>

Writerside/topics/Configuration.md

@@ -1,6 +0,0 @@
-# Configuration
-
-The configuration of MediaManager is divided into backend and frontend settings, which can be set in your
-`docker-compose.yaml` file or in separate `.env` files.
-All settings are set as environment variables, because this makes backing up the configuration easier and allows for
-easier sharing/transferring of the configuration.

Writerside/topics/Indexer-Settings.md

@@ -1,37 +0,0 @@
-# Indexer Settings
-
-## Prowlarr
-
-### `PROWLARR_ENABLED`
-
-Set to `True` to enable Prowlarr. Default is `False`. Example: `true`.
-
-### `PROWLARR_API_KEY`
-
-This is your Prowlarr API key. Example: `prowlarr_api_key`.
-
-### `PROWLARR_URL`
-
-Base URL of your Prowlarr instance. Default is `http://localhost:9696`. Example: `http://prowlarr:9696`.
-
-## Jackett
-
-### `JACKETT_ENABLED`
-
-Set to `True` to enable Jackett. Default is `False`. Example: `true`.
-
-### `JACKETT_API_KEY`
-
-This is your Prowlarr API key. Example: `jackett_api_key`.
-
-### `JACKETT_URL`
-
-Base URL of your Prowlarr instance. Default is `http://localhost:9117`. Example: `http://prowlarr:9117`.
-
-### `JACKETT_INDEXERS`
-
-List of all indexers for Jackett to search through. Default is `all`. Example: `["1337x","0magnet"]`.
-
-<note>
-    <include from="notes.topic" element-id="list-format"/>
-</note>

Writerside/topics/User-Guide.md

@@ -1,51 +0,0 @@
-# Usage
-
-If you are coming from Radarr or Sonarr you will find that MediaManager does things a bit differently.
-Instead of completely automatically downloading and managing your media, MediaManager focuses on providing an
-easy-to-use interface to guide you through the process of finding and downloading media. Advanced features like multiple
-qualities of a show/movie necessitate such a paradigm shift.
-__So here is a quick step-by-step guide to get you started:__
-
-<tabs>
-    <tab id="as-a-user" title="as a user">
-        <procedure title="Downloading/Requesting a show" id="request-show-user">
-           <step>Add a show on the "Add Show" page</step>
-           <step>After adding the show you will be redirected to the show's page.</step>
-           <step>There you can click the "Request Season" button.</step>
-           <step>Select one or more seasons that you want to download</step>
-           <step>Then select the "Min Quality", this will be the minimum resolution of the content to download.</step>
-           <step>Then select the "Wanted Quality", this will be the <strong>maximum</strong> resolution of the content to download.</step>
-           <step>Finally click Submit request, though this is not the last step!</step>
-           <step>An administrator first has to approve your request for download, only then will the requested content be downloaded.</step>
-           <p>Congratulation! You've downloaded a show.</p>
-        </procedure>
-    </tab>
-    <tab id="as-an-admin" title="as an admin">
-        <procedure title="Requesting a show" id="request-show-admin">
-           <step>Add a show on the "Add Show" page</step>
-           <step>After adding the show you will be redirected to the show's page.</step>
-           <step>There you can click the "Request Season" button.</step>
-           <step>Select one or more seasons that you want to download</step>
-           <step>Then select the "Min Quality", this will be the minimum resolution of the content to download.</step>
-           <step>Then select the "Wanted Quality", this will be the <strong>maximum</strong> resolution of the content to download.</step>
-           <step>Finally click Submit request, as you are an admin, your request will be automatically approved.</step>
-           <p>Congratulation! You've downloaded a show.</p>
-        </procedure>
-        <procedure title="Downloading a show" id="download-show-admin">
-            <p>You can only directly download a show if you are an admin!</p>
-           <step>Go to a show's page.</step>
-           <step>There you can click the "Download Season" button.</step>
-           <step>Enter the season's number that you want to download</step>
-           <step>Then optionally select the "File Path Suffix", <strong>it needs to be unique per season per show!</strong> </step>
-           <step>Then click "Download" on a torrent that you want to download.</step>
-           <p>Congratulation! You've downloaded a show.</p>
-        </procedure>
-        <procedure title="Managing requests" id="approving-request-admin">
-           <p>Users need their requests to be approved by an admin, to do this follow these steps:</p>
-           <step>Go to the "Requests" page.</step>
-           <step>There you can approve, delete or modify a user's request.</step>
-        </procedure>
-    </tab>
-</tabs>
-
-

Writerside/topics/api-reference.md

@@ -1,8 +0,0 @@
-# API Reference
-
-Media Manager's backend is built with FastAPI, which automatically generates interactive API documentation.
-
-* **Swagger UI**  (typically available at `http://localhost:8000/docs`).
-* **ReDoc** (typically available at `http://localhost:8000/redoc`).
-
-

Writerside/topics/authentication-setup.md

@@ -1,75 +0,0 @@
-# Authentication
-
-MediaManager supports multiple authentication methods. Email/password authentication is the default, but you can also
-enable OpenID Connect (OAuth 2.0) for integration with external identity providers.
-
-<note>
-   Note the lack of a trailing slash in some env vars like OPENID_CONFIGURATION_ENDPOINT. This is important.
-</note>
-
-## General Authentication Settings
-
-### `AUTH_TOKEN_SECRET`
-
-Strong secret key for signing JWTs (create with `openssl rand -hex 32`). This is a required field. Example:
-`AUTH_TOKEN_SECRET=your_super_secret_key`.
-
-### `AUTH_SESSION_LIFETIME`
-
-Lifetime of user sessions in seconds. Default is `86400` (1 day). Example: `AUTH_SESSION_LIFETIME=604800` (1 week).
-
-### `AUTH_ADMIN_EMAIL`
-
-A list of email addresses for administrator accounts. This is a required field. Example:
-`AUTH_ADMIN_EMAIL=admin@example.com`.
-
-### `FRONTEND_URL`
-
-The URL the frontend will be accessed from. This is a required field. Example: `https://mediamanager.example/`.
-
-<note>
-On login/registration, every user whose email is in <code>AUTH_ADMIN_EMAIL</code> will be granted admin privileges.
-Users whose email is not in <code>AUTH_ADMIN_EMAIL</code> will be regular users and will need to be verified by an administrator,
-this can be done in the settings page.
-</note>
-<tip>
-    <include from="notes.topic" element-id="list-format"/>
-</tip>
-
-## OpenID Connect (OAuth 2.0)
-
-### `OPENID_ENABLED`
-
-Enables OpenID authentication. Default is `FALSE`. Example: `TRUE`.
-
-### `OPENID_CLIENT_ID`
-
-Client ID from your OpenID provider.
-
-### `OPENID_CLIENT_SECRET`
-
-Client Secret from your OpenID provider.
-
-### `OPENID_CONFIGURATION_ENDPOINT`
-
-URL of your OpenID provider's discovery document (e.g., `.../.well-known/openid-configuration`). Example:
-`https://authentik.example.com/application/o/mediamanager/.well-known/openid-configuration`.
-
-### `OPENID_NAME`
-
-Display name for this OpenID provider. Default is `OpenID`. Example: `Authentik`.
-
-### Configuring OpenID Connect
-
-1. Set `OPENID_ENABLED=TRUE`
-2. Configure the following environment variables:
-    * `OPENID_CLIENT_ID`
-    * `OPENID_CLIENT_SECRET`
-    * `OPENID_CONFIGURATION_ENDPOINT`
-    * `OPENID_NAME` (optional)
-    * `FRONTEND_URL` (it is important that this is set correctly, as it is used for the redirect URIs)
-3. Your OpenID server will likely want a redirect URI. This URL will be like:
-   `{FRONTEND_URL}/api/v1/auth/cookie/{OPENID_NAME}/callback`. The exact path depends on the `OPENID_NAME`.
-
-4. Example URL: `https://mediamanager.example/api/v1/auth/cookie/Authentik/callback`
-

Writerside/topics/configuration-backend.md

@@ -1,153 +0,0 @@
-# Backend
-
-These variables configure the core backend application, database connections, authentication, and integrations.
-
-<note>
-    <include from="notes.topic" element-id="list-format"/>
-</note>
-
-## General Settings
-
-### `API_BASE_PATH`
-
-The url base of the backend. Default is `/api/v1`.
-
-### `CORS_URLS`
-
-Enter a list of origins you are going to access the api from. Example: `["https://mm.example"]`.
-
-## Database Settings
-
-### `DB_HOST`
-
-Hostname or IP of the PostgreSQL server. Default is `localhost`.
-
-### `DB_PORT`
-
-Port number of the PostgreSQL server. Default is `5432`.
-
-### `DB_USER`
-
-Username for PostgreSQL connection. Default is `MediaManager`.
-
-### `DB_PASSWORD`
-
-Password for the PostgreSQL user. Default is `MediaManager`.
-
-### `DB_DBNAME`
-
-Name of the PostgreSQL database. Default is `MediaManager`.
-
-## Download Client Settings
-
-Currently, only qBittorrent is supported as a download client. But support for other clients isn't unlikely in the
-future.
-
-### `QBITTORRENT_HOST`
-
-Host of the QBittorrent API. Default is `localhost`. Example: `qbit.example.com`.
-
-### `QBITTORRENT_PORT`
-
-Port of the QBittorrent API. Default is `8080`. Example: `443`.
-
-### `QBITTORRENT_USER`
-
-Username for QBittorrent. Default is `admin`.
-
-### `QBITTORRENT_PASSWORD`
-
-Password for QBittorrent. Default is `admin`.
-
-## Metadata Provider Settings
-
-
-<note>
-   Note the lack of a trailing slash in some env vars like <code>TMDB_RELAY_URL</code>. This is important.
-</note>
-
-
-
-These settings configure the integrations with external metadata providers like The Movie Database (TMDB) and The TVDB.
-
-### TMDB (The Movie Database)
-
-TMDB is the primary metadata provider for MediaManager. It provides detailed information about movies and TV shows.
-
-
-<tip>
-    Other software like Jellyfin use TMDB as well, so there won't be any metadata discrepancies.
-</tip>
-
-#### `TMDB_RELAY_URL`
-
-If you want use your own TMDB relay service, set this to the URL of your own MetadataRelay. Otherwise, don't set it to
-use the default relay.
-
-Default: `https://metadata-relay.maxid.me/tmdb`.
-
-### TVDB (The TVDB)
-
-<warning>
-    The TVDB might provide false metadata, also it doesn't support some features of MediaManager like to show overviews, therfore TMDB is the preferred metadata provider.
-</warning>
-
-#### `TVDB_RELAY_URL`
-
-If you want use your own TVDB relay service, set this to the URL of your own MetadataRelay. Otherwise, don't set it to
-use the default relay.
-
-Default: `https://metadata-relay.maxid.me/tvdb`.
-
-### MetadataRelay
-
-<note>
-  To use MediaManager <strong>you don't need to set up your own MetadataRelay</strong>, as the default relay which is hosted by me, the dev of MediaManager, should be sufficient for most purposes.
-</note>
-
-The MetadataRelay is a service that provides metadata for MediaManager. It acts as a proxy for TMDB and TVDB, allowing
-you to use your own API keys, but not strictly needing your own because only me, the developer, needs to create accounts
-for API keys.
-You might want to use it if you want to avoid rate limits, to protect your privacy, or other reasons.
-If you know Sonarr's Skyhook, this is similar to that.
-
-#### Where to get API keys
-
-Get an API key from [The Movie Database](https://www.themoviedb.org/settings/api). You can create
-an account and generate a free API key in your account settings.
-
-Get an API key from [The TVDB](https://thetvdb.com/auth/register). You can create an account and
-generate a free API key in your account settings.
-
-<tip>
-    If you want to use your own MetadataRelay, you can set the  <code>TMDB_RELAY_URL</code> and/or  <code>TVDB_RELAY_URL</code> to your own relay service.
-</tip>
-
-## Directory Settings
-
-<note>
-    Normally you don't need to change these, as the default mountpoints are usually sufficient. In your <code>docker-compose.yaml</code>, you can just mount <code>/any/directory</code> to <code>/data/torrents</code>.
-</note>
-
-### `IMAGE_DIRECTORY`
-
-Media images (posters, backdrops) will be stored here. Default is `/data/images`.
-
-### `TV_DIRECTORY`
-
-Location of TV show files. Default is `/data/tv`.
-
-### `MOVIE_DIRECTORY`
-
-Location of movie files. Default is `/data/movies`.
-
-### `TORRENT_DIRECTORY`
-
-Location of torrent files and downloads. Default is `/data/torrents`.
-
-## Build Arguments (Dockerfile)
-
-### `VERSION`
-
-Labels the Docker image with a version. Passed during build (e.g., by GitHub Actions). Frontend uses this as
-`PUBLIC_VERSION`. Example (in build command): `docker build --build-arg VERSION=1.2.3 .`

Writerside/topics/configuration-frontend.md

@@ -1,25 +0,0 @@
-# Frontend
-
-## Environment Variables
-
-### `PUBLIC_API_URL`
-
-You (the browser) must reach the backend from this url. Default is `http://localhost:8000/api/v1`. Example:
-`https://mediamanager.example.com/api/v1`.
-
-## Build Arguments (web/Dockerfile)
-
-**TODO: expand on this section**
-
-To configure a url base path for the frontend, you need to build the frontend docker container, this is because
-unfortunately SvelteKit needs to know the base path at build time.
-
-### `BASE_URL`
-
-Sets the base url path, it must begin with a slash and not end with one. Example (in build command):
-`docker build --build-arg BASE_URL=/media -f web/Dockerfile .`
-
-### `VERSION`
-
-Sets the `PUBLIC_VERSION` environment variable at runtime in the frontend container. Passed during build. Example (in
-build command): `docker build --build-arg VERSION=1.2.3 -f web/Dockerfile .`

Writerside/topics/configuration-overview.md

@@ -1,20 +0,0 @@
-# Installation Guide
-
-The recommended way to install and run Media Manager is using Docker and Docker Compose.
-
-## Prerequisites
-
-* Ensure Docker and Docker Compose are installed on your system.
-* If you plan to use OAuth 2.0 / OpenID Connect for authentication, you will need an account and client credentials
-  from an OpenID provider (e.g., Authentik, Pocket ID).
-
-## Setup
-
-* Download the docker-compose.yaml from the MediaManager repo with the following command:
-  ```
-  wget -o docker-compose.yaml https://raw.githubusercontent.com/maxdorninger/MediaManager/refs/heads/master/docker-compose.yaml
-  ```
-
-* Configure the necessary environment variables in your `docker-compose.yaml` file.
-* For more information on the available configuration options, see the [Configuration section](Configuration.md) of the
-  documentation.

Writerside/topics/contributing.md

@@ -1 +0,0 @@
-# Contributing

Writerside/topics/developer-guide.md

@@ -1,42 +0,0 @@
-# Developer Guide
-
-This section is for those who want to contribute to Media Manager or understand its internals.
-
-### Source Code
-
-- `media_manager/`: Backend FastAPI application (Python)
-- `web/`: Frontend SvelteKit application (TypeScript)
-
-### Backend Development
-
-- Uses `uv` for dependency management (see `pyproject.toml` and `uv.lock`)
-- Follows standard FastAPI project structure
-- Database migrations are handled by Alembic (`alembic.ini`, `alembic/` directory)
-
-### Frontend Development
-
-- Uses `npm` for package management (see `web/package.json`)
-- SvelteKit with TypeScript
-
-### Contributing
-
-- Please refer to the project's GitHub repository for contribution guidelines (e.g., forking, branching, pull requests)
-- Consider opening an issue to discuss significant changes before starting work
-
-## Tech Stack
-
-### Backend
-
-- Python with FastAPI
-- SQLAlchemy
-- Pydantic and Pydantic-Settings
-
-### Frontend
-
-- TypeScript with SvelteKit
-- Tailwind CSS
-- shadcn-svelte
-
-### CI/CD
-
-- GitHub Actions

Writerside/topics/introduction.md

@@ -1,27 +0,0 @@
-# MediaManager
-
-MediaManager is modern software to manage your TV and movie library. It is designed to be a replacement for Sonarr,
-Radarr, Overseer, and Jellyseer.
-It supports TVDB and TMDB for metadata, supports OIDC and OAuth 2.0 for authentication and supports Prowlarr and
-Jackett.
-MediaManager is built first and foremost for deployment with Docker, making it easy to set up.
-
-It also provides an API to interact with the software programmatically, allowing for automation and integration with
-other services.
-
-## Screenshots
-
-![screenshot-dashboard.png](screenshot-dashboard.png)
-
-![screenshot-tv-dashboard.png](screenshot-tv-dashboard.png)
-
-![screenshot-download-season.png](screenshot-download-season.png)
-
-![screenshot-request-season.png](screenshot-request-season.png)
-
-![screenshot-tv-torrents.png](screenshot-tv-torrents.png)
-
-![screenshot-settings.png](screenshot-settings.png)
-
-![screenshot-login.png](screenshot-login.png)
-

Writerside/topics/notes.topic

@@ -1,8 +0,0 @@
-<?xml version='1.0' encoding='UTF-8'?>
-<!DOCTYPE topic SYSTEM "https://resources.jetbrains.com/writerside/1.0/html-entities.dtd">
-<topic id="notes"
-       is-library="true" title="notes" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="https://resources.jetbrains.com/writerside/1.0/topic.v2.xsd">
-    <snippet id="list-format">
-        Lists have to be formatted like this: <code>["item1", "item2", "item3"]</code>. Note the double quotes.
-    </snippet>
-</topic>

Writerside/topics/troubleshooting.md

@@ -1,28 +0,0 @@
-# Troubleshooting
-
-<note>
-    Note the lack of a trailing slash in some env vars like FRONTEND_URL. This is important.
-</note>
-
-<tip>
-    Always check the container and browser logs for more specific error messages
-</tip>
-
-## Authentication Issues (OIDC)
-
-* Verify `OPENID_CLIENT_ID`, `OPENID_CLIENT_SECRET`, and `OPENID_CONFIGURATION_ENDPOINT` are correct.
-* Ensure the `FRONTEND_URL` is accurate and that your OpenID provider has the correct redirect URI whitelisted (
-  e.g., `http://your-frontend-url/api/v1/auth/cookie/Authentik/callback`).
-* Check backend logs for errors from `httpx_oauth` or `fastapi-users`.
-
-## CORS Errors
-
-* Ensure `FRONTEND_URL` is correctly set.
-* Ensure your frontend's url is listed in `CORS_URLS`.
-
-## Data Not Appearing / File Issues
-
-* Verify that the volume mounts for `IMAGE_DIRECTORY`, `TV_DIRECTORY`, `MOVIE_DIRECTORY`, and `TORRENT_DIRECTORY` in
-  your `docker-compose.yaml` are correctly pointing to your media folders on the host machine.
-* Check file and directory permissions for the user running the Docker container (or the `node` user inside the
-  containers).

Writerside/v.list

@@ -1,5 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<!DOCTYPE vars SYSTEM "https://resources.jetbrains.com/writerside/1.0/vars.dtd">
-<vars>
-    <var name="product" value="Writerside"/>
-</vars>

Writerside/writerside.cfg

@@ -1,9 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<!DOCTYPE ihp SYSTEM "https://resources.jetbrains.com/writerside/1.0/ihp.dtd">
-
-<ihp version="2.0">
-    <topics dir="topics" web-path="topics"/>
-    <images dir="images" web-path="MediaManager"/>
-    <instance src="mm.tree"/>
-    <instance src="Writerside_libraries.tree"/>
-</ihp>

alembic/env.py

@@ -1,14 +1,16 @@
 import sys
 
-sys.path = ["", ".."] + sys.path[1:]
+sys.path = ["", "..", *sys.path[1:]]
 
 
 from logging.config import fileConfig  # noqa: E402
 
+from sqlalchemy import (  # noqa: E402
+    engine_from_config,
+    pool,
+)
+
 from alembic import context  # noqa: E402
-from pydantic_settings import BaseSettings, SettingsConfigDict  # noqa: E402
-from sqlalchemy import engine_from_config  # noqa: E402
-from sqlalchemy import pool  # noqa: E402
 
 # this is the Alembic Config object, which provides
 # access to the values within the .ini file in use.
@@ -24,28 +26,37 @@ if config.config_file_name is not None:
 # from myapp import mymodel
 # target_metadata = mymodel.Base.metadata
 
-from media_manager.auth.db import User, OAuthAccount  # noqa: E402
-from media_manager.indexer.models import IndexerQueryResult  # noqa: E402
-from media_manager.torrent.models import Torrent  # noqa: E402
-from media_manager.tv.models import Show, Season, Episode, SeasonFile, SeasonRequest  # noqa: E402
-
+from media_manager.auth.db import OAuthAccount, User  # noqa: E402
+from media_manager.config import MediaManagerConfig  # noqa: E402
 from media_manager.database import Base  # noqa: E402
+from media_manager.indexer.models import IndexerQueryResult  # noqa: E402
+from media_manager.movies.models import Movie, MovieFile  # noqa: E402
+from media_manager.notification.models import Notification  # noqa: E402
+from media_manager.torrent.models import Torrent  # noqa: E402
+from media_manager.tv.models import (  # noqa: E402
+    Episode,
+    EpisodeFile,
+    Season,
+    Show,
+)
 
 target_metadata = Base.metadata
 
 # this is to keep pycharm from complaining about/optimizing unused imports
 # noinspection PyStatementEffect
-(
-    User,
-    OAuthAccount,
-    IndexerQueryResult,
-    Torrent,
-    Show,
-    Season,
-    Episode,
-    SeasonFile,
-    SeasonRequest,
-)
+__all__ = [
+    "Episode",
+    "EpisodeFile",
+    "IndexerQueryResult",
+    "Movie",
+    "MovieFile",
+    "Notification",
+    "OAuthAccount",
+    "Season",
+    "Show",
+    "Torrent",
+    "User",
+]
 
 
 # other values from the config, defined by the needs of env.py,
@@ -54,29 +65,8 @@ target_metadata = Base.metadata
 # ... etc.
 
 
-class DbConfig(BaseSettings):
-    model_config = SettingsConfigDict(env_prefix="DB_")
-    HOST: str = "localhost"
-    PORT: int = 5432
-    USER: str = "MediaManager"
-    PASSWORD: str = "MediaManager"
-    DBNAME: str = "MediaManager"
-
-
-db_config = DbConfig()
-db_url = (
-    "postgresql+psycopg"
-    + "://"
-    + db_config.USER
-    + ":"
-    + db_config.PASSWORD
-    + "@"
-    + db_config.HOST
-    + ":"
-    + str(db_config.PORT)
-    + "/"
-    + db_config.DBNAME
-)
+db_config = MediaManagerConfig().database
+db_url = f"postgresql+psycopg://{db_config.user}:{db_config.password}@{db_config.host}:{db_config.port}/{db_config.dbname}"
 
 config.set_main_option("sqlalchemy.url", db_url)
 
@@ -112,6 +102,18 @@ def run_migrations_online() -> None:
     and associate a connection with the context.
 
     """
+
+    def include_object(
+        _object: object | None,
+        name: str | None,
+        type_: str | None,
+        _reflected: bool | None,
+        _compare_to: object | None,
+    ) -> bool:
+        if type_ == "table" and name == "apscheduler_jobs":
+            return False
+        return True
+
     connectable = engine_from_config(
         config.get_section(config.config_ini_section, {}),
         prefix="sqlalchemy.",
@@ -119,7 +121,11 @@ def run_migrations_online() -> None:
     )
 
     with connectable.connect() as connection:
-        context.configure(connection=connection, target_metadata=target_metadata)
+        context.configure(
+            connection=connection,
+            target_metadata=target_metadata,
+            include_object=include_object,
+        )
 
         with context.begin_transaction():
             context.run_migrations()

alembic/versions/16e78af9e5bf_add_original_language_columns_to_show_.py

@@ -0,0 +1,37 @@
+"""add original_language columns to show and movie tables
+
+Revision ID: 16e78af9e5bf
+Revises: eb0bd3cc1852
+Create Date: 2025-12-13 18:47:02.146038
+
+"""
+
+from typing import Sequence, Union
+
+import sqlalchemy as sa
+
+from alembic import op
+
+# revision identifiers, used by Alembic.
+revision: str = "16e78af9e5bf"
+down_revision: Union[str, None] = "eb0bd3cc1852"
+branch_labels: Union[str, Sequence[str], None] = None
+depends_on: Union[str, Sequence[str], None] = None
+
+
+def upgrade() -> None:
+    """Upgrade schema."""
+    # Add original_language column to show table
+    op.add_column("show", sa.Column("original_language", sa.String(10), nullable=True))
+
+    # Add original_language column to movie table
+    op.add_column("movie", sa.Column("original_language", sa.String(10), nullable=True))
+
+
+def downgrade() -> None:
+    """Downgrade schema."""
+    # Remove original_language column from movie table
+    op.drop_column("movie", "original_language")
+
+    # Remove original_language column from show table
+    op.drop_column("show", "original_language")

alembic/versions/1801d9f5a275_add_library_field_to_movie_and_show_.py

@@ -0,0 +1,41 @@
+"""Add library field to Movie and Show tables
+
+Revision ID: 1801d9f5a275
+Revises: 333866afcd2c
+Create Date: 2025-07-16 01:09:44.045395
+
+"""
+
+from typing import Sequence, Union
+
+import sqlalchemy as sa
+
+from alembic import op
+
+# revision identifiers, used by Alembic.
+revision: str = "1801d9f5a275"
+down_revision: Union[str, None] = "333866afcd2c"
+branch_labels: Union[str, Sequence[str], None] = None
+depends_on: Union[str, Sequence[str], None] = None
+
+
+def upgrade() -> None:
+    """Upgrade schema."""
+    op.add_column(
+        "movie",
+        sa.Column(
+            "library", sa.String(), nullable=False, server_default=sa.text("'Default'")
+        ),
+    )
+    op.add_column(
+        "show",
+        sa.Column(
+            "library", sa.String(), nullable=False, server_default=sa.text("'Default'")
+        ),
+    )
+
+
+def downgrade() -> None:
+    """Downgrade schema."""
+    op.drop_column("show", "library")
+    op.drop_column("movie", "library")

alembic/versions/1f340754640a_add_continuous_download_column_to_show_.py

@@ -8,9 +8,9 @@ Create Date: 2025-06-22 13:46:01.973406
 
 from typing import Sequence, Union
 
-from alembic import op
 import sqlalchemy as sa
 
+from alembic import op
 
 # revision identifiers, used by Alembic.
 revision: str = "1f340754640a"

alembic/versions/21a19f0675f9_increase_access_token_length.py

@@ -0,0 +1,45 @@
+"""increase_access_token_length
+
+Revision ID: 21a19f0675f9
+Revises: 1f340754640a
+Create Date: 2025-07-06 10:49:08.814496
+
+"""
+
+from typing import Sequence, Union
+
+import sqlalchemy as sa
+
+from alembic import op
+
+# revision identifiers, used by Alembic.
+revision: str = "21a19f0675f9"
+down_revision: Union[str, None] = "1f340754640a"
+branch_labels: Union[str, Sequence[str], None] = None
+depends_on: Union[str, Sequence[str], None] = None
+
+
+def upgrade() -> None:
+    """Upgrade schema."""
+    # ### commands auto generated by Alembic - please adjust! ###
+    op.alter_column(
+        "oauth_account",
+        "access_token",
+        existing_type=sa.VARCHAR(length=1024),
+        type_=sa.String(length=4096),
+        existing_nullable=False,
+    )
+    # ### end Alembic commands ###
+
+
+def downgrade() -> None:
+    """Downgrade schema."""
+    # ### commands auto generated by Alembic - please adjust! ###
+    op.alter_column(
+        "oauth_account",
+        "access_token",
+        existing_type=sa.String(length=4096),
+        type_=sa.VARCHAR(length=1024),
+        existing_nullable=False,
+    )
+    # ### end Alembic commands ###

alembic/versions/2c61f662ca9e_add_imdb_id_fields.py

@@ -0,0 +1,35 @@
+"""add imdb_id fields
+
+Revision ID: 2c61f662ca9e
+Revises: 16e78af9e5bf
+Create Date: 2025-12-23 19:42:09.593945
+
+"""
+
+from typing import Sequence, Union
+
+import sqlalchemy as sa
+
+from alembic import op
+
+# revision identifiers, used by Alembic.
+revision: str = "2c61f662ca9e"
+down_revision: Union[str, None] = "16e78af9e5bf"
+branch_labels: Union[str, Sequence[str], None] = None
+depends_on: Union[str, Sequence[str], None] = None
+
+
+def upgrade() -> None:
+    """Upgrade schema."""
+    # ### commands auto generated by Alembic - please adjust! ###
+    op.add_column("movie", sa.Column("imdb_id", sa.String(), nullable=True))
+    op.add_column("show", sa.Column("imdb_id", sa.String(), nullable=True))
+    # ### end Alembic commands ###
+
+
+def downgrade() -> None:
+    """Downgrade schema."""
+    # ### commands auto generated by Alembic - please adjust! ###
+    op.drop_column("show", "imdb_id")
+    op.drop_column("movie", "imdb_id")
+    # ### end Alembic commands ###

alembic/versions/333866afcd2c_add_usenet_columns.py

@@ -0,0 +1,50 @@
+"""add-usenet-columns
+
+Revision ID: 333866afcd2c
+Revises: aa4689f80796
+Create Date: 2025-07-09 20:55:42.338629
+
+"""
+
+from typing import Sequence, Union
+
+import sqlalchemy as sa
+
+from alembic import op
+
+# revision identifiers, used by Alembic.
+revision: str = "333866afcd2c"
+down_revision: Union[str, None] = "aa4689f80796"
+branch_labels: Union[str, Sequence[str], None] = None
+depends_on: Union[str, Sequence[str], None] = None
+
+
+def upgrade() -> None:
+    """Upgrade schema."""
+    # ### commands auto generated by Alembic - please adjust! ###
+    op.add_column(
+        "indexer_query_result",
+        sa.Column(
+            "usenet", sa.Boolean(), nullable=False, server_default=sa.text("false")
+        ),
+    )
+    op.add_column(
+        "indexer_query_result",
+        sa.Column("age", sa.Integer(), nullable=False, server_default=sa.text("0")),
+    )
+    op.add_column(
+        "torrent",
+        sa.Column(
+            "usenet", sa.Boolean(), nullable=False, server_default=sa.text("false")
+        ),
+    )
+    # ### end Alembic commands ###
+
+
+def downgrade() -> None:
+    """Downgrade schema."""
+    # ### commands auto generated by Alembic - please adjust! ###
+    op.drop_column("torrent", "usenet")
+    op.drop_column("indexer_query_result", "age")
+    op.drop_column("indexer_query_result", "usenet")
+    # ### end Alembic commands ###

alembic/versions/3a8fbd71e2c2_create_episode_file_table_and_add_episode_column_to_indexerqueryresult.py

@@ -0,0 +1,46 @@
+"""create episode file table and add episode column to indexerqueryresult
+
+Revision ID: 3a8fbd71e2c2
+Revises: 9f3c1b2a4d8e
+Create Date: 2026-01-08 13:43:00
+
+"""
+
+from typing import Sequence, Union
+
+from alembic import op
+from sqlalchemy.dialects import postgresql
+import sqlalchemy as sa
+
+
+# revision identifiers, used by Alembic.
+revision: str = "3a8fbd71e2c2"
+down_revision: Union[str, None] = "9f3c1b2a4d8e"
+branch_labels: Union[str, Sequence[str], None] = None
+depends_on: Union[str, Sequence[str], None] = None
+
+
+
+def upgrade() -> None:
+    quality_enum = postgresql.ENUM("uhd", "fullhd", "hd", "sd", "unknown", name="quality",
+        create_type=False,
+    )
+    # Create episode file table
+    op.create_table(
+        "episode_file",
+        sa.Column("episode_id", sa.UUID(), nullable=False),
+        sa.Column("torrent_id", sa.UUID(), nullable=True),
+        sa.Column("file_path_suffix", sa.String(), nullable=False),
+        sa.Column("quality", quality_enum, nullable=False),
+        sa.ForeignKeyConstraint(["episode_id"], ["episode.id"], ondelete="CASCADE"),
+        sa.ForeignKeyConstraint(["torrent_id"], ["torrent.id"], ondelete="SET NULL"),
+        sa.PrimaryKeyConstraint("episode_id", "file_path_suffix"),
+    )
+    # Add episode column to indexerqueryresult
+    op.add_column(
+        "indexer_query_result", sa.Column("episode", postgresql.ARRAY(sa.Integer()), nullable=True),
+    )
+
+def downgrade() -> None:
+    op.drop_table("episode_file")
+    op.drop_column("indexer_query_result", "episode")

alembic/versions/5299dfed220b_add_score_field_to_indexerqueryresult_.py

@@ -0,0 +1,36 @@
+"""Add score field to IndexerQueryResult table
+
+Revision ID: 5299dfed220b
+Revises: 1801d9f5a275
+Create Date: 2025-07-16 23:24:37.931188
+
+"""
+
+from typing import Sequence, Union
+
+import sqlalchemy as sa
+
+from alembic import op
+
+# revision identifiers, used by Alembic.
+revision: str = "5299dfed220b"
+down_revision: Union[str, None] = "1801d9f5a275"
+branch_labels: Union[str, Sequence[str], None] = None
+depends_on: Union[str, Sequence[str], None] = None
+
+
+def upgrade() -> None:
+    """Upgrade schema."""
+    # ### commands auto generated by Alembic - please adjust! ###
+    op.add_column(
+        "indexer_query_result",
+        sa.Column("score", sa.Integer(), nullable=False, server_default=sa.text("0")),
+    )
+    # ### end Alembic commands ###
+
+
+def downgrade() -> None:
+    """Downgrade schema."""
+    # ### commands auto generated by Alembic - please adjust! ###
+    op.drop_column("indexer_query_result", "score")
+    # ### end Alembic commands ###

alembic/versions/7508237d5bc2_add_ended_column_to_show_table.py

@@ -8,9 +8,9 @@ Create Date: 2025-06-10 21:25:27.871064
 
 from typing import Sequence, Union
 
-from alembic import op
 import sqlalchemy as sa
 
+from alembic import op
 
 # revision identifiers, used by Alembic.
 revision: str = "7508237d5bc2"

alembic/versions/93fb07842385_initial_migration.py

@@ -8,6 +8,10 @@ Create Date: 2025-05-27 21:36:18.532068
 
 from typing import Sequence, Union
 
+import sqlalchemy as sa
+from sqlalchemy.dialects import postgresql
+
+from alembic import op
 
 # revision identifiers, used by Alembic.
 revision: str = "93fb07842385"
@@ -19,6 +23,230 @@ depends_on: Union[str, Sequence[str], None] = None
 def upgrade() -> None:
     """Upgrade schema."""
     # ### commands auto generated by Alembic - please adjust! ###
+    # Create user table
+    op.create_table(
+        "user",
+        sa.Column("id", sa.UUID(), nullable=False),
+        sa.Column("email", sa.String(length=320), nullable=False),
+        sa.Column("hashed_password", sa.String(length=1024), nullable=False),
+        sa.Column("is_active", sa.Boolean(), nullable=False),
+        sa.Column("is_superuser", sa.Boolean(), nullable=False),
+        sa.Column("is_verified", sa.Boolean(), nullable=False),
+        sa.PrimaryKeyConstraint("id"),
+    )
+    op.create_index(op.f("ix_user_email"), "user", ["email"], unique=True)
+
+    # Create oauth account table
+    op.create_table(
+        "oauth_account",
+        sa.Column("id", sa.UUID(), nullable=False),
+        sa.Column("oauth_name", sa.String(length=100), nullable=False),
+        sa.Column("access_token", sa.String(length=1024), nullable=False),
+        sa.Column("expires_at", sa.Integer(), nullable=True),
+        sa.Column("refresh_token", sa.String(length=1024), nullable=True),
+        sa.Column("account_id", sa.String(length=320), nullable=False),
+        sa.Column("account_email", sa.String(length=320), nullable=False),
+        sa.Column("user_id", sa.UUID(), nullable=False),
+        sa.ForeignKeyConstraint(["user_id"], ["user.id"], ondelete="cascade"),
+        sa.PrimaryKeyConstraint("id"),
+    )
+    op.create_index(
+        op.f("ix_oauth_account_account_id"),
+        "oauth_account",
+        ["account_id"],
+        unique=False,
+    )
+    op.create_index(
+        op.f("ix_oauth_account_oauth_name"),
+        "oauth_account",
+        ["oauth_name"],
+        unique=False,
+    )
+
+    # Create torrent table
+    op.create_table(
+        "torrent",
+        sa.Column("id", sa.UUID(), nullable=False),
+        sa.Column(
+            "status",
+            sa.Enum(
+                "finished", "downloading", "error", "unknown", name="torrentstatus"
+            ),
+            nullable=False,
+        ),
+        sa.Column("title", sa.String(), nullable=False),
+        sa.Column(
+            "quality",
+            sa.Enum("uhd", "fullhd", "hd", "sd", "unknown", name="quality"),
+            nullable=False,
+        ),
+        sa.Column("imported", sa.Boolean(), nullable=False),
+        sa.Column("hash", sa.String(), nullable=False),
+        sa.PrimaryKeyConstraint("id"),
+    )
+
+    # Create indexer query result table
+    op.create_table(
+        "indexer_query_result",
+        sa.Column("id", sa.UUID(), nullable=False),
+        sa.Column("title", sa.String(), nullable=False),
+        sa.Column("download_url", sa.String(), nullable=False),
+        sa.Column("seeders", sa.Integer(), nullable=False),
+        sa.Column("flags", postgresql.ARRAY(sa.String()), nullable=True),
+        sa.Column(
+            "quality",
+            sa.Enum("uhd", "fullhd", "hd", "sd", "unknown", name="quality"),
+            nullable=False,
+        ),
+        sa.Column("season", postgresql.ARRAY(sa.Integer()), nullable=True),
+        sa.Column("size", sa.BigInteger(), nullable=True),
+        sa.PrimaryKeyConstraint("id"),
+    )
+
+    # Create notification table
+    op.create_table(
+        "notification",
+        sa.Column("id", sa.UUID(), nullable=False),
+        sa.Column("message", sa.String(), nullable=False),
+        sa.Column("read", sa.Boolean(), nullable=False),
+        sa.Column("timestamp", sa.DateTime(), nullable=False),
+        sa.PrimaryKeyConstraint("id"),
+    )
+
+    # Create show table
+    op.create_table(
+        "show",
+        sa.Column("id", sa.UUID(), nullable=False),
+        sa.Column("external_id", sa.Integer(), nullable=False),
+        sa.Column("metadata_provider", sa.String(), nullable=False),
+        sa.Column("name", sa.String(), nullable=False),
+        sa.Column("overview", sa.String(), nullable=False),
+        sa.Column("year", sa.Integer(), nullable=True),
+        sa.PrimaryKeyConstraint("id"),
+        sa.UniqueConstraint("external_id", "metadata_provider"),
+    )
+
+    # Create movie table
+    op.create_table(
+        "movie",
+        sa.Column("id", sa.UUID(), nullable=False),
+        sa.Column("external_id", sa.Integer(), nullable=False),
+        sa.Column("metadata_provider", sa.String(), nullable=False),
+        sa.Column("name", sa.String(), nullable=False),
+        sa.Column("overview", sa.String(), nullable=False),
+        sa.Column("year", sa.Integer(), nullable=True),
+        sa.PrimaryKeyConstraint("id"),
+        sa.UniqueConstraint("external_id", "metadata_provider"),
+    )
+
+    # Create season table
+    op.create_table(
+        "season",
+        sa.Column("id", sa.UUID(), nullable=False),
+        sa.Column("show_id", sa.UUID(), nullable=False),
+        sa.Column("number", sa.Integer(), nullable=False),
+        sa.Column("external_id", sa.Integer(), nullable=False),
+        sa.Column("name", sa.String(), nullable=False),
+        sa.Column("overview", sa.String(), nullable=False),
+        sa.ForeignKeyConstraint(["show_id"], ["show.id"], ondelete="CASCADE"),
+        sa.PrimaryKeyConstraint("id"),
+        sa.UniqueConstraint("show_id", "number"),
+    )
+
+    # Create movie file table
+    op.create_table(
+        "movie_file",
+        sa.Column("movie_id", sa.UUID(), nullable=False),
+        sa.Column("file_path_suffix", sa.String(), nullable=False),
+        sa.Column(
+            "quality",
+            sa.Enum("uhd", "fullhd", "hd", "sd", "unknown", name="quality"),
+            nullable=False,
+        ),
+        sa.Column("torrent_id", sa.UUID(), nullable=True),
+        sa.ForeignKeyConstraint(["movie_id"], ["movie.id"], ondelete="CASCADE"),
+        sa.ForeignKeyConstraint(["torrent_id"], ["torrent.id"], ondelete="SET NULL"),
+        sa.PrimaryKeyConstraint("movie_id", "file_path_suffix"),
+    )
+
+    # Create movie request table
+    op.create_table(
+        "movie_request",
+        sa.Column("id", sa.UUID(), nullable=False),
+        sa.Column("movie_id", sa.UUID(), nullable=False),
+        sa.Column(
+            "wanted_quality",
+            sa.Enum("uhd", "fullhd", "hd", "sd", "unknown", name="quality"),
+            nullable=False,
+        ),
+        sa.Column(
+            "min_quality",
+            sa.Enum("uhd", "fullhd", "hd", "sd", "unknown", name="quality"),
+            nullable=False,
+        ),
+        sa.Column("authorized", sa.Boolean(), nullable=False),
+        sa.Column("requested_by_id", sa.UUID(), nullable=True),
+        sa.Column("authorized_by_id", sa.UUID(), nullable=True),
+        sa.ForeignKeyConstraint(["authorized_by_id"], ["user.id"], ondelete="SET NULL"),
+        sa.ForeignKeyConstraint(["movie_id"], ["movie.id"], ondelete="CASCADE"),
+        sa.ForeignKeyConstraint(["requested_by_id"], ["user.id"], ondelete="SET NULL"),
+        sa.PrimaryKeyConstraint("id"),
+        sa.UniqueConstraint("movie_id", "wanted_quality"),
+    )
+
+    # Create episode table
+    op.create_table(
+        "episode",
+        sa.Column("id", sa.UUID(), nullable=False),
+        sa.Column("season_id", sa.UUID(), nullable=False),
+        sa.Column("number", sa.Integer(), nullable=False),
+        sa.Column("external_id", sa.Integer(), nullable=False),
+        sa.Column("title", sa.String(), nullable=False),
+        sa.ForeignKeyConstraint(["season_id"], ["season.id"], ondelete="CASCADE"),
+        sa.PrimaryKeyConstraint("id"),
+        sa.UniqueConstraint("season_id", "number"),
+    )
+
+    # Create season file table
+    op.create_table(
+        "season_file",
+        sa.Column("season_id", sa.UUID(), nullable=False),
+        sa.Column("torrent_id", sa.UUID(), nullable=True),
+        sa.Column("file_path_suffix", sa.String(), nullable=False),
+        sa.Column(
+            "quality",
+            sa.Enum("uhd", "fullhd", "hd", "sd", "unknown", name="quality"),
+            nullable=False,
+        ),
+        sa.ForeignKeyConstraint(["season_id"], ["season.id"], ondelete="CASCADE"),
+        sa.ForeignKeyConstraint(["torrent_id"], ["torrent.id"], ondelete="SET NULL"),
+        sa.PrimaryKeyConstraint("season_id", "file_path_suffix"),
+    )
+
+    # Create season request table
+    op.create_table(
+        "season_request",
+        sa.Column("id", sa.UUID(), nullable=False),
+        sa.Column("season_id", sa.UUID(), nullable=False),
+        sa.Column(
+            "wanted_quality",
+            sa.Enum("uhd", "fullhd", "hd", "sd", "unknown", name="quality"),
+            nullable=False,
+        ),
+        sa.Column(
+            "min_quality",
+            sa.Enum("uhd", "fullhd", "hd", "sd", "unknown", name="quality"),
+            nullable=False,
+        ),
+        sa.Column("requested_by_id", sa.UUID(), nullable=True),
+        sa.Column("authorized", sa.Boolean(), nullable=False),
+        sa.Column("authorized_by_id", sa.UUID(), nullable=True),
+        sa.ForeignKeyConstraint(["authorized_by_id"], ["user.id"], ondelete="SET NULL"),
+        sa.ForeignKeyConstraint(["requested_by_id"], ["user.id"], ondelete="SET NULL"),
+        sa.ForeignKeyConstraint(["season_id"], ["season.id"], ondelete="CASCADE"),
+        sa.PrimaryKeyConstraint("id"),
+        sa.UniqueConstraint("season_id", "wanted_quality"),
+    )
 
     # ### end Alembic commands ###
 
@@ -26,5 +254,20 @@ def upgrade() -> None:
 def downgrade() -> None:
     """Downgrade schema."""
     # ### commands auto generated by Alembic - please adjust! ###
-
+    op.drop_table("season_request")
+    op.drop_table("season_file")
+    op.drop_table("episode")
+    op.drop_table("movie_request")
+    op.drop_table("movie_file")
+    op.drop_table("season")
+    op.drop_table("movie")
+    op.drop_table("show")
+    op.drop_table("notification")
+    op.drop_table("indexer_query_result")
+    op.drop_table("torrent")
+    op.drop_index(op.f("ix_oauth_account_oauth_name"), table_name="oauth_account")
+    op.drop_index(op.f("ix_oauth_account_account_id"), table_name="oauth_account")
+    op.drop_table("oauth_account")
+    op.drop_index(op.f("ix_user_email"), table_name="user")
+    op.drop_table("user")
     # ### end Alembic commands ###

alembic/versions/9f3c1b2a4d8e_add_overview_column_to_episode_table.py

@@ -0,0 +1,31 @@
+"""add overview column to episode table
+
+Revision ID: 9f3c1b2a4d8e
+Revises: 2c61f662ca9e
+Create Date: 2025-12-29 21:45:00
+
+"""
+
+from typing import Sequence, Union
+
+from alembic import op
+import sqlalchemy as sa
+
+
+# revision identifiers, used by Alembic.
+revision: str = "9f3c1b2a4d8e"
+down_revision: Union[str, None] = "2c61f662ca9e"
+branch_labels: Union[str, Sequence[str], None] = None
+depends_on: Union[str, Sequence[str], None] = None
+
+
+def upgrade() -> None:
+    # Add overview to episode table
+    op.add_column(
+        "episode",
+        sa.Column("overview", sa.Text(), nullable=True),
+    )
+
+def downgrade() -> None:
+    op.drop_column("episode", "overview")
+

alembic/versions/a6f714d3c8b9_migrate_season_files_to_episode_files.py

@@ -0,0 +1,71 @@
+"""migrate season files to episode files and drop the legacy table
+
+Revision ID: a6f714d3c8b9
+Revises: 16e78af9e5bf
+Create Date: 2026-02-22 16:30:00
+
+"""
+
+from typing import Sequence, Union
+
+import sqlalchemy as sa
+from alembic import op
+from sqlalchemy.dialects import postgresql
+
+
+# revision identifiers, used by Alembic.
+revision: str = "a6f714d3c8b9"
+down_revision: Union[str, None] = "3a8fbd71e2c2"
+branch_labels: Union[str, Sequence[str], None] = None
+depends_on: Union[str, Sequence[str], None] = None
+
+
+def upgrade() -> None:
+    """Copy season_file records into episode_file and remove the legacy table."""
+    op.execute(
+        """
+        INSERT INTO episode_file (episode_id, torrent_id, file_path_suffix, quality)
+        SELECT episode.id, season_file.torrent_id, season_file.file_path_suffix, season_file.quality
+        FROM season_file
+        JOIN season ON season.id = season_file.season_id
+        JOIN episode ON episode.season_id = season.id
+        LEFT JOIN episode_file ON
+            episode_file.episode_id = episode.id
+            AND episode_file.file_path_suffix = season_file.file_path_suffix
+        WHERE episode_file.episode_id IS NULL
+        """
+    )
+    op.drop_table("season_file")
+
+
+def downgrade() -> None:
+    """Recreate season_file, repopulate it from episode_file, and keep both tables."""
+    quality_enum = postgresql.ENUM(
+        "uhd", "fullhd", "hd", "sd", "unknown", name="quality", create_type=False
+    )
+
+    op.create_table(
+        "season_file",
+        sa.Column("season_id", sa.UUID(), nullable=False),
+        sa.Column("torrent_id", sa.UUID(), nullable=True),
+        sa.Column("file_path_suffix", sa.String(), nullable=False),
+        sa.Column("quality", quality_enum, nullable=False),
+        sa.ForeignKeyConstraint(["season_id"], ["season.id"], ondelete="CASCADE"),
+        sa.ForeignKeyConstraint(["torrent_id"], ["torrent.id"], ondelete="SET NULL"),
+        sa.PrimaryKeyConstraint("season_id", "file_path_suffix"),
+    )
+
+    op.execute(
+        """
+        INSERT INTO season_file (season_id, torrent_id, file_path_suffix, quality)
+        SELECT DISTINCT ON (episode.season_id, episode_file.file_path_suffix)
+            episode.season_id,
+            episode_file.torrent_id,
+            episode_file.file_path_suffix,
+            episode_file.quality
+        FROM episode_file
+        JOIN episode ON episode.id = episode_file.episode_id
+        ORDER BY episode.season_id, episode_file.file_path_suffix, episode_file.torrent_id, episode_file.quality
+        """
+    )
+

alembic/versions/aa4689f80796_increase_refresh_token_length.py

@@ -0,0 +1,45 @@
+"""increase_refresh_token_length
+
+Revision ID: aa4689f80796
+Revises: 21a19f0675f9
+Create Date: 2025-07-06 10:54:19.714809
+
+"""
+
+from typing import Sequence, Union
+
+import sqlalchemy as sa
+
+from alembic import op
+
+# revision identifiers, used by Alembic.
+revision: str = "aa4689f80796"
+down_revision: Union[str, None] = "21a19f0675f9"
+branch_labels: Union[str, Sequence[str], None] = None
+depends_on: Union[str, Sequence[str], None] = None
+
+
+def upgrade() -> None:
+    """Upgrade schema."""
+    # ### commands auto generated by Alembic - please adjust! ###
+    op.alter_column(
+        "oauth_account",
+        "refresh_token",
+        existing_type=sa.VARCHAR(length=1024),
+        type_=sa.String(length=4096),
+        existing_nullable=True,
+    )
+    # ### end Alembic commands ###
+
+
+def downgrade() -> None:
+    """Downgrade schema."""
+    # ### commands auto generated by Alembic - please adjust! ###
+    op.alter_column(
+        "oauth_account",
+        "refresh_token",
+        existing_type=sa.String(length=4096),
+        type_=sa.VARCHAR(length=1024),
+        existing_nullable=True,
+    )
+    # ### end Alembic commands ###

alembic/versions/e60ae827ed98_remove_requests.py

@@ -0,0 +1,65 @@
+"""remove requests
+
+Revision ID: e60ae827ed98
+Revises: a6f714d3c8b9
+Create Date: 2026-02-22 18:07:12.866130
+
+"""
+from typing import Sequence, Union
+
+from alembic import op
+import sqlalchemy as sa
+from sqlalchemy.dialects import postgresql
+
+# revision identifiers, used by Alembic.
+revision: str = 'e60ae827ed98'
+down_revision: Union[str, None] = 'a6f714d3c8b9'
+branch_labels: Union[str, Sequence[str], None] = None
+depends_on: Union[str, Sequence[str], None] = None
+
+
+def upgrade() -> None:
+    """Upgrade schema."""
+    # ### commands auto generated by Alembic - please adjust! ###
+    op.drop_table('movie_request')
+    op.drop_table('season_request')
+    op.alter_column('episode', 'overview',
+               existing_type=sa.TEXT(),
+               type_=sa.String(),
+               existing_nullable=True)
+    # ### end Alembic commands ###
+
+
+def downgrade() -> None:
+    """Downgrade schema."""
+    # ### commands auto generated by Alembic - please adjust! ###
+
+    op.create_table('season_request',
+    sa.Column('id', sa.UUID(), autoincrement=False, nullable=False),
+    sa.Column('season_id', sa.UUID(), autoincrement=False, nullable=False),
+    sa.Column('wanted_quality', postgresql.ENUM('uhd', 'fullhd', 'hd', 'sd', 'unknown', name='quality'), autoincrement=False, nullable=False),
+    sa.Column('min_quality', postgresql.ENUM('uhd', 'fullhd', 'hd', 'sd', 'unknown', name='quality'), autoincrement=False, nullable=False),
+    sa.Column('requested_by_id', sa.UUID(), autoincrement=False, nullable=True),
+    sa.Column('authorized', sa.BOOLEAN(), autoincrement=False, nullable=False),
+    sa.Column('authorized_by_id', sa.UUID(), autoincrement=False, nullable=True),
+    sa.ForeignKeyConstraint(['authorized_by_id'], ['user.id'], name=op.f('season_request_authorized_by_id_fkey'), ondelete='SET NULL'),
+    sa.ForeignKeyConstraint(['requested_by_id'], ['user.id'], name=op.f('season_request_requested_by_id_fkey'), ondelete='SET NULL'),
+    sa.ForeignKeyConstraint(['season_id'], ['season.id'], name=op.f('season_request_season_id_fkey'), ondelete='CASCADE'),
+    sa.PrimaryKeyConstraint('id', name=op.f('season_request_pkey')),
+    sa.UniqueConstraint('season_id', 'wanted_quality', name=op.f('season_request_season_id_wanted_quality_key'), postgresql_include=[], postgresql_nulls_not_distinct=False)
+    )
+    op.create_table('movie_request',
+    sa.Column('id', sa.UUID(), autoincrement=False, nullable=False),
+    sa.Column('movie_id', sa.UUID(), autoincrement=False, nullable=False),
+    sa.Column('wanted_quality', postgresql.ENUM('uhd', 'fullhd', 'hd', 'sd', 'unknown', name='quality'), autoincrement=False, nullable=False),
+    sa.Column('min_quality', postgresql.ENUM('uhd', 'fullhd', 'hd', 'sd', 'unknown', name='quality'), autoincrement=False, nullable=False),
+    sa.Column('authorized', sa.BOOLEAN(), autoincrement=False, nullable=False),
+    sa.Column('requested_by_id', sa.UUID(), autoincrement=False, nullable=True),
+    sa.Column('authorized_by_id', sa.UUID(), autoincrement=False, nullable=True),
+    sa.ForeignKeyConstraint(['authorized_by_id'], ['user.id'], name=op.f('movie_request_authorized_by_id_fkey'), ondelete='SET NULL'),
+    sa.ForeignKeyConstraint(['movie_id'], ['movie.id'], name=op.f('movie_request_movie_id_fkey'), ondelete='CASCADE'),
+    sa.ForeignKeyConstraint(['requested_by_id'], ['user.id'], name=op.f('movie_request_requested_by_id_fkey'), ondelete='SET NULL'),
+    sa.PrimaryKeyConstraint('id', name=op.f('movie_request_pkey')),
+    sa.UniqueConstraint('movie_id', 'wanted_quality', name=op.f('movie_request_movie_id_wanted_quality_key'), postgresql_include=[], postgresql_nulls_not_distinct=False)
+    )
+    # ### end Alembic commands ###

alembic/versions/eb0bd3cc1852_add_indexer_column_to_indexerqueryresult.py

@@ -0,0 +1,35 @@
+"""add_indexer_column_to_indexerqueryresult
+
+Revision ID: eb0bd3cc1852
+Revises: 5299dfed220b
+Create Date: 2025-10-28 21:39:24.480466
+
+"""
+
+from typing import Sequence, Union
+
+import sqlalchemy as sa
+
+from alembic import op
+
+# revision identifiers, used by Alembic.
+revision: str = "eb0bd3cc1852"
+down_revision: Union[str, None] = "5299dfed220b"
+branch_labels: Union[str, Sequence[str], None] = None
+depends_on: Union[str, Sequence[str], None] = None
+
+
+def upgrade() -> None:
+    """Upgrade schema."""
+    # ### commands auto generated by Alembic - please adjust! ###
+    op.add_column(
+        "indexer_query_result", sa.Column("indexer", sa.String(), nullable=True)
+    )
+    # ### end Alembic commands ###
+
+
+def downgrade() -> None:
+    """Downgrade schema."""
+    # ### commands auto generated by Alembic - please adjust! ###
+    op.drop_column("indexer_query_result", "indexer")
+    # ### end Alembic commands ###

config.dev.toml

@@ -0,0 +1,175 @@
+# MediaManager Dev Configuration File
+# This file contains all available configuration options for MediaManager
+# Documentation: https://maxdorninger.github.io/MediaManager/
+#
+# This is an example configuration file that gets copied to your config folder
+# on first boot. You should modify the values below to match your setup.
+
+[misc]
+# it's very likely that you need to change this for MediaManager to work
+frontend_url = "http://localhost:5173" # note the lack of a trailing slash
+cors_urls = ["http://localhost:8000", "http://localhost:5173", "http://mediamanager:8000"] # note the lack of a trailing slash
+
+image_directory = "/data/images"
+tv_directory = "/data/tv"
+movie_directory = "/data/movies"
+torrent_directory = "/data/torrents" # this is where MediaManager will search for the downloaded torrents and usenet files
+
+# you probaly don't need to change this
+development = true
+
+# Custom Media Libraries
+# These paths should match your volume mounts in docker-compose.yaml
+# Example: if you mount "./movies:/media/movies" then use path = "/media/movies/subdirectory"
+[[misc.tv_libraries]]
+name = "Live Action"
+path = "/data/tv/live-action"  # Change this to match your actual TV shows location
+
+[[misc.movie_libraries]]
+name = "Documentary"
+path = "/data/movies/documentary"  # Change this to match your actual movies location
+
+[database]
+host = "db"
+port = 5432
+user = "MediaManager"
+password = "MediaManager"
+dbname = "MediaManager"
+
+[auth]
+email_password_resets = false # if true, you also need to set up SMTP (notifications.smtp_config)
+
+token_secret = "CHANGE_ME_GENERATE_RANDOM_STRING" # generate a random string with "openssl rand -hex 32", e.g. here https://www.cryptool.org/en/cto/openssl/
+session_lifetime = 86400  # this is how long you will be logged in after loggin in, in seconds
+
+# Admin users: Users who register with these email addresses will automatically become administrators
+# If no users exist in the database, a default admin user will be created with the first email in this list
+admin_emails = ["admin@example.com", "admin2@example.com"]
+
+# OpenID Connect settings
+[auth.openid_connect]
+enabled = false
+client_id = ""
+client_secret = ""
+configuration_endpoint = "https://openid.example.com/.well-known/openid-configuration"
+name = "OpenID"
+
+[notifications]
+# SMTP settings for email notifications and email password resets
+[notifications.smtp_config]
+smtp_host = "smtp.example.com"
+smtp_port = 587
+smtp_user = "admin"
+smtp_password = "admin"
+from_email = "mediamanager@example.com"
+use_tls = true
+
+# Email notification settings
+[notifications.email_notifications]
+enabled = false
+emails = ["admin@example.com", "admin2@example.com"]  # List of email addresses to send notifications to
+
+# Gotify notification settings
+[notifications.gotify]
+enabled = false
+api_key = ""
+url = "https://gotify.example.com"
+
+# Ntfy notification settings
+[notifications.ntfy]
+enabled = false
+url = "https://ntfy.sh/your-topic"
+
+# Pushover notification settings
+[notifications.pushover]
+enabled = false
+api_key = ""
+user = ""
+
+[torrents]
+# qBittorrent settings
+[torrents.qbittorrent]
+enabled = false
+host = "http://localhost"
+port = 8080
+username = "admin"
+password = "admin"
+
+# Transmission settings
+[torrents.transmission]
+enabled = false
+username = "admin"
+password = "admin"
+https_enabled = true
+host = "localhost"
+port = 9091
+path = "/transmission/rpc" # RPC request path target, usually "/transmission/rpc"
+
+# SABnzbd settings
+[torrents.sabnzbd]
+enabled = false
+host = "http://localhost"
+port = 8080
+api_key = ""
+base_path = "/api"
+
+[indexers]
+# Prowlarr settings
+[indexers.prowlarr]
+enabled = false
+url = "http://localhost:9696"
+api_key = ""
+timeout_seconds = 60
+
+# Jackett settings
+[indexers.jackett]
+enabled = false
+url = "http://localhost:9117"
+api_key = ""
+indexers = ["1337x", "torrentleech"]  # List of indexer names to use
+timeout_seconds = 60
+
+# Title-based scoring rules
+[[indexers.title_scoring_rules]]
+name = "prefer_h265"
+keywords = ["h265", "hevc", "x265", "h.265", "x.265"]
+score_modifier = 100
+negate = false
+
+[[indexers.title_scoring_rules]]
+name = "avoid_cam"
+keywords = ["cam", "camrip", "bdscr", "ddc", "dvdscreener","dvdscr", "hdcam", "hdtc", "hdts", "scr", "screener","telesync", "ts", "webscreener", "tc", "telecine", "tvrip"]
+score_modifier = -10000
+negate = false
+
+# Indexer flag-based scoring rules
+[[indexers.indexer_flag_scoring_rules]]
+name = "reject_non_freeleech"
+flags = ["freeleech", "freeleech75"]
+score_modifier = -10000
+negate = true
+
+[[indexers.indexer_flag_scoring_rules]]
+name = "reject_nuked"
+flags = ["nuked"]
+score_modifier = -10000
+negate = false
+
+# Scoring rulesets
+[[indexers.scoring_rule_sets]]
+name = "default"
+libraries = ["ALL_TV", "ALL_MOVIES"]
+rule_names = ["prefer_h265", "avoid_cam", "reject_nuked"]
+
+[[indexers.scoring_rule_sets]]
+name = "strict_quality"
+libraries = ["ALL_MOVIES"]
+rule_names = ["prefer_h265", "avoid_cam", "reject_non_freeleech"]
+
+# its very unlikely that you need to change this
+[metadata]
+[metadata.tmdb]
+tmdb_relay_url = "https://metadata-relay.dorninger.co/tmdb"
+
+[metadata.tvdb]
+tvdb_relay_url = "https://metadata-relay.dorninger.co/tvdb"

config.example.toml

@@ -0,0 +1,172 @@
+# MediaManager Example Configuration File
+# This file contains all available configuration options for MediaManager
+# Documentation: https://maxdorninger.github.io/MediaManager/
+#
+# This is an example configuration file that gets copied to your config folder
+# on first boot. You should modify the values below to match your setup.
+
+[misc]
+# it's very likely that you need to change this for MediaManager to work
+frontend_url = "http://localhost:8000" # note the lack of a trailing slash
+cors_urls = ["http://localhost:8000"] # note the lack of a trailing slash
+
+image_directory = "/data/images"
+tv_directory = "/data/tv"
+movie_directory = "/data/movies"
+torrent_directory = "/data/torrents" # this is where MediaManager will search for the downloaded torrents and usenet files
+
+# you probaly don't need to change this
+development = false
+
+# Custom Media Libraries
+# These paths should match your volume mounts in docker-compose.yaml
+# Example: if you mount "./movies:/media/movies" then use path = "/media/movies/subdirectory"
+[[misc.tv_libraries]]
+name = "Live Action"
+path = "/data/tv/live-action"  # Change this to match your actual TV shows location
+
+[[misc.movie_libraries]]
+name = "Documentary"
+path = "/data/movies/documentary"  # Change this to match your actual movies location
+
+[database]
+host = "db"
+port = 5432
+user = "MediaManager"
+password = "MediaManager"
+dbname = "MediaManager"
+
+[auth]
+email_password_resets = false # if true, you also need to set up SMTP (notifications.smtp_config)
+
+token_secret = "CHANGE_ME_GENERATE_RANDOM_STRING" # generate a random string with "openssl rand -hex 32", e.g. here https://www.cryptool.org/en/cto/openssl/
+session_lifetime = 86400  # this is how long you will be logged in after loggin in, in seconds
+
+# Admin users: Users who register with these email addresses will automatically become administrators
+# If no users exist in the database, a default admin user will be created with the first email in this list
+admin_emails = ["admin@example.com", "admin2@example.com"]
+
+# OpenID Connect settings
+[auth.openid_connect]
+enabled = false
+client_id = ""
+client_secret = ""
+configuration_endpoint = "https://openid.example.com/.well-known/openid-configuration"
+name = "OpenID"
+
+[notifications]
+# SMTP settings for email notifications and email password resets
+[notifications.smtp_config]
+smtp_host = "smtp.example.com"
+smtp_port = 587
+smtp_user = "admin"
+smtp_password = "admin"
+from_email = "mediamanager@example.com"
+use_tls = true
+
+# Email notification settings
+[notifications.email_notifications]
+enabled = false
+emails = ["admin@example.com", "admin2@example.com"]  # List of email addresses to send notifications to
+
+# Gotify notification settings
+[notifications.gotify]
+enabled = false
+api_key = ""
+url = "https://gotify.example.com"
+
+# Ntfy notification settings
+[notifications.ntfy]
+enabled = false
+url = "https://ntfy.sh/your-topic"
+
+# Pushover notification settings
+[notifications.pushover]
+enabled = false
+api_key = ""
+user = ""
+
+[torrents]
+# qBittorrent settings
+[torrents.qbittorrent]
+enabled = false
+host = "http://localhost"
+port = 8080
+username = "admin"
+password = "admin"
+
+# Transmission settings
+[torrents.transmission]
+enabled = false
+username = "admin"
+password = "admin"
+https_enabled = true
+host = "localhost"
+port = 9091
+path = "/transmission/rpc" # RPC request path target, usually "/transmission/rpc"
+
+# SABnzbd settings
+[torrents.sabnzbd]
+enabled = false
+host = "http://localhost"
+port = 8080
+api_key = ""
+base_path = "/api"
+
+[indexers]
+# Prowlarr settings
+[indexers.prowlarr]
+enabled = false
+url = "http://localhost:9696"
+api_key = ""
+timeout_seconds = 60
+
+# Jackett settings
+[indexers.jackett]
+enabled = false
+url = "http://localhost:9117"
+api_key = ""
+indexers = ["1337x", "torrentleech"]  # List of indexer names to use
+timeout_seconds = 60
+
+# Title-based scoring rules
+[[indexers.title_scoring_rules]]
+name = "prefer_h265"
+keywords = ["h265", "hevc", "x265", "h.265", "x.265"]
+score_modifier = 100
+negate = false
+
+[[indexers.title_scoring_rules]]
+name = "avoid_cam"
+keywords = ["cam", "camrip", "bdscr", "ddc", "dvdscreener","dvdscr", "hdcam", "hdtc", "hdts", "scr", "screener","telesync", "ts", "webscreener", "tc", "telecine", "tvrip"]
+score_modifier = -10000
+negate = false
+
+# Indexer flag-based scoring rules
+[[indexers.indexer_flag_scoring_rules]]
+name = "prefer_freeleech"
+flags = ["freeleech", "freeleech75"]
+score_modifier = 100
+negate = false
+
+[[indexers.indexer_flag_scoring_rules]]
+name = "reject_nuked"
+flags = ["nuked"]
+score_modifier = -10000
+negate = false
+
+# Scoring rulesets
+[[indexers.scoring_rule_sets]]
+name = "default"
+libraries = ["ALL_TV", "ALL_MOVIES"]
+rule_names = ["prefer_h265", "avoid_cam", "reject_nuked", "prefer_freeleech"]
+
+# its very unlikely that you need to change this
+[metadata]
+[metadata.tmdb]
+tmdb_relay_url = "https://metadata-relay.dorninger.co/tmdb"
+primary_languages = [""]
+default_language = "en"
+
+[metadata.tvdb]
+tvdb_relay_url = "https://metadata-relay.dorninger.co/tvdb"

docker-compose.dev.yaml

@@ -0,0 +1,155 @@
+services:
+  db:
+    image: postgres:17
+    restart: unless-stopped
+    container_name: postgres
+    volumes:
+      - ./res/postgres:/var/lib/postgresql/data
+    environment:
+      POSTGRES_USER: MediaManager
+      POSTGRES_DB: MediaManager
+      POSTGRES_PASSWORD: MediaManager
+    ports:
+      - "5432:5432"
+    healthcheck:
+      test: [ "CMD-SHELL", "pg_isready -d $${POSTGRES_DB} -U $${POSTGRES_USER}" ]
+      interval: 10s
+      timeout: 5s
+      retries: 5
+  mediamanager:
+    build:
+      context: .
+      dockerfile: Dockerfile
+      target: app
+      args:
+        - VERSION=locally-built
+        - BASE_PATH=
+    container_name: mediamanager
+    restart: unless-stopped
+    ports:
+      - "8000:8000"
+    environment:
+      - CONFIG_DIR=/app/config
+      - MEDIAMANAGER_MISC__DEVELOPMENT=TRUE
+      - MEDIAMANAGER_MISC__CORS_URLS=["http://localhost:5173"]
+      - DISABLE_FRONTEND_MOUNT=TRUE
+      - LOG_FILE=/dev/null
+      - MEDIAMANAGER_LOG_LEVEL=DEBUG
+    volumes:
+      #- ./web/build:/app/web/build # this is only needed to test built frontend when developing frontend
+      - ./res/images/:/data/images/
+      - ./res/:/data/
+      - ./res/config/:/app/config/
+      - ./media_manager:/app/media_manager
+    depends_on:
+      db:
+        condition: service_healthy
+  frontend:
+    image: node:24-alpine
+    container_name: mediamanager-frontend-dev
+    working_dir: /app
+    command: sh -c "npm install && npm run dev -- --host 0.0.0.0"
+    ports:
+      - "5173:5173"
+      - "24678:24678"
+    volumes:
+      - ./web:/app
+    depends_on:
+      - mediamanager
+  docs:
+    image: squidfunk/mkdocs-material:9
+    container_name: mediamanager-docs
+    volumes:
+      - .:/docs
+    ports:
+      - "9000:9000"
+    command: serve -w /docs -a 0.0.0.0:9000
+
+
+# ----------------------------
+# Additional services can be uncommented and configured as needed
+# ----------------------------
+
+  prowlarr:
+    image: lscr.io/linuxserver/prowlarr:latest
+    container_name: prowlarr
+    environment:
+      - PUID=1000
+      - PGID=1000
+      - TZ=Etc/UTC
+    volumes:
+      - ./res/prowlarr:/config
+    restart: unless-stopped
+    ports:
+      - "9696:9696"
+  qbittorrent:
+    image: lscr.io/linuxserver/qbittorrent:latest
+    container_name: qbittorrent
+    environment:
+      - TZ=Etc/UTC
+      - WEBUI_PORT=8080
+      - TORRENTING_PORT=6881
+    ports:
+      - 8080:8080
+      - 6881:6881
+      - 6881:6881/udp
+    restart: unless-stopped
+    volumes:
+      - ./res/torrents:/download
+      - ./res/qbittorrent:/config
+#  transmission:
+#    image: lscr.io/linuxserver/transmission:latest
+#    container_name: transmission
+#    environment:
+#      - PUID=1000
+#      - PGID=1000
+#      - TZ=Etc/UTC
+#      - USER=admin
+#      - PASS=admin
+#    volumes:
+#      - ./res/transmission:/config
+#      - ./res/torrents:/data/torrents
+#    ports:
+#      - 9091:9091
+#    restart: unless-stopped
+#  pocket-id:
+#    image: ghcr.io/pocket-id/pocket-id
+#    restart: unless-stopped
+#    env_file: .env
+#    ports:
+#      - 1411:1411
+#    volumes:
+#      - ./res/pocket-id:/app/data
+#    healthcheck:
+#      test: "curl -f http://localhost:1411/healthz"
+#      interval: 1m30s
+#      timeout: 5s
+#      retries: 2
+#      start_period: 10s
+#  sabnzbd:
+#    image: lscr.io/linuxserver/sabnzbd:latest
+#    container_name: sabnzbd
+#    environment:
+#      - PUID=1000
+#      - PGID=1000
+#      - TZ=Etc/UTC
+#    volumes:
+#      - ./res/sabnzbd:/config
+#      - ./res/torrents:/downloads
+#    ports:
+#      - 8081:8080
+#    restart: unless-stopped
+  jackett:
+    image: lscr.io/linuxserver/jackett:latest
+    container_name: jackett
+    environment:
+      - PUID=1000
+      - PGID=1000
+      - TZ=Etc/UTC
+      - AUTO_UPDATE=true
+    volumes:
+      - ./res/jackett/data:/config
+      - ./res/jackett/torrents:/downloads
+    ports:
+      - 9117:9117
+    restart: unless-stopped

docker-compose.yaml

@@ -1,68 +1,33 @@
 services:
-  backend:
-    image: ghcr.io/maxdorninger/mediamanager/backend:latest
-    container_name: backend
+  mediamanager:
+    container_name: mediamanager_server
+    image: quay.io/maxdorninger/mediamanager:latest
     ports:
       - "8000:8000"
-    # In your reverse proxy you will probably need to set rule that only requests with a path prefix
-    # of /api/v1 will be forwarded to this container
-    # if you are using traefik the rule is going to look something like this:
-    # "traefik.http.routers.mm-api.rule=Host(`media.example`)&&PathPrefix(`/api/v1`)"
     environment:
-      - QBITTORRENT_PASSWORD=
-      - QBITTORRENT_HOST=
-      - QBITTORRENT_USERNAME=
-      - QBITTORRENT_PORT=
-
-      - CORS_URLS=
-
-      - DB_HOST=db
-      #- DB_NAME=
-      #- DB_PORT=
-      #- DB_PASSWORD=
-      #- DB_DBNAME=
-
-      # generate a random string with "openssl rand -hex 32"
-      - AUTH_TOKEN_SECRET=
-
-      # this should be you email address
-      - AUTH_ADMIN_EMAIL=
-
-      # this is the URL of your frontend, e.g. https://mediamanager.example.com
-      - FRONTEND_URL=
-
-      #- OPENID_ENABLED=FALSE
-      #- OPENID_CLIENT_ID=
-      #- OPENID_CLIENT_SECRET=
-      #- OPENID_CONFIGURATION_ENDPOINT=
-      #- OPENID_NAME=
-
-      #- AUTH_SESSION_LIFETIME=
-      #- API_BASE_PATH=/api/v1
-      #- DEVELOPMENT=
-
+      - CONFIG_DIR=/app/config
     volumes:
-      - ./data/:/data/
-  frontend:
-    image: ghcr.io/maxdorninger/mediamanager/frontend:latest
-    container_name: frontend
-    ports:
-      - "3000:3000"
-    volumes:
-      - ./cache:/app/cache
-    environment:
-      - PUBLIC_API_URL=http://localhost:8000/api/v1
+      # Mount your actual media directories here - these paths should match your config.toml
+      - ./data/:/data/  # Example: change ./data/ to your actual media root
+      # Config folder for application configuration
+      - ./config/:/app/config/
+      # Image folder
+      - ./images/:/data/images/
+    depends_on:
+      db:
+        condition: service_healthy
   db:
-    image: postgres:latest
+    container_name: mediamanager_postgres
+    image: postgres:17
     restart: unless-stopped
-    container_name: postgres
     volumes:
       - ./postgres:/var/lib/postgresql/data
+    healthcheck:
+      test: [ "CMD-SHELL", "pg_isready -d $${POSTGRES_DB} -U $${POSTGRES_USER}" ]
+      interval: 10s
+      timeout: 5s
+      retries: 5
     environment:
       POSTGRES_USER: MediaManager
       POSTGRES_DB: MediaManager
       POSTGRES_PASSWORD: MediaManager
-    ports:
-      - "5432:5432"
-
-

docs/advanced-features/custom-port.md

@@ -0,0 +1,4 @@
+# Custom port
+
+* `PORT`\
+  Port that MediaManager listens on. Default is `8000`. This only works if you are using the Docker image. Configured as environment variable.

docs/advanced-features/disable-startup-ascii-art.md

@@ -0,0 +1,4 @@
+# Disable Startup Ascii Art
+
+* `MEDIAMANAGER_NO_STARTUP_ART`: Set this environment variable (to any value) \
+  to disable the colorized startup splash screen. Unset to reenable.

docs/advanced-features/follow-symlinks-in-frontend-files.md

@@ -0,0 +1,12 @@
+# Follow symlinks in frontend files
+
+MediaManager can be configured to follow symlinks when serving frontend files. This is useful if you have a setup where your frontend files are stored in a different location, and you want to symlink them into the MediaManager frontend directory.
+
+
+
+* `FRONTEND_FOLLOW_SYMLINKS`\
+  Set this environment variable to `true` to follow symlinks when serving frontend files. Default is `false`.
+
+```bash title=".env"
+FRONTEND_FOLLOW_SYMLINKS=true
+```

docs/advanced-features/metadata-provider-configuration.md

@@ -0,0 +1,65 @@
+# Metadata Provider Configuration
+
+## Metadata Provider Configuration
+
+Metadata provider settings are configured in the `[metadata]` section of your `config.toml` file. These settings control how MediaManager retrieves information about movies and TV shows.
+
+### TMDB Settings (`[metadata.tmdb]`)
+
+TMDB (The Movie Database) is the primary metadata provider for MediaManager. It provides detailed information about movies and TV shows.
+
+!!! info
+    Other software like Jellyfin use TMDB as well, so there won't be any metadata discrepancies.
+
+* `tmdb_relay_url`\
+  URL of the TMDB relay (MetadataRelay). Default is `https://metadata-relay.dorninger.co/tmdb`. Example: `https://your-own-relay.example.com/tmdb`.
+* `primary_languages`\
+  If the original language of a show/movie is in this list, metadata is fetched in that language. Otherwise, `default_language` is used. Default is `[]`. Example: `["no", "de", "es"]`. Format: ISO 639-1 (2 letters). Full list: https://en.wikipedia.org/wiki/List\_of\_ISO\_639\_language\_codes
+* `default_language`\
+  TMDB language parameter used when searching and adding. Default is `en`. Format: ISO 639-1 (2 letters).
+
+!!! warning
+    `default_language` sets the TMDB `language` parameter when searching and adding TV shows and movies. If TMDB does not find a matching translation, metadata in the original language will be fetched with no option for a fallback language. It is therefore highly advised to only use "broad" languages. For most use cases, the default setting is safest.
+
+### TVDB Settings (`[metadata.tvdb]`)
+
+!!! warning
+    The TVDB might provide false metadata and doesn't support some features of MediaManager like showing overviews. Therefore, TMDB is the preferred metadata provider.
+
+* `tvdb_relay_url`\
+  URL of the TVDB relay (MetadataRelay). Default is `https://metadata-relay.dorninger.co/tvdb`. Example: `https://your-own-relay.example.com/tvdb`.
+
+### MetadataRelay
+
+!!! info
+    To use MediaManager you don't need to set up your own MetadataRelay, as the default relay hosted by the developer should be sufficient for most purposes.
+
+The MetadataRelay is a service that provides metadata for MediaManager. It acts as a proxy for TMDB and TVDB, allowing you to use your own API keys if needed, but the default relay means you don't need to create accounts for API keys yourself.
+
+You might want to use your own relay if you want to avoid rate limits, protect your privacy, or for other reasons. If you know Sonarr's Skyhook, this is similar to that.
+
+#### Where to get API keys
+
+* Get a TMDB API key from [The Movie Database](https://www.themoviedb.org/settings/api)
+* Get a TVDB API key from [The TVDB](https://thetvdb.com/auth/register)
+
+!!! info
+    If you want to use your own MetadataRelay, you can set the `tmdb_relay_url` and/or `tvdb_relay_url` to your own relay service.
+
+### Example Configuration
+
+Here's a complete example of the metadata section in your `config.toml`:
+
+```toml title="config.toml"
+[metadata]
+    # TMDB configuration
+    [metadata.tmdb]
+    tmdb_relay_url = "https://metadata-relay.dorninger.co/tmdb"
+
+    # TVDB configuration
+    [metadata.tvdb]
+    tvdb_relay_url = "https://metadata-relay.dorninger.co/tvdb"
+```
+
+!!! info
+    In most cases, you can simply use the default values and don't need to specify these settings in your config file at all.

docs/advanced-features/qbittorrent-category.md

@@ -0,0 +1,16 @@
+# qBittorrent Category
+
+qBittorrent supports saving Torrents to subdirectories based on the category of the Torrent. The default category name that MediaManager uses is `MediaManager`.
+
+Use the following variables to customize behavior:
+
+* `torrents.qbittorrent.category_name`\
+  Category name MediaManager uses when adding torrents to qBittorrent. Default is `MediaManager`.
+* `torrents.qbittorrent.category_save_path`\
+  Save path for the category in qBittorrent. By default, no subdirectory is used. Example: `/data/torrents/MediaManager`.
+
+!!! info
+    qBittorrent saves torrents to the path specified by `torrents.qbittorrent.category_save_path`, so it must be a valid path that qBittorrent can write to.
+
+!!! warning
+    For MediaManager to successfully import torrents, you must add the subdirectory to the `misc.torrent_directory` variable.

docs/advanced-features/url-prefix.md

@@ -0,0 +1,36 @@
+# URL Prefix
+
+MediaManager, by default, expects to run at the base of a domain, e.g. `maxdorninger.github.io`.
+
+In order to run it on a prefixed path, like `maxdorninger.github.io/media`, the docker image must be built with a special build argument. That's because SvelteKit needs to know the base URL at build time.
+
+In short, clone the repository, then run:
+
+```none title="Build Docker image"
+docker build \
+  --build-arg BASE_PATH=/media \
+  --build-arg VERSION=my-custom-version \
+  -t MediaManager:my-custom-version \
+  -f Dockerfile .
+```
+
+You also need to set the `BASE_PATH` environment variable at runtime in `docker-compose.yaml`:
+
+* `BASE_PATH`\
+  Base path prefix MediaManager is served under. Example: `/media`. This must match the `BASE_PATH` build arg.
+
+```yaml title="docker-compose.yaml (excerpt)"
+services:
+  mediamanager:
+    image: MediaManager:my-custom-version
+    ports:
+      - "8000:8000"
+    environment:
+      BASE_PATH: /media
+      ...
+```
+
+!!! info
+    Make sure to include the base path in the `frontend_url` field in the config file. See [Backend](../configuration/backend.md).
+
+Finally, ensure that whatever reverse proxy you're using leaves the incoming path unchanged; that is, you should not strip the `/media` from `/media/web/`.

docs/api-reference.md

@@ -0,0 +1,7 @@
+# API Reference
+
+!!! info
+    Media Manager's backend is built with FastAPI, which automatically generates interactive API documentation.
+
+* Swagger UI (typically available at `http://localhost:8000/docs`)
+* ReDoc (typically available at `http://localhost:8000/redoc`)

docs/configuration/README.md

@@ -0,0 +1,69 @@
+# Configuration
+
+MediaManager uses a TOML configuration file (`config.toml`) for all backend settings. This centralized configuration approach makes it easier to manage, backup, and share your MediaManager setup.
+
+Frontend settings are configured through environment variables in your `docker-compose.yaml` file.
+
+## Configuration File Location
+
+!!! warning
+    Note that MediaManager may need to be restarted for changes in the config file to take effect.
+
+Your `config.toml` file should be in the directory that's mounted to `/app/config/config.toml` inside the container:
+
+```yaml
+volumes:
+  - ./config:/app/config
+```
+
+You can change the configuration directory with the following environment variable:
+
+* `CONFIG_DIR`\
+  Directory that contains `config.toml`. Default is `/app/config`. Example: `/etc/mediamanager/`.
+
+## Configuration Sections
+
+The configuration is organized into the following sections:
+
+* `[misc]` - General settings
+* `[database]` - Database settings
+* `[auth]` - Authentication settings
+* `[notifications]` - Notification settings (Email, Gotify, Ntfy, Pushover)
+* `[torrents]` - Download client settings (qBittorrent, Transmission, SABnzbd)
+* `[indexers]` - Indexer settings (Prowlarr and Jackett )
+* `[metadata]` - TMDB and TVDB settings
+
+## Configuring Secrets
+
+For sensitive information like API keys, passwords, and secrets, you should use environment variables. You can actually set every configuration value through environment variables. For example, to set the `token_secret` value for authentication, with a .toml file you would use:
+
+```toml
+[auth]
+token_secret = "your_super_secret_key_here"
+```
+
+But you can also set it through an environment variable:
+
+```none
+MEDIAMANAGER_AUTH__TOKEN_SECRET = "your_super_secret_key_here"
+```
+
+or another example with the OIDC client secret:
+
+```toml
+[auth]
+...
+[auth.openid_connect]
+client_secret = "your_client_secret_from_provider"
+```
+
+env variable:
+
+```none
+MEDIAMANAGER_AUTH__OPENID_CONNECT__CLIENT_SECRET = "your_client_secret_from_provider"
+```
+
+So for every config "level", you basically have to take the name of the value and prepend it with the section names in uppercase with 2 underscores as delimiters and `MEDIAMANAGER_` as the prefix.
+
+!!! warning
+    Note that not every env variable starts with `MEDIAMANAGER_`; this prefix only applies to env variables which replace/overwrite values in the config file. Variables like the `CONFIG_DIR` env variable must not be prefixed.

docs/configuration/authentication.md

@@ -0,0 +1,81 @@
+---
+description: >-
+  MediaManager supports multiple authentication methods. Email/password
+  authentication is the default, but you can also enable OpenID Connect (OAuth
+  2.0) for integration with external identity providers
+---
+
+# Authentication
+
+All authentication settings are configured in the `[auth]` section of your `config.toml` file.
+
+## General Authentication Settings (`[auth]`)
+
+* `token_secret`\
+  Strong secret key for signing JWTs (create with `openssl rand -hex 32`). This is required.
+* `session_lifetime`\
+  Lifetime of user sessions in seconds. Default is `86400` (1 day).
+* `admin_emails`\
+  A list of email addresses for administrator accounts. This is required.
+* `email_password_resets`\
+  Enables password resets via email. Default is `false`.
+
+!!! info
+    To use email password resets, you must also configure SMTP settings in the `[notifications.smtp_config]` section.
+
+!!! info
+    When setting up MediaManager for the first time, you should add your email to `admin_emails` in the `[auth]` config section. MediaManager will then use this email instead of the default admin email. Your account will automatically be created as an admin account, allowing you to manage other users, media and settings.
+
+## OpenID Connect Settings (`[auth.openid_connect]`)
+
+OpenID Connect allows you to integrate with external identity providers like Google, Microsoft Azure AD, Keycloak, or any other OIDC-compliant provider.
+
+* `enabled`\
+  Set to `true` to enable OpenID Connect authentication. Default is `false`.
+* `client_id`\
+  Client ID provided by your OpenID Connect provider.
+* `client_secret`\
+  Client secret provided by your OpenID Connect provider.
+* `configuration_endpoint`\
+  OpenID Connect configuration endpoint URL. Do not include a trailing slash. Usually ends with `/.well-known/openid-configuration`.
+* `name`\
+  Display name for the OpenID Connect provider shown on the login page.
+
+### Configuration for your OpenID Connect Provider
+
+#### Redirect URI
+
+The OpenID server will likely require a redirect URI. This URL will usually look something like this:
+
+```none
+{MEDIAMANAGER_URL}/api/v1/auth/oauth/callback
+```
+
+!!! warning
+    It is very important that you set the correct callback URI, otherwise it won't work!
+
+#### Authentik Example
+
+Here is an example configuration for the OpenID Connect provider for Authentik.
+
+![authentik-redirect-url-example](<../assets/assets/authentik redirect url example.png>)
+
+## Example Configuration
+
+Here's a complete example of the authentication section in your `config.toml`:
+
+```toml title="config.toml"
+[auth]
+token_secret = "a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6q7r8s9t0u1v2w3x4y5z6"
+session_lifetime = 604800  # 1 week
+admin_emails = ["admin@example.com", "manager@example.com"]
+email_password_resets = true
+
+[auth.openid_connect]
+enabled = true
+client_id = "mediamanager-client"
+client_secret = "your-secret-key-here"
+configuration_endpoint = "https://auth.example.com/.well-known/openid-configuration"
+name = "Authentik"
+```
+

docs/configuration/backend.md

@@ -0,0 +1,42 @@
+---
+description: >-
+  These settings configure the core backend application through the config.toml
+  file. All backend configuration is now centralized in this TOML file instead
+  of environment variables.
+---
+
+# Backend
+
+## General Settings (`[misc]`)
+
+*   `frontend_url`\
+    The URL the frontend will be accessed from. This is required. Do not include a trailing slash. Default is `http://localhost:8000`.
+
+    Example: if you are accessing MediaManager at `http://example.com/media`, set this to `http://example.com/media`.
+
+    If you are accessing MediaManager at the root of a domain, e.g. `https://mediamanager.example.com`, set this to `https://mediamanager.example.com`.
+
+    `frontend_url` does not affect where the server binds. It also does not configure a base path prefix. For prefixes, see [URL Prefix](../advanced-features/url-prefix.md).
+* `cors_urls`\
+  A list of origins you are going to access the API from. Do not include trailing slashes.
+* `development`\
+  Set to `true` to enable development mode. Default is `false`.
+
+## Example Configuration
+
+Here's a complete example of the general settings section in your `config.toml`:
+
+```toml title="config.toml"
+[misc]
+
+# REQUIRED: Change this to match your actual frontend domain.
+frontend_url = "http://mediamanager.dev"
+
+cors_urls = ["http://localhost:8000"]
+
+# Optional: Development mode (set to true for debugging)
+development = false
+```
+
+!!! info
+    The `frontend_url` is the most important setting to configure correctly. Make sure it matches your actual deployment URLs.

docs/configuration/custom-libraries.md

@@ -0,0 +1,52 @@
+# Custom Libraries
+
+MediaManager supports custom libraries, allowing you to add multiple folders for your movies and TV series. This feature is useful if you organize your media into different directories. For example, you might have separate folders for "Action" movies and "Comedy" movies, or "Live Action" TV shows and "Animated" TV shows.
+
+## Configuration
+
+Custom libraries are configured in the `misc` section in the `config.toml` file. You can add as many libraries as you need.
+
+!!! info
+    You are not limited to `/data/tv` or `/data/movies`, you can choose the entire path freely!
+
+### Movie Libraries
+
+To add custom movie libraries, add a `[[misc.movie_libraries]]` section for each library. Each library requires a `name` and a `path`.
+
+Example — configuring two movie libraries:
+
+```toml
+[misc]
+
+# ... other misc settings
+
+[[misc.movie_libraries]]
+name = "Action"
+path = "/data/movies/action"
+
+[[misc.movie_libraries]]
+name = "Comedy"
+path = "/data/movies/comedy"
+```
+
+In this example, MediaManager will scan both `/data/movies/action` and `/data/movies/comedy` for movies.
+
+### TV Show Libraries
+
+Similarly, to add custom TV show libraries, add a `[[misc.tv_libraries]]` section for each library. Each library requires a `name` and a `path`.
+
+Example — configuring two TV show libraries:
+
+```toml
+[misc]
+
+# ... other misc settings
+
+[[misc.tv_libraries]]
+name = "Live Action"
+path = "/data/tv/live-action"
+
+[[misc.tv_libraries]]
+name = "Animation"
+path = "/data/tv/animation"
+```

docs/configuration/database.md

@@ -0,0 +1,32 @@
+# Database
+
+Database settings are configured in the `[database]` section of your `config.toml` file. MediaManager uses PostgreSQL as its database backend.
+
+## Database Settings (`[database]`)
+
+* `host`\
+  Hostname or IP of the PostgreSQL server. Default is `localhost`.
+* `port`\
+  Port number of the PostgreSQL server. Default is `5432`.
+* `user`\
+  Username for the PostgreSQL connection. Default is `MediaManager`.
+* `password`\
+  Password for the PostgreSQL user. Default is `MediaManager`.
+* `dbname`\
+  Name of the PostgreSQL database. Default is `MediaManager`.
+
+## Example Configuration
+
+Here's a complete example of the database section in your `config.toml`:
+
+```toml title="config.toml"
+[database]
+host = "db"
+port = 5432
+user = "MediaManager"
+password = "your_secure_password"
+dbname = "MediaManager"
+```
+
+!!! info
+    In docker-compose deployments the container name is simultaneously its hostname, so you can use "db" or "postgres" as host.

docs/configuration/download-clients.md

@@ -0,0 +1,125 @@
+# Download Clients
+
+Download client settings are configured in the `[torrents]` section of your `config.toml` file. MediaManager supports both qBittorrent and SABnzbd as download clients.
+
+## qBittorrent Settings (`[torrents.qbittorrent]`)
+
+qBittorrent is a popular BitTorrent client that MediaManager can integrate with for downloading torrents.
+
+* `enabled`\
+  Set to `true` to enable qBittorrent integration. Default is `false`.
+* `host`\
+  Hostname or IP of the qBittorrent server. Include the protocol (http/https).
+* `port`\
+  Port of the qBittorrent Web UI/API. Default is `8080`.
+* `username`\
+  Username for qBittorrent Web UI authentication. Default is `admin`.
+* `password`\
+  Password for qBittorrent Web UI authentication. Default is `admin`.
+
+## Transmission Settings (`[torrents.transmission]`)
+
+!!! info
+    The downloads path in Transmission and MediaManager must be the same, i.e. the path `/data/torrents` must link to the same volume for both containers.
+
+Transmission is a BitTorrent client that MediaManager can integrate with for downloading torrents.
+
+* `enabled`\
+  Set to `true` to enable Transmission integration. Default is `false`.
+* `username`\
+  Username for Transmission RPC authentication.
+* `password`\
+  Password for Transmission RPC authentication.
+* `https_enabled`\
+  Set to `true` if your Transmission RPC endpoint uses HTTPS. Default is `true`.
+* `host`\
+  Hostname or IP of the Transmission server (without protocol).
+* `port`\
+  Port of the Transmission RPC endpoint. Default is `9091`.
+* `path`\
+  RPC request path target. Usually `/transmission/rpc`.
+
+## SABnzbd Settings (`[torrents.sabnzbd]`)
+
+SABnzbd is a Usenet newsreader that MediaManager can integrate with for downloading NZB files.
+
+* `enabled`\
+  Set to `true` to enable SABnzbd integration. Default is `false`.
+* `host`\
+  Hostname or IP of the SABnzbd server, it needs to include `http(s)://`.
+* `port`\
+  Port of the SABnzbd API. Default is `8080`.
+* `api_key`\
+  API key for SABnzbd. You can find this in SABnzbd's configuration under "General" → "API Key".
+* `base_path`\
+  API base path for SABnzbd. It usually ends with `/api`, the default is `/api`.
+
+## Example Configuration
+
+Here's a complete example of the download clients section in your `config.toml`:
+
+```toml title="config.toml"
+[torrents]
+    # qBittorrent configuration
+    [torrents.qbittorrent]
+    enabled = true
+    host = "http://qbittorrent"
+    port = 8080
+    username = "admin"
+    password = "your_secure_password"
+
+    # Transmission configuration
+    [torrents.transmission]
+    enabled = false
+    username = "admin"
+    password = "your_secure_password"
+    https_enabled = true
+    host = "transmission"
+    port = 9091
+    path = "/transmission/rpc"
+
+    # SABnzbd configuration
+    [torrents.sabnzbd]
+    enabled = false
+    host = "http://sabnzbd"
+    port = 8080
+    api_key = "your_sabnzbd_api_key"
+```
+
+## Docker Compose Integration
+
+When using Docker Compose, make sure your download clients are accessible from the MediaManager backend:
+
+```yaml title="docker-compose.yml"
+services:
+  # MediaManager backend
+  backend:
+    image: ghcr.io/maxdorninger/mediamanager/backend:latest
+    # ... other configuration ...
+
+  # qBittorrent service
+  qbittorrent:
+    image: lscr.io/linuxserver/qbittorrent:latest
+    ports:
+      - "8080:8080"
+    environment:
+      - WEBUI_PORT=8080
+    volumes:
+      - ./data/torrents:/downloads
+    # ... other configuration ...
+
+  # SABnzbd service
+  sabnzbd:
+    image: lscr.io/linuxserver/sabnzbd:latest
+    ports:
+      - "8081:8080"
+    volumes:
+      - ./data/usenet:/downloads
+    # ... other configuration ...
+```
+
+!!! warning
+    You should enable only one BitTorrent and only one Usenet Download Client at any time.
+
+!!! info
+    Make sure the download directories in your download clients are accessible to MediaManager for proper file management and organization.