fix(starlark): critical bug fixes and code quality improvements

Critical fixes:
- Fix stack overflow in safeLocalStorage (was recursively calling itself)
- Fix duplicate event listeners on Starlark grid (added sentinel check)
- Fix JSON validation to fail fast on malformed data instead of silently passing

Error handling improvements:
- Narrow exception catches to specific types (OSError, json.JSONDecodeError, ValueError)
- Use logger.exception() with exc_info=True for better stack traces
- Replace generic "except Exception" with specific exception types

Logging improvements:
- Add "[Starlark Pixlet]" context tags to pixlet_renderer logs
- Redact sensitive config values from debug logs (API keys, etc.)
- Add file_path context to schema parsing warnings

Documentation:
- Fix markdown lint issues (add language tags to code blocks)
- Fix time unit spacing: "(5min)" -> "(5 min)"

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>

.gitignore

@@ -44,3 +44,6 @@ plugins/*
 # Binary files and backups
 bin/pixlet/
 config/backups/
+
+# Starlark apps runtime storage (installed .star files and cached renders)
+/starlark-apps/

docs/STARLARK_APPS_GUIDE.md

@@ -0,0 +1,500 @@
+# Starlark Apps Guide
+
+## Overview
+
+The Starlark Apps plugin for LEDMatrix enables you to run **Tidbyt/Tronbyte community apps** on your LED matrix display without modification. This integration allows you to access hundreds of pre-built widgets and apps from the vibrant Tidbyt community ecosystem.
+
+## Important: Third-Party Content
+
+**⚠️ Apps are NOT managed by the LEDMatrix project**
+
+- Starlark apps are developed and maintained by the **Tidbyt/Tronbyte community**
+- LEDMatrix provides the runtime environment but does **not** create, maintain, or support these apps
+- All apps originate from the [Tronbyte Apps Repository](https://github.com/tronbyt/apps)
+- App quality, functionality, and security are the responsibility of individual app authors
+- LEDMatrix is not affiliated with Tidbyt Inc. or the Tronbyte project
+
+## What is Starlark?
+
+[Starlark](https://github.com/bazelbuild/starlark) is a Python-like language originally developed by Google for the Bazel build system. Tidbyt adopted Starlark for building LED display apps because it's:
+
+- **Sandboxed**: Apps run in a safe, restricted environment
+- **Simple**: Python-like syntax that's easy to learn
+- **Deterministic**: Apps produce consistent output
+- **Fast**: Compiled and optimized for performance
+
+## How It Works
+
+### Architecture
+
+```text
+┌─────────────────────────────────────────────────────────┐
+│                    LEDMatrix System                      │
+│  ┌────────────────────────────────────────────────────┐ │
+│  │         Starlark Apps Plugin (manager.py)          │ │
+│  │  • Manages app lifecycle (install/uninstall)       │ │
+│  │  • Handles app configuration                       │ │
+│  │  • Schedules app rendering                         │ │
+│  └─────────────────┬──────────────────────────────────┘ │
+│                    │                                     │
+│  ┌─────────────────▼──────────────────────────────────┐ │
+│  │      Pixlet Renderer (pixlet_renderer.py)          │ │
+│  │  • Executes .star files using Pixlet CLI           │ │
+│  │  • Extracts configuration schemas                  │ │
+│  │  • Outputs WebP animations                         │ │
+│  └─────────────────┬──────────────────────────────────┘ │
+│                    │                                     │
+│  ┌─────────────────▼──────────────────────────────────┐ │
+│  │      Frame Extractor (frame_extractor.py)          │ │
+│  │  • Decodes WebP animations into frames             │ │
+│  │  • Scales/centers output for display size          │ │
+│  │  • Manages frame timing                            │ │
+│  └─────────────────┬──────────────────────────────────┘ │
+│                    │                                     │
+│  ┌─────────────────▼──────────────────────────────────┐ │
+│  │            LED Matrix Display                       │ │
+│  │  • Renders final output to physical display        │ │
+│  └────────────────────────────────────────────────────┘ │
+└─────────────────────────────────────────────────────────┘
+
+                    ▲
+                    │
+         Downloads apps from
+                    │
+┌───────────────────┴─────────────────────────────────────┐
+│         Tronbyte Apps Repository (GitHub)                │
+│  • 974+ community-built apps                             │
+│  • Weather, sports, stocks, games, clocks, etc.          │
+│  • https://github.com/tronbyt/apps                       │
+└──────────────────────────────────────────────────────────┘
+```
+
+### Rendering Pipeline
+
+1. **User installs app** from the Tronbyte repository via web UI
+2. **Plugin downloads** the `.star` file (and any assets like images/fonts)
+3. **Schema extraction** parses configuration options from the `.star` source
+4. **User configures** the app through the web UI (timezone, location, API keys, etc.)
+5. **Pixlet renders** the app with user config → produces WebP animation
+6. **Frame extraction** decodes WebP → individual PIL Image frames
+7. **Display scaling** adapts 64x32 Tidbyt output to your matrix size
+8. **Rotation** cycles through your installed apps based on schedule
+
+## Getting Started
+
+### 1. Install Pixlet
+
+Pixlet is the rendering engine that executes Starlark apps. The plugin will attempt to use:
+
+1. **Bundled binary** (recommended): Downloaded to `bin/pixlet/pixlet-{platform}-{arch}`
+2. **System installation**: If `pixlet` is available in your PATH
+
+#### Auto-Install via Web UI
+
+Navigate to: **Plugins → Starlark Apps → Status → Install Pixlet**
+
+This runs the bundled installation script which downloads the appropriate binary for your platform.
+
+#### Manual Installation
+
+```bash
+cd /path/to/LEDMatrix
+bash scripts/download_pixlet.sh
+```
+
+Verify installation:
+```bash
+./bin/pixlet/pixlet-linux-amd64 version
+# Pixlet 0.50.2 (or later)
+```
+
+### 2. Enable the Starlark Apps Plugin
+
+1. Open the web UI
+2. Navigate to **Plugins**
+3. Find **Starlark Apps** in the installed plugins list
+4. Enable the plugin
+5. Configure settings:
+   - **Magnify**: Auto-calculated based on your display size (or set manually)
+   - **Render Interval**: How often apps re-render (default: 300s)
+   - **Display Duration**: How long each app shows (default: 15s)
+   - **Cache Output**: Enable to reduce re-rendering (recommended)
+
+### 3. Browse and Install Apps
+
+1. Navigate to **Plugins → Starlark Apps → App Store**
+2. Browse available apps (974+ options)
+3. Filter by category: Weather, Sports, Finance, Games, Clocks, etc.
+4. Click **Install** on desired apps
+5. Configure each app:
+   - Set location/timezone
+   - Enter API keys if required
+   - Customize display preferences
+
+### 4. Configure Apps
+
+Each app may have different configuration options:
+
+#### Common Configuration Types
+
+- **Location** (lat/lng/timezone): For weather, clocks, transit
+- **API Keys**: For services like weather, stocks, sports scores
+- **Display Preferences**: Colors, units, layouts
+- **Dropdown Options**: Team selections, language, themes
+- **Toggles**: Enable/disable features
+
+Configuration is stored in `starlark-apps/{app-id}/config.json` and persists across app updates.
+
+## App Sources and Categories
+
+All apps are sourced from the [Tronbyte Apps Repository](https://github.com/tronbyt/apps). Popular categories include:
+
+### 🌤️ Weather
+- Analog Clock (with weather)
+- Current Weather
+- Weather Forecast
+- Air Quality Index
+
+### 🏈 Sports
+- NFL Scores
+- NBA Scores
+- MLB Scores
+- NHL Scores
+- Soccer/Football Scores
+- Formula 1 Results
+
+### 💰 Finance
+- Stock Tickers
+- Cryptocurrency Prices
+- Market Indices
+
+### 🎮 Games & Fun
+- Conway's Game of Life
+- Pong
+- Nyan Cat
+- Retro Animations
+
+### 🕐 Clocks
+- Analog Clock
+- Fuzzy Clock
+- Binary Clock
+- Word Clock
+
+### 📰 Information
+- News Headlines
+- RSS Feeds
+- GitHub Activity
+- Reddit Feed
+
+### 🚌 Transit & Travel
+- Transit Arrivals
+- Flight Tracker
+- Train Schedules
+
+## Display Size Compatibility
+
+Tronbyte/Tidbyt apps are designed for **64×32 displays**. LEDMatrix automatically adapts content for different display sizes:
+
+### Magnification
+
+The plugin calculates optimal magnification based on your display:
+
+```text
+magnify = floor(min(display_width / 64, display_height / 32))
+```
+
+Examples:
+- **64×32**: magnify = 1 (native, pixel-perfect)
+- **128×64**: magnify = 2 (2x scaling, crisp)
+- **192×64**: magnify = 2 (2x + horizontal centering)
+- **256×64**: magnify = 2 (2x + centering)
+
+### Scaling Modes
+
+**Config → Starlark Apps → Scale Method:**
+- `nearest` (default): Sharp pixels, retro look
+- `bilinear`: Smooth scaling, slight blur
+- `bicubic`: Higher quality smooth scaling
+- `lanczos`: Best quality, most processing
+
+**Center vs Scale:**
+- `scale_output=true`: Stretch to fill display (may distort aspect ratio)
+- `center_small_output=true`: Center output without stretching (preserves aspect ratio)
+
+## Configuration Schema Extraction
+
+LEDMatrix automatically extracts configuration schemas from Starlark apps by parsing the `get_schema()` function in the `.star` source code.
+
+### Supported Field Types
+
+| Starlark Type | Web UI Rendering |
+|--------------|------------------|
+| `schema.Location` | Lat/Lng/Timezone picker |
+| `schema.Text` | Text input field |
+| `schema.Toggle` | Checkbox/switch |
+| `schema.Dropdown` | Select dropdown |
+| `schema.Color` | Color picker |
+| `schema.DateTime` | Date/time picker |
+| `schema.OAuth2` | Warning message (not supported) |
+| `schema.PhotoSelect` | Warning message (not supported) |
+| `schema.LocationBased` | Text fallback with note |
+| `schema.Typeahead` | Text fallback with note |
+
+### Schema Coverage
+
+- **90-95%** of apps: Full schema support
+- **5%**: Partial extraction (complex/dynamic schemas)
+- **<1%**: No schema (apps without configuration)
+
+Apps without extracted schemas can still run with default settings.
+
+## File Structure
+
+```text
+LEDMatrix/
+├── plugin-repos/starlark-apps/     # Plugin source code
+│   ├── manager.py                  # Main plugin logic
+│   ├── pixlet_renderer.py          # Pixlet CLI wrapper
+│   ├── frame_extractor.py          # WebP decoder
+│   ├── tronbyte_repository.py      # GitHub API client
+│   └── requirements.txt            # Python dependencies
+│
+├── starlark-apps/                  # Installed apps (user data)
+│   ├── manifest.json               # App registry
+│   │
+│   └── analogclock/                # Example app
+│       ├── analogclock.star        # Starlark source
+│       ├── config.json             # User configuration
+│       ├── schema.json             # Extracted schema
+│       ├── cached_render.webp      # Rendered output cache
+│       └── images/                 # App assets (if any)
+│           ├── hour_hand.png
+│           └── minute_hand.png
+│
+├── bin/pixlet/                     # Pixlet binaries
+│   ├── pixlet-linux-amd64
+│   ├── pixlet-linux-arm64
+│   └── pixlet-darwin-arm64
+│
+└── scripts/
+    └── download_pixlet.sh          # Pixlet installer
+```
+
+## API Keys and External Services
+
+Many apps require API keys for external services:
+
+### Common API Services
+
+- **Weather**: OpenWeatherMap, Weather.gov, Dark Sky
+- **Sports**: ESPN, The Sports DB, SportsData.io
+- **Finance**: Alpha Vantage, CoinGecko, Yahoo Finance
+- **Transit**: TransitLand, NextBus, local transit APIs
+- **News**: NewsAPI, Reddit, RSS feeds
+
+### Security Note
+
+- API keys are stored in `config.json` files on disk
+- The LEDMatrix web interface does NOT encrypt API keys
+- Ensure your Raspberry Pi is on a trusted network
+- Use read-only or limited-scope API keys when possible
+- **Never commit `starlark-apps/*/config.json` to version control**
+
+## Troubleshooting
+
+### Pixlet Not Found
+
+**Symptom**: "Pixlet binary not found" error
+
+**Solutions**:
+1. Run auto-installer: **Plugins → Starlark Apps → Install Pixlet**
+2. Manual install: `bash scripts/download_pixlet.sh`
+3. Check permissions: `chmod +x bin/pixlet/pixlet-*`
+4. Verify architecture: `uname -m` matches binary name
+
+### App Fails to Render
+
+**Symptom**: "Rendering failed" error in logs
+
+**Solutions**:
+1. Check logs: `journalctl -u ledmatrix | grep -i pixlet`
+2. Verify config: Ensure all required fields are filled
+3. Test manually: `./bin/pixlet/pixlet-linux-amd64 render starlark-apps/{app-id}/{app-id}.star`
+4. Missing assets: Some apps need images/fonts that may fail to download
+5. API issues: Check API keys and rate limits
+
+### Schema Not Extracted
+
+**Symptom**: App installs but shows no configuration options
+
+**Solutions**:
+1. App may not have a `get_schema()` function (normal for some apps)
+2. Schema extraction failed: Check logs for parse errors
+3. Manual config: Edit `starlark-apps/{app-id}/config.json` directly
+4. Report issue: File bug with app details at LEDMatrix GitHub
+
+### Apps Show Distorted/Wrong Size
+
+**Symptom**: Content appears stretched, squished, or cropped
+
+**Solutions**:
+1. Check magnify setting: **Plugins → Starlark Apps → Config**
+2. Try `center_small_output=true` to preserve aspect ratio
+3. Adjust `magnify` manually (1-8) for your display size
+4. Some apps assume 64×32 - may not scale perfectly to all sizes
+
+### App Shows Outdated Data
+
+**Symptom**: Weather, sports scores, etc. don't update
+
+**Solutions**:
+1. Check render interval: **App Config → Render Interval** (300s default)
+2. Force re-render: **Plugins → Starlark Apps → {App} → Render Now**
+3. Clear cache: Restart LEDMatrix service
+4. API rate limits: Some services throttle requests
+5. Check app logs for API errors
+
+## Performance Considerations
+
+### Render Intervals
+
+- Apps re-render on a schedule (default: 300s = 5 minutes)
+- Lower intervals = more CPU/API usage
+- Recommended minimums:
+  - Static content (clocks): 30-60s
+  - Weather: 300s (5min)
+  - Sports scores: 60-120s
+  - Stock tickers: 60s
+
+### Caching
+
+Enable caching to reduce CPU load:
+- `cache_rendered_output=true` (recommended)
+- `cache_ttl=300` (5 minutes)
+
+Cached WebP files are stored in `starlark-apps/{app-id}/cached_render.webp`
+
+### Display Rotation
+
+Balance number of enabled apps with display duration:
+- 5 apps × 15s = 75s full cycle
+- 20 apps × 15s = 300s (5 min) cycle
+
+Long cycles may cause apps to render before being displayed.
+
+## Limitations
+
+### Unsupported Features
+
+- **OAuth2 Authentication**: Apps requiring OAuth login won't work
+- **PhotoSelect**: Image upload from mobile device not supported
+- **Push Notifications**: Apps can't receive real-time events
+- **Background Jobs**: No persistent background tasks
+
+### API Rate Limits
+
+Many apps use free API tiers with rate limits:
+- Rendering too frequently may exceed limits
+- Use appropriate `render_interval` settings
+- Consider paid API tiers for heavy usage
+
+### Display Size Constraints
+
+Apps designed for 64×32 may not utilize larger displays fully:
+- Content may appear small on 128×64+ displays
+- Magnification helps but doesn't add detail
+- Some apps hard-code 64×32 dimensions
+
+## Advanced Usage
+
+### Manual App Installation
+
+Upload custom `.star` files:
+1. Navigate to **Starlark Apps → Upload**
+2. Select `.star` file from disk
+3. Configure app ID and metadata
+4. Set render/display timing
+
+### Custom App Development
+
+While LEDMatrix runs Tronbyte apps, you can also create your own:
+
+1. **Learn Starlark**: [Tidbyt Developer Docs](https://tidbyt.dev/)
+2. **Write `.star` file**: Use Pixlet APIs for rendering
+3. **Test locally**: `pixlet render myapp.star`
+4. **Upload**: Use LEDMatrix web UI to install
+5. **Share**: Contribute to [Tronbyte Apps](https://github.com/tronbyt/apps) repo
+
+### Configuration Reference
+
+**Plugin Config** (`config/config.json` → `plugins.starlark-apps`):
+
+```json
+{
+  "enabled": true,
+  "magnify": 0,                    // 0 = auto, 1-8 = manual
+  "render_timeout": 30,            // Max seconds for Pixlet render
+  "cache_rendered_output": true,   // Cache WebP files
+  "cache_ttl": 300,                // Cache duration (seconds)
+  "scale_output": true,            // Scale to display size
+  "scale_method": "nearest",       // nearest|bilinear|bicubic|lanczos
+  "center_small_output": false,    // Center instead of scale
+  "default_frame_delay": 50,       // Frame timing (ms)
+  "max_frames": null,              // Limit frames (null = unlimited)
+  "auto_refresh_apps": true        // Auto re-render on interval
+}
+```
+
+**App Config** (`starlark-apps/{app-id}/config.json`):
+
+```json
+{
+  "location": "{\"lat\":\"40.7128\",\"lng\":\"-74.0060\",\"timezone\":\"America/New_York\"}",
+  "units": "imperial",
+  "api_key": "your-api-key-here",
+  "render_interval": 300,          // App-specific override
+  "display_duration": 15           // App-specific override
+}
+```
+
+## Resources
+
+### Official Documentation
+
+- **Tidbyt Developer Docs**: https://tidbyt.dev/
+- **Starlark Language**: https://github.com/bazelbuild/starlark
+- **Pixlet Repository**: https://github.com/tidbyt/pixlet
+- **Tronbyte Apps**: https://github.com/tronbyt/apps
+
+### LEDMatrix Documentation
+
+- [Plugin Development Guide](PLUGIN_DEVELOPMENT_GUIDE.md)
+- [REST API Reference](REST_API_REFERENCE.md)
+- [Troubleshooting Guide](TROUBLESHOOTING.md)
+
+### Community
+
+- **Tidbyt Community**: https://discuss.tidbyt.com/
+- **Tronbyte Apps Issues**: https://github.com/tronbyt/apps/issues
+- **LEDMatrix Issues**: https://github.com/ChuckBuilds/LEDMatrix/issues
+
+## License and Legal
+
+- **LEDMatrix**: MIT License (see project root)
+- **Starlark Apps Plugin**: MIT License (part of LEDMatrix)
+- **Pixlet**: Apache 2.0 License (Tidbyt Inc.)
+- **Tronbyte Apps**: Various licenses (see individual app headers)
+- **Starlark Language**: Apache 2.0 License (Google/Bazel)
+
+**Disclaimer**: LEDMatrix is an independent project and is not affiliated with, endorsed by, or sponsored by Tidbyt Inc. The Starlark Apps plugin enables interoperability with Tidbyt's open-source ecosystem but does not imply any official relationship.
+
+## Support
+
+For issues with:
+- **LEDMatrix integration**: File issues at [LEDMatrix GitHub](https://github.com/ChuckBuilds/LEDMatrix/issues)
+- **Specific apps**: File issues at [Tronbyte Apps](https://github.com/tronbyt/apps/issues)
+- **Pixlet rendering**: File issues at [Pixlet Repository](https://github.com/tidbyt/pixlet/issues)
+
+---
+
+**Ready to get started?** Install the Starlark Apps plugin and explore 974+ community apps! 🎨

plugin-repos/starlark-apps/__init__.py

@@ -0,0 +1,7 @@
+"""
+Starlark Apps Plugin Package
+
+Seamlessly import and manage Starlark (.star) widgets from the Tronbyte/Tidbyt community.
+"""
+
+__version__ = "1.0.0"

plugin-repos/starlark-apps/config_schema.json

@@ -0,0 +1,100 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "type": "object",
+  "title": "Starlark Apps Plugin Configuration",
+  "description": "Configuration for managing Starlark (.star) apps",
+  "properties": {
+    "enabled": {
+      "type": "boolean",
+      "description": "Enable or disable the Starlark apps system",
+      "default": true
+    },
+    "pixlet_path": {
+      "type": "string",
+      "description": "Path to Pixlet binary (auto-detected if empty)",
+      "default": ""
+    },
+    "render_timeout": {
+      "type": "number",
+      "description": "Maximum time in seconds for rendering a .star app",
+      "default": 30,
+      "minimum": 5,
+      "maximum": 120
+    },
+    "cache_rendered_output": {
+      "type": "boolean",
+      "description": "Cache rendered WebP output to reduce CPU usage",
+      "default": true
+    },
+    "cache_ttl": {
+      "type": "number",
+      "description": "Cache time-to-live in seconds",
+      "default": 300,
+      "minimum": 60,
+      "maximum": 3600
+    },
+    "default_frame_delay": {
+      "type": "number",
+      "description": "Default delay between frames in milliseconds (if not specified by app)",
+      "default": 50,
+      "minimum": 16,
+      "maximum": 1000
+    },
+    "scale_output": {
+      "type": "boolean",
+      "description": "Scale app output to match display dimensions",
+      "default": true
+    },
+    "scale_method": {
+      "type": "string",
+      "enum": ["nearest", "bilinear", "bicubic", "lanczos"],
+      "description": "Scaling algorithm (nearest=pixel-perfect, lanczos=smoothest)",
+      "default": "nearest"
+    },
+    "magnify": {
+      "type": "integer",
+      "description": "Pixlet magnification factor (0=auto, 1=64x32, 2=128x64, 3=192x96, etc.)",
+      "default": 0,
+      "minimum": 0,
+      "maximum": 8
+    },
+    "center_small_output": {
+      "type": "boolean",
+      "description": "Center small apps on large displays instead of stretching",
+      "default": false
+    },
+    "background_render": {
+      "type": "boolean",
+      "description": "Render apps in background to avoid display delays",
+      "default": true
+    },
+    "auto_refresh_apps": {
+      "type": "boolean",
+      "description": "Automatically refresh apps at their specified intervals",
+      "default": true
+    },
+    "transition": {
+      "type": "object",
+      "description": "Transition settings for app display",
+      "properties": {
+        "type": {
+          "type": "string",
+          "enum": ["redraw", "fade", "slide", "wipe"],
+          "default": "fade"
+        },
+        "speed": {
+          "type": "integer",
+          "description": "Transition speed (1-10)",
+          "default": 3,
+          "minimum": 1,
+          "maximum": 10
+        },
+        "enabled": {
+          "type": "boolean",
+          "default": true
+        }
+      }
+    }
+  },
+  "additionalProperties": false
+}

plugin-repos/starlark-apps/frame_extractor.py

@@ -0,0 +1,285 @@
+"""
+Frame Extractor Module for Starlark Apps
+
+Extracts individual frames from WebP animations produced by Pixlet.
+Handles both static images and animated WebP files.
+"""
+
+import logging
+from typing import List, Tuple, Optional
+from PIL import Image
+
+logger = logging.getLogger(__name__)
+
+
+class FrameExtractor:
+    """
+    Extracts frames from WebP animations.
+
+    Handles:
+    - Static WebP images (single frame)
+    - Animated WebP files (multiple frames with delays)
+    - Frame timing and duration extraction
+    """
+
+    def __init__(self, default_frame_delay: int = 50):
+        """
+        Initialize frame extractor.
+
+        Args:
+            default_frame_delay: Default delay in milliseconds if not specified
+        """
+        self.default_frame_delay = default_frame_delay
+
+    def load_webp(self, webp_path: str) -> Tuple[bool, Optional[List[Tuple[Image.Image, int]]], Optional[str]]:
+        """
+        Load WebP file and extract all frames with their delays.
+
+        Args:
+            webp_path: Path to WebP file
+
+        Returns:
+            Tuple of:
+            - success: bool
+            - frames: List of (PIL.Image, delay_ms) tuples, or None on failure
+            - error: Error message, or None on success
+        """
+        try:
+            with Image.open(webp_path) as img:
+                # Check if animated
+                is_animated = getattr(img, "is_animated", False)
+
+                if not is_animated:
+                    # Static image - single frame
+                    # Convert to RGB (LED matrix needs RGB) to match animated branch format
+                    logger.debug(f"Loaded static WebP: {webp_path}")
+                    rgb_img = img.convert("RGB")
+                    return True, [(rgb_img.copy(), self.default_frame_delay)], None
+
+                # Animated WebP - extract all frames
+                frames = []
+                frame_count = getattr(img, "n_frames", 1)
+
+                logger.debug(f"Extracting {frame_count} frames from animated WebP: {webp_path}")
+
+                for frame_index in range(frame_count):
+                    try:
+                        img.seek(frame_index)
+
+                        # Get frame duration (in milliseconds)
+                        # WebP stores duration in milliseconds
+                        duration = img.info.get("duration", self.default_frame_delay)
+
+                        # Ensure minimum frame delay (prevent too-fast animations)
+                        if duration < 16:  # Less than ~60fps
+                            duration = 16
+
+                        # Convert frame to RGB (LED matrix needs RGB)
+                        frame = img.convert("RGB")
+                        frames.append((frame.copy(), duration))
+
+                    except EOFError:
+                        logger.warning(f"Reached end of frames at index {frame_index}")
+                        break
+                    except Exception as e:
+                        logger.warning(f"Error extracting frame {frame_index}: {e}")
+                        continue
+
+                if not frames:
+                    error = "No frames extracted from WebP"
+                    logger.error(error)
+                    return False, None, error
+
+                logger.debug(f"Successfully extracted {len(frames)} frames")
+                return True, frames, None
+
+        except FileNotFoundError:
+            error = f"WebP file not found: {webp_path}"
+            logger.error(error)
+            return False, None, error
+        except Exception as e:
+            error = f"Error loading WebP: {e}"
+            logger.error(error)
+            return False, None, error
+
+    def scale_frames(
+        self,
+        frames: List[Tuple[Image.Image, int]],
+        target_width: int,
+        target_height: int,
+        method: Image.Resampling = Image.Resampling.NEAREST
+    ) -> List[Tuple[Image.Image, int]]:
+        """
+        Scale all frames to target dimensions.
+
+        Args:
+            frames: List of (image, delay) tuples
+            target_width: Target width in pixels
+            target_height: Target height in pixels
+            method: Resampling method (default: NEAREST for pixel-perfect scaling)
+
+        Returns:
+            List of scaled (image, delay) tuples
+        """
+        scaled_frames = []
+
+        for frame, delay in frames:
+            try:
+                # Only scale if dimensions don't match
+                if frame.width != target_width or frame.height != target_height:
+                    scaled_frame = frame.resize(
+                        (target_width, target_height),
+                        resample=method
+                    )
+                    scaled_frames.append((scaled_frame, delay))
+                else:
+                    scaled_frames.append((frame, delay))
+            except Exception as e:
+                logger.warning(f"Error scaling frame: {e}")
+                # Keep original frame on error
+                scaled_frames.append((frame, delay))
+
+        logger.debug(f"Scaled {len(scaled_frames)} frames to {target_width}x{target_height}")
+        return scaled_frames
+
+    def center_frames(
+        self,
+        frames: List[Tuple[Image.Image, int]],
+        target_width: int,
+        target_height: int,
+        background_color: tuple = (0, 0, 0)
+    ) -> List[Tuple[Image.Image, int]]:
+        """
+        Center frames on a larger canvas instead of scaling.
+        Useful for displaying small widgets on large displays without distortion.
+
+        Args:
+            frames: List of (image, delay) tuples
+            target_width: Target canvas width
+            target_height: Target canvas height
+            background_color: RGB tuple for background (default: black)
+
+        Returns:
+            List of centered (image, delay) tuples
+        """
+        centered_frames = []
+
+        for frame, delay in frames:
+            try:
+                # If frame is already the right size, no centering needed
+                if frame.width == target_width and frame.height == target_height:
+                    centered_frames.append((frame, delay))
+                    continue
+
+                # Create black canvas at target size
+                canvas = Image.new('RGB', (target_width, target_height), background_color)
+
+                # Calculate position to center the frame
+                x_offset = (target_width - frame.width) // 2
+                y_offset = (target_height - frame.height) // 2
+
+                # Paste frame onto canvas
+                canvas.paste(frame, (x_offset, y_offset))
+                centered_frames.append((canvas, delay))
+
+            except Exception as e:
+                logger.warning(f"Error centering frame: {e}")
+                # Keep original frame on error
+                centered_frames.append((frame, delay))
+
+        logger.debug(f"Centered {len(centered_frames)} frames on {target_width}x{target_height} canvas")
+        return centered_frames
+
+    def get_total_duration(self, frames: List[Tuple[Image.Image, int]]) -> int:
+        """
+        Calculate total animation duration in milliseconds.
+
+        Args:
+            frames: List of (image, delay) tuples
+
+        Returns:
+            Total duration in milliseconds
+        """
+        return sum(delay for _, delay in frames)
+
+    def optimize_frames(
+        self,
+        frames: List[Tuple[Image.Image, int]],
+        max_frames: Optional[int] = None,
+        target_duration: Optional[int] = None
+    ) -> List[Tuple[Image.Image, int]]:
+        """
+        Optimize frame list by reducing frame count or adjusting timing.
+
+        Args:
+            frames: List of (image, delay) tuples
+            max_frames: Maximum number of frames to keep
+            target_duration: Target total duration in milliseconds
+
+        Returns:
+            Optimized list of (image, delay) tuples
+        """
+        if not frames:
+            return frames
+
+        optimized = frames.copy()
+
+        # Limit frame count if specified
+        if max_frames is not None and max_frames > 0 and len(optimized) > max_frames:
+            # Sample frames evenly
+            step = len(optimized) / max_frames
+            indices = [int(i * step) for i in range(max_frames)]
+            optimized = [optimized[i] for i in indices]
+            logger.debug(f"Reduced frames from {len(frames)} to {len(optimized)}")
+
+        # Adjust timing to match target duration
+        if target_duration:
+            current_duration = self.get_total_duration(optimized)
+            if current_duration > 0:
+                scale_factor = target_duration / current_duration
+                optimized = [
+                    (frame, max(16, int(delay * scale_factor)))
+                    for frame, delay in optimized
+                ]
+                logger.debug(f"Adjusted timing: {current_duration}ms -> {target_duration}ms")
+
+        return optimized
+
+    def frames_to_gif_data(self, frames: List[Tuple[Image.Image, int]]) -> Optional[bytes]:
+        """
+        Convert frames to GIF byte data for caching or transmission.
+
+        Args:
+            frames: List of (image, delay) tuples
+
+        Returns:
+            GIF bytes, or None on error
+        """
+        if not frames:
+            return None
+
+        try:
+            from io import BytesIO
+
+            output = BytesIO()
+
+            # Prepare frames for PIL
+            images = [frame for frame, _ in frames]
+            durations = [delay for _, delay in frames]
+
+            # Save as GIF
+            images[0].save(
+                output,
+                format="GIF",
+                save_all=True,
+                append_images=images[1:],
+                duration=durations,
+                loop=0,  # Infinite loop
+                optimize=False  # Skip optimization for speed
+            )
+
+            return output.getvalue()
+
+        except Exception as e:
+            logger.error(f"Error converting frames to GIF: {e}")
+            return None

plugin-repos/starlark-apps/manifest.json

@@ -0,0 +1,26 @@
+{
+  "id": "starlark-apps",
+  "name": "Starlark Apps",
+  "version": "1.0.0",
+  "author": "LEDMatrix",
+  "description": "Manages and displays Starlark (.star) apps from Tronbyte/Tidbyt community. Import widgets seamlessly without modification.",
+  "entry_point": "manager.py",
+  "class_name": "StarlarkAppsPlugin",
+  "category": "system",
+  "tags": [
+    "starlark",
+    "widgets",
+    "tronbyte",
+    "tidbyt",
+    "apps",
+    "community"
+  ],
+  "display_modes": [],
+  "update_interval": 60,
+  "default_duration": 15,
+  "dependencies": [
+    "Pillow>=10.0.0",
+    "PyYAML>=6.0",
+    "requests>=2.31.0"
+  ]
+}

plugin-repos/starlark-apps/pixlet_renderer.py

@@ -0,0 +1,659 @@
+"""
+Pixlet Renderer Module for Starlark Apps
+
+Handles execution of Pixlet CLI to render .star files into WebP animations.
+Supports bundled binaries and system-installed Pixlet.
+"""
+
+import json
+import logging
+import os
+import platform
+import re
+import shutil
+import subprocess
+from pathlib import Path
+from typing import Dict, Any, Optional, Tuple, List
+
+logger = logging.getLogger(__name__)
+
+
+class PixletRenderer:
+    """
+    Wrapper for Pixlet CLI rendering.
+
+    Handles:
+    - Auto-detection of bundled or system Pixlet binary
+    - Rendering .star files with configuration
+    - Schema extraction from .star files
+    - Timeout and error handling
+    """
+
+    def __init__(self, pixlet_path: Optional[str] = None, timeout: int = 30):
+        """
+        Initialize the Pixlet renderer.
+
+        Args:
+            pixlet_path: Optional explicit path to Pixlet binary
+            timeout: Maximum seconds to wait for rendering
+        """
+        self.timeout = timeout
+        self.pixlet_binary = self._find_pixlet_binary(pixlet_path)
+
+        if self.pixlet_binary:
+            logger.info(f"[Starlark Pixlet] Pixlet renderer initialized with binary: {self.pixlet_binary}")
+        else:
+            logger.warning("[Starlark Pixlet] Pixlet binary not found - rendering will fail")
+
+    def _find_pixlet_binary(self, explicit_path: Optional[str] = None) -> Optional[str]:
+        """
+        Find Pixlet binary using the following priority:
+        1. Explicit path provided
+        2. Bundled binary for current architecture
+        3. System PATH
+
+        Args:
+            explicit_path: User-specified path to Pixlet
+
+        Returns:
+            Path to Pixlet binary, or None if not found
+        """
+        # 1. Check explicit path
+        if explicit_path and os.path.isfile(explicit_path):
+            if os.access(explicit_path, os.X_OK):
+                logger.debug(f"Using explicit Pixlet path: {explicit_path}")
+                return explicit_path
+            else:
+                logger.warning(f"Explicit Pixlet path not executable: {explicit_path}")
+
+        # 2. Check bundled binary
+        try:
+            bundled_path = self._get_bundled_binary_path()
+            if bundled_path and os.path.isfile(bundled_path):
+                # Ensure executable
+                if not os.access(bundled_path, os.X_OK):
+                    try:
+                        os.chmod(bundled_path, 0o755)
+                        logger.debug(f"Made bundled binary executable: {bundled_path}")
+                    except OSError:
+                        logger.exception(f"Could not make bundled binary executable: {bundled_path}")
+
+                if os.access(bundled_path, os.X_OK):
+                    logger.debug(f"Using bundled Pixlet binary: {bundled_path}")
+                    return bundled_path
+        except OSError:
+            logger.exception("Could not locate bundled binary")
+
+        # 3. Check system PATH
+        system_pixlet = shutil.which("pixlet")
+        if system_pixlet:
+            logger.debug(f"Using system Pixlet: {system_pixlet}")
+            return system_pixlet
+
+        logger.error("Pixlet binary not found in any location")
+        return None
+
+    def _get_bundled_binary_path(self) -> Optional[str]:
+        """
+        Get path to bundled Pixlet binary for current architecture.
+
+        Returns:
+            Path to bundled binary, or None if not found
+        """
+        try:
+            # Determine project root (parent of plugin-repos)
+            current_dir = Path(__file__).resolve().parent
+            project_root = current_dir.parent.parent
+            bin_dir = project_root / "bin" / "pixlet"
+
+            # Detect architecture
+            system = platform.system().lower()
+            machine = platform.machine().lower()
+
+            # Map architecture to binary name
+            if system == "linux":
+                if "aarch64" in machine or "arm64" in machine:
+                    binary_name = "pixlet-linux-arm64"
+                elif "x86_64" in machine or "amd64" in machine:
+                    binary_name = "pixlet-linux-amd64"
+                else:
+                    logger.warning(f"Unsupported Linux architecture: {machine}")
+                    return None
+            elif system == "darwin":
+                if "arm64" in machine:
+                    binary_name = "pixlet-darwin-arm64"
+                else:
+                    binary_name = "pixlet-darwin-amd64"
+            elif system == "windows":
+                binary_name = "pixlet-windows-amd64.exe"
+            else:
+                logger.warning(f"Unsupported system: {system}")
+                return None
+
+            binary_path = bin_dir / binary_name
+            if binary_path.exists():
+                return str(binary_path)
+
+            logger.debug(f"Bundled binary not found at: {binary_path}")
+            return None
+
+        except OSError:
+            logger.exception("Error finding bundled binary")
+            return None
+
+    def _get_safe_working_directory(self, star_file: str) -> Optional[str]:
+        """
+        Get a safe working directory for subprocess execution.
+
+        Args:
+            star_file: Path to .star file
+
+        Returns:
+            Resolved parent directory, or None if empty or invalid
+        """
+        try:
+            resolved_parent = os.path.dirname(os.path.abspath(star_file))
+            # Return None if empty string to avoid FileNotFoundError
+            if not resolved_parent:
+                logger.debug(f"Empty parent directory for star_file: {star_file}")
+                return None
+            return resolved_parent
+        except (OSError, ValueError):
+            logger.debug(f"Could not resolve working directory for: {star_file}")
+            return None
+
+    def is_available(self) -> bool:
+        """
+        Check if Pixlet is available and functional.
+
+        Returns:
+            True if Pixlet can be executed
+        """
+        if not self.pixlet_binary:
+            return False
+
+        try:
+            result = subprocess.run(
+                [self.pixlet_binary, "version"],
+                capture_output=True,
+                text=True,
+                timeout=5
+            )
+            return result.returncode == 0
+        except subprocess.TimeoutExpired:
+            logger.debug("Pixlet version check timed out")
+            return False
+        except (subprocess.SubprocessError, OSError):
+            logger.exception("Pixlet not available")
+            return False
+
+    def get_version(self) -> Optional[str]:
+        """
+        Get Pixlet version string.
+
+        Returns:
+            Version string, or None if unavailable
+        """
+        if not self.pixlet_binary:
+            return None
+
+        try:
+            result = subprocess.run(
+                [self.pixlet_binary, "version"],
+                capture_output=True,
+                text=True,
+                timeout=5
+            )
+            if result.returncode == 0:
+                return result.stdout.strip()
+        except subprocess.TimeoutExpired:
+            logger.debug("Pixlet version check timed out")
+        except (subprocess.SubprocessError, OSError):
+            logger.exception("Could not get Pixlet version")
+
+        return None
+
+    def render(
+        self,
+        star_file: str,
+        output_path: str,
+        config: Optional[Dict[str, Any]] = None,
+        magnify: int = 1
+    ) -> Tuple[bool, Optional[str]]:
+        """
+        Render a .star file to WebP output.
+
+        Args:
+            star_file: Path to .star file
+            output_path: Where to save WebP output
+            config: Configuration dictionary to pass to app
+            magnify: Magnification factor (default 1)
+
+        Returns:
+            Tuple of (success: bool, error_message: Optional[str])
+        """
+        if not self.pixlet_binary:
+            return False, "Pixlet binary not found"
+
+        if not os.path.isfile(star_file):
+            return False, f"Star file not found: {star_file}"
+
+        try:
+            # Build command - config params must be POSITIONAL between star_file and flags
+            # Format: pixlet render <file.star> [key=value]... [flags]
+            cmd = [
+                self.pixlet_binary,
+                "render",
+                star_file
+            ]
+
+            # Add configuration parameters as positional arguments (BEFORE flags)
+            if config:
+                for key, value in config.items():
+                    # Validate key format (alphanumeric + underscore only)
+                    if not re.match(r'^[a-zA-Z_][a-zA-Z0-9_]*$', key):
+                        logger.warning(f"Skipping invalid config key: {key}")
+                        continue
+
+                    # Convert value to string for CLI
+                    if isinstance(value, bool):
+                        value_str = "true" if value else "false"
+                    elif isinstance(value, str) and (value.startswith('{') or value.startswith('[')):
+                        # JSON string - keep as-is, will be properly quoted by subprocess
+                        value_str = value
+                    else:
+                        value_str = str(value)
+
+                    # Validate value doesn't contain dangerous shell metacharacters
+                    # Block: backticks, $(), pipes, redirects, semicolons, ampersands, null bytes
+                    # Allow: most printable chars including spaces, quotes, brackets, braces
+                    if re.search(r'[`$|<>&;\x00]|\$\(', value_str):
+                        logger.warning(f"Skipping config value with unsafe shell characters for key {key}: {value_str}")
+                        continue
+
+                    # Add as positional argument (not -c flag)
+                    cmd.append(f"{key}={value_str}")
+
+            # Add flags AFTER positional config arguments
+            cmd.extend([
+                "-o", output_path,
+                "-m", str(magnify)
+            ])
+
+            # Build sanitized command for logging (redact sensitive values)
+            sanitized_cmd = [self.pixlet_binary, "render", star_file]
+            if config:
+                config_keys = list(config.keys())
+                sanitized_cmd.append(f"[{len(config_keys)} config entries: {', '.join(config_keys)}]")
+            sanitized_cmd.extend(["-o", output_path, "-m", str(magnify)])
+            logger.debug(f"Executing Pixlet: {' '.join(sanitized_cmd)}")
+
+            # Execute rendering
+            safe_cwd = self._get_safe_working_directory(star_file)
+            result = subprocess.run(
+                cmd,
+                capture_output=True,
+                text=True,
+                timeout=self.timeout,
+                cwd=safe_cwd  # Run in .star file directory (or None if relative path)
+            )
+
+            if result.returncode == 0:
+                if os.path.isfile(output_path):
+                    logger.debug(f"Successfully rendered: {star_file} -> {output_path}")
+                    return True, None
+                else:
+                    error = "Rendering succeeded but output file not found"
+                    logger.error(error)
+                    return False, error
+            else:
+                error = f"Pixlet failed (exit {result.returncode}): {result.stderr}"
+                logger.error(error)
+                return False, error
+
+        except subprocess.TimeoutExpired:
+            error = f"Rendering timeout after {self.timeout}s"
+            logger.error(error)
+            return False, error
+        except (subprocess.SubprocessError, OSError):
+            logger.exception("Rendering exception")
+            return False, "Rendering failed - see logs for details"
+
+    def extract_schema(self, star_file: str) -> Tuple[bool, Optional[Dict[str, Any]], Optional[str]]:
+        """
+        Extract configuration schema from a .star file by parsing source code.
+
+        Supports:
+        - Static field definitions (location, text, toggle, dropdown, color, datetime)
+        - Variable-referenced dropdown options
+        - Graceful degradation for unsupported field types
+
+        Args:
+            star_file: Path to .star file
+
+        Returns:
+            Tuple of (success: bool, schema: Optional[Dict], error: Optional[str])
+        """
+        if not os.path.isfile(star_file):
+            return False, None, f"Star file not found: {star_file}"
+
+        try:
+            # Read .star file
+            with open(star_file, 'r', encoding='utf-8') as f:
+                content = f.read()
+
+            # Parse schema from source
+            schema = self._parse_schema_from_source(content, star_file)
+
+            if schema:
+                field_count = len(schema.get('schema', []))
+                logger.debug(f"Extracted schema with {field_count} field(s) from: {star_file}")
+                return True, schema, None
+            else:
+                # No schema found - not an error, app just doesn't have configuration
+                logger.debug(f"No schema found in: {star_file}")
+                return True, None, None
+
+        except UnicodeDecodeError as e:
+            error = f"File encoding error: {e}"
+            logger.warning(error)
+            return False, None, error
+        except Exception as e:
+            logger.exception(f"Schema extraction failed for {star_file}")
+            return False, None, f"Schema extraction error: {str(e)}"
+
+    def _parse_schema_from_source(self, content: str, file_path: str) -> Optional[Dict[str, Any]]:
+        """
+        Parse get_schema() function from Starlark source code.
+
+        Args:
+            content: .star file content
+            file_path: Path to file (for logging)
+
+        Returns:
+            Schema dict with format {"version": "1", "schema": [...]}, or None
+        """
+        # Extract variable definitions (for dropdown options)
+        var_table = self._extract_variable_definitions(content)
+
+        # Extract get_schema() function body
+        schema_body = self._extract_get_schema_body(content)
+        if not schema_body:
+            logger.debug(f"No get_schema() function found in {file_path}")
+            return None
+
+        # Extract version
+        version_match = re.search(r'version\s*=\s*"([^"]+)"', schema_body)
+        version = version_match.group(1) if version_match else "1"
+
+        # Extract fields array from schema.Schema(...) - handle nested brackets
+        fields_start_match = re.search(r'fields\s*=\s*\[', schema_body)
+        if not fields_start_match:
+            # Empty schema or no fields
+            return {"version": version, "schema": []}
+
+        # Find matching closing bracket
+        bracket_count = 1
+        i = fields_start_match.end()
+        while i < len(schema_body) and bracket_count > 0:
+            if schema_body[i] == '[':
+                bracket_count += 1
+            elif schema_body[i] == ']':
+                bracket_count -= 1
+            i += 1
+
+        if bracket_count != 0:
+            # Unmatched brackets
+            logger.warning(f"Unmatched brackets in schema fields for {file_path}")
+            return {"version": version, "schema": []}
+
+        fields_text = schema_body[fields_start_match.end():i-1]
+
+        # Parse individual fields
+        schema_fields = []
+        # Match schema.FieldType(...) patterns
+        field_pattern = r'schema\.(\w+)\s*\((.*?)\)'
+
+        # Find all field definitions (handle nested parentheses)
+        pos = 0
+        while pos < len(fields_text):
+            match = re.search(field_pattern, fields_text[pos:], re.DOTALL)
+            if not match:
+                break
+
+            field_type = match.group(1)
+            field_start = pos + match.start()
+            field_end = pos + match.end()
+
+            # Handle nested parentheses properly
+            paren_count = 1
+            i = pos + match.start() + len(f'schema.{field_type}(')
+            while i < len(fields_text) and paren_count > 0:
+                if fields_text[i] == '(':
+                    paren_count += 1
+                elif fields_text[i] == ')':
+                    paren_count -= 1
+                i += 1
+
+            field_params_text = fields_text[pos + match.start() + len(f'schema.{field_type}('):i-1]
+
+            # Parse field
+            field_dict = self._parse_schema_field(field_type, field_params_text, var_table)
+            if field_dict:
+                schema_fields.append(field_dict)
+
+            pos = i
+
+        return {
+            "version": version,
+            "schema": schema_fields
+        }
+
+    def _extract_variable_definitions(self, content: str) -> Dict[str, List[Dict]]:
+        """
+        Extract top-level variable assignments (for dropdown options).
+
+        Args:
+            content: .star file content
+
+        Returns:
+            Dict mapping variable names to their option lists
+        """
+        var_table = {}
+
+        # Find variable definitions like: variableName = [schema.Option(...), ...]
+        var_pattern = r'^(\w+)\s*=\s*\[(.*?schema\.Option.*?)\]'
+        matches = re.finditer(var_pattern, content, re.MULTILINE | re.DOTALL)
+
+        for match in matches:
+            var_name = match.group(1)
+            options_text = match.group(2)
+
+            # Parse schema.Option entries
+            options = self._parse_schema_options(options_text, {})
+            if options:
+                var_table[var_name] = options
+
+        return var_table
+
+    def _extract_get_schema_body(self, content: str) -> Optional[str]:
+        """
+        Extract get_schema() function body using indentation-aware parsing.
+
+        Args:
+            content: .star file content
+
+        Returns:
+            Function body text, or None if not found
+        """
+        # Find def get_schema(): line
+        pattern = r'^(\s*)def\s+get_schema\s*\(\s*\)\s*:'
+        match = re.search(pattern, content, re.MULTILINE)
+
+        if not match:
+            return None
+
+        # Get the indentation level of the function definition
+        func_indent = len(match.group(1))
+        func_start = match.end()
+
+        # Split content into lines starting after the function definition
+        lines_after = content[func_start:].split('\n')
+        body_lines = []
+
+        for line in lines_after:
+            # Skip empty lines
+            if not line.strip():
+                body_lines.append(line)
+                continue
+
+            # Calculate indentation of current line
+            stripped = line.lstrip()
+            line_indent = len(line) - len(stripped)
+
+            # If line has same or less indentation than function def, check if it's a top-level def
+            if line_indent <= func_indent:
+                # This is a line at the same or outer level - check if it's a function
+                if re.match(r'def\s+\w+', stripped):
+                    # Found next top-level function, stop here
+                    break
+                # Otherwise it might be a comment or other top-level code, stop anyway
+                break
+
+            # Line is indented more than function def, so it's part of the body
+            body_lines.append(line)
+
+        if body_lines:
+            return '\n'.join(body_lines)
+        return None
+
+    def _parse_schema_field(self, field_type: str, params_text: str, var_table: Dict) -> Optional[Dict[str, Any]]:
+        """
+        Parse individual schema field definition.
+
+        Args:
+            field_type: Field type (Location, Text, Toggle, etc.)
+            params_text: Field parameters text
+            var_table: Variable lookup table
+
+        Returns:
+            Field dict, or None if parse fails
+        """
+        # Map Pixlet field types to JSON typeOf
+        type_mapping = {
+            'Location': 'location',
+            'Text': 'text',
+            'Toggle': 'toggle',
+            'Dropdown': 'dropdown',
+            'Color': 'color',
+            'DateTime': 'datetime',
+            'OAuth2': 'oauth2',
+            'PhotoSelect': 'photo_select',
+            'LocationBased': 'location_based',
+            'Typeahead': 'typeahead',
+            'Generated': 'generated',
+        }
+
+        type_of = type_mapping.get(field_type, field_type.lower())
+
+        # Skip Generated fields (invisible meta-fields)
+        if type_of == 'generated':
+            return None
+
+        field_dict = {"typeOf": type_of}
+
+        # Extract common parameters
+        # id
+        id_match = re.search(r'id\s*=\s*"([^"]+)"', params_text)
+        if id_match:
+            field_dict['id'] = id_match.group(1)
+        else:
+            # id is required, skip field if missing
+            return None
+
+        # name
+        name_match = re.search(r'name\s*=\s*"([^"]+)"', params_text)
+        if name_match:
+            field_dict['name'] = name_match.group(1)
+
+        # desc
+        desc_match = re.search(r'desc\s*=\s*"([^"]+)"', params_text)
+        if desc_match:
+            field_dict['desc'] = desc_match.group(1)
+
+        # icon
+        icon_match = re.search(r'icon\s*=\s*"([^"]+)"', params_text)
+        if icon_match:
+            field_dict['icon'] = icon_match.group(1)
+
+        # default (can be string, bool, or variable reference)
+        # First try to match quoted strings (which may contain commas)
+        default_match = re.search(r'default\s*=\s*"([^"]*)"', params_text)
+        if not default_match:
+            # Try single quotes
+            default_match = re.search(r"default\s*=\s*'([^']*)'", params_text)
+        if not default_match:
+            # Fall back to unquoted value (stop at comma or closing paren)
+            default_match = re.search(r'default\s*=\s*([^,\)]+)', params_text)
+
+        if default_match:
+            default_value = default_match.group(1).strip()
+            # Handle boolean
+            if default_value in ('True', 'False'):
+                field_dict['default'] = default_value.lower()
+            # Handle string literal from first two patterns (already extracted without quotes)
+            elif re.search(r'default\s*=\s*["\']', params_text):
+                # This was a quoted string, use the captured content directly
+                field_dict['default'] = default_value
+            # Handle variable reference (can't resolve, use as-is)
+            else:
+                # Try to extract just the value if it's like options[0].value
+                if '.' in default_value or '[' in default_value:
+                    # Complex expression, skip default
+                    pass
+                else:
+                    field_dict['default'] = default_value
+
+        # For dropdown, extract options
+        if type_of == 'dropdown':
+            options_match = re.search(r'options\s*=\s*([^,\)]+)', params_text)
+            if options_match:
+                options_ref = options_match.group(1).strip()
+                # Check if it's a variable reference
+                if options_ref in var_table:
+                    field_dict['options'] = var_table[options_ref]
+                # Or inline options
+                elif options_ref.startswith('['):
+                    # Find the full options array (handle nested brackets)
+                    # This is tricky, for now try to extract inline options
+                    inline_match = re.search(r'options\s*=\s*(\[.*?\])', params_text, re.DOTALL)
+                    if inline_match:
+                        options_text = inline_match.group(1)
+                        field_dict['options'] = self._parse_schema_options(options_text, var_table)
+
+        return field_dict
+
+    def _parse_schema_options(self, options_text: str, var_table: Dict) -> List[Dict[str, str]]:
+        """
+        Parse schema.Option list.
+
+        Args:
+            options_text: Text containing schema.Option(...) entries
+            var_table: Variable lookup table (not currently used)
+
+        Returns:
+            List of {"display": "...", "value": "..."} dicts
+        """
+        options = []
+
+        # Match schema.Option(display = "...", value = "...")
+        option_pattern = r'schema\.Option\s*\(\s*display\s*=\s*"([^"]+)"\s*,\s*value\s*=\s*"([^"]+)"\s*\)'
+        matches = re.finditer(option_pattern, options_text)
+
+        for match in matches:
+            options.append({
+                "display": match.group(1),
+                "value": match.group(2)
+            })
+
+        return options

plugin-repos/starlark-apps/requirements.txt

@@ -0,0 +1,3 @@
+Pillow>=10.4.0
+PyYAML>=6.0.2
+requests>=2.32.0

plugin-repos/starlark-apps/tronbyte_repository.py

@@ -0,0 +1,598 @@
+"""
+Tronbyte Repository Module
+
+Handles interaction with the Tronbyte apps repository on GitHub.
+Fetches app listings, metadata, and downloads .star files.
+"""
+
+import logging
+import time
+import requests
+import yaml
+import threading
+from typing import Dict, Any, Optional, List, Tuple
+from pathlib import Path
+from concurrent.futures import ThreadPoolExecutor, as_completed
+
+logger = logging.getLogger(__name__)
+
+# Module-level cache for bulk app listing (survives across requests)
+_apps_cache = {'data': None, 'timestamp': 0, 'categories': [], 'authors': []}
+_CACHE_TTL = 7200  # 2 hours
+_cache_lock = threading.Lock()
+
+
+class TronbyteRepository:
+    """
+    Interface to the Tronbyte apps repository.
+
+    Provides methods to:
+    - List available apps
+    - Fetch app metadata
+    - Download .star files
+    - Parse manifest.yaml files
+    """
+
+    REPO_OWNER = "tronbyt"
+    REPO_NAME = "apps"
+    DEFAULT_BRANCH = "main"
+    APPS_PATH = "apps"
+
+    def __init__(self, github_token: Optional[str] = None):
+        """
+        Initialize repository interface.
+
+        Args:
+            github_token: Optional GitHub personal access token for higher rate limits
+        """
+        self.github_token = github_token
+        self.base_url = "https://api.github.com"
+        self.raw_url = "https://raw.githubusercontent.com"
+
+        self.session = requests.Session()
+        if github_token:
+            self.session.headers.update({
+                'Authorization': f'token {github_token}'
+            })
+        self.session.headers.update({
+            'Accept': 'application/vnd.github.v3+json',
+            'User-Agent': 'LEDMatrix-Starlark-Plugin'
+        })
+
+    def _make_request(self, url: str, timeout: int = 10) -> Optional[Dict[str, Any]]:
+        """
+        Make a request to GitHub API with error handling.
+
+        Args:
+            url: API URL to request
+            timeout: Request timeout in seconds
+
+        Returns:
+            JSON response or None on error
+        """
+        try:
+            response = self.session.get(url, timeout=timeout)
+
+            if response.status_code == 403:
+                # Rate limit exceeded
+                logger.warning("GitHub API rate limit exceeded")
+                return None
+            elif response.status_code == 404:
+                logger.warning(f"Resource not found: {url}")
+                return None
+            elif response.status_code != 200:
+                logger.error(f"GitHub API error: {response.status_code}")
+                return None
+
+            return response.json()
+
+        except requests.Timeout:
+            logger.error(f"Request timeout: {url}")
+            return None
+        except requests.RequestException as e:
+            logger.error(f"Request error: {e}")
+            return None
+        except Exception as e:
+            logger.error(f"Unexpected error: {e}")
+            return None
+
+    def _fetch_raw_file(self, file_path: str, branch: Optional[str] = None, binary: bool = False):
+        """
+        Fetch raw file content from repository.
+
+        Args:
+            file_path: Path to file in repository
+            branch: Branch name (default: DEFAULT_BRANCH)
+            binary: If True, return bytes; if False, return text
+
+        Returns:
+            File content as string/bytes, or None on error
+        """
+        branch = branch or self.DEFAULT_BRANCH
+        url = f"{self.raw_url}/{self.REPO_OWNER}/{self.REPO_NAME}/{branch}/{file_path}"
+
+        try:
+            response = self.session.get(url, timeout=10)
+            if response.status_code == 200:
+                return response.content if binary else response.text
+            else:
+                logger.warning(f"Failed to fetch raw file: {file_path} ({response.status_code})")
+                return None
+        except Exception as e:
+            logger.error(f"Error fetching raw file {file_path}: {e}")
+            return None
+
+    def list_apps(self) -> Tuple[bool, Optional[List[Dict[str, Any]]], Optional[str]]:
+        """
+        List all available apps in the repository.
+
+        Returns:
+            Tuple of (success, apps_list, error_message)
+        """
+        url = f"{self.base_url}/repos/{self.REPO_OWNER}/{self.REPO_NAME}/contents/{self.APPS_PATH}"
+
+        data = self._make_request(url)
+        if data is None:
+            return False, None, "Failed to fetch repository contents"
+
+        if not isinstance(data, list):
+            return False, None, "Invalid response format"
+
+        # Filter directories (apps)
+        apps = []
+        for item in data:
+            if item.get('type') == 'dir':
+                app_id = item.get('name')
+                if app_id and not app_id.startswith('.'):
+                    apps.append({
+                        'id': app_id,
+                        'path': item.get('path'),
+                        'url': item.get('url')
+                    })
+
+        logger.info(f"Found {len(apps)} apps in repository")
+        return True, apps, None
+
+    def get_app_metadata(self, app_id: str) -> Tuple[bool, Optional[Dict[str, Any]], Optional[str]]:
+        """
+        Fetch metadata for a specific app.
+
+        Reads the manifest.yaml file for the app and parses it.
+
+        Args:
+            app_id: App identifier
+
+        Returns:
+            Tuple of (success, metadata_dict, error_message)
+        """
+        manifest_path = f"{self.APPS_PATH}/{app_id}/manifest.yaml"
+
+        content = self._fetch_raw_file(manifest_path)
+        if not content:
+            return False, None, f"Failed to fetch manifest for {app_id}"
+
+        try:
+            metadata = yaml.safe_load(content)
+
+            # Validate that metadata is a dict before mutating
+            if not isinstance(metadata, dict):
+                if metadata is None:
+                    logger.warning(f"Manifest for {app_id} is empty or None, initializing empty dict")
+                    metadata = {}
+                else:
+                    logger.error(f"Manifest for {app_id} is not a dict (got {type(metadata).__name__}), skipping")
+                    return False, None, f"Invalid manifest format: expected dict, got {type(metadata).__name__}"
+
+            # Enhance with app_id
+            metadata['id'] = app_id
+
+            # Parse schema if present
+            if 'schema' in metadata:
+                # Schema is already parsed from YAML
+                pass
+
+            return True, metadata, None
+
+        except (yaml.YAMLError, TypeError) as e:
+            logger.error(f"Failed to parse manifest for {app_id}: {e}")
+            return False, None, f"Invalid manifest format: {e}"
+
+    def list_apps_with_metadata(self, max_apps: Optional[int] = None) -> List[Dict[str, Any]]:
+        """
+        List all apps with their metadata.
+
+        This is slower as it fetches manifest.yaml for each app.
+
+        Args:
+            max_apps: Optional limit on number of apps to fetch
+
+        Returns:
+            List of app metadata dictionaries
+        """
+        success, apps, error = self.list_apps()
+
+        if not success:
+            logger.error(f"Failed to list apps: {error}")
+            return []
+
+        if max_apps is not None:
+            apps = apps[:max_apps]
+
+        apps_with_metadata = []
+        for app_info in apps:
+            app_id = app_info['id']
+            success, metadata, error = self.get_app_metadata(app_id)
+
+            if success and metadata:
+                # Merge basic info with metadata
+                metadata.update({
+                    'repository_path': app_info['path']
+                })
+                apps_with_metadata.append(metadata)
+            else:
+                # Add basic info even if metadata fetch failed
+                apps_with_metadata.append({
+                    'id': app_id,
+                    'name': app_id.replace('_', ' ').title(),
+                    'summary': 'No description available',
+                    'repository_path': app_info['path'],
+                    'metadata_error': error
+                })
+
+        return apps_with_metadata
+
+    def list_all_apps_cached(self) -> Dict[str, Any]:
+        """
+        Fetch ALL apps with metadata, using a module-level cache.
+
+        On first call (or after cache TTL expires), fetches the directory listing
+        via the GitHub API (1 call) then fetches all manifests in parallel via
+        raw.githubusercontent.com (not rate-limited). Results are cached for 2 hours.
+
+        Returns:
+            Dict with keys: apps, categories, authors, count, cached
+        """
+        global _apps_cache
+
+        now = time.time()
+
+        # Check cache with lock (read-only check)
+        with _cache_lock:
+            if _apps_cache['data'] is not None and (now - _apps_cache['timestamp']) < _CACHE_TTL:
+                return {
+                    'apps': _apps_cache['data'],
+                    'categories': _apps_cache['categories'],
+                    'authors': _apps_cache['authors'],
+                    'count': len(_apps_cache['data']),
+                    'cached': True
+                }
+
+        # Fetch directory listing (1 GitHub API call)
+        success, app_dirs, error = self.list_apps()
+        if not success or not app_dirs:
+            logger.error(f"Failed to list apps for bulk fetch: {error}")
+            return {'apps': [], 'categories': [], 'authors': [], 'count': 0, 'cached': False}
+
+        logger.info(f"Bulk-fetching manifests for {len(app_dirs)} apps...")
+
+        def fetch_one(app_info):
+            """Fetch a single app's manifest (runs in thread pool)."""
+            app_id = app_info['id']
+            manifest_path = f"{self.APPS_PATH}/{app_id}/manifest.yaml"
+            content = self._fetch_raw_file(manifest_path)
+            if content:
+                try:
+                    metadata = yaml.safe_load(content)
+                    if not isinstance(metadata, dict):
+                        metadata = {}
+                    metadata['id'] = app_id
+                    metadata['repository_path'] = app_info.get('path', '')
+                    return metadata
+                except (yaml.YAMLError, TypeError) as e:
+                    logger.warning(f"Failed to parse manifest for {app_id}: {e}")
+            # Fallback: minimal entry
+            return {
+                'id': app_id,
+                'name': app_id.replace('_', ' ').replace('-', ' ').title(),
+                'summary': 'No description available',
+                'repository_path': app_info.get('path', ''),
+            }
+
+        # Parallel manifest fetches via raw.githubusercontent.com (high rate limit)
+        apps_with_metadata = []
+        with ThreadPoolExecutor(max_workers=5) as executor:
+            futures = {executor.submit(fetch_one, info): info for info in app_dirs}
+            for future in as_completed(futures):
+                try:
+                    result = future.result(timeout=30)
+                    if result:
+                        apps_with_metadata.append(result)
+                except Exception as e:
+                    app_info = futures[future]
+                    logger.warning(f"Failed to fetch manifest for {app_info['id']}: {e}")
+                    apps_with_metadata.append({
+                        'id': app_info['id'],
+                        'name': app_info['id'].replace('_', ' ').replace('-', ' ').title(),
+                        'summary': 'No description available',
+                        'repository_path': app_info.get('path', ''),
+                    })
+
+        # Sort by name for consistent ordering
+        apps_with_metadata.sort(key=lambda a: (a.get('name') or a.get('id', '')).lower())
+
+        # Extract unique categories and authors
+        categories = sorted({a.get('category', '') for a in apps_with_metadata if a.get('category')})
+        authors = sorted({a.get('author', '') for a in apps_with_metadata if a.get('author')})
+
+        # Update cache with lock
+        with _cache_lock:
+            _apps_cache['data'] = apps_with_metadata
+            _apps_cache['timestamp'] = now
+            _apps_cache['categories'] = categories
+            _apps_cache['authors'] = authors
+
+        logger.info(f"Cached {len(apps_with_metadata)} apps ({len(categories)} categories, {len(authors)} authors)")
+
+        return {
+            'apps': apps_with_metadata,
+            'categories': categories,
+            'authors': authors,
+            'count': len(apps_with_metadata),
+            'cached': False
+        }
+
+    def download_star_file(self, app_id: str, output_path: Path, filename: Optional[str] = None) -> Tuple[bool, Optional[str]]:
+        """
+        Download the .star file for an app.
+
+        Args:
+            app_id: App identifier (directory name)
+            output_path: Where to save the .star file
+            filename: Optional specific filename from manifest (e.g., "analog_clock.star")
+                     If not provided, assumes {app_id}.star
+
+        Returns:
+            Tuple of (success, error_message)
+        """
+        # Validate inputs for path traversal
+        if '..' in app_id or '/' in app_id or '\\' in app_id:
+            return False, f"Invalid app_id: contains path traversal characters"
+
+        star_filename = filename or f"{app_id}.star"
+        if '..' in star_filename or '/' in star_filename or '\\' in star_filename:
+            return False, f"Invalid filename: contains path traversal characters"
+
+        # Validate output_path to prevent path traversal
+        import tempfile
+        try:
+            resolved_output = output_path.resolve()
+            temp_dir = Path(tempfile.gettempdir()).resolve()
+
+            # Check if output_path is within the system temp directory
+            # Use try/except for compatibility with Python < 3.9 (is_relative_to)
+            try:
+                is_safe = resolved_output.is_relative_to(temp_dir)
+            except AttributeError:
+                # Fallback for Python < 3.9: compare string paths
+                is_safe = str(resolved_output).startswith(str(temp_dir) + '/')
+
+            if not is_safe:
+                logger.warning(f"Path traversal attempt in download_star_file: app_id={app_id}, output_path={output_path}")
+                return False, f"Invalid output_path for {app_id}: must be within temp directory"
+        except Exception as e:
+            logger.error(f"Error validating output_path for {app_id}: {e}")
+            return False, f"Invalid output_path for {app_id}"
+
+        # Use provided filename or fall back to app_id.star
+        star_path = f"{self.APPS_PATH}/{app_id}/{star_filename}"
+
+        content = self._fetch_raw_file(star_path)
+        if not content:
+            return False, f"Failed to download .star file for {app_id} (tried {star_filename})"
+
+        try:
+            output_path.parent.mkdir(parents=True, exist_ok=True)
+            with open(output_path, 'w', encoding='utf-8') as f:
+                f.write(content)
+
+            logger.info(f"Downloaded {app_id}.star to {output_path}")
+            return True, None
+
+        except OSError as e:
+            logger.exception(f"Failed to save .star file: {e}")
+            return False, f"Failed to save file: {e}"
+
+    def get_app_files(self, app_id: str) -> Tuple[bool, Optional[List[str]], Optional[str]]:
+        """
+        List all files in an app directory.
+
+        Args:
+            app_id: App identifier
+
+        Returns:
+            Tuple of (success, file_list, error_message)
+        """
+        url = f"{self.base_url}/repos/{self.REPO_OWNER}/{self.REPO_NAME}/contents/{self.APPS_PATH}/{app_id}"
+
+        data = self._make_request(url)
+        if not data:
+            return False, None, "Failed to fetch app files"
+
+        if not isinstance(data, list):
+            return False, None, "Invalid response format"
+
+        files = [item['name'] for item in data if item.get('type') == 'file']
+        return True, files, None
+
+    def download_app_assets(self, app_id: str, output_dir: Path) -> Tuple[bool, Optional[str]]:
+        """
+        Download all asset files (images, sources, etc.) for an app.
+
+        Args:
+            app_id: App identifier
+            output_dir: Directory to save assets to
+
+        Returns:
+            Tuple of (success, error_message)
+        """
+        # Validate app_id for path traversal
+        if '..' in app_id or '/' in app_id or '\\' in app_id:
+            return False, f"Invalid app_id: contains path traversal characters"
+
+        try:
+            # Get directory listing for the app
+            url = f"{self.base_url}/repos/{self.REPO_OWNER}/{self.REPO_NAME}/contents/{self.APPS_PATH}/{app_id}"
+            data = self._make_request(url)
+            if not data:
+                return False, f"Failed to fetch app directory listing"
+
+            if not isinstance(data, list):
+                return False, f"Invalid directory listing format"
+
+            # Find directories that contain assets (images, sources, etc.)
+            asset_dirs = []
+            for item in data:
+                if item.get('type') == 'dir':
+                    dir_name = item.get('name')
+                    # Common asset directory names in Tronbyte apps
+                    if dir_name in ('images', 'sources', 'fonts', 'assets'):
+                        asset_dirs.append((dir_name, item.get('url')))
+
+            if not asset_dirs:
+                # No asset directories, this is fine
+                return True, None
+
+            # Download each asset directory
+            for dir_name, dir_url in asset_dirs:
+                # Validate directory name for path traversal
+                if '..' in dir_name or '/' in dir_name or '\\' in dir_name:
+                    logger.warning(f"Skipping potentially unsafe directory: {dir_name}")
+                    continue
+
+                # Get files in this directory
+                dir_data = self._make_request(dir_url)
+                if not dir_data or not isinstance(dir_data, list):
+                    logger.warning(f"Could not list files in {app_id}/{dir_name}")
+                    continue
+
+                # Create local directory
+                local_dir = output_dir / dir_name
+                local_dir.mkdir(parents=True, exist_ok=True)
+
+                # Download each file
+                for file_item in dir_data:
+                    if file_item.get('type') == 'file':
+                        file_name = file_item.get('name')
+
+                        # Ensure file_name is a non-empty string before validation
+                        if not file_name or not isinstance(file_name, str):
+                            logger.warning(f"Skipping file with invalid name in {dir_name}: {file_item}")
+                            continue
+
+                        # Validate filename for path traversal
+                        if '..' in file_name or '/' in file_name or '\\' in file_name:
+                            logger.warning(f"Skipping potentially unsafe file: {file_name}")
+                            continue
+
+                        file_path = f"{self.APPS_PATH}/{app_id}/{dir_name}/{file_name}"
+                        content = self._fetch_raw_file(file_path, binary=True)
+                        if content:
+                            # Write binary content to file
+                            output_path = local_dir / file_name
+                            try:
+                                with open(output_path, 'wb') as f:
+                                    f.write(content)
+                                logger.debug(f"Downloaded asset: {dir_name}/{file_name}")
+                            except Exception as e:
+                                logger.warning(f"Failed to save {dir_name}/{file_name}: {e}")
+                        else:
+                            logger.warning(f"Failed to download {dir_name}/{file_name}")
+
+            logger.info(f"Downloaded assets for {app_id} ({len(asset_dirs)} directories)")
+            return True, None
+
+        except Exception as e:
+            logger.exception(f"Error downloading assets for {app_id}: {e}")
+            return False, f"Error downloading assets: {e}"
+
+    def search_apps(self, query: str, apps_with_metadata: List[Dict[str, Any]]) -> List[Dict[str, Any]]:
+        """
+        Search apps by name, summary, or description.
+
+        Args:
+            query: Search query string
+            apps_with_metadata: List of apps with metadata
+
+        Returns:
+            Filtered list of apps matching query
+        """
+        if not query:
+            return apps_with_metadata
+
+        query_lower = query.lower()
+        results = []
+
+        for app in apps_with_metadata:
+            # Search in name, summary, description, author
+            searchable = ' '.join([
+                app.get('name', ''),
+                app.get('summary', ''),
+                app.get('desc', ''),
+                app.get('author', ''),
+                app.get('id', '')
+            ]).lower()
+
+            if query_lower in searchable:
+                results.append(app)
+
+        return results
+
+    def filter_by_category(self, category: str, apps_with_metadata: List[Dict[str, Any]]) -> List[Dict[str, Any]]:
+        """
+        Filter apps by category.
+
+        Args:
+            category: Category name (or 'all' for no filtering)
+            apps_with_metadata: List of apps with metadata
+
+        Returns:
+            Filtered list of apps
+        """
+        if not category or category.lower() == 'all':
+            return apps_with_metadata
+
+        category_lower = category.lower()
+        results = []
+
+        for app in apps_with_metadata:
+            app_category = app.get('category', '').lower()
+            if app_category == category_lower:
+                results.append(app)
+
+        return results
+
+    def get_rate_limit_info(self) -> Dict[str, Any]:
+        """
+        Get current GitHub API rate limit information.
+
+        Returns:
+            Dictionary with rate limit info
+        """
+        url = f"{self.base_url}/rate_limit"
+        data = self._make_request(url)
+
+        if data:
+            core = data.get('resources', {}).get('core', {})
+            return {
+                'limit': core.get('limit', 0),
+                'remaining': core.get('remaining', 0),
+                'reset': core.get('reset', 0),
+                'used': core.get('used', 0)
+            }
+
+        return {
+            'limit': 0,
+            'remaining': 0,
+            'reset': 0,
+            'used': 0
+        }

scripts/download_pixlet.sh

@@ -0,0 +1,139 @@
+#!/bin/bash
+#
+# Download Pixlet binaries for bundled distribution
+#
+# This script downloads Pixlet binaries from the Tronbyte fork
+# for multiple architectures to support various platforms.
+
+set -e
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+PROJECT_ROOT="$(dirname "$SCRIPT_DIR")"
+BIN_DIR="$PROJECT_ROOT/bin/pixlet"
+
+# Pixlet version to download (use 'latest' to auto-detect)
+PIXLET_VERSION="${PIXLET_VERSION:-latest}"
+
+# GitHub repository (Tronbyte fork)
+REPO="tronbyt/pixlet"
+
+echo "========================================"
+echo "Pixlet Binary Download Script"
+echo "========================================"
+
+# Auto-detect latest version if needed
+if [ "$PIXLET_VERSION" = "latest" ]; then
+    echo "Detecting latest version..."
+    PIXLET_VERSION=$(curl -s "https://api.github.com/repos/${REPO}/releases/latest" | grep '"tag_name"' | sed -E 's/.*"([^"]+)".*/\1/')
+    if [ -z "$PIXLET_VERSION" ]; then
+        echo "Failed to detect latest version, using fallback"
+        PIXLET_VERSION="v0.50.2"
+    fi
+fi
+
+echo "Version: $PIXLET_VERSION"
+echo "Target directory: $BIN_DIR"
+echo ""
+
+# Create bin directory if it doesn't exist
+mkdir -p "$BIN_DIR"
+
+# New naming convention: pixlet_v0.50.2_linux-arm64.tar.gz
+# Only download ARM64 Linux binary for Raspberry Pi
+declare -A ARCHITECTURES=(
+    ["linux-arm64"]="pixlet_${PIXLET_VERSION}_linux-arm64.tar.gz"
+)
+
+download_binary() {
+    local arch="$1"
+    local archive_name="$2"
+    local binary_name="pixlet-${arch}"
+
+    local output_path="$BIN_DIR/$binary_name"
+
+    # Skip if already exists
+    if [ -f "$output_path" ]; then
+        echo "✓ $binary_name already exists, skipping..."
+        return 0
+    fi
+
+    echo "→ Downloading $arch..."
+
+    # Construct download URL
+    local url="https://github.com/${REPO}/releases/download/${PIXLET_VERSION}/${archive_name}"
+
+    # Download to temp directory (use project-local temp to avoid /tmp permission issues)
+    local temp_dir
+    temp_dir=$(mktemp -d -p "$PROJECT_ROOT" -t pixlet_download.XXXXXXXXXX)
+    local temp_file="$temp_dir/$archive_name"
+
+    if ! curl -L -o "$temp_file" "$url" 2>/dev/null; then
+        echo "✗ Failed to download $arch"
+        rm -rf "$temp_dir"
+        return 1
+    fi
+
+    # Extract binary
+    echo "  Extracting..."
+    if ! tar -xzf "$temp_file" -C "$temp_dir"; then
+        echo "✗ Failed to extract archive: $temp_file"
+        rm -rf "$temp_dir"
+        return 1
+    fi
+
+    # Find the pixlet binary in extracted files
+    local extracted_binary
+    extracted_binary=$(find "$temp_dir" -name "pixlet" | head -n 1)
+
+    if [ -z "$extracted_binary" ]; then
+        echo "✗ Binary not found in archive"
+        rm -rf "$temp_dir"
+        return 1
+    fi
+
+    # Move to final location
+    mv "$extracted_binary" "$output_path"
+
+    # Make executable
+    chmod +x "$output_path"
+
+    # Clean up
+    rm -rf "$temp_dir"
+
+    # Verify
+    local size
+    size=$(stat -f%z "$output_path" 2>/dev/null || stat -c%s "$output_path" 2>/dev/null || echo "unknown")
+    if [ "$size" = "unknown" ]; then
+        echo "✓ Downloaded $binary_name"
+    else
+        echo "✓ Downloaded $binary_name ($(numfmt --to=iec-i --suffix=B $size 2>/dev/null || echo "${size} bytes"))"
+    fi
+
+    return 0
+}
+
+# Download binaries for each architecture
+success_count=0
+total_count=${#ARCHITECTURES[@]}
+
+for arch in "${!ARCHITECTURES[@]}"; do
+    if download_binary "$arch" "${ARCHITECTURES[$arch]}"; then
+        ((success_count++))
+    fi
+done
+
+echo ""
+echo "========================================"
+echo "Download complete: $success_count/$total_count succeeded"
+echo "========================================"
+
+# List downloaded binaries
+echo ""
+echo "Installed binaries:"
+if compgen -G "$BIN_DIR/*" > /dev/null 2>&1; then
+    ls -lh "$BIN_DIR"/*
+else
+    echo "No binaries found"
+fi
+
+exit 0

web_interface/blueprints/api_v3.py

@@ -10,6 +10,7 @@ import uuid
 import logging
 from datetime import datetime
 from pathlib import Path
+from typing import Optional, Tuple, Dict, Any, Type
 
 logger = logging.getLogger(__name__)
 
@@ -1852,6 +1853,55 @@ def get_installed_plugins():
                 'vegas_content_type': vegas_content_type
             })
 
+        # Append virtual entries for installed Starlark apps
+        starlark_plugin = _get_starlark_plugin()
+        if starlark_plugin and hasattr(starlark_plugin, 'apps'):
+            for app_id, app in starlark_plugin.apps.items():
+                plugins.append({
+                    'id': f'starlark:{app_id}',
+                    'name': app.manifest.get('name', app_id),
+                    'version': 'starlark',
+                    'author': app.manifest.get('author', 'Tronbyte Community'),
+                    'category': 'Starlark App',
+                    'description': app.manifest.get('summary', 'Starlark app'),
+                    'tags': ['starlark'],
+                    'enabled': app.is_enabled(),
+                    'verified': False,
+                    'loaded': True,
+                    'last_updated': None,
+                    'last_commit': None,
+                    'last_commit_message': None,
+                    'branch': None,
+                    'web_ui_actions': [],
+                    'vegas_mode': 'fixed',
+                    'vegas_content_type': 'multi',
+                    'is_starlark_app': True,
+                })
+        else:
+            # Standalone: read from manifest on disk
+            manifest = _read_starlark_manifest()
+            for app_id, app_data in manifest.get('apps', {}).items():
+                plugins.append({
+                    'id': f'starlark:{app_id}',
+                    'name': app_data.get('name', app_id),
+                    'version': 'starlark',
+                    'author': 'Tronbyte Community',
+                    'category': 'Starlark App',
+                    'description': 'Starlark app',
+                    'tags': ['starlark'],
+                    'enabled': app_data.get('enabled', True),
+                    'verified': False,
+                    'loaded': False,
+                    'last_updated': None,
+                    'last_commit': None,
+                    'last_commit_message': None,
+                    'branch': None,
+                    'web_ui_actions': [],
+                    'vegas_mode': 'fixed',
+                    'vegas_content_type': 'multi',
+                    'is_starlark_app': True,
+                })
+
         return jsonify({'status': 'success', 'data': {'plugins': plugins}})
     except Exception as e:
         import traceback
@@ -2127,6 +2177,28 @@ def toggle_plugin():
                 current_enabled = config.get(plugin_id, {}).get('enabled', False)
                 enabled = not current_enabled
 
+        # Handle starlark app toggle (starlark:<app_id> prefix)
+        if plugin_id.startswith('starlark:'):
+            starlark_app_id = plugin_id[len('starlark:'):]
+            starlark_plugin = _get_starlark_plugin()
+            if starlark_plugin and starlark_app_id in starlark_plugin.apps:
+                app = starlark_plugin.apps[starlark_app_id]
+                app.manifest['enabled'] = enabled
+                # Use safe manifest update to prevent race conditions
+                def update_fn(manifest):
+                    manifest['apps'][starlark_app_id]['enabled'] = enabled
+                starlark_plugin._update_manifest_safe(update_fn)
+            else:
+                # Standalone: update manifest directly
+                manifest = _read_starlark_manifest()
+                app_data = manifest.get('apps', {}).get(starlark_app_id)
+                if not app_data:
+                    return jsonify({'status': 'error', 'message': f'Starlark app not found: {starlark_app_id}'}), 404
+                app_data['enabled'] = enabled
+                if not _write_starlark_manifest(manifest):
+                    return jsonify({'status': 'error', 'message': 'Failed to save manifest'}), 500
+            return jsonify({'status': 'success', 'message': f"Starlark app {'enabled' if enabled else 'disabled'}", 'enabled': enabled})
+
         # Check if plugin exists in manifests (discovered but may not be loaded)
         if plugin_id not in api_v3.plugin_manager.plugin_manifests:
             return jsonify({'status': 'error', 'message': f'Plugin {plugin_id} not found'}), 404
@@ -6903,4 +6975,867 @@ def clear_old_errors():
             message="Failed to clear old errors",
             details=str(e),
             status_code=500
-        )
+        )
+
+
+# ─── Starlark Apps API ──────────────────────────────────────────────────────
+
+def _get_tronbyte_repository_class() -> Type[Any]:
+    """Import TronbyteRepository from plugin-repos directory."""
+    import importlib.util
+    import importlib
+
+    module_path = PROJECT_ROOT / 'plugin-repos' / 'starlark-apps' / 'tronbyte_repository.py'
+    if not module_path.exists():
+        raise ImportError(f"TronbyteRepository module not found at {module_path}")
+
+    # If already imported, reload to pick up code changes
+    if "tronbyte_repository" in sys.modules:
+        importlib.reload(sys.modules["tronbyte_repository"])
+        return sys.modules["tronbyte_repository"].TronbyteRepository
+
+    spec = importlib.util.spec_from_file_location("tronbyte_repository", str(module_path))
+    if spec is None:
+        raise ImportError(f"Failed to create module spec for tronbyte_repository at {module_path}")
+
+    module = importlib.util.module_from_spec(spec)
+    if module is None:
+        raise ImportError(f"Failed to create module from spec for tronbyte_repository")
+
+    sys.modules["tronbyte_repository"] = module
+    spec.loader.exec_module(module)
+    return module.TronbyteRepository
+
+
+def _get_pixlet_renderer_class() -> Type[Any]:
+    """Import PixletRenderer from plugin-repos directory."""
+    import importlib.util
+    import importlib
+
+    module_path = PROJECT_ROOT / 'plugin-repos' / 'starlark-apps' / 'pixlet_renderer.py'
+    if not module_path.exists():
+        raise ImportError(f"PixletRenderer module not found at {module_path}")
+
+    # If already imported, reload to pick up code changes
+    if "pixlet_renderer" in sys.modules:
+        importlib.reload(sys.modules["pixlet_renderer"])
+        return sys.modules["pixlet_renderer"].PixletRenderer
+
+    spec = importlib.util.spec_from_file_location("pixlet_renderer", str(module_path))
+    if spec is None:
+        raise ImportError(f"Failed to create module spec for pixlet_renderer at {module_path}")
+
+    module = importlib.util.module_from_spec(spec)
+    if module is None:
+        raise ImportError(f"Failed to create module from spec for pixlet_renderer")
+
+    sys.modules["pixlet_renderer"] = module
+    spec.loader.exec_module(module)
+    return module.PixletRenderer
+
+
+def _validate_and_sanitize_app_id(app_id: Optional[str], fallback_source: Optional[str] = None) -> Tuple[Optional[str], Optional[str]]:
+    """Validate and sanitize app_id to a safe slug."""
+    if not app_id and fallback_source:
+        app_id = fallback_source
+    if not app_id:
+        return None, "app_id is required"
+    if '..' in app_id or '/' in app_id or '\\' in app_id:
+        return None, "app_id contains invalid characters"
+
+    sanitized = re.sub(r'[^a-z0-9_]', '_', app_id.lower()).strip('_')
+    if not sanitized:
+        sanitized = f"app_{hashlib.sha256(app_id.encode()).hexdigest()[:12]}"
+    if sanitized[0].isdigit():
+        sanitized = f"app_{sanitized}"
+    return sanitized, None
+
+
+def _validate_timing_value(value: Any, field_name: str, min_val: int = 1, max_val: int = 86400) -> Tuple[Optional[int], Optional[str]]:
+    """Validate and coerce timing values."""
+    if value is None:
+        return None, None
+    try:
+        int_value = int(value)
+    except (ValueError, TypeError):
+        return None, f"{field_name} must be an integer"
+    if int_value < min_val:
+        return None, f"{field_name} must be at least {min_val}"
+    if int_value > max_val:
+        return None, f"{field_name} must be at most {max_val}"
+    return int_value, None
+
+
+def _get_starlark_plugin() -> Optional[Any]:
+    """Get the starlark-apps plugin instance, or None."""
+    if not api_v3.plugin_manager:
+        return None
+    return api_v3.plugin_manager.get_plugin('starlark-apps')
+
+
+# Starlark standalone helpers for web service (plugin not loaded)
+_STARLARK_APPS_DIR = PROJECT_ROOT / 'starlark-apps'
+_STARLARK_MANIFEST_FILE = _STARLARK_APPS_DIR / 'manifest.json'
+
+
+def _read_starlark_manifest() -> Dict[str, Any]:
+    """Read the starlark-apps manifest.json directly from disk."""
+    try:
+        if _STARLARK_MANIFEST_FILE.exists():
+            with open(_STARLARK_MANIFEST_FILE, 'r') as f:
+                return json.load(f)
+    except (json.JSONDecodeError, OSError) as e:
+        logger.error(f"Error reading starlark manifest: {e}")
+    return {'apps': {}}
+
+
+def _write_starlark_manifest(manifest: Dict[str, Any]) -> bool:
+    """Write the starlark-apps manifest.json to disk with atomic write."""
+    temp_file = None
+    try:
+        _STARLARK_APPS_DIR.mkdir(parents=True, exist_ok=True)
+
+        # Atomic write pattern: write to temp file, then rename
+        temp_file = _STARLARK_MANIFEST_FILE.with_suffix('.tmp')
+        with open(temp_file, 'w') as f:
+            json.dump(manifest, f, indent=2)
+            f.flush()
+            os.fsync(f.fileno())  # Ensure data is written to disk
+
+        # Atomic rename (overwrites destination)
+        temp_file.replace(_STARLARK_MANIFEST_FILE)
+        return True
+    except OSError as e:
+        logger.error(f"Error writing starlark manifest: {e}")
+        # Clean up temp file if it exists
+        if temp_file and temp_file.exists():
+            try:
+                temp_file.unlink()
+            except Exception:
+                pass
+        return False
+
+
+def _install_star_file(app_id: str, star_file_path: str, metadata: Dict[str, Any], assets_dir: Optional[str] = None) -> bool:
+    """Install a .star file and update the manifest (standalone, no plugin needed)."""
+    import shutil
+    import json
+    app_dir = _STARLARK_APPS_DIR / app_id
+    app_dir.mkdir(parents=True, exist_ok=True)
+    dest = app_dir / f"{app_id}.star"
+    shutil.copy2(star_file_path, str(dest))
+
+    # Copy asset directories if provided (images/, sources/, etc.)
+    if assets_dir and Path(assets_dir).exists():
+        assets_path = Path(assets_dir)
+        for item in assets_path.iterdir():
+            if item.is_dir():
+                # Copy entire directory (e.g., images/, sources/)
+                dest_dir = app_dir / item.name
+                if dest_dir.exists():
+                    shutil.rmtree(dest_dir)
+                shutil.copytree(item, dest_dir)
+                logger.debug(f"Copied assets directory: {item.name}")
+        logger.info(f"Installed assets for {app_id}")
+
+    # Try to extract schema using PixletRenderer
+    schema = None
+    try:
+        PixletRenderer = _get_pixlet_renderer_class()
+        pixlet = PixletRenderer()
+        if pixlet.is_available():
+            _, schema, _ = pixlet.extract_schema(str(dest))
+            if schema:
+                schema_path = app_dir / "schema.json"
+                with open(schema_path, 'w') as f:
+                    json.dump(schema, f, indent=2)
+                logger.info(f"Extracted schema for {app_id}")
+    except Exception as e:
+        logger.warning(f"Failed to extract schema for {app_id}: {e}")
+
+    # Create default config — pre-populate with schema defaults
+    default_config = {}
+    if schema:
+        fields = schema.get('fields') or schema.get('schema') or []
+        for field in fields:
+            if isinstance(field, dict) and 'id' in field and 'default' in field:
+                default_config[field['id']] = field['default']
+
+    # Create config.json file
+    config_path = app_dir / "config.json"
+    with open(config_path, 'w') as f:
+        json.dump(default_config, f, indent=2)
+
+    manifest = _read_starlark_manifest()
+    manifest.setdefault('apps', {})[app_id] = {
+        'name': metadata.get('name', app_id),
+        'enabled': True,
+        'render_interval': metadata.get('render_interval', 300),
+        'display_duration': metadata.get('display_duration', 15),
+        'config': metadata.get('config', {}),
+        'star_file': str(dest),
+    }
+    return _write_starlark_manifest(manifest)
+
+
+@api_v3.route('/starlark/status', methods=['GET'])
+def get_starlark_status():
+    """Get Starlark plugin status and Pixlet availability."""
+    try:
+        if not api_v3.plugin_manager:
+            return jsonify({'status': 'error', 'message': 'Plugin manager not initialized', 'pixlet_available': False}), 500
+
+        starlark_plugin = _get_starlark_plugin()
+        if starlark_plugin:
+            info = starlark_plugin.get_info()
+            magnify_info = starlark_plugin.get_magnify_recommendation()
+            return jsonify({
+                'status': 'success',
+                'pixlet_available': info.get('pixlet_available', False),
+                'pixlet_version': info.get('pixlet_version'),
+                'installed_apps': info.get('installed_apps', 0),
+                'enabled_apps': info.get('enabled_apps', 0),
+                'current_app': info.get('current_app'),
+                'plugin_enabled': starlark_plugin.enabled,
+                'display_info': magnify_info
+            })
+
+        # Plugin not loaded - check Pixlet availability directly
+        import shutil
+        import platform
+
+        system = platform.system().lower()
+        machine = platform.machine().lower()
+        bin_dir = PROJECT_ROOT / 'bin' / 'pixlet'
+
+        pixlet_binary = None
+        if system == "linux":
+            if "aarch64" in machine or "arm64" in machine:
+                pixlet_binary = bin_dir / "pixlet-linux-arm64"
+            elif "x86_64" in machine or "amd64" in machine:
+                pixlet_binary = bin_dir / "pixlet-linux-amd64"
+        elif system == "darwin":
+            pixlet_binary = bin_dir / ("pixlet-darwin-arm64" if "arm64" in machine else "pixlet-darwin-amd64")
+
+        pixlet_available = (pixlet_binary and pixlet_binary.exists()) or shutil.which('pixlet') is not None
+
+        # Read app counts from manifest
+        manifest = _read_starlark_manifest()
+        apps = manifest.get('apps', {})
+        installed_count = len(apps)
+        enabled_count = sum(1 for a in apps.values() if a.get('enabled', True))
+
+        return jsonify({
+            'status': 'success',
+            'pixlet_available': pixlet_available,
+            'pixlet_version': None,
+            'installed_apps': installed_count,
+            'enabled_apps': enabled_count,
+            'plugin_enabled': True,
+            'plugin_loaded': False,
+            'display_info': {}
+        })
+
+    except Exception as e:
+        logger.error(f"Error getting starlark status: {e}")
+        return jsonify({'status': 'error', 'message': str(e)}), 500
+
+
+@api_v3.route('/starlark/apps', methods=['GET'])
+def get_starlark_apps():
+    """List all installed Starlark apps."""
+    try:
+        starlark_plugin = _get_starlark_plugin()
+        if starlark_plugin:
+            apps_list = []
+            for app_id, app_instance in starlark_plugin.apps.items():
+                apps_list.append({
+                    'id': app_id,
+                    'name': app_instance.manifest.get('name', app_id),
+                    'enabled': app_instance.is_enabled(),
+                    'has_frames': app_instance.frames is not None,
+                    'render_interval': app_instance.get_render_interval(),
+                    'display_duration': app_instance.get_display_duration(),
+                    'config': app_instance.config,
+                    'has_schema': app_instance.schema is not None,
+                    'last_render_time': app_instance.last_render_time
+                })
+            return jsonify({'status': 'success', 'apps': apps_list, 'count': len(apps_list)})
+
+        # Standalone: read manifest from disk
+        manifest = _read_starlark_manifest()
+        apps_list = []
+        for app_id, app_data in manifest.get('apps', {}).items():
+            apps_list.append({
+                'id': app_id,
+                'name': app_data.get('name', app_id),
+                'enabled': app_data.get('enabled', True),
+                'has_frames': False,
+                'render_interval': app_data.get('render_interval', 300),
+                'display_duration': app_data.get('display_duration', 15),
+                'config': app_data.get('config', {}),
+                'has_schema': False,
+                'last_render_time': None
+            })
+        return jsonify({'status': 'success', 'apps': apps_list, 'count': len(apps_list)})
+
+    except Exception as e:
+        logger.error(f"Error getting starlark apps: {e}")
+        return jsonify({'status': 'error', 'message': str(e)}), 500
+
+
+@api_v3.route('/starlark/apps/<app_id>', methods=['GET'])
+def get_starlark_app(app_id):
+    """Get details for a specific Starlark app."""
+    try:
+        starlark_plugin = _get_starlark_plugin()
+        if starlark_plugin:
+            app = starlark_plugin.apps.get(app_id)
+            if not app:
+                return jsonify({'status': 'error', 'message': f'App not found: {app_id}'}), 404
+            return jsonify({
+                'status': 'success',
+                'app': {
+                    'id': app_id,
+                    'name': app.manifest.get('name', app_id),
+                    'enabled': app.is_enabled(),
+                    'config': app.config,
+                    'schema': app.schema,
+                    'render_interval': app.get_render_interval(),
+                    'display_duration': app.get_display_duration(),
+                    'has_frames': app.frames is not None,
+                    'frame_count': len(app.frames) if app.frames else 0,
+                    'last_render_time': app.last_render_time,
+                }
+            })
+
+        # Standalone: read from manifest
+        manifest = _read_starlark_manifest()
+        app_data = manifest.get('apps', {}).get(app_id)
+        if not app_data:
+            return jsonify({'status': 'error', 'message': f'App not found: {app_id}'}), 404
+
+        # Load schema from schema.json if it exists
+        schema = None
+        schema_file = _STARLARK_APPS_DIR / app_id / 'schema.json'
+        if schema_file.exists():
+            try:
+                with open(schema_file, 'r') as f:
+                    schema = json.load(f)
+            except Exception as e:
+                logger.warning(f"Failed to load schema for {app_id}: {e}")
+
+        return jsonify({
+            'status': 'success',
+            'app': {
+                'id': app_id,
+                'name': app_data.get('name', app_id),
+                'enabled': app_data.get('enabled', True),
+                'config': app_data.get('config', {}),
+                'schema': schema,
+                'render_interval': app_data.get('render_interval', 300),
+                'display_duration': app_data.get('display_duration', 15),
+                'has_frames': False,
+                'frame_count': 0,
+                'last_render_time': None,
+            }
+        })
+
+    except Exception as e:
+        logger.error(f"Error getting starlark app {app_id}: {e}")
+        return jsonify({'status': 'error', 'message': str(e)}), 500
+
+
+@api_v3.route('/starlark/upload', methods=['POST'])
+def upload_starlark_app():
+    """Upload and install a new Starlark app."""
+    try:
+        if 'file' not in request.files:
+            return jsonify({'status': 'error', 'message': 'No file uploaded'}), 400
+
+        file = request.files['file']
+        if not file.filename or not file.filename.endswith('.star'):
+            return jsonify({'status': 'error', 'message': 'File must have .star extension'}), 400
+
+        # Check file size (limit to 5MB for .star files)
+        file.seek(0, 2)  # Seek to end
+        file_size = file.tell()
+        file.seek(0)  # Reset to beginning
+        MAX_STAR_SIZE = 5 * 1024 * 1024  # 5MB
+        if file_size > MAX_STAR_SIZE:
+            return jsonify({'status': 'error', 'message': f'File too large (max 5MB, got {file_size/1024/1024:.1f}MB)'}), 400
+
+        app_name = request.form.get('name')
+        app_id_input = request.form.get('app_id')
+        filename_base = file.filename.replace('.star', '') if file.filename else None
+        app_id, app_id_error = _validate_and_sanitize_app_id(app_id_input, fallback_source=filename_base)
+        if app_id_error:
+            return jsonify({'status': 'error', 'message': f'Invalid app_id: {app_id_error}'}), 400
+
+        render_interval_input = request.form.get('render_interval')
+        render_interval = 300
+        if render_interval_input is not None:
+            render_interval, err = _validate_timing_value(render_interval_input, 'render_interval')
+            if err:
+                return jsonify({'status': 'error', 'message': err}), 400
+            render_interval = render_interval or 300
+
+        display_duration_input = request.form.get('display_duration')
+        display_duration = 15
+        if display_duration_input is not None:
+            display_duration, err = _validate_timing_value(display_duration_input, 'display_duration')
+            if err:
+                return jsonify({'status': 'error', 'message': err}), 400
+            display_duration = display_duration or 15
+
+        import tempfile
+        with tempfile.NamedTemporaryFile(delete=False, suffix='.star') as tmp:
+            file.save(tmp.name)
+            temp_path = tmp.name
+
+        try:
+            metadata = {'name': app_name or app_id, 'render_interval': render_interval, 'display_duration': display_duration}
+            starlark_plugin = _get_starlark_plugin()
+            if starlark_plugin:
+                success = starlark_plugin.install_app(app_id, temp_path, metadata)
+            else:
+                success = _install_star_file(app_id, temp_path, metadata)
+            if success:
+                return jsonify({'status': 'success', 'message': f'App installed: {app_id}', 'app_id': app_id})
+            else:
+                return jsonify({'status': 'error', 'message': 'Failed to install app'}), 500
+        finally:
+            try:
+                os.unlink(temp_path)
+            except OSError:
+                pass
+
+    except Exception as e:
+        logger.error(f"Error uploading starlark app: {e}")
+        return jsonify({'status': 'error', 'message': str(e)}), 500
+
+
+@api_v3.route('/starlark/apps/<app_id>', methods=['DELETE'])
+def uninstall_starlark_app(app_id):
+    """Uninstall a Starlark app."""
+    try:
+        starlark_plugin = _get_starlark_plugin()
+        if starlark_plugin:
+            success = starlark_plugin.uninstall_app(app_id)
+        else:
+            # Standalone: remove app dir and manifest entry
+            import shutil
+            app_dir = (_STARLARK_APPS_DIR / app_id).resolve()
+
+            # Path traversal check - ensure app_dir is within _STARLARK_APPS_DIR
+            try:
+                app_dir.relative_to(_STARLARK_APPS_DIR.resolve())
+            except ValueError:
+                logger.warning(f"Path traversal attempt in uninstall: {app_id}")
+                return jsonify({'status': 'error', 'message': 'Invalid app_id'}), 400
+
+            if app_dir.exists():
+                shutil.rmtree(app_dir)
+            manifest = _read_starlark_manifest()
+            manifest.get('apps', {}).pop(app_id, None)
+            success = _write_starlark_manifest(manifest)
+
+        if success:
+            return jsonify({'status': 'success', 'message': f'App uninstalled: {app_id}'})
+        else:
+            return jsonify({'status': 'error', 'message': 'Failed to uninstall app'}), 500
+
+    except Exception as e:
+        logger.error(f"Error uninstalling starlark app {app_id}: {e}")
+        return jsonify({'status': 'error', 'message': str(e)}), 500
+
+
+@api_v3.route('/starlark/apps/<app_id>/config', methods=['GET'])
+def get_starlark_app_config(app_id):
+    """Get configuration for a Starlark app."""
+    try:
+        starlark_plugin = _get_starlark_plugin()
+        if starlark_plugin:
+            app = starlark_plugin.apps.get(app_id)
+            if not app:
+                return jsonify({'status': 'error', 'message': f'App not found: {app_id}'}), 404
+            return jsonify({'status': 'success', 'config': app.config, 'schema': app.schema})
+
+        # Standalone: read from config.json file
+        app_dir = _STARLARK_APPS_DIR / app_id
+        config_file = app_dir / "config.json"
+
+        if not app_dir.exists():
+            return jsonify({'status': 'error', 'message': f'App not found: {app_id}'}), 404
+
+        config = {}
+        if config_file.exists():
+            try:
+                with open(config_file, 'r') as f:
+                    config = json.load(f)
+            except Exception as e:
+                logger.warning(f"Failed to load config for {app_id}: {e}")
+
+        # Load schema from schema.json
+        schema = None
+        schema_file = app_dir / "schema.json"
+        if schema_file.exists():
+            try:
+                with open(schema_file, 'r') as f:
+                    schema = json.load(f)
+            except Exception as e:
+                logger.warning(f"Failed to load schema for {app_id}: {e}")
+
+        return jsonify({'status': 'success', 'config': config, 'schema': schema})
+
+    except Exception as e:
+        logger.error(f"Error getting config for {app_id}: {e}")
+        return jsonify({'status': 'error', 'message': str(e)}), 500
+
+
+@api_v3.route('/starlark/apps/<app_id>/config', methods=['PUT'])
+def update_starlark_app_config(app_id):
+    """Update configuration for a Starlark app."""
+    try:
+        data = request.get_json()
+        if not data:
+            return jsonify({'status': 'error', 'message': 'No configuration provided'}), 400
+
+        if 'render_interval' in data:
+            val, err = _validate_timing_value(data['render_interval'], 'render_interval')
+            if err:
+                return jsonify({'status': 'error', 'message': err}), 400
+            data['render_interval'] = val
+
+        if 'display_duration' in data:
+            val, err = _validate_timing_value(data['display_duration'], 'display_duration')
+            if err:
+                return jsonify({'status': 'error', 'message': err}), 400
+            data['display_duration'] = val
+
+        starlark_plugin = _get_starlark_plugin()
+        if starlark_plugin:
+            app = starlark_plugin.apps.get(app_id)
+            if not app:
+                return jsonify({'status': 'error', 'message': f'App not found: {app_id}'}), 404
+
+            # Extract timing keys from data before updating config (they belong in manifest, not config)
+            render_interval = data.pop('render_interval', None)
+            display_duration = data.pop('display_duration', None)
+
+            # Update config with non-timing fields only
+            app.config.update(data)
+
+            # Update manifest with timing fields
+            timing_changed = False
+            if render_interval is not None:
+                app.manifest['render_interval'] = render_interval
+                timing_changed = True
+            if display_duration is not None:
+                app.manifest['display_duration'] = display_duration
+                timing_changed = True
+            if app.save_config():
+                # Persist manifest if timing changed (same pattern as toggle endpoint)
+                if timing_changed:
+                    try:
+                        # Use safe manifest update to prevent race conditions
+                        timing_updates = {}
+                        if render_interval is not None:
+                            timing_updates['render_interval'] = render_interval
+                        if display_duration is not None:
+                            timing_updates['display_duration'] = display_duration
+
+                        def update_fn(manifest):
+                            manifest['apps'][app_id].update(timing_updates)
+                        starlark_plugin._update_manifest_safe(update_fn)
+                    except Exception as e:
+                        logger.warning(f"Failed to persist timing to manifest for {app_id}: {e}")
+                starlark_plugin._render_app(app, force=True)
+                return jsonify({'status': 'success', 'message': 'Configuration updated', 'config': app.config})
+            else:
+                return jsonify({'status': 'error', 'message': 'Failed to save configuration'}), 500
+
+        # Standalone: update both config.json and manifest
+        manifest = _read_starlark_manifest()
+        app_data = manifest.get('apps', {}).get(app_id)
+        if not app_data:
+            return jsonify({'status': 'error', 'message': f'App not found: {app_id}'}), 404
+
+        # Extract timing keys (they go in manifest, not config.json)
+        render_interval = data.pop('render_interval', None)
+        display_duration = data.pop('display_duration', None)
+
+        # Update manifest with timing values
+        if render_interval is not None:
+            app_data['render_interval'] = render_interval
+        if display_duration is not None:
+            app_data['display_duration'] = display_duration
+
+        # Load current config from config.json
+        app_dir = _STARLARK_APPS_DIR / app_id
+        config_file = app_dir / "config.json"
+        current_config = {}
+        if config_file.exists():
+            try:
+                with open(config_file, 'r') as f:
+                    current_config = json.load(f)
+            except Exception as e:
+                logger.warning(f"Failed to load config for {app_id}: {e}")
+
+        # Update config with new values (excluding timing keys)
+        current_config.update(data)
+
+        # Write updated config to config.json
+        try:
+            with open(config_file, 'w') as f:
+                json.dump(current_config, f, indent=2)
+        except Exception as e:
+            logger.error(f"Failed to save config.json for {app_id}: {e}")
+            return jsonify({'status': 'error', 'message': f'Failed to save configuration: {e}'}), 500
+
+        # Also update manifest for backward compatibility
+        app_data.setdefault('config', {}).update(data)
+
+        if _write_starlark_manifest(manifest):
+            return jsonify({'status': 'success', 'message': 'Configuration updated', 'config': current_config})
+        else:
+            return jsonify({'status': 'error', 'message': 'Failed to save manifest'}), 500
+
+    except Exception as e:
+        logger.error(f"Error updating config for {app_id}: {e}")
+        return jsonify({'status': 'error', 'message': str(e)}), 500
+
+
+@api_v3.route('/starlark/apps/<app_id>/toggle', methods=['POST'])
+def toggle_starlark_app(app_id):
+    """Enable or disable a Starlark app."""
+    try:
+        data = request.get_json() or {}
+
+        starlark_plugin = _get_starlark_plugin()
+        if starlark_plugin:
+            app = starlark_plugin.apps.get(app_id)
+            if not app:
+                return jsonify({'status': 'error', 'message': f'App not found: {app_id}'}), 404
+            enabled = data.get('enabled')
+            if enabled is None:
+                enabled = not app.is_enabled()
+            app.manifest['enabled'] = enabled
+            # Use safe manifest update to prevent race conditions
+            def update_fn(manifest):
+                manifest['apps'][app_id]['enabled'] = enabled
+            starlark_plugin._update_manifest_safe(update_fn)
+            return jsonify({'status': 'success', 'message': f"App {'enabled' if enabled else 'disabled'}", 'enabled': enabled})
+
+        # Standalone: update manifest directly
+        manifest = _read_starlark_manifest()
+        app_data = manifest.get('apps', {}).get(app_id)
+        if not app_data:
+            return jsonify({'status': 'error', 'message': f'App not found: {app_id}'}), 404
+
+        enabled = data.get('enabled')
+        if enabled is None:
+            enabled = not app_data.get('enabled', True)
+        app_data['enabled'] = enabled
+        if _write_starlark_manifest(manifest):
+            return jsonify({'status': 'success', 'message': f"App {'enabled' if enabled else 'disabled'}", 'enabled': enabled})
+        else:
+            return jsonify({'status': 'error', 'message': 'Failed to save'}), 500
+
+    except Exception as e:
+        logger.error(f"Error toggling app {app_id}: {e}")
+        return jsonify({'status': 'error', 'message': str(e)}), 500
+
+
+@api_v3.route('/starlark/apps/<app_id>/render', methods=['POST'])
+def render_starlark_app(app_id):
+    """Force render a Starlark app."""
+    try:
+        starlark_plugin = _get_starlark_plugin()
+        if not starlark_plugin:
+            return jsonify({'status': 'error', 'message': 'Rendering requires the main LEDMatrix service (plugin not loaded in web service)'}), 503
+
+        app = starlark_plugin.apps.get(app_id)
+        if not app:
+            return jsonify({'status': 'error', 'message': f'App not found: {app_id}'}), 404
+
+        success = starlark_plugin._render_app(app, force=True)
+        if success:
+            return jsonify({'status': 'success', 'message': 'App rendered', 'frame_count': len(app.frames) if app.frames else 0})
+        else:
+            return jsonify({'status': 'error', 'message': 'Failed to render app'}), 500
+
+    except Exception as e:
+        logger.error(f"Error rendering app {app_id}: {e}")
+        return jsonify({'status': 'error', 'message': str(e)}), 500
+
+
+@api_v3.route('/starlark/repository/browse', methods=['GET'])
+def browse_tronbyte_repository():
+    """Browse all apps in the Tronbyte repository (bulk cached fetch).
+
+    Returns ALL apps with metadata, categories, and authors.
+    Filtering/sorting/pagination is handled client-side.
+    Results are cached server-side for 2 hours.
+    """
+    try:
+        TronbyteRepository = _get_tronbyte_repository_class()
+
+        config = api_v3.config_manager.load_config() if api_v3.config_manager else {}
+        github_token = config.get('github_token')
+        repo = TronbyteRepository(github_token=github_token)
+
+        result = repo.list_all_apps_cached()
+
+        rate_limit = repo.get_rate_limit_info()
+
+        return jsonify({
+            'status': 'success',
+            'apps': result['apps'],
+            'categories': result['categories'],
+            'authors': result['authors'],
+            'count': result['count'],
+            'cached': result['cached'],
+            'rate_limit': rate_limit,
+        })
+
+    except Exception as e:
+        logger.error(f"Error browsing repository: {e}")
+        return jsonify({'status': 'error', 'message': str(e)}), 500
+
+
+@api_v3.route('/starlark/repository/install', methods=['POST'])
+def install_from_tronbyte_repository():
+    """Install an app from the Tronbyte repository."""
+    try:
+        data = request.get_json()
+        if not data or 'app_id' not in data:
+            return jsonify({'status': 'error', 'message': 'app_id is required'}), 400
+
+        app_id, app_id_error = _validate_and_sanitize_app_id(data['app_id'])
+        if app_id_error:
+            return jsonify({'status': 'error', 'message': f'Invalid app_id: {app_id_error}'}), 400
+
+        TronbyteRepository = _get_tronbyte_repository_class()
+        import tempfile
+
+        config = api_v3.config_manager.load_config() if api_v3.config_manager else {}
+        github_token = config.get('github_token')
+        repo = TronbyteRepository(github_token=github_token)
+
+        success, metadata, error = repo.get_app_metadata(data['app_id'])
+        if not success:
+            return jsonify({'status': 'error', 'message': f'Failed to fetch app metadata: {error}'}), 404
+
+        with tempfile.NamedTemporaryFile(delete=False, suffix='.star') as tmp:
+            temp_path = tmp.name
+
+        try:
+            # Pass filename from metadata (e.g., "analog_clock.star" for analogclock app)
+            # Note: manifest uses 'fileName' (camelCase), not 'filename'
+            filename = metadata.get('fileName') if metadata else None
+            success, error = repo.download_star_file(data['app_id'], Path(temp_path), filename=filename)
+            if not success:
+                return jsonify({'status': 'error', 'message': f'Failed to download app: {error}'}), 500
+
+            # Download assets (images, sources, etc.) to a temp directory
+            import tempfile
+            temp_assets_dir = tempfile.mkdtemp()
+            try:
+                success_assets, error_assets = repo.download_app_assets(data['app_id'], Path(temp_assets_dir))
+                # Asset download is non-critical - log warning but continue if it fails
+                if not success_assets:
+                    logger.warning(f"Failed to download assets for {data['app_id']}: {error_assets}")
+
+                render_interval = data.get('render_interval', 300)
+                ri, err = _validate_timing_value(render_interval, 'render_interval')
+                if err:
+                    return jsonify({'status': 'error', 'message': err}), 400
+                render_interval = ri or 300
+
+                display_duration = data.get('display_duration', 15)
+                dd, err = _validate_timing_value(display_duration, 'display_duration')
+                if err:
+                    return jsonify({'status': 'error', 'message': err}), 400
+                display_duration = dd or 15
+
+                install_metadata = {
+                    'name': metadata.get('name', app_id) if metadata else app_id,
+                    'render_interval': render_interval,
+                    'display_duration': display_duration
+                }
+
+                starlark_plugin = _get_starlark_plugin()
+                if starlark_plugin:
+                    success = starlark_plugin.install_app(app_id, temp_path, install_metadata, assets_dir=temp_assets_dir)
+                else:
+                    success = _install_star_file(app_id, temp_path, install_metadata, assets_dir=temp_assets_dir)
+            finally:
+                # Clean up temp assets directory
+                import shutil
+                try:
+                    shutil.rmtree(temp_assets_dir)
+                except OSError:
+                    pass
+
+            if success:
+                return jsonify({'status': 'success', 'message': f'App installed: {metadata.get("name", app_id) if metadata else app_id}', 'app_id': app_id})
+            else:
+                return jsonify({'status': 'error', 'message': 'Failed to install app'}), 500
+        finally:
+            try:
+                os.unlink(temp_path)
+            except OSError:
+                pass
+
+    except Exception as e:
+        logger.error(f"Error installing from repository: {e}")
+        return jsonify({'status': 'error', 'message': str(e)}), 500
+
+
+@api_v3.route('/starlark/repository/categories', methods=['GET'])
+def get_tronbyte_categories():
+    """Get list of available app categories (uses bulk cache)."""
+    try:
+        TronbyteRepository = _get_tronbyte_repository_class()
+        config = api_v3.config_manager.load_config() if api_v3.config_manager else {}
+        repo = TronbyteRepository(github_token=config.get('github_token'))
+
+        result = repo.list_all_apps_cached()
+
+        return jsonify({'status': 'success', 'categories': result['categories']})
+
+    except Exception as e:
+        logger.error(f"Error fetching categories: {e}")
+        return jsonify({'status': 'error', 'message': str(e)}), 500
+
+
+@api_v3.route('/starlark/install-pixlet', methods=['POST'])
+def install_pixlet():
+    """Download and install Pixlet binary."""
+    try:
+        script_path = PROJECT_ROOT / 'scripts' / 'download_pixlet.sh'
+        if not script_path.exists():
+            return jsonify({'status': 'error', 'message': 'Installation script not found'}), 404
+
+        os.chmod(script_path, 0o755)
+
+        result = subprocess.run(
+            [str(script_path)],
+            cwd=str(PROJECT_ROOT),
+            capture_output=True,
+            text=True,
+            timeout=300
+        )
+
+        if result.returncode == 0:
+            logger.info("Pixlet downloaded successfully")
+            return jsonify({'status': 'success', 'message': 'Pixlet installed successfully!', 'output': result.stdout})
+        else:
+            return jsonify({'status': 'error', 'message': f'Failed to download Pixlet: {result.stderr}'}), 500
+
+    except subprocess.TimeoutExpired:
+        return jsonify({'status': 'error', 'message': 'Download timed out'}), 500
+    except Exception as e:
+        logger.error(f"Error installing Pixlet: {e}")
+        return jsonify({'status': 'error', 'message': str(e)}), 500

web_interface/blueprints/pages_v3.py

@@ -322,7 +322,11 @@ def _load_plugin_config_partial(plugin_id):
     try:
         if not pages_v3.plugin_manager:
             return '<div class="text-red-500 p-4">Plugin manager not available</div>', 500
-        
+
+        # Handle starlark app config (starlark:<app_id>)
+        if plugin_id.startswith('starlark:'):
+            return _load_starlark_config_partial(plugin_id[len('starlark:'):])
+
         # Try to get plugin info first
         plugin_info = pages_v3.plugin_manager.get_plugin_info(plugin_id)
         
@@ -429,3 +433,78 @@ def _load_plugin_config_partial(plugin_id):
         import traceback
         traceback.print_exc()
         return f'<div class="text-red-500 p-4">Error loading plugin config: {str(e)}</div>', 500
+
+
+def _load_starlark_config_partial(app_id):
+    """Load configuration partial for a Starlark app."""
+    try:
+        starlark_plugin = pages_v3.plugin_manager.get_plugin('starlark-apps') if pages_v3.plugin_manager else None
+
+        if starlark_plugin and hasattr(starlark_plugin, 'apps'):
+            app = starlark_plugin.apps.get(app_id)
+            if not app:
+                return f'<div class="text-red-500 p-4">Starlark app not found: {app_id}</div>', 404
+            return render_template(
+                'v3/partials/starlark_config.html',
+                app_id=app_id,
+                app_name=app.manifest.get('name', app_id),
+                app_enabled=app.is_enabled(),
+                render_interval=app.get_render_interval(),
+                display_duration=app.get_display_duration(),
+                config=app.config,
+                schema=app.schema,
+                has_frames=app.frames is not None,
+                frame_count=len(app.frames) if app.frames else 0,
+                last_render_time=app.last_render_time,
+            )
+
+        # Standalone: read from manifest file
+        manifest_file = Path(__file__).resolve().parent.parent.parent / 'starlark-apps' / 'manifest.json'
+        if not manifest_file.exists():
+            return f'<div class="text-red-500 p-4">Starlark app not found: {app_id}</div>', 404
+
+        with open(manifest_file, 'r') as f:
+            manifest = json.load(f)
+
+        app_data = manifest.get('apps', {}).get(app_id)
+        if not app_data:
+            return f'<div class="text-red-500 p-4">Starlark app not found: {app_id}</div>', 404
+
+        # Load schema from schema.json if it exists
+        schema = None
+        schema_file = Path(__file__).resolve().parent.parent.parent / 'starlark-apps' / app_id / 'schema.json'
+        if schema_file.exists():
+            try:
+                with open(schema_file, 'r') as f:
+                    schema = json.load(f)
+            except Exception as e:
+                print(f"Warning: Could not load schema for {app_id}: {e}")
+
+        # Load config from config.json if it exists
+        config = {}
+        config_file = Path(__file__).resolve().parent.parent.parent / 'starlark-apps' / app_id / 'config.json'
+        if config_file.exists():
+            try:
+                with open(config_file, 'r') as f:
+                    config = json.load(f)
+            except Exception as e:
+                print(f"Warning: Could not load config for {app_id}: {e}")
+
+        return render_template(
+            'v3/partials/starlark_config.html',
+            app_id=app_id,
+            app_name=app_data.get('name', app_id),
+            app_enabled=app_data.get('enabled', True),
+            render_interval=app_data.get('render_interval', 300),
+            display_duration=app_data.get('display_duration', 15),
+            config=config,
+            schema=schema,
+            has_frames=False,
+            frame_count=0,
+            last_render_time=None,
+        )
+
+    except Exception as e:
+        import traceback
+        traceback.print_exc()
+        return f'<div class="text-red-500 p-4">Error loading starlark config: {str(e)}</div>', 500

web_interface/templates/v3/partials/plugins.html

@@ -28,16 +28,6 @@
                     <h3 class="text-lg font-bold text-gray-900">Installed Plugins</h3>
                     <span id="installed-count" class="text-sm text-gray-500 font-medium">0 installed</span>
                 </div>
-                <div class="flex items-center gap-2">
-                    <label for="installed-sort" class="text-sm font-medium text-gray-700 whitespace-nowrap">
-                        <i class="fas fa-sort mr-1"></i>Sort:
-                    </label>
-                    <select id="installed-sort" class="text-sm px-3 py-1.5 border border-gray-300 rounded-lg shadow-sm focus:ring-blue-500 focus:border-blue-500">
-                        <option value="a-z">A &rarr; Z</option>
-                        <option value="z-a">Z &rarr; A</option>
-                        <option value="enabled">Enabled First</option>
-                    </select>
-                </div>
             </div>
             <div id="installed-plugins-content" class="block">
                 <div id="installed-plugins-grid" class="grid grid-cols-1 md:grid-cols-2 lg:grid-cols-3 xl:grid-cols-4 2xl:grid-cols-5 gap-6">
@@ -157,83 +147,58 @@
                 </div>
                 </div>
             </div>
-            <div class="mb-6">
-                <div class="flex gap-3">
-                    <input type="text" id="plugin-search" placeholder="Search plugins by name, description, or tags..." class="form-control text-sm flex-[3] min-w-0 px-4 py-2.5 border border-gray-300 rounded-lg shadow-sm focus:shadow-md transition-shadow">
-                    <select id="plugin-category" class="form-control text-sm flex-1 px-3 py-2.5 border border-gray-300 rounded-lg shadow-sm focus:shadow-md transition-shadow">
-                        <option value="">All Categories</option>
-                        <option value="sports">Sports</option>
-                        <option value="content">Content</option>
-                        <option value="time">Time</option>
-                        <option value="weather">Weather</option>
-                        <option value="financial">Financial</option>
-                        <option value="media">Media</option>
-                        <option value="demo">Demo</option>
-                    </select>
-                    <button id="search-plugins-btn" class="btn bg-blue-600 hover:bg-blue-700 text-white px-5 py-2.5 rounded-lg whitespace-nowrap font-semibold shadow-sm">
-                        <i class="fas fa-search mr-2"></i>Search
-                    </button>
-                </div>
+            <!-- Search Row -->
+            <div class="flex gap-3 mb-4">
+                <input type="text" id="plugin-search" placeholder="Search plugins by name, description, or tags..." class="form-control text-sm flex-[3] min-w-0 px-4 py-2.5 border border-gray-300 rounded-lg shadow-sm focus:shadow-md transition-shadow">
+                <select id="plugin-category" class="form-control text-sm flex-1 px-3 py-2.5 border border-gray-300 rounded-lg shadow-sm focus:shadow-md transition-shadow">
+                    <option value="">All Categories</option>
+                    <option value="sports">Sports</option>
+                    <option value="content">Content</option>
+                    <option value="time">Time</option>
+                    <option value="weather">Weather</option>
+                    <option value="financial">Financial</option>
+                    <option value="media">Media</option>
+                    <option value="demo">Demo</option>
+                </select>
             </div>
 
-            <!-- Sort & Filter Controls -->
-            <div id="store-filter-bar" class="mb-4 space-y-3">
-                <!-- Row 1: Sort + Quick Filters -->
-                <div class="flex flex-wrap items-center gap-3">
-                    <!-- Sort Dropdown -->
-                    <div class="flex items-center gap-2">
-                        <label for="store-sort" class="text-sm font-medium text-gray-700 whitespace-nowrap">
-                            <i class="fas fa-sort mr-1"></i>Sort:
-                        </label>
-                        <select id="store-sort" class="text-sm px-3 py-1.5 border border-gray-300 rounded-lg shadow-sm focus:ring-blue-500 focus:border-blue-500">
-                            <option value="a-z">A &rarr; Z</option>
-                            <option value="z-a">Z &rarr; A</option>
-                            <option value="verified">Verified First</option>
-                            <option value="newest">Recently Updated</option>
-                            <option value="category">Category</option>
-                        </select>
-                    </div>
+            <!-- Sort & Filter Bar -->
+            <div id="store-filter-bar" class="flex flex-wrap items-center gap-3 mb-4 p-3 bg-gray-50 rounded-lg border border-gray-200">
+                <!-- Sort -->
+                <select id="store-sort" class="text-sm px-3 py-1.5 border border-gray-300 rounded-md bg-white">
+                    <option value="a-z">A → Z</option>
+                    <option value="z-a">Z → A</option>
+                    <option value="category">Category</option>
+                    <option value="author">Author</option>
+                    <option value="newest">Newest</option>
+                </select>
 
-                    <!-- Divider -->
-                    <div class="h-6 w-px bg-gray-300"></div>
+                <div class="w-px h-6 bg-gray-300"></div>
 
-                    <!-- Quick Filter Toggles -->
-                    <div class="flex items-center gap-2 flex-wrap">
-                        <span class="text-sm font-medium text-gray-700">Filter:</span>
-                        <button id="filter-verified" type="button" class="filter-pill text-xs px-3 py-1.5 rounded-full border border-gray-300 bg-white hover:bg-gray-50 transition-colors" data-active="false">
-                            <i class="fas fa-check-circle mr-1"></i>Verified
-                        </button>
-                        <button id="filter-new" type="button" class="filter-pill text-xs px-3 py-1.5 rounded-full border border-gray-300 bg-white hover:bg-gray-50 transition-colors" data-active="false">
-                            <i class="fas fa-star mr-1"></i>New
-                        </button>
-                        <button id="filter-installed" type="button" class="filter-pill text-xs px-3 py-1.5 rounded-full border border-gray-300 bg-white hover:bg-gray-50 transition-colors" data-active="false">
-                            <i class="fas fa-download mr-1"></i><span>All</span>
-                        </button>
-                    </div>
+                <!-- Installed filter toggle -->
+                <button id="store-filter-installed" class="text-sm px-3 py-1.5 rounded-md border border-gray-300 bg-white hover:bg-gray-100 transition-colors" title="Cycle: All → Installed → Not Installed">
+                    <i class="fas fa-filter mr-1 text-gray-400"></i>All
+                </button>
 
-                    <!-- Divider -->
-                    <div class="h-6 w-px bg-gray-300"></div>
+                <div class="flex-1"></div>
 
-                    <!-- Author Dropdown -->
-                    <select id="filter-author" class="text-sm px-3 py-1.5 border border-gray-300 rounded-lg shadow-sm focus:ring-blue-500 focus:border-blue-500">
-                        <option value="">All Authors</option>
+                <!-- Active filter count + clear -->
+                <span id="store-active-filters" class="hidden text-xs text-blue-600 font-medium"></span>
+                <button id="store-clear-filters" class="hidden text-sm px-3 py-1.5 rounded-md border border-red-300 bg-white text-red-600 hover:bg-red-50 transition-colors">
+                    <i class="fas fa-times mr-1"></i>Clear Filters
+                </button>
+            </div>
+
+            <!-- Results Bar (top pagination) -->
+            <div class="flex flex-wrap items-center justify-between gap-3 mb-4">
+                <span id="store-results-info" class="text-sm text-gray-600"></span>
+                <div class="flex items-center gap-3">
+                    <select id="store-per-page" class="text-sm px-2 py-1 border border-gray-300 rounded-md bg-white">
+                        <option value="12">12 per page</option>
+                        <option value="24">24 per page</option>
+                        <option value="48">48 per page</option>
                     </select>
-
-                    <!-- Clear Filters + Badge -->
-                    <button id="clear-filters-btn" type="button" class="hidden text-xs px-3 py-1.5 rounded-full bg-red-100 text-red-700 hover:bg-red-200 transition-colors font-medium">
-                        <i class="fas fa-times mr-1"></i>Clear Filters
-                        <span id="filter-count-badge" class="ml-1 inline-flex items-center justify-center bg-red-600 text-white rounded-full w-5 h-5 text-xs font-bold">0</span>
-                    </button>
-                </div>
-
-                <!-- Row 2: Category Pills (populated dynamically) -->
-                <div id="filter-categories-container" class="hidden">
-                    <div class="flex items-center gap-2 flex-wrap">
-                        <span class="text-xs font-medium text-gray-600 whitespace-nowrap">Categories:</span>
-                        <div id="filter-categories-pills" class="flex flex-wrap gap-1.5">
-                            <!-- Dynamically populated category pills -->
-                        </div>
-                    </div>
+                    <div id="store-pagination-top" class="flex items-center gap-1"></div>
                 </div>
             </div>
 
@@ -246,11 +211,106 @@
                         <div class="bg-gray-200 rounded-lg p-4 h-48 animate-pulse"></div>
                         <div class="bg-gray-200 rounded-lg p-4 h-48 animate-pulse"></div>
                         <div class="bg-gray-200 rounded-lg p-4 h-48 animate-pulse"></div>
+                    </div>
                 </div>
             </div>
+
+            <!-- Bottom Pagination -->
+            <div class="flex flex-wrap items-center justify-between gap-3 mt-4">
+                <span id="store-results-info-bottom" class="text-sm text-gray-600"></span>
+                <div id="store-pagination-bottom" class="flex items-center gap-1"></div>
             </div>
         </div>
         
+        <!-- Starlark Apps Section (Tronbyte Community Apps) -->
+        <div id="starlark-apps-section" class="border-t border-gray-200 pt-8 mt-8">
+            <div class="flex items-center justify-between mb-5 pb-3 border-b border-gray-200">
+                <div class="flex items-center gap-3">
+                    <h3 class="text-lg font-bold text-gray-900"><i class="fas fa-star text-yellow-500 mr-2"></i>Starlark Apps</h3>
+                    <span id="starlark-apps-count" class="text-sm text-gray-500 font-medium"></span>
+                </div>
+                <button id="toggle-starlark-section" class="text-sm text-blue-600 hover:text-blue-800 flex items-center font-medium transition-colors">
+                    <i class="fas fa-chevron-down mr-1" id="starlark-section-icon"></i>
+                    <span>Show</span>
+                </button>
+            </div>
+            <div id="starlark-section-content" class="hidden">
+                <p class="text-sm text-gray-600 mb-4">Browse and install Starlark apps from the <a href="https://github.com/tronbyt/apps" target="_blank" class="text-blue-600 hover:text-blue-800 underline">Tronbyte community repository</a>. Requires <strong>Pixlet</strong> binary.</p>
+
+                <!-- Pixlet Status Banner -->
+                <div id="starlark-pixlet-status" class="mb-4"></div>
+
+                <!-- Search Row -->
+                <div class="flex gap-3 mb-4">
+                    <input type="text" id="starlark-search" placeholder="Search by name, description, author..." class="form-control text-sm flex-[3] min-w-0 px-4 py-2.5 border border-gray-300 rounded-lg shadow-sm focus:shadow-md transition-shadow">
+                    <select id="starlark-category" class="form-control text-sm flex-1 px-3 py-2.5 border border-gray-300 rounded-lg shadow-sm focus:shadow-md transition-shadow">
+                        <option value="">All Categories</option>
+                    </select>
+                </div>
+
+                <!-- Sort & Filter Bar -->
+                <div id="starlark-filter-bar" class="flex flex-wrap items-center gap-3 mb-4 p-3 bg-gray-50 rounded-lg border border-gray-200">
+                    <!-- Sort -->
+                    <select id="starlark-sort" class="text-sm px-3 py-1.5 border border-gray-300 rounded-md bg-white">
+                        <option value="a-z">A → Z</option>
+                        <option value="z-a">Z → A</option>
+                        <option value="category">Category</option>
+                        <option value="author">Author</option>
+                    </select>
+
+                    <div class="w-px h-6 bg-gray-300"></div>
+
+                    <!-- Installed filter toggle -->
+                    <button id="starlark-filter-installed" class="text-sm px-3 py-1.5 rounded-md border border-gray-300 bg-white hover:bg-gray-100 transition-colors" title="Cycle: All → Installed → Not Installed">
+                        <i class="fas fa-filter mr-1 text-gray-400"></i>All
+                    </button>
+
+                    <!-- Author filter -->
+                    <select id="starlark-filter-author" class="text-sm px-3 py-1.5 border border-gray-300 rounded-md bg-white">
+                        <option value="">All Authors</option>
+                    </select>
+
+                    <div class="flex-1"></div>
+
+                    <!-- Active filter count + clear -->
+                    <span id="starlark-active-filters" class="hidden text-xs text-blue-600 font-medium"></span>
+                    <button id="starlark-clear-filters" class="hidden text-sm px-3 py-1.5 rounded-md border border-red-300 bg-white text-red-600 hover:bg-red-50 transition-colors">
+                        <i class="fas fa-times mr-1"></i>Clear Filters
+                    </button>
+                </div>
+
+                <!-- Results Bar (top pagination) -->
+                <div class="flex flex-wrap items-center justify-between gap-3 mb-4">
+                    <span id="starlark-results-info" class="text-sm text-gray-600"></span>
+                    <div class="flex items-center gap-3">
+                        <select id="starlark-per-page" class="text-sm px-2 py-1 border border-gray-300 rounded-md bg-white">
+                            <option value="24">24 per page</option>
+                            <option value="48">48 per page</option>
+                            <option value="96">96 per page</option>
+                        </select>
+                        <div id="starlark-pagination-top" class="flex items-center gap-1"></div>
+                    </div>
+                </div>
+
+                <!-- Starlark Apps Grid -->
+                <div id="starlark-apps-grid" class="grid grid-cols-1 md:grid-cols-2 lg:grid-cols-3 xl:grid-cols-4 2xl:grid-cols-5 gap-6">
+                </div>
+
+                <!-- Bottom Pagination -->
+                <div class="flex flex-wrap items-center justify-between gap-3 mt-4">
+                    <span id="starlark-results-info-bottom" class="text-sm text-gray-600"></span>
+                    <div id="starlark-pagination-bottom" class="flex items-center gap-1"></div>
+                </div>
+
+                <!-- Upload .star file -->
+                <div class="flex gap-3 mt-6 pt-4 border-t border-gray-200">
+                    <button id="starlark-upload-btn" class="btn bg-green-600 hover:bg-green-700 text-white px-4 py-2 rounded-md text-sm">
+                        <i class="fas fa-upload mr-2"></i>Upload .star File
+                    </button>
+                </div>
+            </div>
+        </div>
+
         <!-- Install from GitHub URL Section (Separate section, always visible) -->
         <div class="border-t border-gray-200 pt-8 mt-8">
             <div class="flex items-center justify-between mb-5 pb-3 border-b border-gray-200">

web_interface/templates/v3/partials/starlark_config.html

@@ -0,0 +1,456 @@
+<div class="space-y-6">
+    <!-- Header -->
+    <div class="flex items-center justify-between pb-4 border-b border-gray-200">
+        <div>
+            <h3 class="text-lg font-bold text-gray-900">
+                <i class="fas fa-star text-yellow-500 mr-2"></i>{{ app_name }}
+            </h3>
+            <p class="text-sm text-gray-500 mt-1">Starlark App &mdash; ID: {{ app_id }}</p>
+        </div>
+        <div class="flex items-center gap-3">
+            <span class="badge badge-warning"><i class="fas fa-star mr-1"></i>Starlark</span>
+            {% if app_enabled %}
+                <span class="badge badge-success">Enabled</span>
+            {% else %}
+                <span class="badge badge-error">Disabled</span>
+            {% endif %}
+        </div>
+    </div>
+
+    <!-- Status -->
+    <div class="bg-gray-50 rounded-lg p-4 border border-gray-200">
+        <h4 class="text-sm font-semibold text-gray-700 mb-3">Status</h4>
+        <div class="grid grid-cols-2 md:grid-cols-4 gap-4 text-sm">
+            <div>
+                <span class="text-gray-500">Frames:</span>
+                <span class="font-medium ml-1">{{ frame_count if has_frames else 'Not rendered' }}</span>
+            </div>
+            <div>
+                <span class="text-gray-500">Render Interval:</span>
+                <span class="font-medium ml-1">{{ render_interval }}s</span>
+            </div>
+            <div>
+                <span class="text-gray-500">Display Duration:</span>
+                <span class="font-medium ml-1">{{ display_duration }}s</span>
+            </div>
+            <div>
+                <span class="text-gray-500">Last Render:</span>
+                <span class="font-medium ml-1" id="starlark-last-render">{{ last_render_time }}</span>
+            </div>
+        </div>
+    </div>
+
+    <!-- Actions -->
+    <div class="flex gap-3">
+        <button onclick="forceRenderStarlarkApp('{{ app_id }}')"
+                class="btn bg-blue-600 hover:bg-blue-700 text-white px-4 py-2 rounded-md text-sm font-semibold">
+            <i class="fas fa-sync mr-2"></i>Force Render
+        </button>
+        <button onclick="toggleStarlarkApp('{{ app_id }}', {{ 'false' if app_enabled else 'true' }})"
+                class="btn {{ 'bg-red-600 hover:bg-red-700' if app_enabled else 'bg-green-600 hover:bg-green-700' }} text-white px-4 py-2 rounded-md text-sm font-semibold">
+            <i class="fas {{ 'fa-toggle-off' if app_enabled else 'fa-toggle-on' }} mr-2"></i>
+            {{ 'Disable' if app_enabled else 'Enable' }}
+        </button>
+    </div>
+
+    <!-- Configuration -->
+    <div class="bg-white rounded-lg p-4 border border-gray-200">
+        <h4 class="text-sm font-semibold text-gray-700 mb-3">Timing Settings</h4>
+        <div id="starlark-config-form" class="space-y-4">
+            <div class="grid grid-cols-1 md:grid-cols-2 gap-4">
+                <div class="form-group">
+                    <label class="block text-sm font-medium text-gray-700 mb-1">Render Interval (seconds)</label>
+                    <input type="number" min="10" max="86400" step="1"
+                           class="form-control w-full px-3 py-2 border border-gray-300 rounded-md text-sm"
+                           value="{{ render_interval }}"
+                           data-starlark-config="render_interval">
+                    <p class="text-xs text-gray-400 mt-1">How often the app re-renders (fetches new data)</p>
+                </div>
+                <div class="form-group">
+                    <label class="block text-sm font-medium text-gray-700 mb-1">Display Duration (seconds)</label>
+                    <input type="number" min="1" max="3600" step="1"
+                           class="form-control w-full px-3 py-2 border border-gray-300 rounded-md text-sm"
+                           value="{{ display_duration }}"
+                           data-starlark-config="display_duration">
+                    <p class="text-xs text-gray-400 mt-1">How long the app displays before rotating</p>
+                </div>
+            </div>
+
+            {# ── Schema-driven App Settings ── #}
+            {% set fields = [] %}
+            {% if schema %}
+                {% if schema.fields is defined %}
+                    {% set fields = schema.fields %}
+                {% elif schema.schema is defined and schema.schema is iterable and schema.schema is not string %}
+                    {% set fields = schema.schema %}
+                {% endif %}
+            {% endif %}
+
+            {% if fields %}
+            <hr class="border-gray-200 my-2">
+            <h4 class="text-sm font-semibold text-gray-700 mb-2">App Settings</h4>
+
+            {% for field in fields %}
+                {% if field.typeOf is defined and field.id is defined %}
+                {% set field_id = field.id %}
+                {% set field_type = field.typeOf %}
+                {% set field_name = field.name or field_id %}
+                {% set field_desc = field.desc or '' %}
+                {% set field_default = field.default if field.default is defined else '' %}
+                {% set current_val = config.get(field_id, field_default) if config else field_default %}
+
+                {# ── text ── #}
+                {% if field_type == 'text' %}
+                <div class="form-group">
+                    <label class="block text-sm font-medium text-gray-700 mb-1">{{ field_name }}</label>
+                    <input type="text"
+                           class="form-control w-full px-3 py-2 border border-gray-300 rounded-md text-sm"
+                           value="{{ current_val }}"
+                           placeholder="{{ field_desc }}"
+                           data-starlark-config="{{ field_id }}">
+                    {% if field_desc %}
+                    <p class="text-xs text-gray-400 mt-1">{{ field_desc }}</p>
+                    {% endif %}
+                </div>
+
+                {# ── dropdown ── #}
+                {% elif field_type == 'dropdown' %}
+                <div class="form-group">
+                    <label class="block text-sm font-medium text-gray-700 mb-1">{{ field_name }}</label>
+                    <select class="form-control w-full px-3 py-2 border border-gray-300 rounded-md text-sm bg-white"
+                            data-starlark-config="{{ field_id }}">
+                        {% for opt in (field.options or []) %}
+                        <option value="{{ opt.value }}" {{ 'selected' if current_val|string == opt.value|string else '' }}>
+                            {{ opt.display }}
+                        </option>
+                        {% endfor %}
+                    </select>
+                    {% if field_desc %}
+                    <p class="text-xs text-gray-400 mt-1">{{ field_desc }}</p>
+                    {% endif %}
+                </div>
+
+                {# ── toggle ── #}
+                {% elif field_type == 'toggle' %}
+                <div class="form-group">
+                    <label class="flex items-center gap-2 text-sm font-medium text-gray-700 cursor-pointer">
+                        <input type="checkbox"
+                               class="w-4 h-4 rounded border-gray-300 text-blue-600 focus:ring-blue-500"
+                               data-starlark-config="{{ field_id }}"
+                               data-starlark-type="toggle"
+                               {{ 'checked' if (current_val is sameas true or current_val|string|lower in ('true', '1', 'yes')) else '' }}>
+                        {{ field_name }}
+                    </label>
+                    {% if field_desc %}
+                    <p class="text-xs text-gray-400 mt-1 ml-6">{{ field_desc }}</p>
+                    {% endif %}
+                </div>
+
+                {# ── color ── #}
+                {% elif field_type == 'color' %}
+                <div class="form-group">
+                    <label class="block text-sm font-medium text-gray-700 mb-1">{{ field_name }}</label>
+                    <div class="flex items-center gap-2">
+                        <input type="color"
+                               class="w-10 h-10 rounded border border-gray-300 cursor-pointer p-0.5"
+                               value="{{ current_val or '#FFFFFF' }}"
+                               data-starlark-color-picker="{{ field_id }}"
+                               oninput="this.closest('.space-y-6').querySelector('[data-starlark-config={{ field_id }}]').value = this.value">
+                        <input type="text"
+                               class="form-control flex-1 px-3 py-2 border border-gray-300 rounded-md text-sm font-mono"
+                               value="{{ current_val or '#FFFFFF' }}"
+                               placeholder="#RRGGBB"
+                               data-starlark-config="{{ field_id }}"
+                               oninput="var cp = this.closest('.space-y-6').querySelector('[data-starlark-color-picker={{ field_id }}]'); if(cp && this.value.match(/^#[0-9a-fA-F]{6}$/)) cp.value = this.value;">
+                    </div>
+                    {% if field_desc %}
+                    <p class="text-xs text-gray-400 mt-1">{{ field_desc }}</p>
+                    {% endif %}
+                </div>
+
+                {# ── datetime ── #}
+                {% elif field_type == 'datetime' %}
+                <div class="form-group">
+                    <label class="block text-sm font-medium text-gray-700 mb-1">{{ field_name }}</label>
+                    <input type="datetime-local"
+                           class="form-control w-full px-3 py-2 border border-gray-300 rounded-md text-sm"
+                           value="{{ current_val }}"
+                           data-starlark-config="{{ field_id }}">
+                    {% if field_desc %}
+                    <p class="text-xs text-gray-400 mt-1">{{ field_desc }}</p>
+                    {% endif %}
+                </div>
+
+                {# ── location (mini-form) ── #}
+                {% elif field_type == 'location' %}
+                <div class="form-group" data-starlark-location-group="{{ field_id }}" data-starlark-location-value="{{ current_val }}">
+                    <label class="block text-sm font-medium text-gray-700 mb-1">{{ field_name }}</label>
+                    <div class="grid grid-cols-1 md:grid-cols-3 gap-2">
+                        <div>
+                            <input type="number" step="any" min="-90" max="90"
+                                   class="form-control w-full px-3 py-2 border border-gray-300 rounded-md text-sm"
+                                   placeholder="Latitude"
+                                   data-starlark-location-field="{{ field_id }}"
+                                   data-starlark-location-key="lat">
+                        </div>
+                        <div>
+                            <input type="number" step="any" min="-180" max="180"
+                                   class="form-control w-full px-3 py-2 border border-gray-300 rounded-md text-sm"
+                                   placeholder="Longitude"
+                                   data-starlark-location-field="{{ field_id }}"
+                                   data-starlark-location-key="lng">
+                        </div>
+                        <div>
+                            <input type="text"
+                                   class="form-control w-full px-3 py-2 border border-gray-300 rounded-md text-sm"
+                                   placeholder="Timezone (e.g. America/New_York)"
+                                   data-starlark-location-field="{{ field_id }}"
+                                   data-starlark-location-key="timezone">
+                        </div>
+                    </div>
+                    {% if field_desc %}
+                    <p class="text-xs text-gray-400 mt-1">{{ field_desc }}</p>
+                    {% endif %}
+                </div>
+
+                {# ── oauth2 (unsupported) ── #}
+                {% elif field_type == 'oauth2' %}
+                <div class="form-group">
+                    <label class="block text-sm font-medium text-gray-700 mb-1">{{ field_name }}</label>
+                    <div class="bg-yellow-50 border border-yellow-200 rounded-md p-3 text-sm text-yellow-800" data-starlark-unsupported>
+                        <i class="fas fa-exclamation-triangle mr-1"></i>
+                        This app requires OAuth2 authentication, which is not supported in standalone mode.
+                    </div>
+                    {% if field_desc %}
+                    <p class="text-xs text-gray-400 mt-1">{{ field_desc }}</p>
+                    {% endif %}
+                </div>
+
+                {# ── photo_select (unsupported) ── #}
+                {% elif field_type == 'photo_select' %}
+                <div class="form-group">
+                    <label class="block text-sm font-medium text-gray-700 mb-1">{{ field_name }}</label>
+                    <div class="bg-yellow-50 border border-yellow-200 rounded-md p-3 text-sm text-yellow-800" data-starlark-unsupported>
+                        <i class="fas fa-exclamation-triangle mr-1"></i>
+                        Photo upload is not supported in this interface.
+                    </div>
+                </div>
+
+                {# ── generated (hidden meta-field, skip) ── #}
+                {% elif field_type == 'generated' %}
+                    {# Invisible — generated fields are handled server-side by Pixlet #}
+
+                {# ── typeahead / location_based (text fallback with note) ── #}
+                {% elif field_type in ('typeahead', 'location_based') %}
+                <div class="form-group">
+                    <label class="block text-sm font-medium text-gray-700 mb-1">{{ field_name }}</label>
+                    <input type="text"
+                           class="form-control w-full px-3 py-2 border border-gray-300 rounded-md text-sm"
+                           value="{{ current_val }}"
+                           placeholder="{{ field_desc }}"
+                           data-starlark-config="{{ field_id }}">
+                    <p class="text-xs text-yellow-600 mt-1">
+                        <i class="fas fa-info-circle mr-1"></i>
+                        This field normally uses autocomplete which requires a Pixlet server. Enter the value manually.
+                    </p>
+                    {% if field_desc %}
+                    <p class="text-xs text-gray-400 mt-1">{{ field_desc }}</p>
+                    {% endif %}
+                </div>
+
+                {# ── unknown type (text fallback) ── #}
+                {% else %}
+                <div class="form-group">
+                    <label class="block text-sm font-medium text-gray-700 mb-1">{{ field_name }}</label>
+                    <input type="text"
+                           class="form-control w-full px-3 py-2 border border-gray-300 rounded-md text-sm"
+                           value="{{ current_val }}"
+                           placeholder="{{ field_desc }}"
+                           data-starlark-config="{{ field_id }}">
+                    {% if field_desc %}
+                    <p class="text-xs text-gray-400 mt-1">{{ field_desc }}</p>
+                    {% endif %}
+                </div>
+                {% endif %}
+
+                {% endif %}{# end field.typeOf and field.id check #}
+            {% endfor %}
+
+            {# Also show any config keys NOT in the schema (user-added or legacy) #}
+            {% if config %}
+                {% set schema_ids = [] %}
+                {% for f in fields %}
+                    {% if f.id is defined %}
+                        {% if schema_ids.append(f.id) %}{% endif %}
+                    {% endif %}
+                {% endfor %}
+                {% for key, value in config.items() %}
+                    {% if key not in ('render_interval', 'display_duration') and key not in schema_ids %}
+                    <div class="form-group">
+                        <label class="block text-sm font-medium text-gray-700 mb-1">{{ key }} <span class="text-xs text-gray-400">(custom)</span></label>
+                        <input type="text" class="form-control w-full px-3 py-2 border border-gray-300 rounded-md text-sm"
+                               value="{{ value }}"
+                               data-starlark-config="{{ key }}">
+                    </div>
+                    {% endif %}
+                {% endfor %}
+            {% endif %}
+
+            {# ── No schema: fall back to raw config key/value pairs ── #}
+            {% elif config %}
+            <hr class="border-gray-200 my-2">
+            <h4 class="text-sm font-semibold text-gray-700 mb-2">App Settings</h4>
+            {% for key, value in config.items() %}
+                {% if key not in ('render_interval', 'display_duration') %}
+                <div class="form-group">
+                    <label class="block text-sm font-medium text-gray-700 mb-1">{{ key }}</label>
+                    <input type="text" class="form-control w-full px-3 py-2 border border-gray-300 rounded-md text-sm"
+                           value="{{ value }}"
+                           data-starlark-config="{{ key }}">
+                </div>
+                {% endif %}
+            {% endfor %}
+            {% endif %}
+
+            <button onclick="saveStarlarkConfig('{{ app_id }}')"
+                    class="btn bg-blue-600 hover:bg-blue-700 text-white px-4 py-2 rounded-md text-sm font-semibold">
+                <i class="fas fa-save mr-2"></i>Save Configuration
+            </button>
+        </div>
+    </div>
+</div>
+
+<script>
+function forceRenderStarlarkApp(appId) {
+    fetch('/api/v3/starlark/apps/' + encodeURIComponent(appId) + '/render', {method: 'POST'})
+        .then(function(r) { return r.json(); })
+        .then(function(data) {
+            if (data.status === 'success') {
+                if (typeof showNotification === 'function') {
+                    showNotification('Rendered successfully! ' + (data.frame_count || 0) + ' frame(s)', 'success');
+                } else {
+                    alert('Rendered successfully! ' + (data.frame_count || 0) + ' frame(s)');
+                }
+            } else {
+                var msg = 'Render failed: ' + (data.message || 'Unknown error');
+                if (typeof showNotification === 'function') showNotification(msg, 'error');
+                else alert(msg);
+            }
+        })
+        .catch(function(err) {
+            var msg = 'Render failed: ' + err.message;
+            if (typeof showNotification === 'function') showNotification(msg, 'error');
+            else alert(msg);
+        });
+}
+
+function toggleStarlarkApp(appId, enabled) {
+    fetch('/api/v3/starlark/apps/' + encodeURIComponent(appId) + '/toggle', {
+        method: 'POST',
+        headers: {'Content-Type': 'application/json'},
+        body: JSON.stringify({enabled: enabled})
+    })
+    .then(function(r) { return r.json(); })
+    .then(function(data) {
+        if (data.status === 'success') {
+            if (typeof loadInstalledPlugins === 'function') loadInstalledPlugins();
+            else if (typeof window.loadInstalledPlugins === 'function') window.loadInstalledPlugins();
+            var container = document.getElementById('plugin-config-starlark:' + appId);
+            if (container && window.htmx) {
+                htmx.ajax('GET', '/v3/partials/plugin-config/starlark:' + encodeURIComponent(appId), {target: container, swap: 'innerHTML'});
+            }
+        } else {
+            var msg = 'Toggle failed: ' + (data.message || 'Unknown error');
+            if (typeof showNotification === 'function') showNotification(msg, 'error');
+            else alert(msg);
+        }
+    })
+    .catch(function(err) {
+        var msg = 'Toggle failed: ' + err.message;
+        if (typeof showNotification === 'function') showNotification(msg, 'error');
+        else alert(msg);
+    });
+}
+
+function saveStarlarkConfig(appId) {
+    var config = {};
+
+    // Get container to scope queries (prevents conflicts if multiple modals open)
+    var container = document.getElementById('plugin-config-starlark:' + appId);
+    if (!container) {
+        console.error('Container not found for appId:', appId);
+        return;
+    }
+
+    // Collect standard inputs (text, number, select, datetime, color text companion)
+    container.querySelectorAll('[data-starlark-config]').forEach(function(input) {
+        var key = input.getAttribute('data-starlark-config');
+        var type = input.getAttribute('data-starlark-type');
+
+        if (key === 'render_interval' || key === 'display_duration') {
+            config[key] = parseInt(input.value, 10) || 0;
+        } else if (type === 'toggle') {
+            config[key] = input.checked ? 'true' : 'false';
+        } else {
+            config[key] = input.value;
+        }
+    });
+
+    // Collect location mini-form groups
+    container.querySelectorAll('[data-starlark-location-group]').forEach(function(group) {
+        var fieldId = group.getAttribute('data-starlark-location-group');
+        var loc = {};
+        group.querySelectorAll('[data-starlark-location-field="' + fieldId + '"]').forEach(function(sub) {
+            var locKey = sub.getAttribute('data-starlark-location-key');
+            if (sub.value) loc[locKey] = sub.value;
+        });
+        if (Object.keys(loc).length > 0) {
+            config[fieldId] = JSON.stringify(loc);
+        }
+    });
+
+    fetch('/api/v3/starlark/apps/' + encodeURIComponent(appId) + '/config', {
+        method: 'PUT',
+        headers: {'Content-Type': 'application/json'},
+        body: JSON.stringify(config)
+    })
+    .then(function(r) { return r.json(); })
+    .then(function(data) {
+        if (data.status === 'success') {
+            if (typeof showNotification === 'function') showNotification('Configuration saved!', 'success');
+            else alert('Configuration saved!');
+            // Reload partial to reflect updated status
+            var container = document.getElementById('plugin-config-starlark:' + appId);
+            if (container && window.htmx) {
+                htmx.ajax('GET', '/v3/partials/plugin-config/starlark:' + encodeURIComponent(appId), {target: container, swap: 'innerHTML'});
+            }
+        } else {
+            var msg = 'Save failed: ' + (data.message || 'Unknown error');
+            if (typeof showNotification === 'function') showNotification(msg, 'error');
+            else alert(msg);
+        }
+    })
+    .catch(function(err) {
+        var msg = 'Save failed: ' + err.message;
+        if (typeof showNotification === 'function') showNotification(msg, 'error');
+        else alert(msg);
+    });
+}
+
+// Pre-fill location fields from stored JSON config values
+(function() {
+    document.querySelectorAll('[data-starlark-location-group]').forEach(function(group) {
+        var fieldId = group.getAttribute('data-starlark-location-group');
+        // Find the hidden or stored value — look for a data attribute with the raw JSON
+        var rawVal = group.getAttribute('data-starlark-location-value');
+        if (!rawVal) return;
+        try {
+            var loc = JSON.parse(rawVal);
+            group.querySelectorAll('[data-starlark-location-field="' + fieldId + '"]').forEach(function(sub) {
+                var locKey = sub.getAttribute('data-starlark-location-key');
+                if (loc[locKey] !== undefined) sub.value = loc[locKey];
+            });
+        } catch(e) { /* not valid JSON, ignore */ }
+    });
+})();
+</script>