Normalize GitHub asset URLs

backend/Odin.py

@@ -14,6 +14,7 @@ import socket
 from contextlib import asynccontextmanager
 from datetime import datetime, timedelta
 from pathlib import Path
+from urllib.parse import urlparse
 from fastapi import FastAPI, WebSocket, WebSocketDisconnect, Query, Depends, HTTPException, Header
 from fastapi.responses import FileResponse, JSONResponse
 from pydantic import BaseModel, Field
@@ -31,6 +32,18 @@ FRONTEND = os.path.join(ROOT, "frontend")
 DATA_DIR = os.path.join(ROOT, "backend", "data")
 
 
+def _public_asset_url(value: str) -> str:
+    """Return a browser-loadable URL, correcting GitHub's HTML blob links."""
+    value = value.strip()
+    parsed = urlparse(value)
+    parts = parsed.path.strip("/").split("/")
+    if parsed.scheme == "https" and parsed.netloc in {"github.com", "www.github.com"} \
+            and len(parts) >= 5 and parts[2] == "blob":
+        owner, repository, _, revision, *path = parts
+        return f"https://raw.githubusercontent.com/{owner}/{repository}/{revision}/{'/'.join(path)}"
+    return value
+
+
 # --------------------------------------------------------------------------- #
 # Sim Manager — connection broadcast + background WorldEngine
 # --------------------------------------------------------------------------- #
@@ -971,8 +984,8 @@ def get_asset_urls():
     a Space variable does not require committing image files to the Space.
     """
     return {
-        "map_image_url": os.environ.get("MAP_IMAGE_URL", "").strip(),
-        "night_image_url": os.environ.get("MAP_NIGHT_IMAGE_URL", "").strip(),
+        "map_image_url": _public_asset_url(os.environ.get("MAP_IMAGE_URL", "")),
+        "night_image_url": _public_asset_url(os.environ.get("MAP_NIGHT_IMAGE_URL", "")),
     }
 
 

backend/pathfinder.py

@@ -20,6 +20,18 @@ _W = _H = 0
 _load_lock = threading.Lock()
 
 
+def _public_asset_url(value):
+    """Convert a GitHub blob page URL to its downloadable raw-file URL."""
+    value = value.strip()
+    parsed = urlparse(value)
+    parts = parsed.path.strip("/").split("/")
+    if parsed.scheme == "https" and parsed.netloc in {"github.com", "www.github.com"} \
+            and len(parts) >= 5 and parts[2] == "blob":
+        owner, repository, _, revision, *path = parts
+        return f"https://raw.githubusercontent.com/{owner}/{repository}/{revision}/{'/'.join(path)}"
+    return value
+
+
 def _load():
     global _path_img, _white_pixels, _W, _H
     if _white_pixels is not None:
@@ -35,7 +47,7 @@ def _load():
             os.path.join(ROOT, "frontend", "dist", "path.png"),
         ]
         path_file = next((p for p in candidates if os.path.exists(p)), None)
-        path_url = os.environ.get("PATH_IMAGE_URL", "").strip()
+        path_url = _public_asset_url(os.environ.get("PATH_IMAGE_URL", ""))
         try:
             if path_file:
                 image_source = path_file