feat: Add Docker Support and GHCR Publish Workflow

.dockerignore

@@ -0,0 +1,71 @@
+#
+#            PySceneDetect: Python-Based Video Scene Detector
+#   -------------------------------------------------------------------
+#     [  Site:    https://scenedetect.com                           ]
+#     [  Docs:    https://scenedetect.com/docs/                     ]
+#     [  Github:  https://github.com/Breakthrough/PySceneDetect/    ]
+#
+# Copyright (C) 2014-2026 Brandon Castellano <http://www.bcastell.com>.
+# PySceneDetect is licensed under the BSD 3-Clause License; see the
+# included LICENSE file, or visit one of the above pages for details.
+#
+
+# Version control
+.git
+.gitignore
+.github
+
+# Python / Build artifacts
+__pycache__/
+*.pyc
+*.pyo
+*.pyd
+.Python
+env/
+venv/
+.venv/
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+
+# Testing / Tooling
+.pytest_cache/
+.tox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+*.log
+.mypy_cache/
+.hypothesis/
+
+# IDE / Project files
+.vscode/
+.idea/
+*.swp
+*.swo
+.DS_Store
+
+# Project specific exclusions (to keep the image lean)
+test_clips/
+tests/
+docs/
+website/
+benchmark/
+scenedetect.cfg
+

.github/workflows/docker-publish.yml

@@ -0,0 +1,65 @@
+# Build and publish PySceneDetect Docker image to GitHub Container Registry (GHCR).
+name: Publish Docker Image
+
+on:
+  workflow_dispatch:
+  push:
+    branches: [ "main", "fng-infra-docker-ci" ]
+  release:
+    types: [published]
+
+env:
+  REGISTRY: ghcr.io
+  IMAGE_NAME: ${{ github.repository }}
+
+jobs:
+  build-and-push:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      packages: write
+      attestations: write
+      id-token: write
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Setup Docker buildx
+        uses: docker/setup-buildx-action@v3
+
+      - name: Log in to the Container registry
+        uses: docker/login-action@v3
+        with:
+          registry: ${{ env.REGISTRY }}
+          username: ${{ github.actor }}
+          password: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Extract metadata (tags, labels) for Docker
+        id: meta
+        uses: docker/metadata-action@v5
+        with:
+          images: ${{ env.REGISTRY }}/${{ env.IMAGE_NAME }}
+          tags: |
+            type=ref,event=branch
+            type=semver,pattern={{version}}
+            type=semver,pattern={{major}}.{{minor}}
+            type=semver,pattern={{major}}
+            type=sha
+
+      - name: Build and push Docker image
+        id: push
+        uses: docker/build-push-action@v5
+        with:
+          context: .
+          push: true
+          tags: ${{ steps.meta.outputs.tags }}
+          labels: ${{ steps.meta.outputs.labels }}
+
+      - name: Generate artifact attestation
+        uses: actions/attest-build-provenance@v1
+        with:
+          subject-name: ${{ env.REGISTRY }}/${{ env.IMAGE_NAME }}
+          subject-digest: ${{ steps.push.outputs.digest }}
+          push-to-registry: true
+

.github/workflows/publish-pypi.yml

@@ -22,10 +22,12 @@ jobs:
     steps:
       - name: Check workflows
         uses: actions/github-script@v6
+        env:
+          TAG: ${{ github.event.inputs.tag }}
         with:
           script: |
             const { owner, repo } = context.repo;
-            const tag = "${{ github.event.inputs.tag }}";
+            const tag = process.env.TAG;
             const requiredWorkflows = ['Windows Distribution', 'Python Distribution'];
             let workflowConclusions = {};
 

.gitignore

@@ -87,3 +87,4 @@ dmypy.json
 .pyre/
 .pytype/
 cython_debug/
+test_clips/

Dockerfile

@@ -0,0 +1,40 @@
+#
+#            PySceneDetect: Python-Based Video Scene Detector
+#   -------------------------------------------------------------------
+#     [  Site:    https://scenedetect.com                           ]
+#     [  Docs:    https://scenedetect.com/docs/                     ]
+#     [  Github:  https://github.com/Breakthrough/PySceneDetect/    ]
+#
+# Copyright (C) 2014-2026 Brandon Castellano <http://www.bcastell.com>.
+# PySceneDetect is licensed under the BSD 3-Clause License; see the
+# included LICENSE file, or visit one of the above pages for details.
+#
+
+FROM python:3.11.11-slim
+
+# Create a non-root user for security hardening
+RUN useradd -m scenedetect
+
+# Set working directory and copy files with correct ownership
+WORKDIR /app
+COPY --chown=scenedetect:scenedetect . .
+
+# Install necessary system dependencies as root first
+RUN apt-get update && \
+    apt-get install -y --no-install-recommends \
+    ffmpeg \
+    mkvtoolnix && \
+    rm -rf /var/lib/apt/lists/*
+
+# Install PySceneDetect with headless OpenCV and other optional media backends
+# pyav is highly recommended for faster/more robust video decodes
+# moviepy provides an alternative video splitting backend
+RUN --mount=type=cache,target=/root/.cache/pip \
+    pip install ".[opencv-headless,pyav,moviepy]"
+
+# Switch to the non-root user
+USER scenedetect
+
+# The default behavior is to run the CLI
+ENTRYPOINT ["scenedetect"]
+

website/requirements.txt

@@ -1,2 +1,2 @@
 mkdocs==1.5.2
-jinja2==3.1.5
+jinja2==3.1.6