feat(brand): add deterministic asset pipeline

.github/workflows/brand.yml

@@ -0,0 +1,30 @@
+name: Brand
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+    paths:
+      - "brand/**"
+      - "scripts/brand_generate.py"
+      - "tests/test_brand_generate.py"
+      - "Taskfile.yml"
+      - ".github/workflows/brand.yml"
+
+permissions:
+  contents: read
+
+jobs:
+  brand:
+    name: Brand assets
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
+      - uses: actions/setup-python@6d4fd22b20465ccc0f7354476588e8df7c9ca0e0 # v7.1.0
+        with:
+          python-version: "3.11"
+      - name: Install librsvg2-bin
+        run: sudo apt-get update && sudo apt-get install -y librsvg2-bin
+      - run: python3 -m unittest tests.test_brand_generate.BrandGenerateTests.test_rsvg_convert_integration -v
+      - run: python3 scripts/brand_generate.py --check

Taskfile.yml

@@ -28,3 +28,13 @@ tasks:
       - zensical build --strict
       - python -m unittest tests.test_check_docs -v
       - python scripts/check_docs.py site
+
+  brand:generate:
+    desc: Generate ffmpegfyMe brand assets
+    cmds:
+      - python3 scripts/brand_generate.py --generate
+
+  brand:check:
+    desc: Check ffmpegfyMe brand assets are current
+    cmds:
+      - python3 scripts/brand_generate.py --check

brand/data/brand.json

@@ -0,0 +1,10 @@
+{
+  "base": "#24273a",
+  "mantle": "#1e2030",
+  "crust": "#181926",
+  "text": "#cad3f5",
+  "subtext1": "#b8c0e0",
+  "surface0": "#363a4f",
+  "surface1": "#494d64",
+  "sky": "#91d7e3"
+}

brand/data/facts.json

@@ -0,0 +1,14 @@
+{
+  "output_formats": [
+    "MP4",
+    "MKV"
+  ],
+  "max_attempts_per_item": 3,
+  "default_inactivity_timeout_seconds": 60,
+  "social_pillars": [
+    "Authenticated HTTP/HLS",
+    "MP4/MKV stream copy",
+    "Resumable batches with retries"
+  ],
+  "readme_banner_tagline": "Download HTTP/HLS streams as MP4 or MKV — no transcoding."
+}

brand/generated/social-preview.json

@@ -0,0 +1,5 @@
+{
+  "png_sha256": "da3a098556eb90e92a785d3537a090ce9f9a81a89da916c2bf34eaf52718e295",
+  "rsvg_convert_version": "rsvg-convert version 2.63.4\n\nlibraries used:\n  cairo 1.18.6\n  pango 1.58.2\n  harfbuzz 15.0.0\n  fontconfig 2.18.3",
+  "source_sha256": "cb7131a6cb31870dcbcac8f83576ce5f6fee7d4edf127157987e0641f151b656"
+}