Mesh Canvas Studio – 3D Multi-Viewer & Optimizer

Run this single command block in your Debian terminal:

code Bash

fuser -k 8765/tcp 2>/dev/null || true
pkill -9 -f glb_viewer.py 2>/dev/null || true
mkdir -p ~/.local/share/glb-viewer

cat << 'EOF' > ~/.local/share/glb-viewer/glb_viewer.py
#!/usr/bin/env python3
"""
Debian 3D Multi-Viewer (VisionOS Edition)
Supports GLB, GLTF, FBX, and OBJ with Batch Compression & Full Comparison
"""

import http.server
import json
import os
import shutil
import socket
import subprocess
import sys
import tempfile
import threading
import time
import urllib.parse
import urllib.request

PORT = 8765
URL = f"http://127.0.0.1:{PORT}"
MODELS = {}
MODEL_COUNTER = 0
CURRENT_ACTIVE_LABEL = ""
UPLOAD_DIR = os.path.join(tempfile.gettempdir(), "glb_viewer_uploads")
CONVERT_DIR = os.path.join(tempfile.gettempdir(), "glb_viewer_converted")
os.makedirs(UPLOAD_DIR, exist_ok=True)
os.makedirs(CONVERT_DIR, exist_ok=True)

SERVER_INSTANCE = None
DATA_LOCK = threading.Lock()
SUPPORTED_EXTS = (".glb", ".gltf", ".fbx", ".obj")


def find_tool(tool_name):
    p = shutil.which(tool_name)
    if p:
        return p
    for candidate_dir in ["/usr/local/bin", "/usr/bin", os.path.expanduser("~/.local/bin")]:
        full = os.path.join(candidate_dir, tool_name)
        if os.path.isfile(full) and os.access(full, os.X_OK):
            return full
    return None


def format_size(num_bytes):
    if num_bytes < 1024:
        return f"{num_bytes} B"
    elif num_bytes < 1024 * 1024:
        return f"{num_bytes / 1024:.1f} KB"
    elif num_bytes < 1024 * 1024 * 1024:
        return f"{num_bytes / (1024 * 1024):.2f} MB"
    else:
        return f"{num_bytes / (1024 * 1024 * 1024):.2f} GB"


def check_port_open():
    s = socket.socket(socket.AF_INET, socket.SOCK_STREAM)
    s.settimeout(0.2)
    try:
        s.connect(("127.0.0.1", PORT))
        return True
    except (OSError, ConnectionRefusedError):
        return False
    finally:
        s.close()


def convert_to_glb(input_path):
    """Converts FBX, OBJ, or GLTF to GLB if needed."""
    ext = os.path.splitext(input_path)[1].lower()
    base = os.path.splitext(os.path.basename(input_path))[0]
    out_glb = os.path.join(CONVERT_DIR, f"{base}.glb")

    if ext == ".glb":
        return input_path, None

    if ext == ".fbx":
        fbx_tool = find_tool("fbx2gltf")
        if not fbx_tool:
            return None, "fbx2gltf not found in PATH. Install fbx2gltf to convert FBX files."
        cmd = [fbx_tool, "-i", input_path, "-b", "-o", out_glb]
        res = subprocess.run(cmd, stdout=subprocess.PIPE, stderr=subprocess.PIPE, text=True)
        if res.returncode == 0 and os.path.isfile(out_glb):
            return out_glb, None
        return None, res.stderr or "FBX conversion failed."

    if ext == ".obj":
        obj_tool = find_tool("obj2gltf")
        if not obj_tool:
            return None, "obj2gltf not found. Install via: npm install -g obj2gltf"
        cmd = [obj_tool, "-i", input_path, "-o", out_glb, "--binary"]
        res = subprocess.run(cmd, stdout=subprocess.PIPE, stderr=subprocess.PIPE, text=True)
        if res.returncode == 0 and os.path.isfile(out_glb):
            return out_glb, None
        return None, res.stderr or "OBJ conversion failed."

    if ext == ".gltf":
        gltf_tool = find_tool("gltf-transform")
        if gltf_tool:
            cmd = [gltf_tool, "copy", input_path, out_glb]
            res = subprocess.run(cmd, stdout=subprocess.PIPE, stderr=subprocess.PIPE, text=True)
            if res.returncode == 0 and os.path.isfile(out_glb):
                return out_glb, None
        return input_path, None

    return None, f"Unsupported format: {ext}"


def add_paths(path_list, clear_existing=False, is_compressed=False):
    global MODELS, MODEL_COUNTER, CURRENT_ACTIVE_LABEL
    with DATA_LOCK:
        if clear_existing:
            MODELS.clear()
            MODEL_COUNTER = 0

        for p in path_list:
            p = os.path.abspath(os.path.expanduser(p.strip()))
            is_comp = is_compressed or ("compress-GLB" in p) or p.lower().endswith("_clean.glb")

            files_to_check = []
            if os.path.isdir(p):
                for root, _, files in os.walk(p):
                    for f in sorted(files):
                        if f.lower().endswith(SUPPORTED_EXTS):
                            files_to_check.append(os.path.join(root, f))
            elif os.path.isfile(p) and p.lower().endswith(SUPPORTED_EXTS):
                files_to_check.append(p)

            for file_path in files_to_check:
                fname = os.path.basename(file_path)
                f_ext = os.path.splitext(fname)[1].lower()

                # Convert FBX/OBJ to GLB if needed
                actual_path = file_path
                orig_name = fname
                if f_ext in [".fbx", ".obj"]:
                    glb_path, err = convert_to_glb(file_path)
                    if glb_path and os.path.isfile(glb_path):
                        actual_path = glb_path
                    else:
                        print(f"Conversion warning for {fname}: {err}")
                        continue

                if not any(m["path"] == actual_path for m in MODELS.values()):
                    sz = os.path.getsize(actual_path) if os.path.isfile(actual_path) else 0
                    f_is_comp = is_comp or ("compress-GLB" in actual_path) or fname.lower().endswith("_clean.glb")

                    display_name = fname if fname.lower().endswith(".glb") else f"{os.path.splitext(fname)[0]}.glb"

                    MODELS[MODEL_COUNTER] = {
                        "id": MODEL_COUNTER,
                        "name": display_name,
                        "raw_name": orig_name,
                        "path": actual_path,
                        "dir": os.path.dirname(file_path),
                        "size_bytes": sz,
                        "size_str": format_size(sz),
                        "is_compressed": f_is_comp,
                        "orig_ext": f_ext.replace(".", "").upper()
                    }
                    MODEL_COUNTER += 1

        count = len(MODELS)
        CURRENT_ACTIVE_LABEL = f"{count} model{'s' if count != 1 else ''} loaded"


def pick_folder_native(title="Select Folder"):
    try:
        res = subprocess.run(
            ["zenity", "--file-selection", "--directory", f"--title={title}"],
            stdout=subprocess.PIPE, stderr=subprocess.PIPE, text=True
        )
        if res.returncode == 0 and res.stdout.strip():
            return res.stdout.strip()
    except Exception:
        pass
    return None


def pick_files_native():
    try:
        res = subprocess.run(
            ["zenity", "--file-selection", "--multiple", "--separator=|",
             "--file-filter=3D Models (*.glb, *.gltf, *.fbx, *.obj) | *.glb *.GLB *.gltf *.GLTF *.fbx *.FBX *.obj *.OBJ",
             "--title=Select 3D Files to Add"],
            stdout=subprocess.PIPE, stderr=subprocess.PIPE, text=True
        )
        if res.returncode == 0 and res.stdout.strip():
            return res.stdout.strip().split("|")
    except Exception:
        pass
    return []


def run_gltf_compress(mode, target_base_folder):
    gt = find_tool("gltf-transform")
    if not gt:
        return False, "Error: 'gltf-transform' not found. Run: sudo npm install -g @gltf-transform/cli", None, []

    out_dir = os.path.join(target_base_folder, "compress-GLB")
    os.makedirs(out_dir, exist_ok=True)

    with DATA_LOCK:
        models_to_process = [m for m in MODELS.values() if not m.get("is_compressed", False)]

    if not models_to_process:
        return False, "No uncompressed models loaded to optimize.", out_dir, []

    success_count = 0
    errors = []
    created_paths = []

    for item in models_to_process:
        src = item["path"]
        if not os.path.isfile(src):
            continue

        base_name = os.path.splitext(item["name"])[0]
        if base_name.endswith("_clean"):
            base_name = base_name[:-6]
        dest = os.path.join(out_dir, f"{base_name}_clean.glb")

        if mode == "ultra":
            cmd = [
                gt, "optimize", src, dest,
                "--compress", "draco",
                "--texture-compress", "webp",
                "--texture-size", "128",
                "--simplify-ratio", "0.25",
                "--simplify-error", "0.05",
                "--join-meshes", "true"
            ]
        else:
            cmd = [
                gt, "optimize", src, dest,
                "--compress", "draco",
                "--texture-compress", "webp",
                "--texture-size", "512"
            ]

        try:
            res = subprocess.run(cmd, stdout=subprocess.PIPE, stderr=subprocess.PIPE, text=True)
            if res.returncode == 0 and os.path.isfile(dest):
                success_count += 1
                created_paths.append(dest)
            else:
                errors.append(f"{item['name']}: {res.stderr.strip()[:100]}")
        except Exception as e:
            errors.append(f"{item['name']}: {str(e)}")

    if created_paths:
        add_paths(created_paths, clear_existing=False, is_compressed=True)

    msg = f"✓ Compressed {success_count}/{len(models_to_process)} models into {out_dir}"
    if errors:
        msg += f" (Errors: {len(errors)})"
    return True, msg, out_dir, created_paths


class GLBHandler(http.server.SimpleHTTPRequestHandler):
    def end_headers(self):
        self.send_header("Access-Control-Allow-Origin", "*")
        self.send_header("Access-Control-Allow-Methods", "GET, POST, OPTIONS")
        self.send_header("Access-Control-Allow-Headers", "Content-Type, X-Filename")
        self.send_header("Cache-Control", "no-cache, no-store, must-revalidate, max-age=0")
        self.send_header("Pragma", "no-cache")
        super().end_headers()

    def send_json(self, data, status=200):
        payload = json.dumps(data).encode("utf-8")
        self.send_response(status)
        self.send_header("Content-Type", "application/json")
        self.send_header("Content-Length", str(len(payload)))
        self.end_headers()
        self.wfile.write(payload)

    def do_OPTIONS(self):
        self.send_response(200)
        self.send_header("Content-Length", "0")
        self.end_headers()

    def do_GET(self):
        parsed = urllib.parse.urlparse(self.path)

        if parsed.path == "/":
            payload = HTML_PAGE.encode("utf-8")
            self.send_response(200)
            self.send_header("Content-Type", "text/html; charset=utf-8")
            self.send_header("Content-Length", str(len(payload)))
            self.end_headers()
            self.wfile.write(payload)
            return

        elif parsed.path == "/api/models":
            with DATA_LOCK:
                self.send_json({
                    "label": CURRENT_ACTIVE_LABEL or "No models loaded",
                    "models": list(MODELS.values())
                })
            return

        elif parsed.path == "/model":
            qs = urllib.parse.parse_qs(parsed.query)
            try:
                m_id = int(qs.get("id", [-1])[0])
            except ValueError:
                m_id = -1

            filepath = None
            with DATA_LOCK:
                if m_id in MODELS and os.path.isfile(MODELS[m_id]["path"]):
                    filepath = MODELS[m_id]["path"]

            if filepath:
                self.send_response(200)
                self.send_header("Content-Type", "model/gltf-binary")
                self.send_header("Content-Length", str(os.path.getsize(filepath)))
                self.end_headers()
                with open(filepath, "rb") as f:
                    shutil.copyfileobj(f, self.wfile)
                return
            else:
                self.send_error(404, "Model not found on disk")
                return

        super().do_GET()

    def do_POST(self):
        global MODELS, MODEL_COUNTER, CURRENT_ACTIVE_LABEL
        parsed = urllib.parse.urlparse(self.path)

        if parsed.path == "/api/remove_models":
            length = int(self.headers.get("Content-Length", 0))
            body = json.loads(self.rfile.read(length).decode("utf-8")) if length > 0 else {}
            ids = body.get("ids", [])
            with DATA_LOCK:
                for m_id in ids:
                    try:
                        m_id = int(m_id)
                        if m_id in MODELS:
                            del MODELS[m_id]
                    except (ValueError, TypeError):
                        pass
                count = len(MODELS)
                CURRENT_ACTIVE_LABEL = f"{count} model{'s' if count != 1 else ''} loaded"
                model_list = list(MODELS.values())
            self.send_json({"success": True, "label": CURRENT_ACTIVE_LABEL, "models": model_list})
            return

        elif parsed.path == "/api/open_folder":
            length = int(self.headers.get("Content-Length", 0))
            body = json.loads(self.rfile.read(length).decode("utf-8")) if length > 0 else {}
            folder_path = body.get("folder")
            if folder_path and os.path.isdir(folder_path):
                subprocess.Popen(["xdg-open", folder_path], stdout=subprocess.DEVNULL, stderr=subprocess.DEVNULL)
                self.send_json({"success": True})
            else:
                self.send_json({"error": "Folder not found"}, status=404)
            return

        elif parsed.path == "/api/compress":
            length = int(self.headers.get("Content-Length", 0))
            body = json.loads(self.rfile.read(length).decode("utf-8")) if length > 0 else {}
            mode = body.get("mode", "standard")

            target_folder = pick_folder_native("Select Target Destination for 'compress-GLB'")
            if not target_folder:
                self.send_json({"success": False, "message": "Cancelled: No folder selected."})
                return

            ok, message, out_dir, created = run_gltf_compress(mode, target_folder)
            with DATA_LOCK:
                model_list = list(MODELS.values())
            self.send_json({
                "success": ok,
                "message": message,
                "folder": out_dir,
                "created_count": len(created),
                "models": model_list
            })
            return

        elif parsed.path == "/api/rename":
            length = int(self.headers.get("Content-Length", 0))
            body = json.loads(self.rfile.read(length).decode("utf-8"))
            try:
                m_id = int(body.get("id"))
            except (TypeError, ValueError):
                m_id = -1

            new_name = os.path.basename(body.get("newName", "").strip())
            if not new_name.lower().endswith(".glb"):
                new_name += ".glb"

            with DATA_LOCK:
                if m_id in MODELS:
                    old_path = MODELS[m_id]["path"]
                    if not os.path.isfile(old_path):
                        self.send_json({"error": f"File not found: {old_path}"}, status=404)
                        return

                    dir_name = os.path.dirname(old_path)
                    new_path = os.path.join(dir_name, new_name)

                    if os.path.exists(new_path) and new_path != old_path:
                        self.send_json({"error": "A file with that name already exists!"}, status=400)
                        return

                    try:
                        os.rename(old_path, new_path)
                        MODELS[m_id]["name"] = new_name
                        MODELS[m_id]["path"] = new_path
                        self.send_json({"success": True, "newName": new_name, "folder": dir_name})
                    except Exception as e:
                        self.send_json({"error": str(e)}, status=500)
                else:
                    self.send_json({"error": "Model ID not found"}, status=404)
            return

        elif parsed.path == "/api/load_paths":
            length = int(self.headers.get("Content-Length", 0))
            body = json.loads(self.rfile.read(length).decode("utf-8"))
            paths = body.get("paths", [])
            clear_existing = body.get("clear_existing", False)
            add_paths(paths, clear_existing=clear_existing)
            with DATA_LOCK:
                self.send_json({"label": CURRENT_ACTIVE_LABEL, "models": list(MODELS.values())})
            return

        elif parsed.path == "/api/select_folder":
            folder = pick_folder_native("Select 3D Folder to Add")
            if folder:
                add_paths([folder], clear_existing=False)
            with DATA_LOCK:
                self.send_json({"label": CURRENT_ACTIVE_LABEL, "models": list(MODELS.values())})
            return

        elif parsed.path == "/api/select_files":
            files = pick_files_native()
            if files:
                add_paths(files, clear_existing=False)
            with DATA_LOCK:
                self.send_json({"label": CURRENT_ACTIVE_LABEL, "models": list(MODELS.values())})
            return

        elif parsed.path == "/api/clear":
            with DATA_LOCK:
                MODELS.clear()
                MODEL_COUNTER = 0
                CURRENT_ACTIVE_LABEL = ""
            for folder_to_clean in [UPLOAD_DIR, CONVERT_DIR]:
                for f in os.listdir(folder_to_clean):
                    try:
                        os.remove(os.path.join(folder_to_clean, f))
                    except Exception:
                        pass
            self.send_json({"success": True})
            return

        elif parsed.path == "/api/upload":
            length = int(self.headers.get("Content-Length", 0))
            raw_filename = os.path.basename(self.headers.get("X-Filename", "dropped.glb"))
            dest = os.path.join(UPLOAD_DIR, raw_filename)

            try:
                with open(dest, "wb") as f:
                    remaining = length
                    while remaining > 0:
                        chunk = self.rfile.read(min(remaining, 65536))
                        if not chunk:
                            break
                        f.write(chunk)
                        remaining -= len(chunk)

                add_paths([dest], clear_existing=False)
                with DATA_LOCK:
                    self.send_json({"label": CURRENT_ACTIVE_LABEL, "models": list(MODELS.values())})
            except Exception as e:
                self.send_json({"error": str(e)}, status=500)
            return

        elif parsed.path == "/api/quit":
            self.send_json({"success": True})
            def shutdown():
                time.sleep(0.3)
                if SERVER_INSTANCE:
                    SERVER_INSTANCE.shutdown()
                os._exit(0)
            threading.Thread(target=shutdown).start()
            return

        self.send_error(404)


HTML_PAGE = """<!DOCTYPE html>
<html lang="en">
<head>
  <meta charset="UTF-8" />
  <title>VisionOS 3D Studio</title>
  <style>
    * { box-sizing: border-box; margin: 0; padding: 0; user-select: none; }
    body {
      overflow: hidden;
      background: radial-gradient(circle at 50% 30%, #171b26 0%, #0a0c10 100%);
      font-family: -apple-system, BlinkMacSystemFont, "SF Pro Display", "SF Pro Text", system-ui, sans-serif;
      color: #f1f5f9;
      -webkit-font-smoothing: antialiased;
    }

    #webgl-container { position: absolute; inset: 0; z-index: 1; }
    #css2d-container { position: absolute; inset: 0; pointer-events: none; z-index: 2; overflow: hidden; }

    /* Apple VisionOS Frosted Glass Model Tag */
    .model-label {
      background: rgba(28, 32, 45, 0.72);
      border: 1px solid rgba(255, 255, 255, 0.16);
      backdrop-filter: blur(28px) saturate(200%);
      -webkit-backdrop-filter: blur(28px) saturate(200%);
      padding: 6px 14px;
      border-radius: 9999px;
      font-size: 13px;
      font-weight: 500;
      color: #e2e8f0;
      box-shadow: 0 16px 36px rgba(0, 0, 0, 0.4), inset 0 1px 1px rgba(255, 255, 255, 0.25);
      white-space: nowrap;
      pointer-events: auto;
      display: inline-flex;
      align-items: center;
      gap: 9px;
      transition: all 0.25s cubic-bezier(0.16, 1, 0.3, 1);
      cursor: pointer;
    }
    .model-label:hover {
      background: rgba(45, 52, 72, 0.82);
      border-color: rgba(255, 255, 255, 0.35);
      transform: translateY(-2px) scale(1.03);
      box-shadow: 0 20px 42px rgba(0, 0, 0, 0.5), inset 0 1px 1.5px rgba(255, 255, 255, 0.4);
    }
    .model-label.compressed-label {
      border-color: rgba(52, 211, 153, 0.4);
      background: rgba(16, 28, 28, 0.75);
      box-shadow: 0 14px 32px rgba(5, 150, 105, 0.2), inset 0 1px 1px rgba(52, 211, 153, 0.3);
    }
    .model-label.selected {
      border-color: #f59e0b !important;
      background: rgba(45, 34, 18, 0.88) !important;
      color: #fef3c7 !important;
      box-shadow: 0 0 24px rgba(245, 158, 11, 0.55), inset 0 1px 1px rgba(254, 243, 199, 0.5) !important;
      transform: translateY(-2px) scale(1.06) !important;
    }

    .label-title { cursor: pointer; font-weight: 500; letter-spacing: -0.01em; }
    .label-title:hover { color: #38bdf8; }

    .focus-btn {
      cursor: pointer; opacity: 0.75; display: inline-flex; align-items: center; justify-content: center;
      transition: opacity 0.2s, transform 0.2s;
    }
    .focus-btn:hover { opacity: 1; transform: scale(1.2); }

    .size-badge {
      font-size: 11px;
      font-weight: 600;
      background: rgba(255, 255, 255, 0.09);
      border: 1px solid rgba(255, 255, 255, 0.16);
      color: #94a3b8;
      padding: 2px 8px;
      border-radius: 9999px;
      font-variant-numeric: tabular-nums;
      letter-spacing: -0.01em;
    }
    .format-badge {
      font-size: 10px;
      font-weight: 700;
      background: rgba(56, 189, 248, 0.15);
      border: 1px solid rgba(56, 189, 248, 0.35);
      color: #38bdf8;
      padding: 1px 6px;
      border-radius: 9999px;
    }
    .comp-badge {
      font-size: 10px;
      font-weight: 700;
      background: rgba(16, 185, 129, 0.25);
      border: 1px solid rgba(52, 211, 153, 0.5);
      color: #34d399;
      padding: 1px 7px;
      border-radius: 9999px;
    }
    .anim-badge {
      font-size: 10px;
      font-weight: 600;
      background: rgba(168, 85, 247, 0.2);
      border: 1px solid rgba(192, 132, 252, 0.4);
      color: #c084fc;
      padding: 1px 7px;
      border-radius: 9999px;
    }

    /* Auto-Expanding VisionOS Rename Input */
    .rename-input {
      background: rgba(15, 23, 42, 0.95);
      border: 1.5px solid #38bdf8;
      color: #ffffff;
      font-size: 13px;
      font-family: inherit;
      padding: 4px 12px;
      border-radius: 9999px;
      outline: none;
      min-width: 220px;
      max-width: 600px;
      box-shadow: 0 0 18px rgba(56, 189, 248, 0.45);
    }

    /* Apple VisionOS Floating Top Dock */
    #ui-bar {
      position: absolute; top: 20px; left: 50%; transform: translateX(-50%);
      z-index: 10; display: flex; gap: 7px;
      background: rgba(22, 26, 36, 0.65);
      border: 1px solid rgba(255, 255, 255, 0.15);
      backdrop-filter: blur(32px) saturate(200%);
      -webkit-backdrop-filter: blur(32px) saturate(200%);
      padding: 8px 12px; border-radius: 9999px; align-items: center;
      box-shadow: 0 24px 60px rgba(0, 0, 0, 0.55), inset 0 1px 1px rgba(255, 255, 255, 0.25);
    }

    .btn {
      background: rgba(255, 255, 255, 0.08);
      color: #f1f5f9;
      border: 1px solid rgba(255, 255, 255, 0.12);
      padding: 7px 14px;
      border-radius: 9999px;
      cursor: pointer;
      font-size: 12.5px;
      font-weight: 500;
      display: inline-flex;
      align-items: center;
      gap: 7px;
      transition: all 0.2s cubic-bezier(0.16, 1, 0.3, 1);
    }
    .btn svg { width: 14px; height: 14px; stroke-width: 2; }
    .btn:hover {
      background: rgba(255, 255, 255, 0.18);
      border-color: rgba(255, 255, 255, 0.3);
      transform: translateY(-1px);
    }
    .btn-primary {
      background: #2563eb; color: #fff; border-color: rgba(255, 255, 255, 0.25);
    }
    .btn-primary:hover { background: #1d4ed8; }

    .btn-compress {
      background: rgba(16, 185, 129, 0.2);
      color: #34d399;
      border: 1px solid rgba(16, 185, 129, 0.4);
    }
    .btn-compress:hover {
      background: #059669; color: #fff;
      box-shadow: 0 0 16px rgba(16, 185, 129, 0.4);
    }

    .btn-ultra {
      background: rgba(245, 158, 11, 0.2);
      color: #fbbf24;
      border: 1px solid rgba(245, 158, 11, 0.4);
    }
    .btn-ultra:hover {
      background: #d97706; color: #fff;
      box-shadow: 0 0 16px rgba(245, 158, 11, 0.4);
    }

    .btn-danger {
      background: rgba(239, 68, 68, 0.18);
      color: #f87171;
      border: 1px solid rgba(239, 68, 68, 0.35);
    }
    .btn-danger:hover {
      background: #dc2626; color: #fff;
      box-shadow: 0 0 16px rgba(239, 68, 68, 0.4);
    }

    #path-display {
      max-width: 170px; overflow: hidden; text-overflow: ellipsis; white-space: nowrap;
      font-size: 12px; color: #94a3b8; background: rgba(0, 0, 0, 0.25);
      padding: 5px 10px; border-radius: 9999px; border: 1px solid rgba(255, 255, 255, 0.08);
    }

    #selected-badge {
      display: none; background: rgba(245, 158, 11, 0.25);
      border: 1px solid #f59e0b; color: #fbbf24; padding: 4px 10px;
      border-radius: 9999px; font-size: 11px; font-weight: 600;
    }

    #isolation-badge {
      display: none; background: rgba(56, 189, 248, 0.2);
      border: 1px solid #38bdf8; color: #7dd3fc; padding: 4px 10px;
      border-radius: 9999px; font-size: 11px; font-weight: 500;
    }

    /* VisionOS Floating Folder Pill Button */
    #open-folder-float {
      position: absolute; bottom: 24px; right: 24px; z-index: 30;
      display: none; align-items: center; gap: 8px;
      background: rgba(16, 185, 129, 0.85); color: #ffffff;
      border: 1px solid rgba(255, 255, 255, 0.3);
      padding: 10px 20px; border-radius: 9999px; font-size: 13px; font-weight: 600;
      cursor: pointer; box-shadow: 0 16px 40px rgba(0, 0, 0, 0.5), 0 0 20px rgba(16, 185, 129, 0.4);
      backdrop-filter: blur(20px);
      transition: all 0.25s cubic-bezier(0.16, 1, 0.3, 1);
    }
    #open-folder-float:hover {
      background: #059669; transform: translateY(-2px) scale(1.04);
      box-shadow: 0 20px 48px rgba(0, 0, 0, 0.6), 0 0 28px rgba(16, 185, 129, 0.6);
    }

    #loader {
      position: absolute; bottom: 74px; right: 24px;
      background: rgba(22, 26, 36, 0.78);
      border: 1px solid rgba(255, 255, 255, 0.16);
      backdrop-filter: blur(24px);
      padding: 9px 18px; border-radius: 9999px;
      display: none; align-items: center; gap: 10px; z-index: 25; font-size: 12.5px;
      box-shadow: 0 12px 30px rgba(0,0,0,0.4);
    }
    .spinner {
      width: 14px; height: 14px; border: 2px solid rgba(255, 255, 255, 0.25);
      border-top-color: #38bdf8; border-radius: 50%; animation: spin 0.75s linear infinite;
    }
    @keyframes spin { to { transform: rotate(360deg); } }

    /* VisionOS Animation Sheet */
    #anim-panel {
      position: absolute; bottom: 24px; left: 24px; z-index: 25;
      background: rgba(22, 26, 38, 0.75);
      border: 1px solid rgba(255, 255, 255, 0.16);
      backdrop-filter: blur(36px) saturate(200%);
      border-radius: 24px; padding: 18px;
      width: 340px; max-height: 480px; display: none; flex-direction: column; gap: 12px;
      box-shadow: 0 24px 60px rgba(0, 0, 0, 0.65), inset 0 1px 1px rgba(255, 255, 255, 0.2);
    }
    #anim-panel-header {
      display: flex; justify-content: space-between; align-items: center;
      border-bottom: 1px solid rgba(255, 255, 255, 0.08); padding-bottom: 10px;
    }
    #anim-panel-title { font-size: 14px; font-weight: 600; color: #38bdf8; letter-spacing: -0.01em; }
    #close-anim-btn {
      background: rgba(255, 255, 255, 0.1); border: none; color: #94a3b8; cursor: pointer;
      font-size: 14px; width: 24px; height: 24px; border-radius: 50%;
      display: flex; align-items: center; justify-content: center;
    }
    #close-anim-btn:hover { background: rgba(255, 255, 255, 0.2); color: #fff; }

    #anim-list { display: flex; flex-direction: column; gap: 6px; max-height: 160px; overflow-y: auto; }
    .anim-row {
      display: flex; align-items: center; justify-content: space-between;
      background: rgba(255, 255, 255, 0.05); padding: 7px 12px; border-radius: 12px;
      font-size: 12px; cursor: pointer; transition: background 0.2s;
    }
    .anim-row:hover { background: rgba(56, 189, 248, 0.18); }
    .anim-row label { display: flex; align-items: center; gap: 8px; cursor: pointer; overflow: hidden; text-overflow: ellipsis; }
    .anim-row input[type="checkbox"] { accent-color: #38bdf8; }

    #snippet-box {
      background: rgba(10, 14, 22, 0.8); border: 1px solid rgba(255, 255, 255, 0.08);
      border-radius: 14px; padding: 12px; font-family: ui-monospace, SFMono-Regular, Menlo, monospace;
      font-size: 11px; color: #cbd5e1;
    }
    #snippet-code { white-space: pre-wrap; word-break: break-all; max-height: 90px; overflow-y: auto; line-height: 1.4; color: #38bdf8; }
    #copy-snippet-btn {
      margin-top: 8px; width: 100%; background: rgba(56, 189, 248, 0.15); border: 1px solid rgba(56, 189, 248, 0.3);
      color: #7dd3fc; padding: 7px; border-radius: 10px; cursor: pointer; font-size: 11.5px; font-weight: 600;
    }
    #copy-snippet-btn:hover { background: #0284c7; color: #fff; }

    #toast {
      position: absolute; bottom: 24px; left: 50%; transform: translateX(-50%) translateY(60px);
      background: rgba(24, 28, 38, 0.85);
      border: 1px solid rgba(255, 255, 255, 0.18);
      backdrop-filter: blur(28px);
      padding: 10px 22px; border-radius: 9999px; font-size: 13px; z-index: 30;
      opacity: 0; transition: all 0.3s cubic-bezier(0.16, 1, 0.3, 1); pointer-events: none;
      box-shadow: 0 16px 40px rgba(0,0,0,0.5);
    }
    #toast.show { transform: translateX(-50%) translateY(0); opacity: 1; }

    #drop-overlay {
      position: absolute; inset: 24px; border: 2px dashed rgba(56, 189, 248, 0.35);
      background: rgba(13, 16, 23, 0.85); backdrop-filter: blur(32px);
      border-radius: 28px; display: flex; flex-direction: column; justify-content: center; align-items: center;
      z-index: 20; pointer-events: none; transition: opacity 0.3s ease; text-align: center;
    }
    #drop-overlay.hidden { opacity: 0; pointer-events: none; }
    #drop-overlay.drag-hover { background: rgba(2, 132, 199, 0.2); border-color: #38bdf8; opacity: 1; }
    #drop-overlay h2 { font-size: 26px; margin-bottom: 8px; color: #f8fafc; font-weight: 600; letter-spacing: -0.02em; }
    #drop-overlay p { font-size: 14px; color: #94a3b8; max-width: 540px; line-height: 1.6; }
  </style>

  <script async src="https://unpkg.com/es-module-shims@1.8.0/dist/es-module-shims.js"></script>
  <script type="importmap">
    {
      "imports": {
        "three": "https://unpkg.com/three@0.165.0/build/three.module.js",
        "three/addons/": "https://unpkg.com/three@0.165.0/examples/jsm/"
      }
    }
  </script>
</head>
<body>
  <div id="webgl-container"></div>
  <div id="css2d-container"></div>

  <!-- VisionOS Glass Capsule Nav Bar -->
  <div id="ui-bar">
    <button class="btn btn-primary" id="open-files-btn">
      <svg viewBox="0 0 24 24" fill="none" stroke="currentColor"><path d="M14 2H6a2 2 0 0 0-2 2v16a2 2 0 0 0 2 2h12a2 2 0 0 0 2-2V8z"/><polyline points="14 2 14 8 20 8"/><line x1="12" y1="18" x2="12" y2="12"/><line x1="9" y1="15" x2="15" y2="15"/></svg>
      Add Files
    </button>
    <button class="btn" id="open-folder-btn">
      <svg viewBox="0 0 24 24" fill="none" stroke="currentColor"><path d="M22 19a2 2 0 0 1-2 2H4a2 2 0 0 1-2-2V5a2 2 0 0 1 2-2h5l2 3h9a2 2 0 0 1 2 2z"/><line x1="12" y1="11" x2="12" y2="17"/><line x1="9" y1="14" x2="15" y2="14"/></svg>
      Folder
    </button>
    <button class="btn btn-compress" id="compress-std-btn" title="Draco + 512px WebP">
      <svg viewBox="0 0 24 24" fill="none" stroke="currentColor"><path d="M4 14.899A7 7 0 1 1 15.71 8h1.79a4.5 4.5 0 0 1 2.5 8.242"/><path d="M12 12v9"/><path d="m8 17 4 4 4-4"/></svg>
      Compress (512)
    </button>
    <button class="btn btn-ultra" id="compress-ultra-btn" title="Draco + 128px + 75% Simplify + Join">
      <svg viewBox="0 0 24 24" fill="none" stroke="currentColor"><polygon points="13 2 3 14 12 14 11 22 21 10 12 10 13 2"/></svg>
      Ultra Low-Poly
    </button>
    <button class="btn" id="reset-cam-btn">
      <svg viewBox="0 0 24 24" fill="none" stroke="currentColor"><circle cx="12" cy="12" r="10"/><circle cx="12" cy="12" r="2"/></svg>
      Reset View
    </button>
    <button class="btn" id="clear-btn">
      <svg viewBox="0 0 24 24" fill="none" stroke="currentColor"><polyline points="3 6 5 6 21 6"/><path d="M19 6v14a2 2 0 0 1-2 2H7a2 2 0 0 1-2-2V6m3 0V4a2 2 0 0 1 2-2h4a2 2 0 0 1 2 2v2"/></svg>
      Clear
    </button>
    <button class="btn btn-danger" id="quit-btn" title="Quit Server">
      <svg viewBox="0 0 24 24" fill="none" stroke="currentColor"><path d="M18.36 6.64a9 9 0 1 1-12.73 0"/><line x1="12" y1="2" x2="12" y2="12"/></svg>
      Quit
    </button>
    <span id="selected-badge">0 Selected (Hit Del)</span>
    <span id="isolation-badge">🔍 Focused</span>
    <span id="path-display">No models loaded</span>
    <span id="model-count" style="font-size:12px;color:#94a3b8;margin-left:4px;">0 models</span>
  </div>

  <button id="open-folder-float" title="Open Destination Folder">
    <svg width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><path d="M22 19a2 2 0 0 1-2 2H4a2 2 0 0 1-2-2V5a2 2 0 0 1 2-2h5l2 3h9a2 2 0 0 1 2 2z"/></svg>
    Open compress-GLB Folder
  </button>

  <div id="anim-panel">
    <div id="anim-panel-header">
      <span id="anim-panel-title">🎬 Animations (0)</span>
      <button id="close-anim-btn">✕</button>
    </div>
    <div id="anim-list"></div>
    <div id="snippet-box">
      <div style="font-size:10px; color:#94a3b8; margin-bottom:4px;">THREE.JS CODE TO USE:</div>
      <pre id="snippet-code"></pre>
      <button id="copy-snippet-btn">Copy Code</button>
    </div>
  </div>

  <div id="drop-overlay">
    <h2>Drop 3D Files Here</h2>
    <p>Supports <b>GLB</b>, <b>GLTF</b>, <b>FBX</b>, and <b>OBJ</b>.<br/>
    • FBX and OBJ auto-convert to GLB on load<br/>
    • Hold <b>Shift + Click</b> to multi-select, press <b>Delete</b> to remove<br/>
    • Model names sit neatly at the <b>bottom center</b>; tap to rename with full name</p>
  </div>

  <div id="toast">Saved changes</div>
  <div id="loader"><div class="spinner"></div><span id="loader-text">Loading...</span></div>

  <script type="module">
    import * as THREE from 'three';
    import { OrbitControls } from 'three/addons/controls/OrbitControls.js';
    import { GLTFLoader } from 'three/addons/loaders/GLTFLoader.js';
    import { DRACOLoader } from 'three/addons/loaders/DRACOLoader.js';
    import { KTX2Loader } from 'three/addons/loaders/KTX2Loader.js';
    import { MeshoptDecoder } from 'three/addons/libs/meshopt_decoder.module.js';
    import { CSS2DRenderer, CSS2DObject } from 'three/addons/renderers/CSS2DRenderer.js';

    const TARGET_SIZE = 2.5;
    const GRID_SPACING = 3.6;

    const clock = new THREE.Clock();
    const scene = new THREE.Scene();
    scene.background = new THREE.Color('#0b0d12');

    const camera = new THREE.PerspectiveCamera(45, window.innerWidth / window.innerHeight, 0.05, 2000);
    camera.position.set(0, 9, 18);

    const renderer = new THREE.WebGLRenderer({ antialias: true, alpha: true });
    renderer.setPixelRatio(Math.min(window.devicePixelRatio, 2));
    renderer.setSize(window.innerWidth, window.innerHeight);
    renderer.toneMapping = THREE.ACESFilmicToneMapping;
    renderer.toneMappingExposure = 1.05;
    renderer.shadowMap.enabled = true;
    document.getElementById('webgl-container').appendChild(renderer.domElement);

    const labelContainer = document.getElementById('css2d-container');
    const labelRenderer = new CSS2DRenderer({ element: labelContainer });
    labelRenderer.setSize(window.innerWidth, window.innerHeight);

    const controls = new OrbitControls(camera, renderer.domElement);
    controls.enableDamping = true;
    controls.dampingFactor = 0.05;

    scene.add(new THREE.HemisphereLight(0xffffff, 0x334155, 1.4));
    const dirLight = new THREE.DirectionalLight(0xffffff, 1.6);
    dirLight.position.set(20, 40, 20);
    dirLight.castShadow = true;
    scene.add(dirLight);

    const grid = new THREE.GridHelper(100, 100, 0x1e293b, 0x111827);
    grid.position.y = -0.01;
    scene.add(grid);

    const dracoLoader = new DRACOLoader();
    dracoLoader.setDecoderPath('https://www.gstatic.com/draco/versioned/decoders/1.5.7/');

    const ktx2Loader = new KTX2Loader()
      .setTranscoderPath('https://unpkg.com/three@0.165.0/examples/jsm/libs/basis/')
      .detectSupport(renderer);

    const gltfLoader = new GLTFLoader();
    gltfLoader.setDRACOLoader(dracoLoader);
    gltfLoader.setKTX2Loader(ktx2Loader);
    gltfLoader.setMeshoptDecoder(MeshoptDecoder);

    const modelGroup = new THREE.Group();
    scene.add(modelGroup);
    const loadedItems = [];
    const selectedItems = new Set();

    let isIsolated = false;
    let focusedItem = null;
    const isolationBadge = document.getElementById('isolation-badge');
    const selectedBadge = document.getElementById('selected-badge');
    const openFolderFloatBtn = document.getElementById('open-folder-float');
    let currentOutputFolder = null;

    const animPanel = document.getElementById('anim-panel');
    ['pointerdown', 'mousedown', 'click', 'dblclick'].forEach(evt => {
      animPanel.addEventListener(evt, e => e.stopPropagation());
    });

    function showToast(message, isError = false) {
      const toast = document.getElementById('toast');
      toast.textContent = message;
      toast.style.borderColor = isError ? 'rgba(239, 68, 68, 0.4)' : 'rgba(52, 211, 153, 0.4)';
      toast.style.color = isError ? '#f87171' : '#34d399';
      toast.classList.add('show');
      setTimeout(() => toast.classList.remove('show'), 5000);
    }

    function updateSelectionUI() {
      loadedItems.forEach(item => {
        const isSel = selectedItems.has(item);
        if (isSel) {
          item.labelDiv.classList.add('selected');
          if (!item.selectionBox) {
            item.selectionBox = new THREE.BoxHelper(item.root, 0xf59e0b);
            scene.add(item.selectionBox);
          }
          item.selectionBox.visible = true;
          item.selectionBox.update();
        } else {
          item.labelDiv.classList.remove('selected');
          if (item.selectionBox) item.selectionBox.visible = false;
        }
      });

      if (selectedItems.size > 0) {
        selectedBadge.style.display = 'inline-block';
        selectedBadge.innerText = `Selected (${selectedItems.size}) - Hit [Del]`;
      } else {
        selectedBadge.style.display = 'none';
      }
    }

    function toggleSelection(item, isShift = false) {
      if (isShift) {
        if (selectedItems.has(item)) selectedItems.delete(item);
        else selectedItems.add(item);
      } else {
        const wasSingleSelected = selectedItems.size === 1 && selectedItems.has(item);
        selectedItems.clear();
        if (!wasSingleSelected) selectedItems.add(item);
      }
      updateSelectionUI();
    }

    function clearSelection() {
      if (selectedItems.size === 0) return;
      selectedItems.clear();
      updateSelectionUI();
    }

    function removeLoadedItem(item) {
      if (item.selectionBox) {
        scene.remove(item.selectionBox);
        if (item.selectionBox.geometry) item.selectionBox.geometry.dispose();
        item.selectionBox = null;
      }
      if (item.labelDiv && item.labelDiv.parentNode) {
        item.labelDiv.parentNode.removeChild(item.labelDiv);
      }
      item.root.traverse(node => {
        if (node.isMesh) {
          if (node.geometry) node.geometry.dispose();
          if (node.material) {
            if (Array.isArray(node.material)) node.material.forEach(m => m.dispose());
            else node.material.dispose();
          }
        }
      });
      modelGroup.remove(item.root);
      const idx = loadedItems.indexOf(item);
      if (idx !== -1) loadedItems.splice(idx, 1);
    }

    function purgeScene() {
      clearSelection();
      while (labelContainer.firstChild) {
        labelContainer.removeChild(labelContainer.firstChild);
      }
      loadedItems.forEach(item => {
        if (item.selectionBox) {
          scene.remove(item.selectionBox);
          if (item.selectionBox.geometry) item.selectionBox.geometry.dispose();
        }
      });
      modelGroup.traverse((node) => {
        if (node.isMesh) {
          if (node.geometry) node.geometry.dispose();
          if (node.material) {
            if (Array.isArray(node.material)) node.material.forEach(m => m.dispose());
            else node.material.dispose();
          }
        }
      });
      while (modelGroup.children.length > 0) {
        modelGroup.remove(modelGroup.children[0]);
      }
      loadedItems.length = 0;
      isIsolated = false;
      focusedItem = null;
      isolationBadge.style.display = 'none';
      selectedBadge.style.display = 'none';
      animPanel.style.display = 'none';
      openFolderFloatBtn.style.display = 'none';
      document.getElementById('model-count').innerText = '0 models';
    }

    let cameraAnim = null;
    function animateCameraTo(targetPos, targetLookAt, duration = 750) {
      cameraAnim = {
        startPos: camera.position.clone(),
        endPos: targetPos,
        startTarget: controls.target.clone(),
        endTarget: targetLookAt,
        startTime: performance.now(),
        duration
      };
    }

    function focusModel(item) {
      if (loadedItems.length > 1) {
        isIsolated = true;
        focusedItem = item;
        isolationBadge.style.display = 'inline-block';

        loadedItems.forEach(i => {
          if (i === item) {
            i.root.visible = true;
            i.labelDiv.style.display = 'inline-flex';
          } else {
            i.root.visible = false;
            i.labelDiv.style.display = 'none';
          }
        });
      }

      const targetLookAt = new THREE.Vector3();
      item.root.getWorldPosition(targetLookAt);
      targetLookAt.y += item.effectiveTargetSize * 0.45;

      const targetCamPos = targetLookAt.clone().add(new THREE.Vector3(0, item.effectiveTargetSize * 0.4, item.effectiveTargetSize * 1.6));
      animateCameraTo(targetCamPos, targetLookAt);

      showAnimationPanel(item);
    }

    function resetIsolationAndOverview() {
      isIsolated = false;
      focusedItem = null;
      isolationBadge.style.display = 'none';
      animPanel.style.display = 'none';

      loadedItems.forEach(i => {
        i.root.visible = true;
        i.labelDiv.style.display = 'inline-flex';
      });

      updateCameraView();
    }

    function updateCameraView() {
      isIsolated = false;
      focusedItem = null;
      isolationBadge.style.display = 'none';

      loadedItems.forEach(i => {
        i.root.visible = true;
        i.labelDiv.style.display = 'inline-flex';
      });

      const box = new THREE.Box3().setFromObject(modelGroup);
      if (box.isEmpty()) return;

      const center = box.getCenter(new THREE.Vector3());
      const size = box.getSize(new THREE.Vector3());
      const maxDim = Math.max(size.x, size.y, size.z, 2.0);
      const fov = camera.fov * (Math.PI / 180);
      const dist = Math.abs(maxDim / 2 / Math.tan(fov / 2)) * 1.5;

      animateCameraTo(new THREE.Vector3(center.x, center.y + dist * 0.45, center.z + dist), center);
    }

    let scrollBackAccumulator = 0;
    window.addEventListener('wheel', (e) => {
      if (isIsolated) {
        if (e.deltaY > 0) {
          scrollBackAccumulator += e.deltaY;
          if (scrollBackAccumulator > 30) {
            scrollBackAccumulator = 0;
            resetIsolationAndOverview();
          }
        } else {
          scrollBackAccumulator = 0;
        }
      }
    }, { passive: true });

    let activeSnippetCode = '';
    function showAnimationPanel(item) {
      if (!item.animations || item.animations.length === 0) {
        animPanel.style.display = 'none';
        return;
      }

      animPanel.style.display = 'flex';
      document.getElementById('anim-panel-title').innerText = `🎬 ${item.name} (${item.animations.length})`;

      const listContainer = document.getElementById('anim-list');
      listContainer.innerHTML = '';

      let firstClipName = item.animations[0].name;

      item.animations.forEach((clip) => {
        const action = item.actions[clip.name];
        const isPlaying = action && action.isRunning() && !action.paused;

        const row = document.createElement('div');
        row.className = 'anim-row';

        const label = document.createElement('label');
        const cb = document.createElement('input');
        cb.type = 'checkbox';
        cb.checked = isPlaying;

        cb.addEventListener('change', () => {
          if (cb.checked) {
            action.reset().fadeIn(0.2).play();
          } else {
            action.fadeOut(0.2);
          }
          updateSnippet(item, clip.name);
        });

        const span = document.createElement('span');
        span.textContent = clip.name;
        span.title = `Duration: ${clip.duration.toFixed(2)}s`;

        label.appendChild(cb);
        label.appendChild(span);
        row.appendChild(label);

        row.addEventListener('click', (e) => {
          if (e.target !== cb) {
            cb.checked = !cb.checked;
            cb.dispatchEvent(new Event('change'));
          }
        });

        listContainer.appendChild(row);
      });

      const anyRunning = Object.values(item.actions).some(a => a.isRunning() && !a.paused);
      if (!anyRunning && item.animations.length > 0) {
        const firstAction = item.actions[firstClipName];
        firstAction.reset().fadeIn(0.2).play();
        const firstCb = listContainer.querySelector('input[type="checkbox"]');
        if (firstCb) firstCb.checked = true;
      }

      updateSnippet(item, firstClipName);
    }

    function updateSnippet(item, clipName) {
      activeSnippetCode = `// 1. Create animation mixer for model
const mixer = new THREE.AnimationMixer(gltf.scene);

// 2. Find clip by name: "${clipName}"
const clip = THREE.AnimationClip.findByName(gltf.animations, '${clipName}');

// 3. Create action and play
const action = mixer.clipAction(clip);
action.play();

// 4. Update in animate loop:
// mixer.update(clock.getDelta());`;

      document.getElementById('snippet-code').innerText = activeSnippetCode;
    }

    document.getElementById('copy-snippet-btn').addEventListener('click', () => {
      if (!activeSnippetCode) return;
      navigator.clipboard.writeText(activeSnippetCode).then(() => {
        const btn = document.getElementById('copy-snippet-btn');
        btn.innerText = '✓ Copied!';
        setTimeout(() => btn.innerText = 'Copy Code', 2000);
      });
    });

    document.getElementById('close-anim-btn').addEventListener('click', () => {
      animPanel.style.display = 'none';
    });

    function rearrangeModels() {
      if (loadedItems.length === 0) return;

      const originals = loadedItems.filter(i => !i.isCompressed);
      const compressed = loadedItems.filter(i => i.isCompressed);

      if (originals.length > 0 && compressed.length > 0) {
        // Upper row: Originals
        const origSpacing = GRID_SPACING;
        const oCols = originals.length;
        originals.forEach((item, index) => {
          const x = (index - (oCols - 1) / 2) * origSpacing;
          const z = -GRID_SPACING * 0.85;
          item.root.position.set(x, 0, z);
        });

        // Bottom row: Compressed (slightly smaller, placed down in front)
        const compSpacing = GRID_SPACING * 0.82;
        const cCols = compressed.length;
        compressed.forEach((item, index) => {
          const x = (index - (cCols - 1) / 2) * compSpacing;
          const z = GRID_SPACING * 0.85;
          item.root.position.set(x, 0, z);
        });
      } else {
        const count = loadedItems.length;
        if (count === 1) {
          loadedItems[0].root.position.set(0, 0, 0);
        } else {
          const cols = Math.ceil(Math.sqrt(count));
          loadedItems.forEach((item, index) => {
            const col = index % cols;
            const row = Math.floor(index / cols);
            item.root.position.set(
              (col - (cols - 1) / 2) * GRID_SPACING,
              0,
              (row - (Math.ceil(count / cols) - 1) / 2) * GRID_SPACING
            );
          });
        }
      }

      updateCameraView();
      document.getElementById('model-count').innerText = `${loadedItems.length} model${loadedItems.length > 1 ? 's' : ''}`;
    }

    function setupEditableLabel(labelDiv, item) {
      ['pointerdown', 'mousedown', 'dblclick'].forEach(evt => {
        labelDiv.addEventListener(evt, e => e.stopPropagation());
      });

      labelDiv.addEventListener('click', (e) => {
        e.stopPropagation();

        if (e.target.closest('.focus-btn')) {
          focusModel(item);
          return;
        }

        if (e.shiftKey) {
          toggleSelection(item, true);
          return;
        }

        if (labelDiv.querySelector('input')) return;

        if (!e.target.closest('.label-title')) {
          toggleSelection(item, false);
          return;
        }

        // Rename logic with auto-expanding full-width input
        const oldFullName = item.name;
        const baseName = oldFullName.replace(/\\.glb$/i, '');

        labelDiv.innerHTML = '';
        const input = document.createElement('input');
        input.type = 'text';
        input.className = 'rename-input';
        input.value = baseName;

        // Auto-size input dynamically to fit FULL name without clipping
        const adjustWidth = () => {
          input.style.width = Math.min(Math.max((input.value.length + 3) * 8.5, 200), 540) + 'px';
        };
        adjustWidth();
        input.addEventListener('input', adjustWidth);

        labelDiv.appendChild(input);
        input.focus();
        input.select();

        let finished = false;

        async function applyRename() {
          if (finished) return;
          finished = true;

          let newBase = input.value.trim();
          if (!newBase) newBase = baseName;
          const newFullName = newBase.toLowerCase().endsWith('.glb') ? newBase : `${newBase}.glb`;

          item.name = newFullName;
          renderLabelDisplay(labelDiv, item);

          if (newFullName === oldFullName) return;

          try {
            const res = await fetch('/api/rename', {
              method: 'POST',
              headers: { 'Content-Type': 'application/json' },
              body: JSON.stringify({ id: Number(item.id), newName: newFullName })
            });

            const data = await res.json();
            if (data.success) {
              item.name = data.newName;
              renderLabelDisplay(labelDiv, item);
              showToast(`✓ Renamed: ${data.newName}`);
            } else {
              throw new Error(data.error || 'Disk rename failed');
            }
          } catch (err) {
            item.name = oldFullName;
            renderLabelDisplay(labelDiv, item);
            showToast(`✗ Failed to rename: ${err.message}`, true);
          }
        }

        input.addEventListener('blur', applyRename);
        input.addEventListener('keydown', (e) => {
          if (e.key === 'Enter') {
            e.preventDefault();
            applyRename();
          } else if (e.key === 'Escape') {
            e.preventDefault();
            finished = true;
            renderLabelDisplay(labelDiv, item);
          }
        });
      });
    }

    function renderLabelDisplay(labelDiv, item) {
      const animBadge = (item.animations && item.animations.length > 0)
        ? `<span class="anim-badge">🎬 ${item.animations.length}</span>`
        : '';
      const sizeBadge = item.size_str
        ? `<span class="size-badge">${item.size_str}</span>`
        : '';
      const formatBadge = (item.orig_ext && item.orig_ext !== 'GLB')
        ? `<span class="format-badge">${item.orig_ext}</span>`
        : '';
      const compBadge = item.isCompressed
        ? `<span class="comp-badge">🗜️ CLEAN</span>`
        : '';

      labelDiv.innerHTML = `
        <span class="focus-btn" title="Focus closely">
          <svg width="13" height="13" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2.5"><circle cx="12" cy="12" r="10"/><circle cx="12" cy="12" r="3"/></svg>
        </span>
        <span class="label-title" title="Click to rename">${item.name}</span>
        ${formatBadge}
        ${sizeBadge}
        ${compBadge}
        ${animBadge}
      `;
    }

    async function loadModel(m) {
      return new Promise((resolve, reject) => {
        gltfLoader.load(
          `/model?id=${m.id}&_t=${Date.now()}`,
          (gltf) => {
            const root = new THREE.Group();
            const model = gltf.scene;

            model.traverse((node) => {
              if (node.isMesh) {
                node.castShadow = true;
                node.receiveShadow = true;
              }
            });

            const isComp = Boolean(m.is_compressed);
            const effectiveTargetSize = isComp ? (TARGET_SIZE * 0.72) : TARGET_SIZE;

            const rawBox = new THREE.Box3().setFromObject(model);
            const rawSize = rawBox.getSize(new THREE.Vector3());
            const maxAxis = Math.max(rawSize.x, rawSize.y, rawSize.z);
            const scale = maxAxis > 0 ? (effectiveTargetSize / maxAxis) : 1;
            model.scale.setScalar(scale);
            model.updateMatrixWorld(true);

            const scaledBox = new THREE.Box3().setFromObject(model);
            const scaledCenter = scaledBox.getCenter(new THREE.Vector3());
            model.position.x = -scaledCenter.x;
            model.position.y = -scaledBox.min.y;
            model.position.z = -scaledCenter.z;
            root.add(model);

            let mixer = null;
            const actions = {};
            const animations = gltf.animations || [];

            if (animations.length > 0) {
              mixer = new THREE.AnimationMixer(model);
              animations.forEach((clip, idx) => {
                if (!clip.name || clip.name.trim() === '') {
                  clip.name = `Animation_${idx + 1}`;
                }
                actions[clip.name] = mixer.clipAction(clip);
              });
            }

            const div = document.createElement('div');
            div.className = 'model-label' + (isComp ? ' compressed-label' : '');

            const item = {
              id: m.id,
              name: m.name,
              raw_name: m.raw_name,
              orig_ext: m.orig_ext,
              size_str: m.size_str,
              isCompressed: isComp,
              effectiveTargetSize,
              root,
              labelDiv: div,
              selectionBox: null,
              animations,
              mixer,
              actions
            };

            renderLabelDisplay(div, item);
            setupEditableLabel(div, item);

            // Positioning: BOTTOM CENTER below the model ground level
            const labelObj = new CSS2DObject(div);
            labelObj.position.set(0, -0.28, 0);
            root.add(labelObj);

            model.traverse((node) => {
              if (node.isMesh) node.userData.ownerItem = item;
            });

            modelGroup.add(root);
            loadedItems.push(item);
            resolve(item);
          },
          undefined,
          (err) => reject(err)
        );
      });
    }

    async function triggerCompression(mode) {
      if (loadedItems.length === 0) {
        showToast("No models loaded to compress!", true);
        return;
      }
      showToast("Select target destination folder in dialog window...", false);
      const loader = document.getElementById('loader');
      document.getElementById('loader-text').innerText = "Compressing models & loading clean copies...";
      loader.style.display = 'flex';

      try {
        const res = await fetch('/api/compress', {
          method: 'POST',
          headers: { 'Content-Type': 'application/json' },
          body: JSON.stringify({ mode })
        });
        const data = await res.json();
        showToast(data.message, !data.success);

        if (data.success && data.folder) {
          currentOutputFolder = data.folder;
          openFolderFloatBtn.style.display = 'inline-flex';
          openFolderFloatBtn.innerHTML = `
            <svg width="15" height="15" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><path d="M22 19a2 2 0 0 1-2 2H4a2 2 0 0 1-2-2V5a2 2 0 0 1 2-2h5l2 3h9a2 2 0 0 1 2 2z"/></svg>
            Open '${data.folder.split('/').pop()}' Folder
          `;

          await loadModelsFromBackend();
        }
      } catch (err) {
        showToast(`Compression failed: ${err.message}`, true);
      } finally {
        loader.style.display = 'none';
      }
    }

    openFolderFloatBtn.addEventListener('click', async () => {
      if (!currentOutputFolder) return;
      try {
        await fetch('/api/open_folder', {
          method: 'POST',
          headers: { 'Content-Type': 'application/json' },
          body: JSON.stringify({ folder: currentOutputFolder })
        });
      } catch (e) {
        showToast("Could not open folder: " + e.message, true);
      }
    });

    document.getElementById('compress-std-btn').addEventListener('click', () => triggerCompression('standard'));
    document.getElementById('compress-ultra-btn').addEventListener('click', () => triggerCompression('ultra'));

    const raycaster = new THREE.Raycaster();
    const mouse = new THREE.Vector2();
    let pointerDownCoord = { x: 0, y: 0 };

    renderer.domElement.addEventListener('pointerdown', (e) => {
      pointerDownCoord.x = e.clientX;
      pointerDownCoord.y = e.clientY;
    });

    renderer.domElement.addEventListener('pointerup', (e) => {
      const dragDist = Math.hypot(e.clientX - pointerDownCoord.x, e.clientY - pointerDownCoord.y);
      if (dragDist > 5) return;

      mouse.x = (e.clientX / window.innerWidth) * 2 - 1;
      mouse.y = -(e.clientY / window.innerHeight) * 2 + 1;

      raycaster.setFromCamera(mouse, camera);
      const intersects = raycaster.intersectObjects(modelGroup.children, true);

      if (intersects.length > 0) {
        let curr = intersects[0].object;
        while (curr && !curr.userData.ownerItem && curr.parent) {
          curr = curr.parent;
        }
        if (curr && curr.userData.ownerItem) {
          toggleSelection(curr.userData.ownerItem, e.shiftKey);
        }
      } else {
        if (!e.shiftKey) {
          clearSelection();
          if (isIsolated) resetIsolationAndOverview();
        }
      }
    });

    renderer.domElement.addEventListener('dblclick', (e) => {
      mouse.x = (e.clientX / window.innerWidth) * 2 - 1;
      mouse.y = -(e.clientY / window.innerHeight) * 2 + 1;

      raycaster.setFromCamera(mouse, camera);
      const intersects = raycaster.intersectObjects(modelGroup.children, true);

      if (intersects.length > 0) {
        let curr = intersects[0].object;
        while (curr && !curr.userData.ownerItem && curr.parent) {
          curr = curr.parent;
        }
        if (curr && curr.userData.ownerItem) {
          focusModel(curr.userData.ownerItem);
        }
      }
    });

    window.addEventListener('keydown', async (e) => {
      if (['INPUT', 'TEXTAREA'].includes(document.activeElement.tagName)) return;

      if (e.key === 'Delete' || e.key === 'Backspace') {
        if (selectedItems.size === 0) return;

        e.preventDefault();
        const toDelete = Array.from(selectedItems);
        const deleteIds = toDelete.map(i => i.id);

        if (isIsolated) resetIsolationAndOverview();

        toDelete.forEach(item => removeLoadedItem(item));
        selectedItems.clear();
        updateSelectionUI();

        try {
          const res = await fetch('/api/remove_models', {
            method: 'POST',
            headers: { 'Content-Type': 'application/json' },
            body: JSON.stringify({ ids: deleteIds })
          });
          const data = await res.json();
          if (data.label) {
            document.getElementById('path-display').innerText = data.label;
          }
        } catch (err) {
          console.error(err);
        }

        if (loadedItems.length === 0) {
          purgeScene();
          document.getElementById('drop-overlay').classList.remove('hidden');
        } else {
          rearrangeModels();
        }

        showToast(`🗑️ Removed ${toDelete.length} model(s) from canvas`);
      }
    });

    async function loadModelsFromBackend() {
      const loader = document.getElementById('loader');
      loader.style.display = 'flex';

      const res = await fetch(`/api/models?_t=${Date.now()}`, { cache: 'no-store' });
      const data = await res.json();
      const models = data.models || [];
      const overlay = document.getElementById('drop-overlay');

      const pathDisplay = document.getElementById('path-display');
      pathDisplay.innerText = data.label || 'No models loaded';
      pathDisplay.title = data.label || 'No models loaded';

      if (models.length === 0) {
        purgeScene();
        overlay.classList.remove('hidden');
        document.getElementById('model-count').innerText = '0 models';
        loader.style.display = 'none';
        return;
      }

      overlay.classList.add('hidden');

      const serverIds = new Set(models.map(m => m.id));
      for (let i = loadedItems.length - 1; i >= 0; i--) {
        const item = loadedItems[i];
        if (!serverIds.has(item.id)) {
          removeLoadedItem(item);
        }
      }

      const currentLoadedIds = new Set(loadedItems.map(i => i.id));
      const toLoad = models.filter(m => !currentLoadedIds.has(m.id));

      for (let i = 0; i < toLoad.length; i++) {
        document.getElementById('loader-text').innerText = `Loading (${i + 1}/${toLoad.length}): ${toLoad[i].name}`;
        try {
          await loadModel(toLoad[i]);
        } catch (e) {
          console.error(e);
        }
      }

      rearrangeModels();
      loader.style.display = 'none';

      if (models.length === 1 && loadedItems[0] && loadedItems[0].animations.length > 0) {
        showAnimationPanel(loadedItems[0]);
      }
    }

    window.addEventListener('dragover', (e) => {
      e.preventDefault();
      document.getElementById('drop-overlay').classList.remove('hidden');
      document.getElementById('drop-overlay').classList.add('drag-hover');
    });

    window.addEventListener('dragleave', (e) => {
      if (e.clientX <= 0 || e.clientY <= 0) {
        document.getElementById('drop-overlay').classList.remove('drag-hover');
        if (loadedItems.length > 0) document.getElementById('drop-overlay').classList.add('hidden');
      }
    });

    window.addEventListener('drop', async (e) => {
      e.preventDefault();
      document.getElementById('drop-overlay').classList.remove('drag-hover');

      let paths = [];
      const rawUris = e.dataTransfer.getData('text/uri-list') || e.dataTransfer.getData('text/plain');
      if (rawUris) {
        const lines = rawUris.split(/\\r?\\n/).filter(l => l.trim().length > 0 && !l.startsWith('#'));
        for (const line of lines) {
          if (line.startsWith('file://')) {
            try {
              paths.push(decodeURIComponent(new URL(line).pathname));
            } catch {
              paths.push(decodeURIComponent(line.replace(/^file:\\/\\//, '')));
            }
          } else if (line.startsWith('/')) {
            paths.push(line.trim());
          }
        }
      }

      if (paths.length > 0) {
        await fetch('/api/load_paths', {
          method: 'POST',
          headers: { 'Content-Type': 'application/json' },
          body: JSON.stringify({ paths, clear_existing: false })
        });
        loadModelsFromBackend();
        return;
      }

      const validExts = ['.glb', '.gltf', '.fbx', '.obj'];
      const files = Array.from(e.dataTransfer.files).filter(f =>
        validExts.some(ext => f.name.toLowerCase().endsWith(ext))
      );

      if (files.length === 0) {
        showToast("No supported 3D files detected (.glb, .gltf, .fbx, .obj)", true);
        return;
      }

      for (const file of files) {
        await fetch('/api/upload', {
          method: 'POST',
          headers: { 'X-Filename': file.name },
          body: file
        });
      }
      loadModelsFromBackend();
    });

    document.getElementById('open-files-btn').addEventListener('click', async () => {
      await fetch('/api/select_files', { method: 'POST' });
      loadModelsFromBackend();
    });

    document.getElementById('open-folder-btn').addEventListener('click', async () => {
      await fetch('/api/select_folder', { method: 'POST' });
      loadModelsFromBackend();
    });

    document.getElementById('clear-btn').addEventListener('click', async () => {
      await fetch('/api/clear', { method: 'POST' });
      purgeScene();
      document.getElementById('path-display').innerText = 'No models loaded';
      document.getElementById('drop-overlay').classList.remove('hidden');
      openFolderFloatBtn.style.display = 'none';
      showToast("Cleared canvas and models");
    });

    document.getElementById('quit-btn').addEventListener('click', async () => {
      showToast("Shutting down server...");
      await fetch('/api/quit', { method: 'POST' });
      setTimeout(() => window.close(), 500);
    });

    document.getElementById('reset-cam-btn').addEventListener('click', resetIsolationAndOverview);

    window.addEventListener('resize', () => {
      camera.aspect = window.innerWidth / window.innerHeight;
      camera.updateProjectionMatrix();
      renderer.setSize(window.innerWidth, window.innerHeight);
      labelRenderer.setSize(window.innerWidth, window.innerHeight);
    });

    function animate() {
      requestAnimationFrame(animate);

      const delta = clock.getDelta();
      loadedItems.forEach(item => {
        if (item.mixer && item.root.visible) item.mixer.update(delta);
        if (item.selectionBox && item.selectionBox.visible) item.selectionBox.update();
      });

      if (cameraAnim) {
        const elapsed = performance.now() - cameraAnim.startTime;
        const progress = Math.min(elapsed / cameraAnim.duration, 1);
        const ease = 1 - Math.pow(1 - progress, 3);

        camera.position.lerpVectors(cameraAnim.startPos, cameraAnim.endPos, ease);
        controls.target.lerpVectors(cameraAnim.startTarget, cameraAnim.endTarget, ease);

        if (progress >= 1) cameraAnim = null;
      }

      controls.update();
      renderer.render(scene, camera);
      labelRenderer.render(scene, camera);
    }

    animate();
    loadModelsFromBackend();
  </script>
</body>
</html>
"""


def main():
    global SERVER_INSTANCE

    if check_port_open():
        raw_args = [arg for arg in sys.argv[1:]]
        paths = [os.path.abspath(f) for f in raw_args if os.path.exists(f)]
        if paths:
            try:
                req = urllib.request.Request(
                    f"{URL}/api/load_paths",
                    data=json.dumps({"paths": paths, "clear_existing": False}).encode("utf-8"),
                    headers={"Content-Type": "application/json"}
                )
                urllib.request.urlopen(req, timeout=1)
            except Exception:
                pass
        subprocess.Popen(["xdg-open", URL], stdout=subprocess.DEVNULL, stderr=subprocess.DEVNULL)
        sys.exit(0)

    targets = [arg for arg in sys.argv[1:] if os.path.exists(arg)]
    if targets:
        add_paths(targets, clear_existing=False)

    http.server.ThreadingHTTPServer.allow_reuse_address = True
    SERVER_INSTANCE = http.server.ThreadingHTTPServer(("127.0.0.1", PORT), GLBHandler)

    threading.Thread(target=lambda: (time.sleep(0.1), subprocess.Popen(["xdg-open", URL]))).start()

    try:
        SERVER_INSTANCE.serve_forever()
    except KeyboardInterrupt:
        SERVER_INSTANCE.server_close()


if __name__ == "__main__":
    main()
EOF

chmod +x ~/.local/share/glb-viewer/glb_viewer.py

Step 2: Start the viewer

code Bash

python3 ~/.local/share/glb-viewer/glb_viewer.py

(Press Ctrl + Shift + R in your browser to reload all new styles).

Here is the complete launcher script.

It adds proper MIME type associations (so you can right-click any .glb, .gltf, .fbx, or .obj file and choose “Open With → 3D Multi-Viewer”), sets up the desktop icon, and trust-enables it for GNOME/KDE/XFCE desktop environments.

Run this block in your Debian terminal:

code Bash

mkdir -p ~/.local/share/applications

cat << EOF > ~/.local/share/applications/glb-viewer.desktop
[Desktop Entry]
Version=1.0
Type=Application
Name=3D Multi-Viewer Studio
GenericName=VisionOS 3D Viewer & Optimizer
Comment=View, focus, convert FBX/OBJ, and compress 3D GLB models
Exec=/usr/bin/python3 /home/$USER/.local/share/glb-viewer/glb_viewer.py %F
Icon=applications-graphics
Terminal=false
Categories=Graphics;3DGraphics;Viewer;
MimeType=model/gltf-binary;model/gltf+json;application/octet-stream;
StartupNotify=true
Actions=NewWindow;

[Desktop Action NewWindow]
Name=Open Clean Canvas
Exec=/usr/bin/python3 /home/$USER/.local/share/glb-viewer/glb_viewer.py
EOF

chmod +x ~/.local/share/applications/glb-viewer.desktop

# Place on desktop if ~/Desktop exists
if [ -d "$HOME/Desktop" ]; then
    cp ~/.local/share/applications/glb-viewer.desktop "$HOME/Desktop/"
    chmod +x "$HOME/Desktop/glb-viewer.desktop"
    gio set "$HOME/Desktop/glb-viewer.desktop" metadata::trusted true 2>/dev/null || true
fi

# Refresh desktop app databases
update-desktop-database ~/.local/share/applications/ 2>/dev/null || true