Add balloon, glider, and UAV sprites with admin sprite management

New dedicated pixel art sprites for ADS-B emitter categories B2
(lighter-than-air → balloon), B1 (glider/sailplane → glider), and
B6 (UAV → uav), replacing the previous fallback to smallProp. Adds
an admin Sprites tab for previewing and uploading replacement PNGs
for all 9 aircraft sprite types.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

CLAUDE.md

@@ -52,7 +52,7 @@ Access at http://localhost:{web_port} (configured in config.json)
 ### Sprite Assets
 
 All PNG sprites face right (eastward) and are flipped in-canvas for westbound aircraft:
-- 6 aircraft types: smallProp, regionalJet, narrowBody, wideBody, heavy, helicopter
+- 9 aircraft types: smallProp, regionalJet, narrowBody, wideBody, heavy, helicopter, balloon, glider, uav
 - Directional backgrounds: north.png, south.png, east.png, west.png (1536x1024, shown based on view direction)
 - Celestial: sun.png, moon_6_phases.png (2x3 sprite sheet)
 - Weather: happycloud.png (clear), raincloud.png (rain/snow)
@@ -75,10 +75,10 @@ Mapping from DO-260B emitter categories to sprite types:
 | A5 | Heavy (> 300,000 lbs) | wideBody or heavy (by altitude/speed) |
 | A6 | High performance (> 5g, > 400 kts) | narrowBody |
 | A7 | Rotorcraft | helicopter |
-| B1 | Glider / sailplane | smallProp |
+| B1 | Glider / sailplane | glider |
-| B2 | Lighter-than-air | smallProp |
+| B2 | Lighter-than-air | balloon |
 | B4 | Skydiver drop plane | smallProp |
-| B6 | UAV | smallProp |
+| B6 | UAV | uav |
 
 Once an emitter category is received for an aircraft, it is locked in and heuristic re-evaluation is skipped.
 

admin/admin.css

@@ -348,6 +348,101 @@ textarea {
     color: #fff;
 }
 
+/* Sprite Management */
+.sprite-info {
+    background: rgba(0, 0, 0, 0.3);
+    border: 2px solid #5c94fc;
+    border-radius: 8px;
+    padding: 14px 18px;
+    margin-bottom: 20px;
+}
+
+.sprite-info h3 {
+    font-family: 'Press Start 2P', monospace;
+    font-size: 10px;
+    color: #fcd444;
+    margin-bottom: 10px;
+}
+
+.sprite-info p {
+    font-size: 12px;
+    color: #b4d4ec;
+    margin-bottom: 4px;
+    line-height: 1.6;
+}
+
+.sprite-grid {
+    display: grid;
+    grid-template-columns: repeat(3, 1fr);
+    gap: 14px;
+}
+
+.sprite-card {
+    background: rgba(0, 0, 0, 0.4);
+    border: 2px solid #5c94fc;
+    border-radius: 8px;
+    padding: 14px;
+    text-align: center;
+}
+
+.sprite-card h4 {
+    font-family: 'Press Start 2P', monospace;
+    font-size: 10px;
+    color: #fcfcfc;
+    margin-bottom: 4px;
+}
+
+.sprite-card .sprite-categories {
+    font-size: 10px;
+    color: #888;
+    margin-bottom: 10px;
+}
+
+.sprite-preview {
+    background: rgba(0, 0, 0, 0.3);
+    border: 1px solid #444;
+    border-radius: 4px;
+    padding: 6px;
+    margin-bottom: 10px;
+    display: flex;
+    align-items: center;
+    justify-content: center;
+    min-height: 80px;
+}
+
+.sprite-preview img {
+    max-width: 100%;
+    height: auto;
+    max-height: 80px;
+    image-rendering: pixelated;
+}
+
+.sprite-preview .no-sprite {
+    color: #666;
+    font-size: 11px;
+}
+
+.sprite-upload-label {
+    display: inline-block;
+    font-family: 'Press Start 2P', monospace;
+    font-size: 8px;
+    padding: 6px 12px;
+    border: 2px solid #5c94fc;
+    border-radius: 6px;
+    background: rgba(92, 148, 252, 0.2);
+    color: #fcfcfc;
+    cursor: pointer;
+    transition: all 0.15s;
+}
+
+.sprite-upload-label:hover {
+    background: rgba(92, 148, 252, 0.4);
+}
+
+.sprite-upload-input {
+    display: none;
+}
+
 /* Mobile */
 @media (max-width: 768px) {
     .admin-header {
@@ -389,4 +484,8 @@ textarea {
     .button-row .btn {
         width: 100%;
     }
+
+    .sprite-grid {
+        grid-template-columns: repeat(2, 1fr);
+    }
 }

admin/admin.html

@@ -40,6 +40,7 @@
             <button class="tab" data-tab="location">LOCATION</button>
             <button class="tab" data-tab="display">DISPLAY</button>
             <button class="tab" data-tab="tuning">TUNING</button>
+            <button class="tab" data-tab="sprites">SPRITES</button>
             <button class="tab" data-tab="security">SECURITY</button>
         </nav>
 
@@ -201,6 +202,20 @@
                 </div>
             </section>
 
+            <!-- Sprites Tab -->
+            <section id="tab-sprites" class="tab-pane hidden">
+                <h2>Aircraft Sprites</h2>
+                <div class="sprite-info">
+                    <h3>Sprite Specifications</h3>
+                    <p><strong>Size:</strong> 500 x 333 px &nbsp; <strong>Format:</strong> PNG 8-bit RGBA (transparent background)</p>
+                    <p><strong>Orientation:</strong> Facing right (auto-flipped for westbound aircraft)</p>
+                    <p><strong>Style:</strong> Retro SNES pixel art, white/blue/red color scheme</p>
+                </div>
+                <div id="sprite-grid" class="sprite-grid">
+                    <!-- Populated by JS -->
+                </div>
+            </section>
+
             <!-- Security Tab -->
             <section id="tab-security" class="tab-pane hidden">
                 <h2>Change Admin Password</h2>

admin/admin.js

@@ -67,6 +67,11 @@
             document.querySelectorAll('.tab-pane').forEach(p => p.classList.add('hidden'));
             tab.classList.add('active');
             document.getElementById('tab-' + tab.dataset.tab).classList.remove('hidden');
+            // Lazy-load sprites on first visit
+            if (tab.dataset.tab === 'sprites' && !spritesLoaded) {
+                spritesLoaded = true;
+                loadSprites();
+            }
         });
     });
 
@@ -307,6 +312,76 @@
         }
     });
 
+    // ------- Sprites -------
+    let spritesLoaded = false;
+
+    async function loadSprites() {
+        try {
+            const res = await fetch('/api/admin/sprites');
+            if (!res.ok) return;
+            const data = await res.json();
+            const grid = document.getElementById('sprite-grid');
+            if (!grid) return;
+
+            grid.innerHTML = '';
+            (data.sprites || []).forEach(sprite => {
+                const card = document.createElement('div');
+                card.className = 'sprite-card';
+
+                const cacheBust = Date.now();
+                const imgHtml = sprite.exists
+                    ? `<img src="${sprite.url}?v=${cacheBust}" alt="${sprite.type}">`
+                    : `<span class="no-sprite">No sprite</span>`;
+
+                card.innerHTML = `
+                    <h4>${sprite.type}</h4>
+                    <div class="sprite-categories">${sprite.categories || ''}</div>
+                    <div class="sprite-preview">${imgHtml}</div>
+                    <label class="sprite-upload-label">
+                        UPLOAD
+                        <input type="file" class="sprite-upload-input" accept=".png,image/png" data-type="${sprite.type}">
+                    </label>
+                `;
+
+                const fileInput = card.querySelector('.sprite-upload-input');
+                fileInput.addEventListener('change', async (e) => {
+                    const file = e.target.files[0];
+                    if (!file) return;
+
+                    if (!file.type.includes('png')) {
+                        toast('Only PNG files are allowed', true);
+                        e.target.value = '';
+                        return;
+                    }
+
+                    const formData = new FormData();
+                    formData.append('file', file);
+
+                    try {
+                        const uploadRes = await fetch(`/api/admin/sprites/${sprite.type}`, {
+                            method: 'POST',
+                            body: formData
+                        });
+                        if (uploadRes.ok) {
+                            toast(`${sprite.type} sprite updated`);
+                            loadSprites(); // Refresh previews
+                        } else {
+                            const err = await uploadRes.json();
+                            toast(err.error || 'Upload failed', true);
+                        }
+                    } catch (err) {
+                        toast('Upload error', true);
+                    }
+                    e.target.value = '';
+                });
+
+                grid.appendChild(card);
+            });
+        } catch (e) {
+            console.error('Failed to load sprites', e);
+        }
+    }
+
     // ------- Helpers -------
     async function saveConfig(body) {
         try {

ads-bit.js

@@ -99,7 +99,10 @@ class ADSBit {
             narrowBody: new Image(),
             wideBody: new Image(),
             heavy: new Image(),
-            helicopter: new Image()
+            helicopter: new Image(),
+            balloon: new Image(),
+            glider: new Image(),
+            uav: new Image()
         };
 
         // Track which images have loaded
@@ -109,7 +112,10 @@ class ADSBit {
             narrowBody: false,
             wideBody: false,
             heavy: false,
-            helicopter: false
+            helicopter: false,
+            balloon: false,
+            glider: false,
+            uav: false
         };
 
         // Load all aircraft images
@@ -785,10 +791,10 @@ class ADSBit {
                 break;
             case 'A6': type = 'narrowBody'; break;     // High performance (> 5g, > 400 kts)
             case 'A7': type = 'helicopter'; break;     // Rotorcraft
-            case 'B1': type = 'smallProp'; break;      // Glider / sailplane
+            case 'B1': type = 'glider'; break;         // Glider / sailplane
-            case 'B2': type = 'smallProp'; break;      // Lighter-than-air
+            case 'B2': type = 'balloon'; break;        // Lighter-than-air
             case 'B4': type = 'smallProp'; break;      // Skydiver drop plane
-            case 'B6': type = 'smallProp'; break;      // UAV
+            case 'B6': type = 'uav'; break;            // UAV
             default:   type = 'narrowBody'; break;     // Unknown or surface vehicles
         }
 

server.py

@@ -752,6 +752,77 @@ async def handle_admin_scan_receivers(request):
     return web.json_response({"receivers": found})
 
 
+# All valid sprite type names
+SPRITE_TYPES = [
+    "smallProp", "regionalJet", "narrowBody", "wideBody",
+    "heavy", "helicopter", "balloon", "glider", "uav"
+]
+
+# Which ADS-B emitter categories map to each sprite
+SPRITE_CATEGORY_MAP = {
+    "smallProp": "A1, B4",
+    "regionalJet": "A2",
+    "narrowBody": "A3, A4, A6",
+    "wideBody": "A5 (lower alt/speed)",
+    "heavy": "A5 (high alt/speed)",
+    "helicopter": "A7",
+    "balloon": "B2",
+    "glider": "B1",
+    "uav": "B6",
+}
+
+
+@require_auth
+async def handle_admin_sprites(request):
+    """GET /api/admin/sprites - List all sprite types with exists/url info."""
+    sprites = []
+    for stype in SPRITE_TYPES:
+        filepath = WEB_DIR / "images" / f"{stype}.png"
+        sprites.append({
+            "type": stype,
+            "exists": filepath.exists(),
+            "url": f"/images/{stype}.png",
+            "categories": SPRITE_CATEGORY_MAP.get(stype, ""),
+        })
+    return web.json_response({"sprites": sprites})
+
+
+@require_auth
+async def handle_admin_sprite_upload(request):
+    """POST /api/admin/sprites/{type} - Upload/replace a sprite PNG."""
+    stype = request.match_info.get("type", "")
+    if stype not in SPRITE_TYPES:
+        return web.json_response(
+            {"error": f"Invalid sprite type: {stype}"}, status=400
+        )
+
+    reader = await request.multipart()
+    field = await reader.next()
+    if field is None or field.name != "file":
+        return web.json_response({"error": "No file field in upload"}, status=400)
+
+    # Read the uploaded file (limit to 5 MB)
+    data = bytearray()
+    while True:
+        chunk = await field.read_chunk(8192)
+        if not chunk:
+            break
+        data.extend(chunk)
+        if len(data) > 5 * 1024 * 1024:
+            return web.json_response({"error": "File too large (max 5 MB)"}, status=400)
+
+    # Validate PNG header
+    if data[:8] != b'\x89PNG\r\n\x1a\n':
+        return web.json_response({"error": "File is not a valid PNG"}, status=400)
+
+    # Save to images directory
+    filepath = WEB_DIR / "images" / f"{stype}.png"
+    with open(filepath, "wb") as f:
+        f.write(data)
+
+    return web.json_response({"ok": True, "type": stype})
+
+
 async def restart_receiver_connections():
     """Cancel existing receiver tasks and start new ones."""
     global receivers, receiver_tasks
@@ -863,6 +934,8 @@ async def start_http_server():
     app.router.add_post('/api/admin/password', handle_admin_password)
     app.router.add_post('/api/admin/scan-receivers', handle_admin_scan_receivers)
     app.router.add_post('/api/admin/restart-receivers', handle_admin_restart_receivers)
+    app.router.add_get('/api/admin/sprites', handle_admin_sprites)
+    app.router.add_post('/api/admin/sprites/{type}', handle_admin_sprite_upload)
 
     # Static files (must be last - catch-all)
     app.router.add_get('/{tail:.*}', handle_http)