Add Linux support (x86_64 + aarch64)

Full cross-platform Linux support with self-contained dependency bundling,
matching the existing macOS and Windows architecture.

Rust worker:
- New platform/linux.rs with XDG Base Directory paths
- LinuxX64/LinuxArm64 platform variants in dependency_locator
- LD_LIBRARY_PATH + vapoursynth.auto.conf environment setup
- Linux libdvdread search paths (Debian, Fedora, Arch)

Flutter app:
- Generated app/linux/ platform (GTK3)
- Linux branches in dependency_manager, tool_locator, disc_detector,
  whisper_addon_manager for XDG paths and LD_LIBRARY_PATH
- Linux DVD detection (/media, /run/media, /mnt)
- xdg-open for "Show in Folder" on Linux

Build scripts:
- download-deps-linux.sh: builds Python, VapourSynth, FFmpeg, 20 plugins
- package-deps-linux.sh: zips deps with SHA256 for auto-download
- package-linux.sh: creates distributable .tar.gz
- run-debug-linux.sh: dev build + run convenience script

CI & release:
- build-linux.yml: GitHub Actions matrix (x64 + arm64)
- Updated release.sh, ci-build-and-release.sh, check-deps-changed.sh

Documentation:
- CLAUDE.md and README.md updated with Linux instructions

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: StuartCameronCode

.github/workflows/build-linux.yml

@@ -0,0 +1,133 @@
+name: Build Linux
+
+on:
+  workflow_dispatch:
+    inputs:
+      version:
+        description: 'Version number (e.g., 0.9.0)'
+        required: true
+        type: string
+      deps_tag:
+        description: 'Deps release tag (e.g., deps-v1.3.0)'
+        required: true
+        type: string
+      arch:
+        description: 'Architecture'
+        required: false
+        type: choice
+        options:
+          - x64
+          - arm64
+          - both
+        default: x64
+
+jobs:
+  build:
+    strategy:
+      matrix:
+        include:
+          - os: ubuntu-22.04
+            arch: x64
+            flutter_arch: x64
+            rust_target: x86_64-unknown-linux-gnu
+          - os: ubuntu-22.04-arm
+            arch: arm64
+            flutter_arch: arm64
+            rust_target: aarch64-unknown-linux-gnu
+      fail-fast: false
+
+    runs-on: ${{ matrix.os }}
+
+    # Only run the job if it matches the requested arch (or both)
+    if: ${{ inputs.arch == 'both' || inputs.arch == matrix.arch }}
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Install system dependencies
+        run: |
+          sudo apt-get update
+          sudo apt-get install -y clang cmake git ninja-build pkg-config \
+            libgtk-3-dev liblzma-dev libstdc++-12-dev
+
+      - name: Setup Flutter
+        uses: subosito/flutter-action@v2
+        with:
+          channel: 'stable'
+          cache: true
+
+      - name: Setup Rust
+        uses: dtolnay/rust-toolchain@stable
+        with:
+          targets: ${{ matrix.rust_target }}
+
+      - name: Cache Rust dependencies
+        uses: actions/cache@v4
+        with:
+          path: |
+            ~/.cargo/bin/
+            ~/.cargo/registry/index/
+            ~/.cargo/registry/cache/
+            ~/.cargo/git/db/
+            worker/target/
+          key: ${{ runner.os }}-${{ matrix.arch }}-cargo-${{ hashFiles('**/Cargo.lock') }}
+          restore-keys: |
+            ${{ runner.os }}-${{ matrix.arch }}-cargo-
+
+      - name: Download Linux dependencies
+        run: |
+          DEPS_VERSION="${{ inputs.deps_tag }}"
+          DEPS_VERSION="${DEPS_VERSION#deps-v}"
+
+          mkdir -p deps/linux-${{ matrix.arch }}
+
+          DEPS_URL="https://github.com/${{ github.repository }}/releases/download/${{ inputs.deps_tag }}/VapourBox-deps-${DEPS_VERSION}-linux-${{ matrix.arch }}.zip"
+          echo "Downloading deps from: $DEPS_URL"
+          curl -L -o deps.zip "$DEPS_URL"
+          unzip -o deps.zip -d deps/linux-${{ matrix.arch }}
+          rm -f deps.zip
+
+          echo "Dependencies extracted:"
+          ls -la deps/
+
+      - name: Update version numbers
+        run: |
+          VERSION="${{ inputs.version }}"
+          DEPS_TAG="${{ inputs.deps_tag }}"
+          DEPS_VERSION="${DEPS_TAG#deps-v}"
+
+          # Update pubspec.yaml
+          sed -i "s/^version: .*/version: ${VERSION}+1/" app/pubspec.yaml
+
+          # Update deps-version.json
+          sed -i "s/\"version\": \"[^\"]*\"/\"version\": \"${DEPS_VERSION}\"/" app/assets/deps-version.json
+          sed -i "s/\"releaseTag\": \"[^\"]*\"/\"releaseTag\": \"${DEPS_TAG}\"/" app/assets/deps-version.json
+
+          # Update Cargo.toml
+          sed -i "s/^version = \".*\"/version = \"${VERSION}\"/" worker/Cargo.toml
+
+      - name: Build Rust worker
+        run: |
+          cd worker
+          cargo build --release --target ${{ matrix.rust_target }}
+          # Copy to default release location for package script
+          mkdir -p target/release
+          cp target/${{ matrix.rust_target }}/release/vapourbox-worker target/release/ || true
+
+      - name: Build Flutter app
+        run: |
+          cd app
+          flutter pub get
+          dart run build_runner build --delete-conflicting-outputs
+          flutter build linux --release
+
+      - name: Package release
+        run: |
+          ./Scripts/package-linux.sh --version "${{ inputs.version }}" --arch ${{ matrix.arch }} --skip-build
+
+      - name: Upload artifacts
+        uses: actions/upload-artifact@v4
+        with:
+          name: VapourBox-${{ inputs.version }}-linux-${{ matrix.arch }}
+          path: dist/VapourBox-${{ inputs.version }}-linux-${{ matrix.arch }}.tar.gz

.gitignore

@@ -50,7 +50,6 @@ app/windows/flutter/generated_plugins.cmake
 # Platform-specific (unsupported platforms)
 app/android/
 app/ios/
-app/linux/
 app/web/
 
 # =============================================================================

CLAUDE.md

@@ -12,7 +12,7 @@ Both files should stay synchronized - README.md is for humans, CLAUDE.md is for
 
 ## Project Overview
 
-VapourBox is a **cross-platform** (macOS + Windows) video processing application using VapourSynth. It provides a simple drag-and-drop interface for deinterlacing, denoising, sharpening, and other video processing tasks as an alternative to more complex tools like Hybrid.
+VapourBox is a **cross-platform** (macOS + Windows + Linux) video processing application using VapourSynth. It provides a simple drag-and-drop interface for deinterlacing, denoising, sharpening, and other video processing tasks as an alternative to more complex tools like Hybrid.
 
 **Technology Stack:**
 - **UI**: Flutter (Dart) - cross-platform desktop app
@@ -56,7 +56,8 @@ VapourBox/
 │   ├── assets/filters/         # Built-in filter schemas (JSON)
 │   │   └── core/               # Core filters (deinterlace, denoise, etc.)
 │   ├── macos/                  # macOS platform config
-│   └── windows/                # Windows platform config
+│   ├── windows/                # Windows platform config
+│   └── linux/                  # Linux platform config
 │
 ├── worker/                     # Rust worker crate
 │   ├── src/
@@ -72,7 +73,9 @@ VapourBox/
 ├── deps/                       # Platform-specific dependencies
 │   ├── macos-arm64/            # Python 3.12, VS, FFmpeg, plugins
 │   ├── macos-x64/
-│   └── windows-x64/            # VSPipe, Python 3.8, FFmpeg, plugins
+│   ├── windows-x64/            # VSPipe, Python 3.8, FFmpeg, plugins
+│   ├── linux-x64/              # Python 3.12, VS, FFmpeg, plugins
+│   └── linux-arm64/
 │
 ├── licenses/                   # GPL, LGPL, NOTICES
 ├── Scripts/                    # Build, package, and release scripts
@@ -109,15 +112,19 @@ VapourBox/
 - Rust 1.70+
 - Windows: Visual Studio Build Tools with C++ workload
 - macOS: Xcode Command Line Tools
+- Linux: `clang cmake git ninja-build pkg-config libgtk-3-dev liblzma-dev libstdc++-12-dev`
 
 ### Download Dependencies
 
 ```bash
 # macOS
-./scripts/download-deps-macos.sh
+./Scripts/download-deps-macos.sh
 
 # Windows (PowerShell)
-.\scripts\download-deps-windows.ps1
+.\Scripts\download-deps-windows.ps1
+
+# Linux
+./Scripts/download-deps-linux.sh
 ```
 
 ### Build Rust Worker
@@ -152,6 +159,11 @@ mkdir -p ../build/macos/Build/Products/Release
 cp -R ~/Library/Developer/Xcode/DerivedData/Runner-*/Build/Products/Release/vapourbox.app ../build/macos/Build/Products/Release/
 ```
 
+**Linux:**
+```bash
+cd app && flutter pub get && flutter build linux --release
+```
+
 ### Generate Dart JSON Serialization
 
 ```bash
@@ -189,6 +201,15 @@ dart run build_runner build
 2. Copy worker: `cp worker/target/debug/vapourbox-worker.exe app/build/windows/x64/runner/Debug/`
 3. Run app: `cd app && flutter run`
 
+**Linux: Use the debug script:**
+
+```bash
+./Scripts/run-debug-linux.sh            # Full build (worker + app) and launch
+./Scripts/run-debug-linux.sh --skip-worker  # Rebuild app only
+./Scripts/run-debug-linux.sh --skip-app     # Rebuild worker only
+./Scripts/run-debug-linux.sh --run-only     # Just copy and launch
+```
+
 ### Production Packaging
 
 **IMPORTANT**: Never manually assemble a release build. Always use packaging scripts — the app will silently crash on video drop if the bundle is incomplete.
@@ -200,8 +221,14 @@ dart run build_runner build
 # Windows
 .\Scripts\package-windows.ps1 -Version "X.Y.Z" [-SkipBuild]
 
+# Linux
+./Scripts/package-linux.sh --version X.Y.Z [--skip-build]
+
 # Test packaged app from terminal to see errors:
+# macOS:
 dist/VapourBox.app/Contents/MacOS/vapourbox
+# Linux:
+dist/VapourBox-X.Y.Z-linux-x64/vapourbox
 ```
 
 Do NOT run `app/build/macos/Build/Products/Release/vapourbox.app` directly — it lacks templates and proper bundle structure.
@@ -431,7 +458,17 @@ The `download-deps-windows.ps1` and `download-deps-macos.sh` scripts apply these
 - Quarantine removal: `xattr -cr` on deps after download
 - Show in Folder: `open -R <path>`
 
-Plugin lists for both platforms: see `deps/` directories or download scripts.
+### Linux
+
+- Bundled deps in `~/.local/share/VapourBox/deps/linux-{x64,arm64}/` (or `$XDG_DATA_HOME`)
+- Worker sets: `PYTHONHOME`, `PYTHONPATH`, `VAPOURSYNTH_CONF_PATH`, `LD_LIBRARY_PATH`
+- `patchelf` used for RPATH fixup (equivalent to macOS `install_name_tool`)
+- GPU/OpenCL: requires user-installed GPU driver; nnedi3cl degrades gracefully without it
+- Show in Folder: `xdg-open <directory>`
+- Debug builds: use `./Scripts/run-debug-linux.sh`
+- No code signing or quarantine removal needed
+
+Plugin lists for all platforms: see `deps/` directories or download scripts.
 
 ---
 
@@ -478,23 +515,29 @@ Prerequisites: draft release must exist for the tag, `gh` CLI authenticated.
 | `Scripts/check-deps-changed.sh` | Detect if deps changed since last release (exit 0=changed, 1=unchanged) |
 | `Scripts/package-macos.sh` | Package macOS app |
 | `Scripts/package-windows.ps1` | Package Windows app |
+| `Scripts/package-linux.sh` | Package Linux app |
 | `Scripts/package-deps-macos.sh` | Package macOS deps |
 | `Scripts/package-deps-windows.ps1` | Package Windows deps |
+| `Scripts/package-deps-linux.sh` | Package Linux deps |
+| `Scripts/download-deps-linux.sh` | Build Linux deps from source |
+| `Scripts/run-debug-linux.sh` | Dev build + run for Linux |
 
 ### Release Checklist
 
 1. **Confirm version** — ask user, update `pubspec.yaml`
 2. **Check deps** — run `check-deps-changed.sh`; if changed, bump version in `deps-version.json`
 3. **Build & package** — use packaging scripts (or `release.sh` for full automation)
-4. **Update `app/assets/deps-version.json`** — after packaging each platform's deps zip, update its `sha256` and `size` fields with the values printed by the packaging script. **Both platforms must have valid (non-null) sha256 and size before release.** The app uses these values to verify downloaded deps at runtime.
+4. **Update `app/assets/deps-version.json`** — after packaging each platform's deps zip, update its `sha256` and `size` fields with the values printed by the packaging script. **All platforms must have valid (non-null) sha256 and size before release.** The app uses these values to verify downloaded deps at runtime.
 5. **Test** — fresh install + upgrade test
 6. **Create GitHub releases** — deps release first (if changed, tag `deps-vX.Y.Z`), then app release (tag `vX.Y.Z`)
 
 ### Cross-Platform Notes
 
 - Flutter Windows can't build on macOS — use GitHub Actions
+- Flutter Linux can't build on macOS — use GitHub Actions or a Linux VM
 - Windows deps can be zipped on macOS if `deps/windows-x64/` exists
-- CI builds are ad-hoc signed; sign locally for distribution
+- Linux deps must be built on Linux (`./Scripts/download-deps-linux.sh`)
+- CI builds are ad-hoc signed; sign locally for distribution (macOS only)
 
 ### Dependency Version History
 

README.md

@@ -30,6 +30,8 @@ Get the latest release for your platform:
 |----------|------|
 | macOS (Apple Silicon) | `VapourBox-x.x.x-macos-arm64.dmg` |
 | Windows 10/11 (x64) | `VapourBox-x.x.x-windows-x64.zip` |
+| Linux (x64) | `VapourBox-x.x.x-linux-x64.tar.gz` |
+| Linux (arm64) | `VapourBox-x.x.x-linux-arm64.tar.gz` |
 
 ## Installation
 
@@ -48,6 +50,15 @@ Get the latest release for your platform:
 3. Run `vapourbox.exe`
 4. On first launch, VapourBox will automatically download its processing dependencies (~195 MB)
 
+### Linux
+
+1. Download the `.tar.gz` file for your architecture from the [releases page](https://github.com/StuartCameronCode/VapourBox/releases/latest)
+2. Extract: `tar -xzf VapourBox-x.x.x-linux-x64.tar.gz`
+3. Run: `cd VapourBox-x.x.x-linux-x64 && ./vapourbox`
+4. On first launch, VapourBox will automatically download its processing dependencies (~100 MB)
+
+> **GPU acceleration**: For GPU-accelerated deinterlacing (NNEDI3CL), install your GPU's OpenCL driver. Without it, VapourBox falls back to CPU-based processing automatically.
+
 ## Features
 
 - **Drag-and-drop interface** — drop video files, folders, or VIDEO_TS directories to start
@@ -117,6 +128,17 @@ brew install libdvdcss
 
 Download `libdvdcss-2.dll` from [VideoLAN](https://www.videolan.org/developers/libdvdcss.html) and place it in the VapourBox application directory (next to `vapourbox.exe`).
 
+**Linux:**
+
+```bash
+# Debian/Ubuntu
+sudo apt install libdvdcss2
+# Fedora (RPM Fusion required)
+sudo dnf install libdvdcss
+# Arch
+sudo pacman -S libdvdcss
+```
+
 Unencrypted DVDs (home recordings, some independent releases) work without libdvdcss.
 
 ### Timeline Navigation

Scripts/check-deps-changed.sh

@@ -20,8 +20,11 @@ DEPS_PATHS=(
     "deps/windows-x64/ffmpeg"
     "deps/macos-arm64"
     "deps/macos-x64"
+    "deps/linux-x64"
+    "deps/linux-arm64"
     "Scripts/download-deps-windows.ps1"
     "Scripts/download-deps-macos.sh"
+    "Scripts/download-deps-linux.sh"
 )
 
 # Get the last deps release tag