
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.pyStep 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