feat: Enhance LacyLights.app launcher with intelligent network interface selection

[bbernstein]

Summary

Enhanced the LacyLights.app launcher with comprehensive network interface selection capabilities, providing a user-friendly GUI experience that matches the intelligent interface detection added to lacylights-node.

Key Features

🎯 Intelligent Interface Detection

• Type Detection: Uses networksetup -listallhardwareports to identify interface types
• Visual Indicators: Emoji icons for different interface types:
  • 🌐 Ethernet - Built-in wired connections
  • 🔌 USB Ethernet - USB-to-Ethernet adapters
  • 📶 WiFi - Wireless connections
  • ⚡ Thunderbolt - Thunderbolt bridge connections
  • 🔗 Bridge - Network bridges

📊 Smart Sorting & Defaults

• Reliability-Based Sorting: Orders interfaces by connection reliability
  1. Ethernet interfaces (most reliable for DMX)
  2. WiFi interfaces (good backup option)
  3. Other interface types
  4. Localhost (testing only)
  5. Global Broadcast (universal fallback)
• Smart Default: Automatically selects first option (typically most reliable interface)

🎭 Broadcast-Only Options

• Art-Net Optimized: Shows only broadcast addresses suitable for DMX transmission
• No Unicast Confusion: Removes individual IP addresses that aren't appropriate for Art-Net
• Clear Descriptions: Each option shows interface type, connection method, and broadcast address

🔄 Seamless Integration

• Environment Variable Passing: Selected interface passed to start.sh via ARTNET_BROADCAST
• Consistent Experience: Matches the enhanced interface selection in lacylights-node
• User-Friendly Flow: Integrated naturally into existing app launch process

Interface Selection Example

Available Network Interface Options:
============================================================
[1] 🔌 en21 - USB Ethernet Broadcast (192.168.7.255)  ← DEFAULT
[2] 📶 en0 - WiFi Broadcast (192.168.7.255)
[3] 🏠 Localhost (for testing only)
[4] 🌍 Global Broadcast (255.255.255.255)
============================================================

📡 Select Art-Net broadcast destination:
   (This determines where DMX data will be sent)
   Press Enter for default (first option)

Select option [1-4] (default: 1): ⏎

✅ Selected: 🔌 en21 - USB Ethernet Broadcast (192.168.7.255)
   Broadcasting to: 192.168.7.255

Benefits

🎯 Better User Experience

• Visual Clarity: Immediate identification of interface types
• Informed Decisions: Users can choose the most appropriate connection
• Reduced Confusion: Clear distinction between different interface types

🚀 Improved Reliability

• Prioritizes Wired Connections: Default selection favors more stable connections
• DMX-Appropriate Options: Only shows broadcast addresses suitable for lighting control
• Intelligent Fallbacks: Graceful handling of edge cases and invalid selections

🔄 Consistent Experience

• Matches Command Line: Same logic and sorting as lacylights-node interface selector
• Unified Approach: Consistent behavior across all LacyLights launch methods
• Professional Polish: Enhanced GUI experience for app-based launches

Technical Implementation

Interface Detection Logic

get_interface_type() {
    hardware_info=$(networksetup -listallhardwareports | grep -B2 "Device: $iface")
    
    if echo "$hardware_info" | grep -qi "wi-fi\|wifi\|wireless"; then
        echo "WiFi"
    elif echo "$hardware_info" | grep -qi "usb.*ethernet"; then
        echo "USB Ethernet"
    elif echo "$hardware_info" | grep -qi "thunderbolt"; then
        echo "Thunderbolt"
    # ... additional detection logic
}

Broadcast Address Integration

# Pass selected interface to start.sh
ARTNET_BROADCAST="$ARTNET_BROADCAST" ./start.sh --with-mcp

Test Plan

• Verify interface type detection works across different hardware configurations
• Confirm sorting prioritizes Ethernet → WiFi → Localhost → Global Broadcast
• Test default selection chooses first (most reliable) option
• Validate broadcast address extraction and validation
• Ensure seamless integration with existing launcher flow
• Verify environment variable passing to start.sh works correctly

Related Changes

This PR complements the enhanced interface selection added to lacylights-node in PR #18, providing a consistent experience across both GUI app launches and direct command-line usage.

🤖 Generated with Claude Code

[Copilot]

Pull Request Overview

This PR enhances the LacyLights.app launcher with intelligent network interface selection capabilities. It adds comprehensive network interface detection and a user-friendly GUI for selecting the appropriate broadcast interface for Art-Net DMX transmission.

• Adds intelligent network interface type detection using macOS networksetup command
• Implements smart sorting that prioritizes reliable connections (Ethernet → WiFi → Others → Localhost → Global)
• Integrates selected interface into the existing launcher workflow via environment variables

---

_{Tip: Customize your code reviews with copilot-instructions.md. Create the file or learn how to get started.}