From b5caee5b86f8ccb8264fe8c1a149fdcf0346ca45 Mon Sep 17 00:00:00 2001
From: saphid <4596216+saphid@users.noreply.github.com>
Date: Mon, 28 Sep 2026 23:12:24 +1000
Subject: [PATCH] Library art: real gameplay instead of GitHub social cards;
 accept GIF sources

GitHub's opengraph preview is repo text, stats and an identicon; as a Steam hero
it looked broken. GitHub entries no longer default to it (the store draws its
fallback, Steam gets generated art). Source GIFs (common gameplay captures) are
accepted; the Frame's Chromium draws the first frame. Open Saber Plus uses its
gameplay GIF as banner. Verified on the Frame: hero/wide now show gameplay.

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
---
 tests/test_apk_more_sources.py      | 8 +++-----
 tests/test_frame_android_library.py | 4 ++++
 ui/apk_sources/github.py            | 3 ++-
 ui/apk_sources/github_curated.json  | 4 ++--
 ui/frame_artwork.py                 | 8 +++++++-
 5 files changed, 18 insertions(+), 9 deletions(-)

diff --git a/tests/test_apk_more_sources.py b/tests/test_apk_more_sources.py
index 80e346f..f1879b9 100644
--- a/tests/test_apk_more_sources.py
+++ b/tests/test_apk_more_sources.py
@@ -37,7 +37,7 @@ class PublisherSources(unittest.TestCase):
             self.assertTrue(entry['summary'])
             images = entry['images']
             self.assertEqual(entry['icon'], images['icon'])
-            for url in [images['icon'], images['banner']] + images['screenshots']:
+            for url in [u for u in [images['icon'], images['banner']] if u] + images['screenshots']:
                 self.assertTrue(url.startswith('https://'))
                 self.assertEqual(evidence[url]['status'], 200)
                 self.assertTrue(evidence[url]['image'])
@@ -53,8 +53,7 @@ class PublisherSources(unittest.TestCase):
         self.assertEqual(entry['images'], curated['images'])
         unknown = github.details(github.sources()[0], 'unknown/project')
         self.assertEqual(unknown['icon'], 'https://github.com/unknown.png')
-        self.assertEqual(unknown['images']['banner'],
-                         'https://opengraph.githubassets.com/1/unknown/project')
+        self.assertIsNone(unknown['images']['banner'])
 
     def test_real_releases(self):
         for key, repo in [('khronos', 'KhronosGroup/OpenXR-SDK-Source'),
@@ -79,8 +78,7 @@ class PublisherSources(unittest.TestCase):
         for entry, repo in zip(entries, data['items']):
             self.assertEqual(entry['icon'], repo['owner']['avatar_url'])
             self.assertEqual(entry['images']['icon'], entry['icon'])
-            self.assertEqual(entry['images']['banner'],
-                             'https://opengraph.githubassets.com/1/' + repo['full_name'])
+            self.assertIsNone(entry['images']['banner'])
             self.assertEqual(entry['images']['screenshots'], [])
         self.assertFalse(github.details(github.sources()[0], 'unknown/project')['downloadable'])
         with self.assertRaises(SourceError):
diff --git a/tests/test_frame_android_library.py b/tests/test_frame_android_library.py
index fdee8cb..a124362 100644
--- a/tests/test_frame_android_library.py
+++ b/tests/test_frame_android_library.py
@@ -171,6 +171,10 @@ class ArtworkTests(unittest.TestCase):
         data = (FIXTURES / 'icon.jpg').read_bytes()
         self.assertEqual(art.image_type(data), 'jpg')
         self.assertEqual(art.image_type(data + b'\0' * 64), 'jpg')  # trailing padding after EOI
+        gif = b'GIF89a' + struct.pack('<HH', 640, 360) + b'\0' * 20  # gameplay GIFs: first frame drawn
+        self.assertEqual(art.image_type(gif), 'gif')
+        with self.assertRaises(ValueError):
+            art.image_type(b'GIF89a' + struct.pack('<HH', 0, 360) + b'\0' * 20)
         with self.assertRaises(ValueError):
             art.image_type(data[:30])
 
diff --git a/ui/apk_sources/github.py b/ui/apk_sources/github.py
index 08fcf57..e636f2a 100644
--- a/ui/apk_sources/github.py
+++ b/ui/apk_sources/github.py
@@ -35,7 +35,8 @@ def _entry(source, c, approved=True):
     artwork = c.get('images') or {}
     icon = artwork.get('icon') or c.get('icon') or 'https://github.com/' + c['repo'].split('/')[0] + '.png'
     images = {'icon': icon,
-              'banner': artwork.get('banner') or 'https://opengraph.githubassets.com/1/' + c['repo'],
+              # No GitHub social-preview card: it's repo text and stats, not art; the UI draws a fallback.
+              'banner': artwork.get('banner'),
               'screenshots': list(artwork.get('screenshots') or [])}
     return {'source': source['id'], 'id': c['repo'], 'package': None,
             'name': c['name'], 'summary': c.get('summary') or '', 'icon': icon,
diff --git a/ui/apk_sources/github_curated.json b/ui/apk_sources/github_curated.json
index 90cdf21..b264042 100644
--- a/ui/apk_sources/github_curated.json
+++ b/ui/apk_sources/github_curated.json
@@ -9,7 +9,7 @@
     "allow_prerelease": false,
     "images": {
       "icon": "https://raw.githubusercontent.com/KhronosGroup/OpenXR-SDK-Source/3ed64d0f9bb680f24b80a085091e5c8fab38f7b7/src/tests/hello_xr/android_resources/vulkan/mipmap-xxxhdpi/ic_helloxr_launcher.png",
-      "banner": "https://opengraph.githubassets.com/1/KhronosGroup/OpenXR-SDK-Source",
+      "banner": null,
       "screenshots": []
     },
     "icon": "https://raw.githubusercontent.com/KhronosGroup/OpenXR-SDK-Source/3ed64d0f9bb680f24b80a085091e5c8fab38f7b7/src/tests/hello_xr/android_resources/vulkan/mipmap-xxxhdpi/ic_helloxr_launcher.png"
@@ -60,7 +60,7 @@
     "allow_prerelease": false,
     "images": {
       "icon": "https://raw.githubusercontent.com/arpruss/OpenSaberPlus/8c5295cdaadf02ea7418b0c6cbea20240ba913af/icon.png",
-      "banner": "https://opengraph.githubassets.com/1/arpruss/OpenSaberPlus",
+      "banner": "https://raw.githubusercontent.com/arpruss/OpenSaberPlus/8c5295cdaadf02ea7418b0c6cbea20240ba913af/doc/images/OS0.4.0_1.gif",
       "screenshots": [
         "https://raw.githubusercontent.com/arpruss/OpenSaberPlus/8c5295cdaadf02ea7418b0c6cbea20240ba913af/doc/images/OS0.4.0_1.gif",
         "https://raw.githubusercontent.com/arpruss/OpenSaberPlus/8c5295cdaadf02ea7418b0c6cbea20240ba913af/doc/images/OS0.4.0_2.gif",
diff --git a/ui/frame_artwork.py b/ui/frame_artwork.py
index 13db919..d1fcb1e 100644
--- a/ui/frame_artwork.py
+++ b/ui/frame_artwork.py
@@ -34,6 +34,12 @@ def image_type(data):
     if data.startswith(PNG):
         png_size(data)
         return 'png'
+    if data[:6] in (b'GIF87a', b'GIF89a') and len(data) >= 10:
+        # Gameplay GIFs are common source screenshots; the Frame's Chromium draws their first frame.
+        w, h = struct.unpack_from('<HH', data, 6)
+        if w and h and w * h <= MAX_PIXELS and max(w, h) <= 8192:
+            return 'gif'
+        raise ValueError('artwork GIF has unsupported dimensions')
     if data.startswith(b'\xff\xd8'):
         # Check JPEG SOF dimensions without depending on an image library; trailing padding is fine.
         pos = 2
@@ -52,7 +58,7 @@ def image_type(data):
                     return 'jpg'
                 break
             pos += size
-    raise ValueError('artwork must be a supported PNG or JPEG')
+    raise ValueError('artwork must be a supported PNG, JPEG or GIF')
 
 
 def fetch(value, deadline=None):