better error handling and correct image call for top 25

test/README_broadcast_logo_analyzer.md

@@ -0,0 +1,103 @@
+# Broadcast Logo Analyzer
+
+This script analyzes broadcast channel logos to ensure we have proper logos for every game and identifies missing or problematic logos that might show as white boxes.
+
+## Important Notes
+
+**This script must be run on the Raspberry Pi** where the LEDMatrix project is located, as it needs to access the actual logo files in the `assets/broadcast_logos/` directory.
+
+## Usage
+
+### On Raspberry Pi (Recommended)
+
+```bash
+# SSH into your Raspberry Pi
+ssh pi@your-pi-ip
+
+# Navigate to the LEDMatrix project directory
+cd /path/to/LEDMatrix
+
+# Run the analyzer
+python test/analyze_broadcast_logos.py
+```
+
+### Local Testing (Optional)
+
+If you want to test the script logic locally, you can:
+
+1. Copy some logo files from your Pi to your local machine
+2. Place them in `assets/broadcast_logos/` directory
+3. Run the script locally
+
+## What the Script Does
+
+1. **Checks Logo Mappings**: Verifies all broadcast channel names in `BROADCAST_LOGO_MAP` have corresponding logo files
+2. **Validates File Existence**: Ensures all referenced logo files actually exist
+3. **Analyzes Logo Quality**: 
+   - Checks dimensions (too small/large)
+   - Analyzes transparency handling
+   - Detects potential white box issues
+   - Measures content density
+4. **Identifies Issues**:
+   - Missing logos
+   - Problematic logos (corrupted, too transparent, etc.)
+   - Orphaned logo files (exist but not mapped)
+5. **Generates Report**: Creates both console output and JSON report
+
+## Output
+
+The script generates:
+- **Console Report**: Detailed analysis with recommendations
+- **JSON Report**: `test/broadcast_logo_analysis.json` with structured data
+
+## Common Issues Found
+
+- **White Boxes**: Usually caused by:
+  - Missing logo files
+  - Corrupted image files
+  - Images that are mostly transparent
+  - Images with very low content density
+- **Missing Logos**: Broadcast channels that don't have corresponding logo files
+- **Orphaned Logos**: Logo files that exist but aren't mapped to any broadcast channel
+
+## Recommendations
+
+The script provides specific recommendations for each issue found, such as:
+- Adding missing logo files
+- Fixing problematic logos
+- Optimizing logo dimensions
+- Ensuring proper transparency handling
+
+## Example Output
+
+```
+BROADCAST LOGO ANALYSIS REPORT
+================================================================================
+
+SUMMARY:
+  Total broadcast mappings: 44
+  Existing logos: 40
+  Missing logos: 2
+  Problematic logos: 2
+  Orphaned logos: 1
+
+MISSING LOGOS (2):
+--------------------------------------------------
+  New Channel -> newchannel.png
+    Expected: /path/to/LEDMatrix/assets/broadcast_logos/newchannel.png
+
+PROBLEMATIC LOGOS (2):
+--------------------------------------------------
+  ESPN -> espn
+    Issue: Very low content density: 2.1%
+    Recommendation: Logo may appear as a white box - check content
+```
+
+## Troubleshooting
+
+If you see errors about missing dependencies:
+```bash
+pip install Pillow
+```
+
+If the script can't find the broadcast logos directory, ensure you're running it from the LEDMatrix project root directory.