@@ -1996,6 +2221,9 @@
Stocks: ${u.stocks || 0} used / ${f.stocks || 0} forecast
Sports: ${u.sports || 0} used / ${f.sports || 0} forecast
News: ${u.news || 0} used / ${f.news || 0} forecast
+
Odds: ${u.odds || 0} used / ${f.odds || 0} forecast
+
Music: ${u.music || 0} used / ${f.music || 0} forecast
+
YouTube: ${u.youtube || 0} used / ${f.youtube || 0} forecast
`;
} catch (e) {
// ignore
@@ -2686,6 +2914,88 @@
});
})();
+ // Leaderboard form submit
+ (function augmentLeaderboardForm(){
+ const form = document.getElementById('leaderboard-form');
+ form.addEventListener('submit', async function(e){
+ e.preventDefault();
+ const payload = {
+ leaderboard: {
+ enabled: document.getElementById('leaderboard_enabled').checked,
+ update_interval: parseInt(document.getElementById('leaderboard_update_interval').value),
+ scroll_speed: parseFloat(document.getElementById('leaderboard_scroll_speed').value),
+ scroll_delay: parseFloat(document.getElementById('leaderboard_scroll_delay').value),
+ display_duration: parseInt(document.getElementById('leaderboard_display_duration').value),
+ loop: document.getElementById('leaderboard_loop').checked,
+ request_timeout: parseInt(document.getElementById('leaderboard_request_timeout').value),
+ dynamic_duration: document.getElementById('leaderboard_dynamic_duration').checked,
+ min_duration: parseInt(document.getElementById('leaderboard_min_duration').value),
+ max_duration: parseInt(document.getElementById('leaderboard_max_duration').value),
+ duration_buffer: parseFloat(document.getElementById('leaderboard_duration_buffer').value),
+ enabled_sports: {
+ nfl: {
+ enabled: document.getElementById('leaderboard_nfl_enabled').checked,
+ top_teams: parseInt(document.getElementById('leaderboard_nfl_top_teams').value)
+ },
+ nba: {
+ enabled: document.getElementById('leaderboard_nba_enabled').checked,
+ top_teams: parseInt(document.getElementById('leaderboard_nba_top_teams').value)
+ },
+ mlb: {
+ enabled: document.getElementById('leaderboard_mlb_enabled').checked,
+ top_teams: parseInt(document.getElementById('leaderboard_mlb_top_teams').value)
+ },
+ ncaa_fb: {
+ enabled: document.getElementById('leaderboard_ncaa_fb_enabled').checked,
+ top_teams: parseInt(document.getElementById('leaderboard_ncaa_fb_top_teams').value),
+ show_ranking: document.getElementById('leaderboard_ncaa_fb_show_ranking').checked
+ },
+ nhl: {
+ enabled: document.getElementById('leaderboard_nhl_enabled').checked,
+ top_teams: parseInt(document.getElementById('leaderboard_nhl_top_teams').value)
+ },
+ ncaam_basketball: {
+ enabled: document.getElementById('leaderboard_ncaam_basketball_enabled').checked,
+ top_teams: parseInt(document.getElementById('leaderboard_ncaam_basketball_top_teams').value)
+ }
+ }
+ }
+ };
+ await saveConfigJson(payload);
+ });
+ })();
+
+ // Of The Day form submit
+ (function augmentOfTheDayForm(){
+ const form = document.getElementById('of_the_day-form');
+ form.addEventListener('submit', async function(e){
+ e.preventDefault();
+ const categoryOrder = document.getElementById('of_the_day_category_order').value.split(',').map(s => s.trim()).filter(Boolean);
+ const payload = {
+ of_the_day: {
+ enabled: document.getElementById('of_the_day_enabled').checked,
+ update_interval: parseInt(document.getElementById('of_the_day_update_interval').value),
+ display_rotate_interval: parseInt(document.getElementById('of_the_day_display_rotate_interval').value),
+ subtitle_rotate_interval: parseInt(document.getElementById('of_the_day_subtitle_rotate_interval').value),
+ category_order: categoryOrder,
+ categories: {
+ word_of_the_day: {
+ enabled: document.getElementById('of_the_day_word_enabled').checked,
+ data_file: document.getElementById('of_the_day_word_data_file').value,
+ display_name: document.getElementById('of_the_day_word_display_name').value
+ },
+ slovenian_word_of_the_day: {
+ enabled: document.getElementById('of_the_day_slovenian_enabled').checked,
+ data_file: document.getElementById('of_the_day_slovenian_data_file').value,
+ display_name: document.getElementById('of_the_day_slovenian_display_name').value
+ }
+ }
+ }
+ };
+ await saveConfigJson(payload);
+ });
+ })();
+
// Text form submit
(function augmentTextForm(){
const form = document.getElementById('text-form');
diff --git a/test/README_broadcast_logo_analyzer.md b/test/README_broadcast_logo_analyzer.md
new file mode 100644
index 00000000..d23f74c0
--- /dev/null
+++ b/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.
diff --git a/test/analyze_broadcast_logos.py b/test/analyze_broadcast_logos.py
new file mode 100644
index 00000000..b95454ab
--- /dev/null
+++ b/test/analyze_broadcast_logos.py
@@ -0,0 +1,418 @@
+#!/usr/bin/env python3
+"""
+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: 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):
+ python test/analyze_broadcast_logos.py
+
+Features:
+- Checks all broadcast logos referenced in BROADCAST_LOGO_MAP
+- Validates logo file existence and integrity
+- Analyzes logo dimensions and transparency
+- Identifies potential white box issues
+- Provides recommendations for missing logos
+- Generates a detailed report
+"""
+
+import os
+import sys
+import json
+from pathlib import Path
+from typing import Dict, List, Set, Tuple, Optional
+from PIL import Image, ImageStat
+import logging
+
+# Add the project root to the path so we can import from src
+project_root = Path(__file__).parent.parent
+sys.path.insert(0, str(project_root))
+
+# Define the broadcast logo map directly (copied from odds_ticker_manager.py)
+BROADCAST_LOGO_MAP = {
+ "ACC Network": "accn",
+ "ACCN": "accn",
+ "ABC": "abc",
+ "BTN": "btn",
+ "CBS": "cbs",
+ "CBSSN": "cbssn",
+ "CBS Sports Network": "cbssn",
+ "ESPN": "espn",
+ "ESPN2": "espn2",
+ "ESPN3": "espn3",
+ "ESPNU": "espnu",
+ "ESPNEWS": "espn",
+ "ESPN+": "espn",
+ "ESPN Plus": "espn",
+ "FOX": "fox",
+ "FS1": "fs1",
+ "FS2": "fs2",
+ "MLBN": "mlbn",
+ "MLB Network": "mlbn",
+ "MLB.TV": "mlbn",
+ "NBC": "nbc",
+ "NFLN": "nfln",
+ "NFL Network": "nfln",
+ "PAC12": "pac12n",
+ "Pac-12 Network": "pac12n",
+ "SECN": "espn-sec-us",
+ "TBS": "tbs",
+ "TNT": "tnt",
+ "truTV": "tru",
+ "Peacock": "nbc",
+ "Paramount+": "paramount-plus",
+ "Hulu": "espn",
+ "Disney+": "espn",
+ "Apple TV+": "nbc",
+ # Regional sports networks
+ "MASN": "cbs",
+ "MASN2": "cbs",
+ "MAS+": "cbs",
+ "SportsNet": "nbc",
+ "FanDuel SN": "fox",
+ "FanDuel SN DET": "fox",
+ "FanDuel SN FL": "fox",
+ "SportsNet PIT": "nbc",
+ "Padres.TV": "espn",
+ "CLEGuardians.TV": "espn"
+}
+
+# Set up logging
+logging.basicConfig(
+ level=logging.INFO,
+ format='%(asctime)s - %(levelname)s - %(message)s'
+)
+logger = logging.getLogger(__name__)
+
+class BroadcastLogoAnalyzer:
+ """Analyzes broadcast channel logos for completeness and quality."""
+
+ def __init__(self, project_root: Path):
+ self.project_root = project_root
+ self.broadcast_logos_dir = project_root / "assets" / "broadcast_logos"
+ self.results = {
+ 'total_mappings': len(BROADCAST_LOGO_MAP),
+ 'existing_logos': [],
+ 'missing_logos': [],
+ 'problematic_logos': [],
+ 'recommendations': []
+ }
+
+ def analyze_all_logos(self) -> Dict:
+ """Perform comprehensive analysis of all broadcast logos."""
+ logger.info("Starting broadcast logo analysis...")
+
+ # Get all logo files that exist
+ existing_files = self._get_existing_logo_files()
+ logger.info(f"Found {len(existing_files)} existing logo files")
+
+ # Check each mapping in BROADCAST_LOGO_MAP
+ for broadcast_name, logo_filename in BROADCAST_LOGO_MAP.items():
+ self._analyze_logo_mapping(broadcast_name, logo_filename, existing_files)
+
+ # Check for orphaned logo files (files that exist but aren't mapped)
+ self._check_orphaned_logos(existing_files)
+
+ # Generate recommendations
+ self._generate_recommendations()
+
+ return self.results
+
+ def _get_existing_logo_files(self) -> Set[str]:
+ """Get all existing logo files in the broadcast_logos directory."""
+ existing_files = set()
+
+ if not self.broadcast_logos_dir.exists():
+ logger.warning(f"Broadcast logos directory does not exist: {self.broadcast_logos_dir}")
+ return existing_files
+
+ for file_path in self.broadcast_logos_dir.iterdir():
+ if file_path.is_file() and file_path.suffix.lower() in ['.png', '.jpg', '.jpeg']:
+ existing_files.add(file_path.stem) # filename without extension
+
+ return existing_files
+
+ def _analyze_logo_mapping(self, broadcast_name: str, logo_filename: str, existing_files: Set[str]):
+ """Analyze a single logo mapping."""
+ logo_path = self.broadcast_logos_dir / f"{logo_filename}.png"
+
+ if logo_filename not in existing_files:
+ self.results['missing_logos'].append({
+ 'broadcast_name': broadcast_name,
+ 'logo_filename': logo_filename,
+ 'expected_path': str(logo_path)
+ })
+ logger.warning(f"Missing logo: {broadcast_name} -> {logo_filename}.png")
+ return
+
+ # Logo exists, analyze its quality
+ try:
+ analysis = self._analyze_logo_quality(logo_path, broadcast_name, logo_filename)
+ if analysis['is_problematic']:
+ self.results['problematic_logos'].append(analysis)
+ else:
+ self.results['existing_logos'].append(analysis)
+ except Exception as e:
+ logger.error(f"Error analyzing logo {logo_path}: {e}")
+ self.results['problematic_logos'].append({
+ 'broadcast_name': broadcast_name,
+ 'logo_filename': logo_filename,
+ 'path': str(logo_path),
+ 'error': str(e),
+ 'is_problematic': True
+ })
+
+ def _analyze_logo_quality(self, logo_path: Path, broadcast_name: str, logo_filename: str) -> Dict:
+ """Analyze the quality of a logo file."""
+ try:
+ with Image.open(logo_path) as img:
+ # Basic image info
+ width, height = img.size
+ mode = img.mode
+
+ # Convert to RGBA for analysis if needed
+ if mode != 'RGBA':
+ img_rgba = img.convert('RGBA')
+ else:
+ img_rgba = img
+
+ # Analyze for potential white box issues
+ analysis = {
+ 'broadcast_name': broadcast_name,
+ 'logo_filename': logo_filename,
+ 'path': str(logo_path),
+ 'dimensions': (width, height),
+ 'mode': mode,
+ 'file_size': logo_path.stat().st_size,
+ 'is_problematic': False,
+ 'issues': [],
+ 'recommendations': []
+ }
+
+ # Check for white box issues
+ self._check_white_box_issues(img_rgba, analysis)
+
+ # Check dimensions
+ self._check_dimensions(width, height, analysis)
+
+ # Check transparency
+ self._check_transparency(img_rgba, analysis)
+
+ # Check if image is mostly empty/white
+ self._check_content_density(img_rgba, analysis)
+
+ return analysis
+
+ except Exception as e:
+ raise Exception(f"Failed to analyze image: {e}")
+
+ def _check_white_box_issues(self, img: Image.Image, analysis: Dict):
+ """Check for potential white box issues."""
+ # Get image statistics
+ stat = ImageStat.Stat(img)
+
+ # Check if image is mostly white
+ if img.mode == 'RGBA':
+ # For RGBA, check RGB channels
+ r_mean, g_mean, b_mean = stat.mean[:3]
+ if r_mean > 240 and g_mean > 240 and b_mean > 240:
+ analysis['issues'].append("Image appears to be mostly white")
+ analysis['is_problematic'] = True
+
+ # Check for completely transparent images
+ if img.mode == 'RGBA':
+ alpha_channel = img.split()[3]
+ alpha_stat = ImageStat.Stat(alpha_channel)
+ if alpha_stat.mean[0] < 10: # Very low alpha
+ analysis['issues'].append("Image is mostly transparent")
+ analysis['is_problematic'] = True
+
+ def _check_dimensions(self, width: int, height: int, analysis: Dict):
+ """Check if dimensions are reasonable."""
+ if width < 16 or height < 16:
+ analysis['issues'].append(f"Very small dimensions: {width}x{height}")
+ analysis['is_problematic'] = True
+ analysis['recommendations'].append("Consider using a higher resolution logo")
+
+ if width > 512 or height > 512:
+ analysis['issues'].append(f"Very large dimensions: {width}x{height}")
+ analysis['recommendations'].append("Consider optimizing logo size for better performance")
+
+ # Check aspect ratio
+ aspect_ratio = width / height
+ if aspect_ratio > 4 or aspect_ratio < 0.25:
+ analysis['issues'].append(f"Extreme aspect ratio: {aspect_ratio:.2f}")
+ analysis['recommendations'].append("Consider using a more square logo")
+
+ def _check_transparency(self, img: Image.Image, analysis: Dict):
+ """Check transparency handling."""
+ if img.mode == 'RGBA':
+ # Check if there's any transparency
+ alpha_channel = img.split()[3]
+ alpha_data = list(alpha_channel.getdata())
+ min_alpha = min(alpha_data)
+ max_alpha = max(alpha_data)
+
+ if min_alpha < 255:
+ analysis['recommendations'].append("Logo has transparency - ensure proper background handling")
+
+ if max_alpha < 128:
+ analysis['issues'].append("Logo is very transparent")
+ analysis['is_problematic'] = True
+
+ def _check_content_density(self, img: Image.Image, analysis: Dict):
+ """Check if the image has sufficient content."""
+ # Convert to grayscale for analysis
+ gray = img.convert('L')
+
+ # Count non-white pixels (assuming white background)
+ pixels = list(gray.getdata())
+ non_white_pixels = sum(1 for p in pixels if p < 240)
+ total_pixels = len(pixels)
+ content_ratio = non_white_pixels / total_pixels
+
+ if content_ratio < 0.05: # Less than 5% content
+ analysis['issues'].append(f"Very low content density: {content_ratio:.1%}")
+ analysis['is_problematic'] = True
+ analysis['recommendations'].append("Logo may appear as a white box - check content")
+
+ def _check_orphaned_logos(self, existing_files: Set[str]):
+ """Check for logo files that exist but aren't mapped."""
+ mapped_filenames = set(BROADCAST_LOGO_MAP.values())
+ orphaned_files = existing_files - mapped_filenames
+
+ if orphaned_files:
+ self.results['orphaned_logos'] = list(orphaned_files)
+ logger.info(f"Found {len(orphaned_files)} orphaned logo files: {orphaned_files}")
+
+ def _generate_recommendations(self):
+ """Generate overall recommendations."""
+ recommendations = []
+
+ if self.results['missing_logos']:
+ recommendations.append(f"Add {len(self.results['missing_logos'])} missing logo files")
+
+ if self.results['problematic_logos']:
+ recommendations.append(f"Fix {len(self.results['problematic_logos'])} problematic logos")
+
+ if 'orphaned_logos' in self.results:
+ recommendations.append(f"Consider mapping {len(self.results['orphaned_logos'])} orphaned logo files")
+
+ # General recommendations
+ recommendations.extend([
+ "Ensure all logos are PNG format with transparency support",
+ "Use consistent dimensions (preferably 64x64 or 128x128 pixels)",
+ "Test logos on the actual LED matrix display",
+ "Consider creating fallback logos for missing channels"
+ ])
+
+ self.results['recommendations'] = recommendations
+
+ def print_report(self):
+ """Print a detailed analysis report."""
+ print("\n" + "="*80)
+ print("BROADCAST LOGO ANALYSIS REPORT")
+ print("="*80)
+
+ print(f"\nSUMMARY:")
+ print(f" Total broadcast mappings: {self.results['total_mappings']}")
+ print(f" Existing logos: {len(self.results['existing_logos'])}")
+ print(f" Missing logos: {len(self.results['missing_logos'])}")
+ print(f" Problematic logos: {len(self.results['problematic_logos'])}")
+
+ if 'orphaned_logos' in self.results:
+ print(f" Orphaned logos: {len(self.results['orphaned_logos'])}")
+
+ # Missing logos
+ if self.results['missing_logos']:
+ print(f"\nMISSING LOGOS ({len(self.results['missing_logos'])}):")
+ print("-" * 50)
+ for missing in self.results['missing_logos']:
+ print(f" {missing['broadcast_name']} -> {missing['logo_filename']}.png")
+ print(f" Expected: {missing['expected_path']}")
+
+ # Problematic logos
+ if self.results['problematic_logos']:
+ print(f"\nPROBLEMATIC LOGOS ({len(self.results['problematic_logos'])}):")
+ print("-" * 50)
+ for problematic in self.results['problematic_logos']:
+ print(f" {problematic['broadcast_name']} -> {problematic['logo_filename']}")
+ if 'error' in problematic:
+ print(f" Error: {problematic['error']}")
+ if 'issues' in problematic:
+ for issue in problematic['issues']:
+ print(f" Issue: {issue}")
+ if 'recommendations' in problematic:
+ for rec in problematic['recommendations']:
+ print(f" Recommendation: {rec}")
+
+ # Orphaned logos
+ if 'orphaned_logos' in self.results and self.results['orphaned_logos']:
+ print(f"\nORPHANED LOGOS ({len(self.results['orphaned_logos'])}):")
+ print("-" * 50)
+ for orphaned in self.results['orphaned_logos']:
+ print(f" {orphaned}.png (not mapped in BROADCAST_LOGO_MAP)")
+
+ # Recommendations
+ if self.results['recommendations']:
+ print(f"\nRECOMMENDATIONS:")
+ print("-" * 50)
+ for i, rec in enumerate(self.results['recommendations'], 1):
+ print(f" {i}. {rec}")
+
+ print("\n" + "="*80)
+
+ def save_report(self, output_file: str = "broadcast_logo_analysis.json"):
+ """Save the analysis results to a JSON file."""
+ output_path = self.project_root / "test" / output_file
+ with open(output_path, 'w') as f:
+ json.dump(self.results, f, indent=2)
+ logger.info(f"Analysis report saved to: {output_path}")
+
+def main():
+ """Main function to run the broadcast logo analysis."""
+ print("Broadcast Logo Analyzer")
+ print("=" * 50)
+
+ # Check if we're in the right directory structure
+ if not (project_root / "assets" / "broadcast_logos").exists():
+ print("ERROR: This script must be run from the LEDMatrix project root directory")
+ print(f"Expected directory structure: {project_root}/assets/broadcast_logos/")
+ print("Please run this script on the Raspberry Pi where the LEDMatrix project is located.")
+ print("\nTo test the script logic locally, you can copy some logo files to the expected location.")
+ return 1
+
+ # Initialize analyzer
+ analyzer = BroadcastLogoAnalyzer(project_root)
+
+ # Run analysis
+ try:
+ results = analyzer.analyze_all_logos()
+
+ # Print report
+ analyzer.print_report()
+
+ # Save report
+ analyzer.save_report()
+
+ # Return exit code based on issues found
+ total_issues = len(results['missing_logos']) + len(results['problematic_logos'])
+ if total_issues > 0:
+ print(f"\n⚠️ Found {total_issues} issues that need attention!")
+ return 1
+ else:
+ print(f"\n✅ All broadcast logos are in good condition!")
+ return 0
+
+ except Exception as e:
+ logger.error(f"Analysis failed: {e}")
+ return 1
+
+if __name__ == "__main__":
+ exit(main())
diff --git a/test/broadcast_logo_analysis.json b/test/broadcast_logo_analysis.json
new file mode 100644
index 00000000..01768bb0
--- /dev/null
+++ b/test/broadcast_logo_analysis.json
@@ -0,0 +1,757 @@
+{
+ "total_mappings": 44,
+ "existing_logos": [
+ {
+ "broadcast_name": "ACC Network",
+ "logo_filename": "accn",
+ "path": "C:\\Users\\Charles\\Documents\\GitHub\\LEDMatrix\\assets\\broadcast_logos\\accn.png",
+ "dimensions": [
+ 512,
+ 150
+ ],
+ "mode": "RGBA",
+ "file_size": 6772,
+ "is_problematic": false,
+ "issues": [],
+ "recommendations": [
+ "Logo has transparency - ensure proper background handling"
+ ]
+ },
+ {
+ "broadcast_name": "ACCN",
+ "logo_filename": "accn",
+ "path": "C:\\Users\\Charles\\Documents\\GitHub\\LEDMatrix\\assets\\broadcast_logos\\accn.png",
+ "dimensions": [
+ 512,
+ 150
+ ],
+ "mode": "RGBA",
+ "file_size": 6772,
+ "is_problematic": false,
+ "issues": [],
+ "recommendations": [
+ "Logo has transparency - ensure proper background handling"
+ ]
+ },
+ {
+ "broadcast_name": "ABC",
+ "logo_filename": "abc",
+ "path": "C:\\Users\\Charles\\Documents\\GitHub\\LEDMatrix\\assets\\broadcast_logos\\abc.png",
+ "dimensions": [
+ 512,
+ 511
+ ],
+ "mode": "P",
+ "file_size": 21748,
+ "is_problematic": false,
+ "issues": [],
+ "recommendations": [
+ "Logo has transparency - ensure proper background handling"
+ ]
+ },
+ {
+ "broadcast_name": "BTN",
+ "logo_filename": "btn",
+ "path": "C:\\Users\\Charles\\Documents\\GitHub\\LEDMatrix\\assets\\broadcast_logos\\btn.png",
+ "dimensions": [
+ 512,
+ 309
+ ],
+ "mode": "P",
+ "file_size": 4281,
+ "is_problematic": false,
+ "issues": [],
+ "recommendations": [
+ "Logo has transparency - ensure proper background handling"
+ ]
+ },
+ {
+ "broadcast_name": "CBS",
+ "logo_filename": "cbs",
+ "path": "C:\\Users\\Charles\\Documents\\GitHub\\LEDMatrix\\assets\\broadcast_logos\\cbs.png",
+ "dimensions": [
+ 330,
+ 96
+ ],
+ "mode": "RGBA",
+ "file_size": 10111,
+ "is_problematic": false,
+ "issues": [],
+ "recommendations": [
+ "Logo has transparency - ensure proper background handling"
+ ]
+ },
+ {
+ "broadcast_name": "CBSSN",
+ "logo_filename": "cbssn",
+ "path": "C:\\Users\\Charles\\Documents\\GitHub\\LEDMatrix\\assets\\broadcast_logos\\cbssn.png",
+ "dimensions": [
+ 512,
+ 111
+ ],
+ "mode": "RGBA",
+ "file_size": 16230,
+ "is_problematic": false,
+ "issues": [
+ "Extreme aspect ratio: 4.61"
+ ],
+ "recommendations": [
+ "Consider using a more square logo",
+ "Logo has transparency - ensure proper background handling"
+ ]
+ },
+ {
+ "broadcast_name": "CBS Sports Network",
+ "logo_filename": "cbssn",
+ "path": "C:\\Users\\Charles\\Documents\\GitHub\\LEDMatrix\\assets\\broadcast_logos\\cbssn.png",
+ "dimensions": [
+ 512,
+ 111
+ ],
+ "mode": "RGBA",
+ "file_size": 16230,
+ "is_problematic": false,
+ "issues": [
+ "Extreme aspect ratio: 4.61"
+ ],
+ "recommendations": [
+ "Consider using a more square logo",
+ "Logo has transparency - ensure proper background handling"
+ ]
+ },
+ {
+ "broadcast_name": "ESPN",
+ "logo_filename": "espn",
+ "path": "C:\\Users\\Charles\\Documents\\GitHub\\LEDMatrix\\assets\\broadcast_logos\\espn.png",
+ "dimensions": [
+ 512,
+ 512
+ ],
+ "mode": "RGBA",
+ "file_size": 7391,
+ "is_problematic": false,
+ "issues": [],
+ "recommendations": [
+ "Logo has transparency - ensure proper background handling"
+ ]
+ },
+ {
+ "broadcast_name": "ESPN2",
+ "logo_filename": "espn2",
+ "path": "C:\\Users\\Charles\\Documents\\GitHub\\LEDMatrix\\assets\\broadcast_logos\\espn2.png",
+ "dimensions": [
+ 512,
+ 97
+ ],
+ "mode": "P",
+ "file_size": 3996,
+ "is_problematic": false,
+ "issues": [
+ "Extreme aspect ratio: 5.28"
+ ],
+ "recommendations": [
+ "Consider using a more square logo",
+ "Logo has transparency - ensure proper background handling"
+ ]
+ },
+ {
+ "broadcast_name": "ESPN3",
+ "logo_filename": "espn3",
+ "path": "C:\\Users\\Charles\\Documents\\GitHub\\LEDMatrix\\assets\\broadcast_logos\\espn3.png",
+ "dimensions": [
+ 512,
+ 101
+ ],
+ "mode": "P",
+ "file_size": 4221,
+ "is_problematic": false,
+ "issues": [
+ "Extreme aspect ratio: 5.07"
+ ],
+ "recommendations": [
+ "Consider using a more square logo",
+ "Logo has transparency - ensure proper background handling"
+ ]
+ },
+ {
+ "broadcast_name": "ESPNU",
+ "logo_filename": "espnu",
+ "path": "C:\\Users\\Charles\\Documents\\GitHub\\LEDMatrix\\assets\\broadcast_logos\\espnu.png",
+ "dimensions": [
+ 512,
+ 147
+ ],
+ "mode": "RGBA",
+ "file_size": 6621,
+ "is_problematic": false,
+ "issues": [],
+ "recommendations": [
+ "Logo has transparency - ensure proper background handling"
+ ]
+ },
+ {
+ "broadcast_name": "ESPNEWS",
+ "logo_filename": "espn",
+ "path": "C:\\Users\\Charles\\Documents\\GitHub\\LEDMatrix\\assets\\broadcast_logos\\espn.png",
+ "dimensions": [
+ 512,
+ 512
+ ],
+ "mode": "RGBA",
+ "file_size": 7391,
+ "is_problematic": false,
+ "issues": [],
+ "recommendations": [
+ "Logo has transparency - ensure proper background handling"
+ ]
+ },
+ {
+ "broadcast_name": "ESPN+",
+ "logo_filename": "espn",
+ "path": "C:\\Users\\Charles\\Documents\\GitHub\\LEDMatrix\\assets\\broadcast_logos\\espn.png",
+ "dimensions": [
+ 512,
+ 512
+ ],
+ "mode": "RGBA",
+ "file_size": 7391,
+ "is_problematic": false,
+ "issues": [],
+ "recommendations": [
+ "Logo has transparency - ensure proper background handling"
+ ]
+ },
+ {
+ "broadcast_name": "ESPN Plus",
+ "logo_filename": "espn",
+ "path": "C:\\Users\\Charles\\Documents\\GitHub\\LEDMatrix\\assets\\broadcast_logos\\espn.png",
+ "dimensions": [
+ 512,
+ 512
+ ],
+ "mode": "RGBA",
+ "file_size": 7391,
+ "is_problematic": false,
+ "issues": [],
+ "recommendations": [
+ "Logo has transparency - ensure proper background handling"
+ ]
+ },
+ {
+ "broadcast_name": "FOX",
+ "logo_filename": "fox",
+ "path": "C:\\Users\\Charles\\Documents\\GitHub\\LEDMatrix\\assets\\broadcast_logos\\fox.png",
+ "dimensions": [
+ 512,
+ 307
+ ],
+ "mode": "RGBA",
+ "file_size": 94499,
+ "is_problematic": false,
+ "issues": [],
+ "recommendations": [
+ "Logo has transparency - ensure proper background handling"
+ ]
+ },
+ {
+ "broadcast_name": "FS1",
+ "logo_filename": "fs1",
+ "path": "C:\\Users\\Charles\\Documents\\GitHub\\LEDMatrix\\assets\\broadcast_logos\\fs1.png",
+ "dimensions": [
+ 512,
+ 257
+ ],
+ "mode": "RGBA",
+ "file_size": 8139,
+ "is_problematic": false,
+ "issues": [],
+ "recommendations": [
+ "Logo has transparency - ensure proper background handling"
+ ]
+ },
+ {
+ "broadcast_name": "FS2",
+ "logo_filename": "fs2",
+ "path": "C:\\Users\\Charles\\Documents\\GitHub\\LEDMatrix\\assets\\broadcast_logos\\fs2.png",
+ "dimensions": [
+ 512,
+ 256
+ ],
+ "mode": "RGBA",
+ "file_size": 8204,
+ "is_problematic": false,
+ "issues": [],
+ "recommendations": [
+ "Logo has transparency - ensure proper background handling"
+ ]
+ },
+ {
+ "broadcast_name": "MLBN",
+ "logo_filename": "mlbn",
+ "path": "C:\\Users\\Charles\\Documents\\GitHub\\LEDMatrix\\assets\\broadcast_logos\\mlbn.png",
+ "dimensions": [
+ 512,
+ 528
+ ],
+ "mode": "RGBA",
+ "file_size": 42129,
+ "is_problematic": false,
+ "issues": [
+ "Very large dimensions: 512x528"
+ ],
+ "recommendations": [
+ "Consider optimizing logo size for better performance",
+ "Logo has transparency - ensure proper background handling"
+ ]
+ },
+ {
+ "broadcast_name": "MLB Network",
+ "logo_filename": "mlbn",
+ "path": "C:\\Users\\Charles\\Documents\\GitHub\\LEDMatrix\\assets\\broadcast_logos\\mlbn.png",
+ "dimensions": [
+ 512,
+ 528
+ ],
+ "mode": "RGBA",
+ "file_size": 42129,
+ "is_problematic": false,
+ "issues": [
+ "Very large dimensions: 512x528"
+ ],
+ "recommendations": [
+ "Consider optimizing logo size for better performance",
+ "Logo has transparency - ensure proper background handling"
+ ]
+ },
+ {
+ "broadcast_name": "MLB.TV",
+ "logo_filename": "mlbn",
+ "path": "C:\\Users\\Charles\\Documents\\GitHub\\LEDMatrix\\assets\\broadcast_logos\\mlbn.png",
+ "dimensions": [
+ 512,
+ 528
+ ],
+ "mode": "RGBA",
+ "file_size": 42129,
+ "is_problematic": false,
+ "issues": [
+ "Very large dimensions: 512x528"
+ ],
+ "recommendations": [
+ "Consider optimizing logo size for better performance",
+ "Logo has transparency - ensure proper background handling"
+ ]
+ },
+ {
+ "broadcast_name": "NBC",
+ "logo_filename": "nbc",
+ "path": "C:\\Users\\Charles\\Documents\\GitHub\\LEDMatrix\\assets\\broadcast_logos\\nbc.png",
+ "dimensions": [
+ 512,
+ 479
+ ],
+ "mode": "RGBA",
+ "file_size": 15720,
+ "is_problematic": false,
+ "issues": [],
+ "recommendations": [
+ "Logo has transparency - ensure proper background handling"
+ ]
+ },
+ {
+ "broadcast_name": "NFLN",
+ "logo_filename": "nfln",
+ "path": "C:\\Users\\Charles\\Documents\\GitHub\\LEDMatrix\\assets\\broadcast_logos\\nfln.png",
+ "dimensions": [
+ 330,
+ 130
+ ],
+ "mode": "RGBA",
+ "file_size": 10944,
+ "is_problematic": false,
+ "issues": [],
+ "recommendations": [
+ "Logo has transparency - ensure proper background handling"
+ ]
+ },
+ {
+ "broadcast_name": "NFL Network",
+ "logo_filename": "nfln",
+ "path": "C:\\Users\\Charles\\Documents\\GitHub\\LEDMatrix\\assets\\broadcast_logos\\nfln.png",
+ "dimensions": [
+ 330,
+ 130
+ ],
+ "mode": "RGBA",
+ "file_size": 10944,
+ "is_problematic": false,
+ "issues": [],
+ "recommendations": [
+ "Logo has transparency - ensure proper background handling"
+ ]
+ },
+ {
+ "broadcast_name": "PAC12",
+ "logo_filename": "pac12n",
+ "path": "C:\\Users\\Charles\\Documents\\GitHub\\LEDMatrix\\assets\\broadcast_logos\\pac12n.png",
+ "dimensions": [
+ 512,
+ 645
+ ],
+ "mode": "RGBA",
+ "file_size": 84038,
+ "is_problematic": false,
+ "issues": [
+ "Very large dimensions: 512x645"
+ ],
+ "recommendations": [
+ "Consider optimizing logo size for better performance",
+ "Logo has transparency - ensure proper background handling"
+ ]
+ },
+ {
+ "broadcast_name": "Pac-12 Network",
+ "logo_filename": "pac12n",
+ "path": "C:\\Users\\Charles\\Documents\\GitHub\\LEDMatrix\\assets\\broadcast_logos\\pac12n.png",
+ "dimensions": [
+ 512,
+ 645
+ ],
+ "mode": "RGBA",
+ "file_size": 84038,
+ "is_problematic": false,
+ "issues": [
+ "Very large dimensions: 512x645"
+ ],
+ "recommendations": [
+ "Consider optimizing logo size for better performance",
+ "Logo has transparency - ensure proper background handling"
+ ]
+ },
+ {
+ "broadcast_name": "SECN",
+ "logo_filename": "espn-sec-us",
+ "path": "C:\\Users\\Charles\\Documents\\GitHub\\LEDMatrix\\assets\\broadcast_logos\\espn-sec-us.png",
+ "dimensions": [
+ 512,
+ 718
+ ],
+ "mode": "RGBA",
+ "file_size": 87531,
+ "is_problematic": false,
+ "issues": [
+ "Very large dimensions: 512x718"
+ ],
+ "recommendations": [
+ "Consider optimizing logo size for better performance",
+ "Logo has transparency - ensure proper background handling"
+ ]
+ },
+ {
+ "broadcast_name": "TBS",
+ "logo_filename": "tbs",
+ "path": "C:\\Users\\Charles\\Documents\\GitHub\\LEDMatrix\\assets\\broadcast_logos\\tbs.png",
+ "dimensions": [
+ 512,
+ 276
+ ],
+ "mode": "RGBA",
+ "file_size": 61816,
+ "is_problematic": false,
+ "issues": [],
+ "recommendations": [
+ "Logo has transparency - ensure proper background handling"
+ ]
+ },
+ {
+ "broadcast_name": "truTV",
+ "logo_filename": "tru",
+ "path": "C:\\Users\\Charles\\Documents\\GitHub\\LEDMatrix\\assets\\broadcast_logos\\tru.png",
+ "dimensions": [
+ 512,
+ 198
+ ],
+ "mode": "RGBA",
+ "file_size": 11223,
+ "is_problematic": false,
+ "issues": [],
+ "recommendations": [
+ "Logo has transparency - ensure proper background handling"
+ ]
+ },
+ {
+ "broadcast_name": "Peacock",
+ "logo_filename": "nbc",
+ "path": "C:\\Users\\Charles\\Documents\\GitHub\\LEDMatrix\\assets\\broadcast_logos\\nbc.png",
+ "dimensions": [
+ 512,
+ 479
+ ],
+ "mode": "RGBA",
+ "file_size": 15720,
+ "is_problematic": false,
+ "issues": [],
+ "recommendations": [
+ "Logo has transparency - ensure proper background handling"
+ ]
+ },
+ {
+ "broadcast_name": "Paramount+",
+ "logo_filename": "paramount-plus",
+ "path": "C:\\Users\\Charles\\Documents\\GitHub\\LEDMatrix\\assets\\broadcast_logos\\paramount-plus.png",
+ "dimensions": [
+ 330,
+ 205
+ ],
+ "mode": "RGBA",
+ "file_size": 17617,
+ "is_problematic": false,
+ "issues": [],
+ "recommendations": [
+ "Logo has transparency - ensure proper background handling"
+ ]
+ },
+ {
+ "broadcast_name": "Hulu",
+ "logo_filename": "espn",
+ "path": "C:\\Users\\Charles\\Documents\\GitHub\\LEDMatrix\\assets\\broadcast_logos\\espn.png",
+ "dimensions": [
+ 512,
+ 512
+ ],
+ "mode": "RGBA",
+ "file_size": 7391,
+ "is_problematic": false,
+ "issues": [],
+ "recommendations": [
+ "Logo has transparency - ensure proper background handling"
+ ]
+ },
+ {
+ "broadcast_name": "Disney+",
+ "logo_filename": "espn",
+ "path": "C:\\Users\\Charles\\Documents\\GitHub\\LEDMatrix\\assets\\broadcast_logos\\espn.png",
+ "dimensions": [
+ 512,
+ 512
+ ],
+ "mode": "RGBA",
+ "file_size": 7391,
+ "is_problematic": false,
+ "issues": [],
+ "recommendations": [
+ "Logo has transparency - ensure proper background handling"
+ ]
+ },
+ {
+ "broadcast_name": "Apple TV+",
+ "logo_filename": "nbc",
+ "path": "C:\\Users\\Charles\\Documents\\GitHub\\LEDMatrix\\assets\\broadcast_logos\\nbc.png",
+ "dimensions": [
+ 512,
+ 479
+ ],
+ "mode": "RGBA",
+ "file_size": 15720,
+ "is_problematic": false,
+ "issues": [],
+ "recommendations": [
+ "Logo has transparency - ensure proper background handling"
+ ]
+ },
+ {
+ "broadcast_name": "MASN",
+ "logo_filename": "cbs",
+ "path": "C:\\Users\\Charles\\Documents\\GitHub\\LEDMatrix\\assets\\broadcast_logos\\cbs.png",
+ "dimensions": [
+ 330,
+ 96
+ ],
+ "mode": "RGBA",
+ "file_size": 10111,
+ "is_problematic": false,
+ "issues": [],
+ "recommendations": [
+ "Logo has transparency - ensure proper background handling"
+ ]
+ },
+ {
+ "broadcast_name": "MASN2",
+ "logo_filename": "cbs",
+ "path": "C:\\Users\\Charles\\Documents\\GitHub\\LEDMatrix\\assets\\broadcast_logos\\cbs.png",
+ "dimensions": [
+ 330,
+ 96
+ ],
+ "mode": "RGBA",
+ "file_size": 10111,
+ "is_problematic": false,
+ "issues": [],
+ "recommendations": [
+ "Logo has transparency - ensure proper background handling"
+ ]
+ },
+ {
+ "broadcast_name": "MAS+",
+ "logo_filename": "cbs",
+ "path": "C:\\Users\\Charles\\Documents\\GitHub\\LEDMatrix\\assets\\broadcast_logos\\cbs.png",
+ "dimensions": [
+ 330,
+ 96
+ ],
+ "mode": "RGBA",
+ "file_size": 10111,
+ "is_problematic": false,
+ "issues": [],
+ "recommendations": [
+ "Logo has transparency - ensure proper background handling"
+ ]
+ },
+ {
+ "broadcast_name": "SportsNet",
+ "logo_filename": "nbc",
+ "path": "C:\\Users\\Charles\\Documents\\GitHub\\LEDMatrix\\assets\\broadcast_logos\\nbc.png",
+ "dimensions": [
+ 512,
+ 479
+ ],
+ "mode": "RGBA",
+ "file_size": 15720,
+ "is_problematic": false,
+ "issues": [],
+ "recommendations": [
+ "Logo has transparency - ensure proper background handling"
+ ]
+ },
+ {
+ "broadcast_name": "FanDuel SN",
+ "logo_filename": "fox",
+ "path": "C:\\Users\\Charles\\Documents\\GitHub\\LEDMatrix\\assets\\broadcast_logos\\fox.png",
+ "dimensions": [
+ 512,
+ 307
+ ],
+ "mode": "RGBA",
+ "file_size": 94499,
+ "is_problematic": false,
+ "issues": [],
+ "recommendations": [
+ "Logo has transparency - ensure proper background handling"
+ ]
+ },
+ {
+ "broadcast_name": "FanDuel SN DET",
+ "logo_filename": "fox",
+ "path": "C:\\Users\\Charles\\Documents\\GitHub\\LEDMatrix\\assets\\broadcast_logos\\fox.png",
+ "dimensions": [
+ 512,
+ 307
+ ],
+ "mode": "RGBA",
+ "file_size": 94499,
+ "is_problematic": false,
+ "issues": [],
+ "recommendations": [
+ "Logo has transparency - ensure proper background handling"
+ ]
+ },
+ {
+ "broadcast_name": "FanDuel SN FL",
+ "logo_filename": "fox",
+ "path": "C:\\Users\\Charles\\Documents\\GitHub\\LEDMatrix\\assets\\broadcast_logos\\fox.png",
+ "dimensions": [
+ 512,
+ 307
+ ],
+ "mode": "RGBA",
+ "file_size": 94499,
+ "is_problematic": false,
+ "issues": [],
+ "recommendations": [
+ "Logo has transparency - ensure proper background handling"
+ ]
+ },
+ {
+ "broadcast_name": "SportsNet PIT",
+ "logo_filename": "nbc",
+ "path": "C:\\Users\\Charles\\Documents\\GitHub\\LEDMatrix\\assets\\broadcast_logos\\nbc.png",
+ "dimensions": [
+ 512,
+ 479
+ ],
+ "mode": "RGBA",
+ "file_size": 15720,
+ "is_problematic": false,
+ "issues": [],
+ "recommendations": [
+ "Logo has transparency - ensure proper background handling"
+ ]
+ },
+ {
+ "broadcast_name": "Padres.TV",
+ "logo_filename": "espn",
+ "path": "C:\\Users\\Charles\\Documents\\GitHub\\LEDMatrix\\assets\\broadcast_logos\\espn.png",
+ "dimensions": [
+ 512,
+ 512
+ ],
+ "mode": "RGBA",
+ "file_size": 7391,
+ "is_problematic": false,
+ "issues": [],
+ "recommendations": [
+ "Logo has transparency - ensure proper background handling"
+ ]
+ },
+ {
+ "broadcast_name": "CLEGuardians.TV",
+ "logo_filename": "espn",
+ "path": "C:\\Users\\Charles\\Documents\\GitHub\\LEDMatrix\\assets\\broadcast_logos\\espn.png",
+ "dimensions": [
+ 512,
+ 512
+ ],
+ "mode": "RGBA",
+ "file_size": 7391,
+ "is_problematic": false,
+ "issues": [],
+ "recommendations": [
+ "Logo has transparency - ensure proper background handling"
+ ]
+ }
+ ],
+ "missing_logos": [],
+ "problematic_logos": [
+ {
+ "broadcast_name": "TNT",
+ "logo_filename": "tnt",
+ "path": "C:\\Users\\Charles\\Documents\\GitHub\\LEDMatrix\\assets\\broadcast_logos\\tnt.png",
+ "dimensions": [
+ 512,
+ 512
+ ],
+ "mode": "P",
+ "file_size": 6131,
+ "is_problematic": true,
+ "issues": [
+ "Image appears to be mostly white",
+ "Very low content density: 0.0%"
+ ],
+ "recommendations": [
+ "Logo has transparency - ensure proper background handling",
+ "Logo may appear as a white box - check content"
+ ]
+ }
+ ],
+ "recommendations": [
+ "Fix 1 problematic logos",
+ "Consider mapping 1 orphaned logo files",
+ "Ensure all logos are PNG format with transparency support",
+ "Use consistent dimensions (preferably 64x64 or 128x128 pixels)",
+ "Test logos on the actual LED matrix display",
+ "Consider creating fallback logos for missing channels"
+ ],
+ "orphaned_logos": [
+ "prime"
+ ]
+}
\ No newline at end of file
diff --git a/test/debug_espn_api.py b/test/debug_espn_api.py
new file mode 100644
index 00000000..510e0444
--- /dev/null
+++ b/test/debug_espn_api.py
@@ -0,0 +1,85 @@
+#!/usr/bin/env python3
+"""
+Debug script to examine ESPN API response structure
+"""
+
+import requests
+import json
+
+def debug_espn_api():
+ """Debug ESPN API responses."""
+
+ # Test different endpoints
+ test_endpoints = [
+ {
+ 'name': 'NFL Standings',
+ 'url': 'https://site.api.espn.com/apis/site/v2/sports/football/nfl/standings'
+ },
+ {
+ 'name': 'NFL Teams',
+ 'url': 'https://site.api.espn.com/apis/site/v2/sports/football/nfl/teams'
+ },
+ {
+ 'name': 'NFL Scoreboard',
+ 'url': 'https://site.api.espn.com/apis/site/v2/sports/football/nfl/scoreboard'
+ },
+ {
+ 'name': 'NBA Teams',
+ 'url': 'https://site.api.espn.com/apis/site/v2/sports/basketball/nba/teams'
+ },
+ {
+ 'name': 'MLB Teams',
+ 'url': 'https://site.api.espn.com/apis/site/v2/sports/baseball/mlb/teams'
+ }
+ ]
+
+ for endpoint in test_endpoints:
+ print(f"\n{'='*50}")
+ print(f"Testing {endpoint['name']}")
+ print(f"URL: {endpoint['url']}")
+ print('='*50)
+
+ try:
+ response = requests.get(endpoint['url'], timeout=30)
+ response.raise_for_status()
+ data = response.json()
+
+ print(f"Response status: {response.status_code}")
+ print(f"Response keys: {list(data.keys())}")
+
+ # Print a sample of the response
+ if 'sports' in data:
+ sports = data['sports']
+ print(f"Sports found: {len(sports)}")
+ if sports:
+ leagues = sports[0].get('leagues', [])
+ print(f"Leagues found: {len(leagues)}")
+ if leagues:
+ teams = leagues[0].get('teams', [])
+ print(f"Teams found: {len(teams)}")
+ if teams:
+ print("Sample team data:")
+ sample_team = teams[0]
+ print(f" Team: {sample_team.get('team', {}).get('name', 'Unknown')}")
+ print(f" Abbreviation: {sample_team.get('team', {}).get('abbreviation', 'Unknown')}")
+ stats = sample_team.get('stats', [])
+ print(f" Stats found: {len(stats)}")
+ for stat in stats[:3]: # Show first 3 stats
+ print(f" {stat.get('name', 'Unknown')}: {stat.get('value', 'Unknown')}")
+
+ elif 'groups' in data:
+ groups = data['groups']
+ print(f"Groups found: {len(groups)}")
+ if groups:
+ print("Sample group data:")
+ print(json.dumps(groups[0], indent=2)[:500] + "...")
+
+ else:
+ print("Sample response data:")
+ print(json.dumps(data, indent=2)[:500] + "...")
+
+ except Exception as e:
+ print(f"Error: {e}")
+
+if __name__ == "__main__":
+ debug_espn_api()
diff --git a/test/download_espn_ncaa_fb_logos.py b/test/download_espn_ncaa_fb_logos.py
new file mode 100644
index 00000000..54afc90c
--- /dev/null
+++ b/test/download_espn_ncaa_fb_logos.py
@@ -0,0 +1,192 @@
+#!/usr/bin/env python3
+"""
+Script to download all NCAA Football team logos from ESPN API
+and update the all_team_abbreviations.txt file with current ESPN abbreviations.
+"""
+
+import os
+import requests
+import json
+from pathlib import Path
+import time
+
+def create_logo_directory():
+ """Create the ncaaFBlogos directory if it doesn't exist."""
+ logo_dir = Path("test/ncaaFBlogos")
+ logo_dir.mkdir(parents=True, exist_ok=True)
+ return logo_dir
+
+def fetch_teams_data():
+ """Fetch team data from ESPN API."""
+ url = "https://site.api.espn.com/apis/site/v2/sports/football/college-football/teams"
+
+ try:
+ response = requests.get(url, timeout=30)
+ response.raise_for_status()
+ return response.json()
+ except requests.exceptions.RequestException as e:
+ print(f"Error fetching teams data: {e}")
+ return None
+
+def download_logo(url, filepath, team_name):
+ """Download a logo from URL and save to filepath."""
+ try:
+ response = requests.get(url, timeout=30)
+ response.raise_for_status()
+
+ with open(filepath, 'wb') as f:
+ f.write(response.content)
+
+ print(f"✓ Downloaded: {team_name} -> {filepath.name}")
+ return True
+
+ except requests.exceptions.RequestException as e:
+ print(f"✗ Failed to download {team_name}: {e}")
+ return False
+
+def normalize_abbreviation(abbreviation):
+ """Normalize team abbreviation to lowercase for filename."""
+ return abbreviation.lower()
+
+def update_abbreviations_file(teams_data, abbreviations_file_path):
+ """Update the all_team_abbreviations.txt file with current ESPN abbreviations."""
+ print(f"\nUpdating abbreviations file: {abbreviations_file_path}")
+
+ # Read existing file
+ existing_content = []
+ if os.path.exists(abbreviations_file_path):
+ with open(abbreviations_file_path, 'r', encoding='utf-8') as f:
+ existing_content = f.readlines()
+
+ # Find the NCAAF section
+ ncaaf_start = -1
+ ncaaf_end = -1
+
+ for i, line in enumerate(existing_content):
+ if line.strip() == "NCAAF":
+ ncaaf_start = i
+ elif ncaaf_start != -1 and line.strip() and not line.startswith(" "):
+ ncaaf_end = i
+ break
+
+ if ncaaf_start == -1:
+ print("Warning: Could not find NCAAF section in abbreviations file")
+ return
+
+ if ncaaf_end == -1:
+ ncaaf_end = len(existing_content)
+
+ # Extract teams from ESPN data
+ espn_teams = []
+ for team_data in teams_data:
+ team = team_data.get('team', {})
+ abbreviation = team.get('abbreviation', '')
+ display_name = team.get('displayName', '')
+
+ if abbreviation and display_name:
+ espn_teams.append((abbreviation, display_name))
+
+ # Sort teams by abbreviation
+ espn_teams.sort(key=lambda x: x[0])
+
+ # Create new NCAAF section
+ new_ncaaf_section = ["NCAAF\n"]
+ for abbreviation, display_name in espn_teams:
+ new_ncaaf_section.append(f" {abbreviation} => {display_name}\n")
+ new_ncaaf_section.append("\n")
+
+ # Reconstruct the file
+ new_content = (
+ existing_content[:ncaaf_start] +
+ new_ncaaf_section +
+ existing_content[ncaaf_end:]
+ )
+
+ # Write updated file
+ with open(abbreviations_file_path, 'w', encoding='utf-8') as f:
+ f.writelines(new_content)
+
+ print(f"✓ Updated abbreviations file with {len(espn_teams)} NCAAF teams")
+
+def main():
+ """Main function to download all NCAA FB team logos and update abbreviations."""
+ print("Starting NCAA Football logo download and abbreviations update...")
+
+ # Create directory
+ logo_dir = create_logo_directory()
+ print(f"Created/verified directory: {logo_dir}")
+
+ # Fetch teams data
+ print("Fetching teams data from ESPN API...")
+ data = fetch_teams_data()
+
+ if not data:
+ print("Failed to fetch teams data. Exiting.")
+ return
+
+ # Extract teams
+ teams = []
+ try:
+ sports = data.get('sports', [])
+ for sport in sports:
+ leagues = sport.get('leagues', [])
+ for league in leagues:
+ teams = league.get('teams', [])
+ break
+ except (KeyError, IndexError) as e:
+ print(f"Error parsing teams data: {e}")
+ return
+
+ print(f"Found {len(teams)} teams")
+
+ # Download logos
+ downloaded_count = 0
+ failed_count = 0
+
+ for team_data in teams:
+ team = team_data.get('team', {})
+
+ # Extract team information
+ abbreviation = team.get('abbreviation', '')
+ display_name = team.get('displayName', 'Unknown')
+ logos = team.get('logos', [])
+
+ if not abbreviation or not logos:
+ print(f"⚠ Skipping {display_name}: missing abbreviation or logos")
+ continue
+
+ # Get the default logo (first one is usually default)
+ logo_url = logos[0].get('href', '')
+ if not logo_url:
+ print(f"⚠ Skipping {display_name}: no logo URL")
+ continue
+
+ # Create filename
+ filename = f"{normalize_abbreviation(abbreviation)}.png"
+ filepath = logo_dir / filename
+
+ # Skip if already exists
+ if filepath.exists():
+ print(f"⏭ Skipping {display_name}: {filename} already exists")
+ continue
+
+ # Download logo
+ if download_logo(logo_url, filepath, display_name):
+ downloaded_count += 1
+ else:
+ failed_count += 1
+
+ # Small delay to be respectful to the API
+ time.sleep(0.1)
+
+ print(f"\nDownload complete!")
+ print(f"✓ Successfully downloaded: {downloaded_count} logos")
+ print(f"✗ Failed downloads: {failed_count}")
+ print(f"📁 Logos saved in: {logo_dir}")
+
+ # Update abbreviations file
+ abbreviations_file_path = "assets/sports/all_team_abbreviations.txt"
+ update_abbreviations_file(teams, abbreviations_file_path)
+
+if __name__ == "__main__":
+ main()
diff --git a/test/download_ncaa_fb_logos.py b/test/download_ncaa_fb_logos.py
new file mode 100644
index 00000000..f3cf4915
--- /dev/null
+++ b/test/download_ncaa_fb_logos.py
@@ -0,0 +1,128 @@
+#!/usr/bin/env python3
+"""
+Script to download all NCAA Football team logos from ESPN API
+and save them with team abbreviations as filenames.
+"""
+
+import os
+import requests
+import json
+from pathlib import Path
+import time
+
+def create_logo_directory():
+ """Create the ncaaFBlogos directory if it doesn't exist."""
+ logo_dir = Path("test/ncaaFBlogos")
+ logo_dir.mkdir(parents=True, exist_ok=True)
+ return logo_dir
+
+def fetch_teams_data():
+ """Fetch team data from ESPN API."""
+ url = "https://site.api.espn.com/apis/site/v2/sports/football/college-football/teams"
+
+ try:
+ response = requests.get(url, timeout=30)
+ response.raise_for_status()
+ return response.json()
+ except requests.exceptions.RequestException as e:
+ print(f"Error fetching teams data: {e}")
+ return None
+
+def download_logo(url, filepath, team_name):
+ """Download a logo from URL and save to filepath."""
+ try:
+ response = requests.get(url, timeout=30)
+ response.raise_for_status()
+
+ with open(filepath, 'wb') as f:
+ f.write(response.content)
+
+ print(f"✓ Downloaded: {team_name} -> {filepath.name}")
+ return True
+
+ except requests.exceptions.RequestException as e:
+ print(f"✗ Failed to download {team_name}: {e}")
+ return False
+
+def normalize_abbreviation(abbreviation):
+ """Normalize team abbreviation to lowercase for filename."""
+ return abbreviation.lower()
+
+def main():
+ """Main function to download all NCAA FB team logos."""
+ print("Starting NCAA Football logo download...")
+
+ # Create directory
+ logo_dir = create_logo_directory()
+ print(f"Created/verified directory: {logo_dir}")
+
+ # Fetch teams data
+ print("Fetching teams data from ESPN API...")
+ data = fetch_teams_data()
+
+ if not data:
+ print("Failed to fetch teams data. Exiting.")
+ return
+
+ # Extract teams
+ teams = []
+ try:
+ sports = data.get('sports', [])
+ for sport in sports:
+ leagues = sport.get('leagues', [])
+ for league in leagues:
+ teams = league.get('teams', [])
+ break
+ except (KeyError, IndexError) as e:
+ print(f"Error parsing teams data: {e}")
+ return
+
+ print(f"Found {len(teams)} teams")
+
+ # Download logos
+ downloaded_count = 0
+ failed_count = 0
+
+ for team_data in teams:
+ team = team_data.get('team', {})
+
+ # Extract team information
+ abbreviation = team.get('abbreviation', '')
+ display_name = team.get('displayName', 'Unknown')
+ logos = team.get('logos', [])
+
+ if not abbreviation or not logos:
+ print(f"⚠ Skipping {display_name}: missing abbreviation or logos")
+ continue
+
+ # Get the default logo (first one is usually default)
+ logo_url = logos[0].get('href', '')
+ if not logo_url:
+ print(f"⚠ Skipping {display_name}: no logo URL")
+ continue
+
+ # Create filename
+ filename = f"{normalize_abbreviation(abbreviation)}.png"
+ filepath = logo_dir / filename
+
+ # Skip if already exists
+ if filepath.exists():
+ print(f"⏭ Skipping {display_name}: {filename} already exists")
+ continue
+
+ # Download logo
+ if download_logo(logo_url, filepath, display_name):
+ downloaded_count += 1
+ else:
+ failed_count += 1
+
+ # Small delay to be respectful to the API
+ time.sleep(0.1)
+
+ print(f"\nDownload complete!")
+ print(f"✓ Successfully downloaded: {downloaded_count} logos")
+ print(f"✗ Failed downloads: {failed_count}")
+ print(f"📁 Logos saved in: {logo_dir}")
+
+if __name__ == "__main__":
+ main()
diff --git a/test/ncaaFBlogos/amh.png b/test/ncaaFBlogos/amh.png
new file mode 100644
index 00000000..c9f3ca86
Binary files /dev/null and b/test/ncaaFBlogos/amh.png differ
diff --git a/test/ncaaFBlogos/ann.png b/test/ncaaFBlogos/ann.png
new file mode 100644
index 00000000..6c61e18b
Binary files /dev/null and b/test/ncaaFBlogos/ann.png differ
diff --git a/test/ncaaFBlogos/ariz.png b/test/ncaaFBlogos/ariz.png
new file mode 100644
index 00000000..bd17bbc3
Binary files /dev/null and b/test/ncaaFBlogos/ariz.png differ
diff --git a/test/ncaaFBlogos/ark.png b/test/ncaaFBlogos/ark.png
new file mode 100644
index 00000000..870c0e1c
Binary files /dev/null and b/test/ncaaFBlogos/ark.png differ
diff --git a/test/ncaaFBlogos/asu.png b/test/ncaaFBlogos/asu.png
new file mode 100644
index 00000000..ec9e1162
Binary files /dev/null and b/test/ncaaFBlogos/asu.png differ
diff --git a/test/ncaaFBlogos/aub.png b/test/ncaaFBlogos/aub.png
new file mode 100644
index 00000000..fcd97fab
Binary files /dev/null and b/test/ncaaFBlogos/aub.png differ
diff --git a/test/ncaaFBlogos/bois.png b/test/ncaaFBlogos/bois.png
new file mode 100644
index 00000000..ccbd604e
Binary files /dev/null and b/test/ncaaFBlogos/bois.png differ
diff --git a/test/ncaaFBlogos/brst.png b/test/ncaaFBlogos/brst.png
new file mode 100644
index 00000000..e6bba244
Binary files /dev/null and b/test/ncaaFBlogos/brst.png differ
diff --git a/test/ncaaFBlogos/buena.png b/test/ncaaFBlogos/buena.png
new file mode 100644
index 00000000..88c443b3
Binary files /dev/null and b/test/ncaaFBlogos/buena.png differ
diff --git a/test/ncaaFBlogos/cal.png b/test/ncaaFBlogos/cal.png
new file mode 100644
index 00000000..ebc43156
Binary files /dev/null and b/test/ncaaFBlogos/cal.png differ
diff --git a/test/ncaaFBlogos/car.png b/test/ncaaFBlogos/car.png
new file mode 100644
index 00000000..dff64804
Binary files /dev/null and b/test/ncaaFBlogos/car.png differ
diff --git a/test/ncaaFBlogos/cla.png b/test/ncaaFBlogos/cla.png
new file mode 100644
index 00000000..30eefb63
Binary files /dev/null and b/test/ncaaFBlogos/cla.png differ
diff --git a/test/ncaaFBlogos/colby.png b/test/ncaaFBlogos/colby.png
new file mode 100644
index 00000000..5df6982f
Binary files /dev/null and b/test/ncaaFBlogos/colby.png differ
diff --git a/test/ncaaFBlogos/colo.png b/test/ncaaFBlogos/colo.png
new file mode 100644
index 00000000..42ba2d55
Binary files /dev/null and b/test/ncaaFBlogos/colo.png differ
diff --git a/test/ncaaFBlogos/conn.png b/test/ncaaFBlogos/conn.png
new file mode 100644
index 00000000..1114466e
Binary files /dev/null and b/test/ncaaFBlogos/conn.png differ
diff --git a/test/ncaaFBlogos/cp.png b/test/ncaaFBlogos/cp.png
new file mode 100644
index 00000000..80ac8ba5
Binary files /dev/null and b/test/ncaaFBlogos/cp.png differ
diff --git a/test/ncaaFBlogos/csu.png b/test/ncaaFBlogos/csu.png
new file mode 100644
index 00000000..5ade1fc8
Binary files /dev/null and b/test/ncaaFBlogos/csu.png differ
diff --git a/test/ncaaFBlogos/cur.png b/test/ncaaFBlogos/cur.png
new file mode 100644
index 00000000..4c71f0be
Binary files /dev/null and b/test/ncaaFBlogos/cur.png differ
diff --git a/test/ncaaFBlogos/del.png b/test/ncaaFBlogos/del.png
new file mode 100644
index 00000000..52d230ba
Binary files /dev/null and b/test/ncaaFBlogos/del.png differ
diff --git a/test/ncaaFBlogos/dub.png b/test/ncaaFBlogos/dub.png
new file mode 100644
index 00000000..cefe34e5
Binary files /dev/null and b/test/ncaaFBlogos/dub.png differ
diff --git a/test/ncaaFBlogos/elm.png b/test/ncaaFBlogos/elm.png
new file mode 100644
index 00000000..19601cf7
Binary files /dev/null and b/test/ncaaFBlogos/elm.png differ
diff --git a/test/ncaaFBlogos/famu.png b/test/ncaaFBlogos/famu.png
new file mode 100644
index 00000000..cbd35117
Binary files /dev/null and b/test/ncaaFBlogos/famu.png differ
diff --git a/test/ncaaFBlogos/fla.png b/test/ncaaFBlogos/fla.png
new file mode 100644
index 00000000..2383ea78
Binary files /dev/null and b/test/ncaaFBlogos/fla.png differ
diff --git a/test/ncaaFBlogos/fsu.png b/test/ncaaFBlogos/fsu.png
new file mode 100644
index 00000000..9a3be669
Binary files /dev/null and b/test/ncaaFBlogos/fsu.png differ
diff --git a/test/ncaaFBlogos/gri.png b/test/ncaaFBlogos/gri.png
new file mode 100644
index 00000000..1924fa7a
Binary files /dev/null and b/test/ncaaFBlogos/gri.png differ
diff --git a/test/ncaaFBlogos/gt.png b/test/ncaaFBlogos/gt.png
new file mode 100644
index 00000000..228b8fdb
Binary files /dev/null and b/test/ncaaFBlogos/gt.png differ
diff --git a/test/ncaaFBlogos/gtwn.png b/test/ncaaFBlogos/gtwn.png
new file mode 100644
index 00000000..9990feee
Binary files /dev/null and b/test/ncaaFBlogos/gtwn.png differ
diff --git a/test/ncaaFBlogos/haw.png b/test/ncaaFBlogos/haw.png
new file mode 100644
index 00000000..cd5856dc
Binary files /dev/null and b/test/ncaaFBlogos/haw.png differ
diff --git a/test/ncaaFBlogos/how.png b/test/ncaaFBlogos/how.png
new file mode 100644
index 00000000..a4b902a9
Binary files /dev/null and b/test/ncaaFBlogos/how.png differ
diff --git a/test/ncaaFBlogos/idho.png b/test/ncaaFBlogos/idho.png
new file mode 100644
index 00000000..1cfcdfff
Binary files /dev/null and b/test/ncaaFBlogos/idho.png differ
diff --git a/test/ncaaFBlogos/isu.png b/test/ncaaFBlogos/isu.png
new file mode 100644
index 00000000..c59e3753
Binary files /dev/null and b/test/ncaaFBlogos/isu.png differ
diff --git a/test/ncaaFBlogos/jxst.png b/test/ncaaFBlogos/jxst.png
new file mode 100644
index 00000000..d507ee89
Binary files /dev/null and b/test/ncaaFBlogos/jxst.png differ
diff --git a/test/ncaaFBlogos/lut.png b/test/ncaaFBlogos/lut.png
new file mode 100644
index 00000000..684e10f2
Binary files /dev/null and b/test/ncaaFBlogos/lut.png differ
diff --git a/test/ncaaFBlogos/mesa.png b/test/ncaaFBlogos/mesa.png
new file mode 100644
index 00000000..66159848
Binary files /dev/null and b/test/ncaaFBlogos/mesa.png differ
diff --git a/test/ncaaFBlogos/mil.png b/test/ncaaFBlogos/mil.png
new file mode 100644
index 00000000..adc29c39
Binary files /dev/null and b/test/ncaaFBlogos/mil.png differ
diff --git a/test/ncaaFBlogos/mor.png b/test/ncaaFBlogos/mor.png
new file mode 100644
index 00000000..b701025e
Binary files /dev/null and b/test/ncaaFBlogos/mor.png differ
diff --git a/test/ncaaFBlogos/nor.png b/test/ncaaFBlogos/nor.png
new file mode 100644
index 00000000..2b62fead
Binary files /dev/null and b/test/ncaaFBlogos/nor.png differ
diff --git a/test/ncaaFBlogos/red.png b/test/ncaaFBlogos/red.png
new file mode 100644
index 00000000..196b387d
Binary files /dev/null and b/test/ncaaFBlogos/red.png differ
diff --git a/test/ncaaFBlogos/sac.png b/test/ncaaFBlogos/sac.png
new file mode 100644
index 00000000..5ef0343f
Binary files /dev/null and b/test/ncaaFBlogos/sac.png differ
diff --git a/test/ncaaFBlogos/sdsu.png b/test/ncaaFBlogos/sdsu.png
new file mode 100644
index 00000000..f73ee988
Binary files /dev/null and b/test/ncaaFBlogos/sdsu.png differ
diff --git a/test/ncaaFBlogos/sjsu.png b/test/ncaaFBlogos/sjsu.png
new file mode 100644
index 00000000..dbffbcc7
Binary files /dev/null and b/test/ncaaFBlogos/sjsu.png differ
diff --git a/test/ncaaFBlogos/stan.png b/test/ncaaFBlogos/stan.png
new file mode 100644
index 00000000..36dc600f
Binary files /dev/null and b/test/ncaaFBlogos/stan.png differ
diff --git a/test/ncaaFBlogos/stet.png b/test/ncaaFBlogos/stet.png
new file mode 100644
index 00000000..d31e923b
Binary files /dev/null and b/test/ncaaFBlogos/stet.png differ
diff --git a/test/ncaaFBlogos/uab.png b/test/ncaaFBlogos/uab.png
new file mode 100644
index 00000000..854220a7
Binary files /dev/null and b/test/ncaaFBlogos/uab.png differ
diff --git a/test/ncaaFBlogos/ucla.png b/test/ncaaFBlogos/ucla.png
new file mode 100644
index 00000000..216f392c
Binary files /dev/null and b/test/ncaaFBlogos/ucla.png differ
diff --git a/test/ncaaFBlogos/uga.png b/test/ncaaFBlogos/uga.png
new file mode 100644
index 00000000..53175cff
Binary files /dev/null and b/test/ncaaFBlogos/uga.png differ
diff --git a/test/ncaaFBlogos/usa.png b/test/ncaaFBlogos/usa.png
new file mode 100644
index 00000000..3083699d
Binary files /dev/null and b/test/ncaaFBlogos/usa.png differ
diff --git a/test/ncaaFBlogos/usc.png b/test/ncaaFBlogos/usc.png
new file mode 100644
index 00000000..84c2711e
Binary files /dev/null and b/test/ncaaFBlogos/usc.png differ
diff --git a/test/ncaaFBlogos/usf.png b/test/ncaaFBlogos/usf.png
new file mode 100644
index 00000000..c1b4c5b6
Binary files /dev/null and b/test/ncaaFBlogos/usf.png differ
diff --git a/test/ncaaFBlogos/yale.png b/test/ncaaFBlogos/yale.png
new file mode 100644
index 00000000..fa375049
Binary files /dev/null and b/test/ncaaFBlogos/yale.png differ
diff --git a/test/test_leaderboard.py b/test/test_leaderboard.py
new file mode 100644
index 00000000..54efa66e
--- /dev/null
+++ b/test/test_leaderboard.py
@@ -0,0 +1,99 @@
+#!/usr/bin/env python3
+"""
+Test script for the LeaderboardManager
+"""
+
+import sys
+import os
+import json
+import logging
+
+# Add the src directory to the path
+sys.path.insert(0, os.path.join(os.path.dirname(__file__), '..', 'src'))
+
+from leaderboard_manager import LeaderboardManager
+from display_manager import DisplayManager
+from config_manager import ConfigManager
+
+# Configure logging
+logging.basicConfig(
+ level=logging.INFO,
+ format='%(asctime)s - %(levelname)s - %(message)s'
+)
+
+def test_leaderboard_manager():
+ """Test the leaderboard manager functionality."""
+
+ # Load configuration
+ config_manager = ConfigManager()
+ config = config_manager.load_config()
+
+ # Enable leaderboard and some sports for testing
+ config['leaderboard'] = {
+ 'enabled': True,
+ 'enabled_sports': {
+ 'nfl': {
+ 'enabled': True,
+ 'top_teams': 5
+ },
+ 'nba': {
+ 'enabled': True,
+ 'top_teams': 5
+ },
+ 'mlb': {
+ 'enabled': True,
+ 'top_teams': 5
+ }
+ },
+ 'update_interval': 3600,
+ 'scroll_speed': 2,
+ 'scroll_delay': 0.05,
+ 'display_duration': 60,
+ 'loop': True,
+ 'request_timeout': 30,
+ 'dynamic_duration': True,
+ 'min_duration': 30,
+ 'max_duration': 300,
+ 'duration_buffer': 0.1
+ }
+
+ # Initialize display manager (this will be a mock for testing)
+ display_manager = DisplayManager(config)
+
+ # Initialize leaderboard manager
+ leaderboard_manager = LeaderboardManager(config, display_manager)
+
+ print("Testing LeaderboardManager...")
+ print(f"Enabled: {leaderboard_manager.is_enabled}")
+ print(f"Enabled sports: {[k for k, v in leaderboard_manager.league_configs.items() if v['enabled']]}")
+
+ # Test fetching standings
+ print("\nFetching standings...")
+ leaderboard_manager.update()
+
+ print(f"Number of leagues with data: {len(leaderboard_manager.leaderboard_data)}")
+
+ for league_data in leaderboard_manager.leaderboard_data:
+ league = league_data['league']
+ teams = league_data['teams']
+ print(f"\n{league.upper()}:")
+ for i, team in enumerate(teams[:5]): # Show top 5
+ record = f"{team['wins']}-{team['losses']}"
+ if 'ties' in team:
+ record += f"-{team['ties']}"
+ print(f" {i+1}. {team['abbreviation']} {record}")
+
+ # Test image creation
+ print("\nCreating leaderboard image...")
+ if leaderboard_manager.leaderboard_data:
+ leaderboard_manager._create_leaderboard_image()
+ if leaderboard_manager.leaderboard_image:
+ print(f"Image created successfully: {leaderboard_manager.leaderboard_image.size}")
+ print(f"Dynamic duration: {leaderboard_manager.dynamic_duration:.1f}s")
+ else:
+ print("Failed to create image")
+ else:
+ print("No data available to create image")
+
+if __name__ == "__main__":
+ test_leaderboard_manager()
diff --git a/test/test_leaderboard_simple.py b/test/test_leaderboard_simple.py
new file mode 100644
index 00000000..f65fb081
--- /dev/null
+++ b/test/test_leaderboard_simple.py
@@ -0,0 +1,205 @@
+#!/usr/bin/env python3
+"""
+Simple test script for the LeaderboardManager (without display dependencies)
+"""
+
+import sys
+import os
+import json
+import logging
+import requests
+from typing import Dict, Any, List, Optional
+from datetime import datetime, timedelta, timezone
+from PIL import Image, ImageDraw, ImageFont
+
+# Configure logging
+logging.basicConfig(
+ level=logging.INFO,
+ format='%(asctime)s - %(levelname)s - %(message)s'
+)
+
+logger = logging.getLogger(__name__)
+
+def test_espn_api():
+ """Test ESPN API endpoints for standings."""
+
+ # Test different league endpoints
+ test_leagues = [
+ {
+ 'name': 'NFL',
+ 'url': 'https://site.api.espn.com/apis/site/v2/sports/football/nfl/standings'
+ },
+ {
+ 'name': 'NBA',
+ 'url': 'https://site.api.espn.com/apis/site/v2/sports/basketball/nba/standings'
+ },
+ {
+ 'name': 'MLB',
+ 'url': 'https://site.api.espn.com/apis/site/v2/sports/baseball/mlb/standings'
+ }
+ ]
+
+ for league in test_leagues:
+ print(f"\nTesting {league['name']} API...")
+ try:
+ response = requests.get(league['url'], timeout=30)
+ response.raise_for_status()
+ data = response.json()
+
+ print(f"✓ {league['name']} API response successful")
+
+ # Check if we have groups data
+ groups = data.get('groups', [])
+ print(f" Groups found: {len(groups)}")
+
+ # Try to extract some team data
+ total_teams = 0
+ for group in groups:
+ if 'standings' in group:
+ total_teams += len(group['standings'])
+ elif 'groups' in group:
+ # Handle nested groups (like NFL conferences/divisions)
+ for sub_group in group['groups']:
+ if 'standings' in sub_group:
+ total_teams += len(sub_group['standings'])
+ elif 'groups' in sub_group:
+ for sub_sub_group in sub_group['groups']:
+ if 'standings' in sub_sub_group:
+ total_teams += len(sub_sub_group['standings'])
+
+ print(f" Total teams found: {total_teams}")
+
+ except Exception as e:
+ print(f"✗ {league['name']} API failed: {e}")
+
+def test_standings_parsing():
+ """Test parsing standings data."""
+
+ # Test NFL standings parsing using teams endpoint
+ print("\nTesting NFL standings parsing...")
+ try:
+ # First get all teams
+ teams_url = 'https://site.api.espn.com/apis/site/v2/sports/football/nfl/teams'
+ response = requests.get(teams_url, timeout=30)
+ response.raise_for_status()
+ data = response.json()
+
+ sports = data.get('sports', [])
+ if not sports:
+ print("✗ No sports data found")
+ return
+
+ leagues = sports[0].get('leagues', [])
+ if not leagues:
+ print("✗ No leagues data found")
+ return
+
+ teams = leagues[0].get('teams', [])
+ if not teams:
+ print("✗ No teams data found")
+ return
+
+ print(f"Found {len(teams)} NFL teams")
+
+ # Test fetching individual team records
+ standings = []
+ test_teams = teams[:5] # Test first 5 teams to avoid too many API calls
+
+ for team_data in test_teams:
+ team = team_data.get('team', {})
+ team_abbr = team.get('abbreviation')
+ team_name = team.get('name', 'Unknown')
+
+ if not team_abbr:
+ continue
+
+ print(f" Fetching record for {team_abbr}...")
+
+ # Fetch individual team record
+ team_url = f"https://site.api.espn.com/apis/site/v2/sports/football/nfl/teams/{team_abbr}"
+ team_response = requests.get(team_url, timeout=30)
+ team_response.raise_for_status()
+ team_data = team_response.json()
+
+ team_info = team_data.get('team', {})
+ stats = team_info.get('stats', [])
+
+ # Find wins and losses
+ wins = 0
+ losses = 0
+ ties = 0
+
+ for stat in stats:
+ if stat.get('name') == 'wins':
+ wins = stat.get('value', 0)
+ elif stat.get('name') == 'losses':
+ losses = stat.get('value', 0)
+ elif stat.get('name') == 'ties':
+ ties = stat.get('value', 0)
+
+ # Calculate win percentage
+ total_games = wins + losses + ties
+ win_percentage = wins / total_games if total_games > 0 else 0
+
+ standings.append({
+ 'name': team_name,
+ 'abbreviation': team_abbr,
+ 'wins': wins,
+ 'losses': losses,
+ 'ties': ties,
+ 'win_percentage': win_percentage
+ })
+
+ # Sort by win percentage and show results
+ standings.sort(key=lambda x: x['win_percentage'], reverse=True)
+
+ print("NFL team records:")
+ for i, team in enumerate(standings):
+ record = f"{team['wins']}-{team['losses']}"
+ if team['ties'] > 0:
+ record += f"-{team['ties']}"
+ print(f" {i+1}. {team['abbreviation']} {record} ({team['win_percentage']:.3f})")
+
+ except Exception as e:
+ print(f"✗ NFL standings parsing failed: {e}")
+
+def test_logo_loading():
+ """Test logo loading functionality."""
+
+ print("\nTesting logo loading...")
+
+ # Test team logo loading
+ logo_dir = "assets/sports/nfl_logos"
+ test_teams = ["TB", "DAL", "NE"]
+
+ for team in test_teams:
+ logo_path = os.path.join(logo_dir, f"{team}.png")
+ if os.path.exists(logo_path):
+ print(f"✓ {team} logo found: {logo_path}")
+ else:
+ print(f"✗ {team} logo not found: {logo_path}")
+
+ # Test league logo loading
+ league_logos = [
+ "assets/sports/nfl_logos/nfl.png",
+ "assets/sports/nba_logos/nba.png",
+ "assets/sports/mlb_logos/mlb.png",
+ "assets/sports/nhl_logos/nhl.png",
+ "assets/sports/ncaa_fbs_logos/ncaa_fb.png",
+ "assets/sports/ncaa_fbs_logos/ncaam.png"
+ ]
+
+ for logo_path in league_logos:
+ if os.path.exists(logo_path):
+ print(f"✓ League logo found: {logo_path}")
+ else:
+ print(f"✗ League logo not found: {logo_path}")
+
+if __name__ == "__main__":
+ print("Testing LeaderboardManager components...")
+
+ test_espn_api()
+ test_standings_parsing()
+ test_logo_loading()
+
+ print("\nTest completed!")
diff --git a/test/test_ncaa_fb_leaderboard.py b/test/test_ncaa_fb_leaderboard.py
new file mode 100644
index 00000000..36a1f8ee
--- /dev/null
+++ b/test/test_ncaa_fb_leaderboard.py
@@ -0,0 +1,288 @@
+#!/usr/bin/env python3
+"""
+Test script to demonstrate NCAA Football leaderboard data gathering.
+Shows the top 10 NCAA Football teams ranked by win percentage.
+This script examines the actual ESPN API response structure to understand
+how team records are provided in the teams endpoint.
+"""
+
+import sys
+import os
+import json
+import time
+import requests
+from typing import Dict, Any, List, Optional
+
+# Add the src directory to the path so we can import our modules
+sys.path.insert(0, os.path.join(os.path.dirname(__file__), '..', 'src'))
+
+from cache_manager import CacheManager
+from config_manager import ConfigManager
+
+class NCAAFBLeaderboardTester:
+ """Test class to demonstrate NCAA Football leaderboard data gathering."""
+
+ def __init__(self):
+ self.cache_manager = CacheManager()
+ self.config_manager = ConfigManager()
+ self.request_timeout = 30
+
+ # NCAA Football configuration (matching the leaderboard manager)
+ self.ncaa_fb_config = {
+ 'sport': 'football',
+ 'league': 'college-football',
+ 'teams_url': 'https://site.api.espn.com/apis/site/v2/sports/football/college-football/teams',
+ 'top_teams': 10 # Show top 10 for this test
+ }
+
+ def examine_api_structure(self) -> None:
+ """Examine the ESPN API response structure to understand available data."""
+ print("Examining ESPN API response structure...")
+ print("=" * 60)
+
+ try:
+ response = requests.get(self.ncaa_fb_config['teams_url'], timeout=self.request_timeout)
+ response.raise_for_status()
+ data = response.json()
+
+ print(f"API Response Status: {response.status_code}")
+ print(f"Response Keys: {list(data.keys())}")
+
+ sports = data.get('sports', [])
+ if sports:
+ print(f"Sports found: {len(sports)}")
+ sport = sports[0]
+ print(f"Sport keys: {list(sport.keys())}")
+ print(f"Sport name: {sport.get('name', 'Unknown')}")
+
+ leagues = sport.get('leagues', [])
+ if leagues:
+ print(f"Leagues found: {len(leagues)}")
+ league = leagues[0]
+ print(f"League keys: {list(league.keys())}")
+ print(f"League name: {league.get('name', 'Unknown')}")
+
+ teams = league.get('teams', [])
+ if teams:
+ print(f"Teams found: {len(teams)}")
+
+ # Examine first team structure
+ first_team = teams[0]
+ print(f"\nFirst team structure:")
+ print(f"Team keys: {list(first_team.keys())}")
+
+ team_info = first_team.get('team', {})
+ print(f"Team info keys: {list(team_info.keys())}")
+ print(f"Team name: {team_info.get('name', 'Unknown')}")
+ print(f"Team abbreviation: {team_info.get('abbreviation', 'Unknown')}")
+
+ # Check for record data
+ record = team_info.get('record', {})
+ print(f"Record keys: {list(record.keys())}")
+
+ if record:
+ items = record.get('items', [])
+ print(f"Record items: {len(items)}")
+ if items:
+ print(f"First record item: {items[0]}")
+
+ # Check for stats data
+ stats = team_info.get('stats', [])
+ print(f"Stats found: {len(stats)}")
+ if stats:
+ print("Available stats:")
+ for stat in stats[:5]: # Show first 5 stats
+ print(f" {stat.get('name', 'Unknown')}: {stat.get('value', 'Unknown')}")
+
+ # Check for standings data
+ standings = first_team.get('standings', {})
+ print(f"Standings keys: {list(standings.keys())}")
+
+ print(f"\nSample team data structure:")
+ print(json.dumps(first_team, indent=2)[:1000] + "...")
+
+ except Exception as e:
+ print(f"Error examining API structure: {e}")
+
+ def fetch_ncaa_fb_rankings_correct(self) -> List[Dict[str, Any]]:
+ """Fetch NCAA Football rankings from ESPN API using the correct approach."""
+ cache_key = "leaderboard_college-football-rankings"
+
+ # Try to get cached data first
+ cached_data = self.cache_manager.get_cached_data_with_strategy(cache_key, 'leaderboard')
+ if cached_data:
+ print("Using cached rankings data for NCAA Football")
+ return cached_data.get('rankings', [])
+
+ try:
+ print("Fetching fresh rankings data for NCAA Football")
+ rankings_url = "https://site.api.espn.com/apis/site/v2/sports/football/college-football/rankings"
+ print(f"Rankings URL: {rankings_url}")
+
+ # Get rankings data
+ response = requests.get(rankings_url, timeout=self.request_timeout)
+ response.raise_for_status()
+ data = response.json()
+
+ print(f"Available rankings: {[rank['name'] for rank in data.get('availableRankings', [])]}")
+ print(f"Latest season: {data.get('latestSeason', {})}")
+ print(f"Latest week: {data.get('latestWeek', {})}")
+
+ rankings_data = data.get('rankings', [])
+ if not rankings_data:
+ print("No rankings data found")
+ return []
+
+ # Use the first ranking (usually AP Top 25)
+ first_ranking = rankings_data[0]
+ ranking_name = first_ranking.get('name', 'Unknown')
+ ranking_type = first_ranking.get('type', 'Unknown')
+ teams = first_ranking.get('ranks', [])
+
+ print(f"Using ranking: {ranking_name} ({ranking_type})")
+ print(f"Found {len(teams)} teams in ranking")
+
+ standings = []
+
+ # Process each team in the ranking
+ for i, team_data in enumerate(teams):
+ team_info = team_data.get('team', {})
+ team_name = team_info.get('name', 'Unknown')
+ team_abbr = team_info.get('abbreviation', 'Unknown')
+ current_rank = team_data.get('current', 0)
+ record_summary = team_data.get('recordSummary', '0-0')
+
+ print(f" {current_rank}. {team_name} ({team_abbr}): {record_summary}")
+
+ # Parse the record string (e.g., "12-1", "8-4", "10-2-1")
+ wins = 0
+ losses = 0
+ ties = 0
+ win_percentage = 0
+
+ try:
+ parts = record_summary.split('-')
+ if len(parts) >= 2:
+ wins = int(parts[0])
+ losses = int(parts[1])
+ if len(parts) == 3:
+ ties = int(parts[2])
+
+ # Calculate win percentage
+ total_games = wins + losses + ties
+ win_percentage = wins / total_games if total_games > 0 else 0
+ except (ValueError, IndexError):
+ print(f" Could not parse record: {record_summary}")
+ continue
+
+ standings.append({
+ 'name': team_name,
+ 'abbreviation': team_abbr,
+ 'rank': current_rank,
+ 'wins': wins,
+ 'losses': losses,
+ 'ties': ties,
+ 'win_percentage': win_percentage,
+ 'record_summary': record_summary,
+ 'ranking_name': ranking_name
+ })
+
+ # Limit to top teams (they're already ranked)
+ top_teams = standings[:self.ncaa_fb_config['top_teams']]
+
+ # Cache the results
+ cache_data = {
+ 'rankings': top_teams,
+ 'timestamp': time.time(),
+ 'league': 'college-football',
+ 'ranking_name': ranking_name
+ }
+ self.cache_manager.save_cache(cache_key, cache_data)
+
+ print(f"Fetched and cached {len(top_teams)} teams for college-football")
+ return top_teams
+
+ except Exception as e:
+ print(f"Error fetching rankings for college-football: {e}")
+ return []
+
+ def display_standings(self, standings: List[Dict[str, Any]]) -> None:
+ """Display the standings in a formatted way."""
+ if not standings:
+ print("No standings data available")
+ return
+
+ ranking_name = standings[0].get('ranking_name', 'Unknown Ranking') if standings else 'Unknown'
+
+ print("\n" + "="*80)
+ print(f"NCAA FOOTBALL LEADERBOARD - TOP 10 TEAMS ({ranking_name})")
+ print("="*80)
+ print(f"{'Rank':<4} {'Team':<25} {'Abbr':<6} {'Record':<12} {'Win %':<8}")
+ print("-"*80)
+
+ for team in standings:
+ record_str = f"{team['wins']}-{team['losses']}"
+ if team['ties'] > 0:
+ record_str += f"-{team['ties']}"
+
+ win_pct = team['win_percentage']
+ win_pct_str = f"{win_pct:.3f}" if win_pct > 0 else "0.000"
+
+ print(f"{team['rank']:<4} {team['name']:<25} {team['abbreviation']:<6} {record_str:<12} {win_pct_str:<8}")
+
+ print("="*80)
+ print(f"Total teams processed: {len(standings)}")
+ print(f"Data fetched at: {time.strftime('%Y-%m-%d %H:%M:%S')}")
+
+ def run_test(self) -> None:
+ """Run the complete test."""
+ print("NCAA Football Leaderboard Data Gathering Test")
+ print("=" * 50)
+ print("This test demonstrates how the leaderboard manager should gather data:")
+ print("1. Fetches rankings from ESPN API rankings endpoint")
+ print("2. Uses poll-based rankings (AP, Coaches, etc.) not win percentage")
+ print("3. Gets team records from the ranking data")
+ print("4. Displays top 10 teams with their poll rankings")
+ print()
+
+ print("\n" + "="*60)
+ print("FETCHING RANKINGS DATA")
+ print("="*60)
+
+ # Fetch the rankings using the correct approach
+ standings = self.fetch_ncaa_fb_rankings_correct()
+
+ # Display the results
+ self.display_standings(standings)
+
+ # Show some additional info
+ if standings:
+ ranking_name = standings[0].get('ranking_name', 'Unknown')
+ print(f"\nAdditional Information:")
+ print(f"- API Endpoint: https://site.api.espn.com/apis/site/v2/sports/football/college-football/rankings")
+ print(f"- Single API call fetches poll-based rankings")
+ print(f"- Rankings are based on polls, not just win percentage")
+ print(f"- Data is cached to avoid excessive API calls")
+ print(f"- Using ranking: {ranking_name}")
+
+ # Show the best team
+ best_team = standings[0]
+ print(f"\nCurrent #1 Team: {best_team['name']} ({best_team['abbreviation']})")
+ print(f"Record: {best_team['wins']}-{best_team['losses']}{f'-{best_team['ties']}' if best_team['ties'] > 0 else ''}")
+ print(f"Win Percentage: {best_team['win_percentage']:.3f}")
+ print(f"Poll Ranking: #{best_team['rank']}")
+
+def main():
+ """Main function to run the test."""
+ try:
+ tester = NCAAFBLeaderboardTester()
+ tester.run_test()
+ except KeyboardInterrupt:
+ print("\nTest interrupted by user")
+ except Exception as e:
+ print(f"Error running test: {e}")
+ import traceback
+ traceback.print_exc()
+
+if __name__ == "__main__":
+ main()
diff --git a/test/test_odds_ticker_dynamic_duration.py b/test/test_odds_ticker_dynamic_duration.py
new file mode 100644
index 00000000..f78daf58
--- /dev/null
+++ b/test/test_odds_ticker_dynamic_duration.py
@@ -0,0 +1,124 @@
+#!/usr/bin/env python3
+"""
+Test script for debugging OddsTickerManager dynamic duration calculation
+"""
+
+import sys
+import os
+import time
+import logging
+
+# Add the parent directory to the Python path so we can import from src
+sys.path.insert(0, os.path.join(os.path.dirname(__file__), '..'))
+
+from src.display_manager import DisplayManager
+from src.config_manager import ConfigManager
+from src.odds_ticker_manager import OddsTickerManager
+
+# Configure logging to show debug information
+logging.basicConfig(
+ level=logging.DEBUG,
+ format='%(asctime)s.%(msecs)03d - %(levelname)s:%(name)s:%(message)s',
+ datefmt='%H:%M:%S'
+)
+
+def test_dynamic_duration():
+ """Test the dynamic duration calculation for odds ticker."""
+ print("Testing OddsTickerManager Dynamic Duration...")
+
+ try:
+ # Load configuration
+ config_manager = ConfigManager()
+ config = config_manager.load_config()
+
+ # Initialize display manager
+ display_manager = DisplayManager(config)
+
+ # Initialize odds ticker
+ odds_ticker = OddsTickerManager(config, display_manager)
+
+ print(f"Odds ticker enabled: {odds_ticker.is_enabled}")
+ print(f"Dynamic duration enabled: {odds_ticker.dynamic_duration_enabled}")
+ print(f"Min duration: {odds_ticker.min_duration}s")
+ print(f"Max duration: {odds_ticker.max_duration}s")
+ print(f"Duration buffer: {odds_ticker.duration_buffer}")
+ print(f"Scroll speed: {odds_ticker.scroll_speed}")
+ print(f"Scroll delay: {odds_ticker.scroll_delay}")
+ print(f"Display width: {display_manager.matrix.width}")
+
+ if not odds_ticker.is_enabled:
+ print("Odds ticker is disabled in config. Enabling for test...")
+ odds_ticker.is_enabled = True
+
+ # Temporarily disable favorite teams filter for testing
+ print("Temporarily disabling favorite teams filter to test display...")
+ original_show_favorite = odds_ticker.show_favorite_teams_only
+ odds_ticker.show_favorite_teams_only = False
+
+ # Update odds ticker data
+ print("\nUpdating odds ticker data...")
+ odds_ticker.update()
+
+ print(f"Found {len(odds_ticker.games_data)} games")
+
+ if odds_ticker.games_data:
+ print("\nSample game data:")
+ for i, game in enumerate(odds_ticker.games_data[:3]): # Show first 3 games
+ print(f" Game {i+1}: {game.get('away_team', 'Unknown')} @ {game.get('home_team', 'Unknown')}")
+ print(f" Time: {game.get('start_time', 'Unknown')}")
+ print(f" League: {game.get('league', 'Unknown')}")
+ print(f" Sport: {game.get('sport', 'Unknown')}")
+ if game.get('odds'):
+ print(f" Has odds: Yes")
+ else:
+ print(f" Has odds: No")
+ print(f" Available keys: {list(game.keys())}")
+ print()
+
+ # Check dynamic duration calculation
+ print("\nDynamic Duration Analysis:")
+ print(f"Total scroll width: {odds_ticker.total_scroll_width}px")
+ print(f"Calculated dynamic duration: {odds_ticker.dynamic_duration}s")
+
+ # Calculate expected duration manually
+ display_width = display_manager.matrix.width
+ total_scroll_distance = display_width + odds_ticker.total_scroll_width
+ frames_needed = total_scroll_distance / odds_ticker.scroll_speed
+ total_time = frames_needed * odds_ticker.scroll_delay
+ buffer_time = total_time * odds_ticker.duration_buffer
+ calculated_duration = int(total_time + buffer_time)
+
+ print(f"\nManual calculation:")
+ print(f" Display width: {display_width}px")
+ print(f" Content width: {odds_ticker.total_scroll_width}px")
+ print(f" Total scroll distance: {total_scroll_distance}px")
+ print(f" Frames needed: {frames_needed:.1f}")
+ print(f" Base time: {total_time:.2f}s")
+ print(f" Buffer time: {buffer_time:.2f}s ({odds_ticker.duration_buffer*100}%)")
+ print(f" Calculated duration: {calculated_duration}s")
+
+ # Test display for a few iterations
+ print(f"\nTesting display for 10 iterations...")
+ for i in range(10):
+ print(f" Display iteration {i+1} starting...")
+ odds_ticker.display()
+ print(f" Display iteration {i+1} complete - scroll position: {odds_ticker.scroll_position}")
+ time.sleep(1)
+
+ else:
+ print("No games found even with favorite teams filter disabled.")
+
+ # Restore original setting
+ odds_ticker.show_favorite_teams_only = original_show_favorite
+
+ # Cleanup
+ display_manager.cleanup()
+ print("\nTest completed successfully!")
+
+ except Exception as e:
+ print(f"Error during test: {e}")
+ import traceback
+ traceback.print_exc()
+
+if __name__ == "__main__":
+ test_dynamic_duration()
diff --git a/test/test_odds_ticker_live.py b/test/test_odds_ticker_live.py
new file mode 100644
index 00000000..b65ed0e2
--- /dev/null
+++ b/test/test_odds_ticker_live.py
@@ -0,0 +1,173 @@
+#!/usr/bin/env python3
+"""
+Test script to verify odds ticker live game functionality.
+"""
+
+import sys
+import os
+import json
+import requests
+from datetime import datetime, timezone
+
+# Add the src directory to the path
+sys.path.insert(0, os.path.join(os.path.dirname(__file__), '..', 'src'))
+
+from odds_ticker_manager import OddsTickerManager
+from display_manager import DisplayManager
+from cache_manager import CacheManager
+from config_manager import ConfigManager
+
+def test_live_game_detection():
+ """Test that the odds ticker can detect live games."""
+ print("Testing live game detection in odds ticker...")
+
+ # Create a minimal config for testing
+ config = {
+ 'odds_ticker': {
+ 'enabled': True,
+ 'enabled_leagues': ['mlb', 'nfl', 'nba'],
+ 'show_favorite_teams_only': False,
+ 'max_games_per_league': 3,
+ 'show_odds_only': False,
+ 'update_interval': 300,
+ 'scroll_speed': 2,
+ 'scroll_delay': 0.05,
+ 'display_duration': 30,
+ 'future_fetch_days': 1,
+ 'loop': True,
+ 'show_channel_logos': True,
+ 'broadcast_logo_height_ratio': 0.8,
+ 'broadcast_logo_max_width_ratio': 0.8,
+ 'request_timeout': 30,
+ 'dynamic_duration': True,
+ 'min_duration': 30,
+ 'max_duration': 300,
+ 'duration_buffer': 0.1
+ },
+ 'timezone': 'UTC',
+ 'mlb': {
+ 'enabled': True,
+ 'favorite_teams': []
+ },
+ 'nfl_scoreboard': {
+ 'enabled': True,
+ 'favorite_teams': []
+ },
+ 'nba_scoreboard': {
+ 'enabled': True,
+ 'favorite_teams': []
+ }
+ }
+
+ # Create mock display manager
+ class MockDisplayManager:
+ def __init__(self):
+ self.matrix = MockMatrix()
+ self.image = None
+ self.draw = None
+
+ def update_display(self):
+ pass
+
+ def is_currently_scrolling(self):
+ return False
+
+ def set_scrolling_state(self, state):
+ pass
+
+ def defer_update(self, func, priority=0):
+ pass
+
+ def process_deferred_updates(self):
+ pass
+
+ class MockMatrix:
+ def __init__(self):
+ self.width = 128
+ self.height = 32
+
+ # Create managers
+ display_manager = MockDisplayManager()
+ cache_manager = CacheManager()
+ config_manager = ConfigManager()
+
+ # Create odds ticker manager
+ odds_ticker = OddsTickerManager(config, display_manager)
+
+ # Test fetching games
+ print("Fetching games...")
+ games = odds_ticker._fetch_upcoming_games()
+
+ print(f"Found {len(games)} total games")
+
+ # Check for live games
+ live_games = [game for game in games if game.get('status_state') == 'in']
+ scheduled_games = [game for game in games if game.get('status_state') != 'in']
+
+ print(f"Live games: {len(live_games)}")
+ print(f"Scheduled games: {len(scheduled_games)}")
+
+ # Display live games
+ for i, game in enumerate(live_games[:3]): # Show first 3 live games
+ print(f"\nLive Game {i+1}:")
+ print(f" Teams: {game['away_team']} @ {game['home_team']}")
+ print(f" Status: {game.get('status')} (State: {game.get('status_state')})")
+
+ live_info = game.get('live_info')
+ if live_info:
+ print(f" Score: {live_info.get('away_score', 0)} - {live_info.get('home_score', 0)}")
+ print(f" Period: {live_info.get('period', 'N/A')}")
+ print(f" Clock: {live_info.get('clock', 'N/A')}")
+ print(f" Detail: {live_info.get('detail', 'N/A')}")
+
+ # Sport-specific info
+ sport = None
+ for league_key, league_config in odds_ticker.league_configs.items():
+ if league_config.get('logo_dir') == game.get('logo_dir'):
+ sport = league_config.get('sport')
+ break
+
+ if sport == 'baseball':
+ print(f" Inning: {live_info.get('inning_half', 'N/A')} {live_info.get('inning', 'N/A')}")
+ print(f" Count: {live_info.get('balls', 0)}-{live_info.get('strikes', 0)}")
+ print(f" Outs: {live_info.get('outs', 0)}")
+ print(f" Bases: {live_info.get('bases_occupied', [])}")
+ elif sport == 'football':
+ print(f" Quarter: {live_info.get('quarter', 'N/A')}")
+ print(f" Down: {live_info.get('down', 'N/A')} & {live_info.get('distance', 'N/A')}")
+ print(f" Yard Line: {live_info.get('yard_line', 'N/A')}")
+ print(f" Possession: {live_info.get('possession', 'N/A')}")
+ elif sport == 'basketball':
+ print(f" Quarter: {live_info.get('quarter', 'N/A')}")
+ print(f" Time: {live_info.get('time_remaining', 'N/A')}")
+ print(f" Possession: {live_info.get('possession', 'N/A')}")
+ elif sport == 'hockey':
+ print(f" Period: {live_info.get('period', 'N/A')}")
+ print(f" Time: {live_info.get('time_remaining', 'N/A')}")
+ print(f" Power Play: {live_info.get('power_play', False)}")
+ else:
+ print(" No live info available")
+
+ # Test formatting
+ print("\nTesting text formatting...")
+ for game in live_games[:2]: # Test first 2 live games
+ formatted_text = odds_ticker._format_odds_text(game)
+ print(f"Formatted text: {formatted_text}")
+
+ # Test image creation
+ print("\nTesting image creation...")
+ if games:
+ try:
+ odds_ticker.games_data = games[:3] # Use first 3 games
+ odds_ticker._create_ticker_image()
+ if odds_ticker.ticker_image:
+ print(f"Successfully created ticker image: {odds_ticker.ticker_image.size}")
+ else:
+ print("Failed to create ticker image")
+ except Exception as e:
+ print(f"Error creating ticker image: {e}")
+
+ print("\nTest completed!")
+
+if __name__ == "__main__":
+ test_live_game_detection()
diff --git a/test/test_ranking_toggle.py b/test/test_ranking_toggle.py
new file mode 100644
index 00000000..703e32e7
--- /dev/null
+++ b/test/test_ranking_toggle.py
@@ -0,0 +1,289 @@
+#!/usr/bin/env python3
+"""
+Test script to demonstrate the new ranking/record toggle functionality
+for both the leaderboard manager and NCAA FB managers.
+"""
+
+import sys
+import os
+import json
+import time
+from typing import Dict, Any
+
+# Add the src directory to the path so we can import our modules
+sys.path.insert(0, os.path.join(os.path.dirname(__file__), '..', 'src'))
+
+from leaderboard_manager import LeaderboardManager
+from ncaa_fb_managers import BaseNCAAFBManager
+from cache_manager import CacheManager
+from config_manager import ConfigManager
+
+def test_leaderboard_ranking_toggle():
+ """Test the leaderboard manager ranking toggle functionality."""
+
+ print("Testing Leaderboard Manager Ranking Toggle")
+ print("=" * 50)
+
+ # Create a mock display manager
+ class MockDisplayManager:
+ def __init__(self):
+ self.matrix = type('Matrix', (), {'width': 64, 'height': 32})()
+ self.image = None
+ self.draw = None
+
+ def update_display(self):
+ pass
+
+ def set_scrolling_state(self, scrolling):
+ pass
+
+ def process_deferred_updates(self):
+ pass
+
+ # Test configuration with show_ranking enabled
+ config_ranking_enabled = {
+ 'leaderboard': {
+ 'enabled': True,
+ 'enabled_sports': {
+ 'ncaa_fb': {
+ 'enabled': True,
+ 'top_teams': 10,
+ 'show_ranking': True # Show rankings
+ }
+ },
+ 'update_interval': 3600,
+ 'scroll_speed': 2,
+ 'scroll_delay': 0.05,
+ 'display_duration': 60,
+ 'loop': True,
+ 'request_timeout': 30,
+ 'dynamic_duration': True,
+ 'min_duration': 30,
+ 'max_duration': 300,
+ 'duration_buffer': 0.1,
+ 'time_per_team': 2.0,
+ 'time_per_league': 3.0
+ }
+ }
+
+ # Test configuration with show_ranking disabled
+ config_ranking_disabled = {
+ 'leaderboard': {
+ 'enabled': True,
+ 'enabled_sports': {
+ 'ncaa_fb': {
+ 'enabled': True,
+ 'top_teams': 10,
+ 'show_ranking': False # Show records
+ }
+ },
+ 'update_interval': 3600,
+ 'scroll_speed': 2,
+ 'scroll_delay': 0.05,
+ 'display_duration': 60,
+ 'loop': True,
+ 'request_timeout': 30,
+ 'dynamic_duration': True,
+ 'min_duration': 30,
+ 'max_duration': 300,
+ 'duration_buffer': 0.1,
+ 'time_per_team': 2.0,
+ 'time_per_league': 3.0
+ }
+ }
+
+ try:
+ display_manager = MockDisplayManager()
+
+ # Test with ranking enabled
+ print("1. Testing with show_ranking = True")
+ leaderboard_manager = LeaderboardManager(config_ranking_enabled, display_manager)
+ ncaa_fb_config = leaderboard_manager.league_configs['ncaa_fb']
+ print(f" show_ranking config: {ncaa_fb_config.get('show_ranking', 'Not set')}")
+
+ standings = leaderboard_manager._fetch_standings(ncaa_fb_config)
+ if standings:
+ print(f" Fetched {len(standings)} teams")
+ print(" Top 5 teams with rankings:")
+ for i, team in enumerate(standings[:5]):
+ rank = team.get('rank', 'N/A')
+ record = team.get('record_summary', 'N/A')
+ print(f" {i+1}. {team['name']} ({team['abbreviation']}) - Rank: #{rank}, Record: {record}")
+
+ print("\n2. Testing with show_ranking = False")
+ leaderboard_manager = LeaderboardManager(config_ranking_disabled, display_manager)
+ ncaa_fb_config = leaderboard_manager.league_configs['ncaa_fb']
+ print(f" show_ranking config: {ncaa_fb_config.get('show_ranking', 'Not set')}")
+
+ standings = leaderboard_manager._fetch_standings(ncaa_fb_config)
+ if standings:
+ print(f" Fetched {len(standings)} teams")
+ print(" Top 5 teams with records:")
+ for i, team in enumerate(standings[:5]):
+ rank = team.get('rank', 'N/A')
+ record = team.get('record_summary', 'N/A')
+ print(f" {i+1}. {team['name']} ({team['abbreviation']}) - Rank: #{rank}, Record: {record}")
+
+ print("\n✓ Leaderboard ranking toggle test completed!")
+ return True
+
+ except Exception as e:
+ print(f"✗ Error testing leaderboard ranking toggle: {e}")
+ import traceback
+ traceback.print_exc()
+ return False
+
+def test_ncaa_fb_ranking_toggle():
+ """Test the NCAA FB manager ranking toggle functionality."""
+
+ print("\nTesting NCAA FB Manager Ranking Toggle")
+ print("=" * 50)
+
+ # Create a mock display manager
+ class MockDisplayManager:
+ def __init__(self):
+ self.matrix = type('Matrix', (), {'width': 64, 'height': 32})()
+ self.image = None
+ self.draw = None
+
+ def update_display(self):
+ pass
+
+ def set_scrolling_state(self, scrolling):
+ pass
+
+ def process_deferred_updates(self):
+ pass
+
+ # Test configurations
+ configs = [
+ {
+ 'name': 'show_ranking=true, show_records=true',
+ 'config': {
+ 'ncaa_fb_scoreboard': {
+ 'enabled': True,
+ 'show_records': True,
+ 'show_ranking': True,
+ 'logo_dir': 'assets/sports/ncaa_fbs_logos',
+ 'display_modes': {
+ 'ncaa_fb_live': True,
+ 'ncaa_fb_recent': True,
+ 'ncaa_fb_upcoming': True
+ }
+ }
+ }
+ },
+ {
+ 'name': 'show_ranking=true, show_records=false',
+ 'config': {
+ 'ncaa_fb_scoreboard': {
+ 'enabled': True,
+ 'show_records': False,
+ 'show_ranking': True,
+ 'logo_dir': 'assets/sports/ncaa_fbs_logos',
+ 'display_modes': {
+ 'ncaa_fb_live': True,
+ 'ncaa_fb_recent': True,
+ 'ncaa_fb_upcoming': True
+ }
+ }
+ }
+ },
+ {
+ 'name': 'show_ranking=false, show_records=true',
+ 'config': {
+ 'ncaa_fb_scoreboard': {
+ 'enabled': True,
+ 'show_records': True,
+ 'show_ranking': False,
+ 'logo_dir': 'assets/sports/ncaa_fbs_logos',
+ 'display_modes': {
+ 'ncaa_fb_live': True,
+ 'ncaa_fb_recent': True,
+ 'ncaa_fb_upcoming': True
+ }
+ }
+ }
+ },
+ {
+ 'name': 'show_ranking=false, show_records=false',
+ 'config': {
+ 'ncaa_fb_scoreboard': {
+ 'enabled': True,
+ 'show_records': False,
+ 'show_ranking': False,
+ 'logo_dir': 'assets/sports/ncaa_fbs_logos',
+ 'display_modes': {
+ 'ncaa_fb_live': True,
+ 'ncaa_fb_recent': True,
+ 'ncaa_fb_upcoming': True
+ }
+ }
+ }
+ }
+ ]
+
+ try:
+ display_manager = MockDisplayManager()
+ cache_manager = CacheManager()
+
+ for i, test_config in enumerate(configs, 1):
+ print(f"{i}. Testing: {test_config['name']}")
+ ncaa_fb_manager = BaseNCAAFBManager(test_config['config'], display_manager, cache_manager)
+ print(f" show_records: {ncaa_fb_manager.show_records}")
+ print(f" show_ranking: {ncaa_fb_manager.show_ranking}")
+
+ # Test fetching rankings
+ rankings = ncaa_fb_manager._fetch_team_rankings()
+ if rankings:
+ print(f" Fetched rankings for {len(rankings)} teams")
+ print(" Sample rankings:")
+ for j, (team_abbr, rank) in enumerate(list(rankings.items())[:3]):
+ print(f" {team_abbr}: #{rank}")
+ print()
+
+ print("✓ NCAA FB ranking toggle test completed!")
+ print("\nLogic Summary:")
+ print("- show_ranking=true, show_records=true: Shows #5 if ranked, 2-0 if unranked")
+ print("- show_ranking=true, show_records=false: Shows #5 if ranked, nothing if unranked")
+ print("- show_ranking=false, show_records=true: Shows 2-0 (record)")
+ print("- show_ranking=false, show_records=false: Shows nothing")
+ return True
+
+ except Exception as e:
+ print(f"✗ Error testing NCAA FB ranking toggle: {e}")
+ import traceback
+ traceback.print_exc()
+ return False
+
+def main():
+ """Main function to run all tests."""
+ print("NCAA Football Ranking/Record Toggle Test")
+ print("=" * 60)
+ print("This test demonstrates the new functionality:")
+ print("- Leaderboard manager can show poll rankings (#5) or records (2-0)")
+ print("- NCAA FB managers can show poll rankings (#5) or records (2-0)")
+ print("- Configuration controls which is displayed")
+ print()
+
+ try:
+ success1 = test_leaderboard_ranking_toggle()
+ success2 = test_ncaa_fb_ranking_toggle()
+
+ if success1 and success2:
+ print("\n🎉 All tests passed! The ranking/record toggle is working correctly.")
+ print("\nConfiguration Summary:")
+ print("- Set 'show_ranking': true in config to show poll rankings (#5)")
+ print("- Set 'show_ranking': false in config to show season records (2-0)")
+ print("- Works in both leaderboard and NCAA FB scoreboard managers")
+ else:
+ print("\n❌ Some tests failed. Please check the errors above.")
+ except KeyboardInterrupt:
+ print("\nTest interrupted by user")
+ except Exception as e:
+ print(f"Error running tests: {e}")
+ import traceback
+ traceback.print_exc()
+
+if __name__ == "__main__":
+ main()
diff --git a/test/test_standings_fetch.py b/test/test_standings_fetch.py
new file mode 100644
index 00000000..3b5d7b80
--- /dev/null
+++ b/test/test_standings_fetch.py
@@ -0,0 +1,239 @@
+#!/usr/bin/env python3
+"""
+Test script to verify the standings fetching logic works correctly.
+This tests the core functionality without requiring the full LED matrix setup.
+"""
+
+import requests
+import json
+import time
+from typing import Dict, Any, List
+
+def fetch_standings_data(league_config: Dict[str, Any]) -> List[Dict[str, Any]]:
+ """Fetch standings data from ESPN API using the standings endpoint."""
+ league_key = league_config['league']
+
+ try:
+ print(f"Fetching fresh standings data for {league_key}")
+
+ # Build the standings URL with query parameters
+ standings_url = league_config['standings_url']
+ params = {
+ 'season': league_config.get('season', 2024),
+ 'level': league_config.get('level', 1),
+ 'sort': league_config.get('sort', 'winpercent:desc,gamesbehind:asc')
+ }
+
+ print(f"Fetching standings from: {standings_url} with params: {params}")
+
+ response = requests.get(standings_url, params=params, timeout=30)
+ response.raise_for_status()
+ data = response.json()
+
+ standings = []
+
+ # Parse the standings data structure
+ # Check if we have direct standings data or children (divisions/conferences)
+ if 'standings' in data and 'entries' in data['standings']:
+ # Direct standings data (e.g., NFL overall standings)
+ standings_data = data['standings']['entries']
+ print(f"Processing direct standings data with {len(standings_data)} teams")
+
+ for entry in standings_data:
+ team_data = entry.get('team', {})
+ stats = entry.get('stats', [])
+
+ team_name = team_data.get('displayName', 'Unknown')
+ team_abbr = team_data.get('abbreviation', 'Unknown')
+
+ # Extract record from stats
+ wins = 0
+ losses = 0
+ ties = 0
+ win_percentage = 0.0
+
+ for stat in stats:
+ stat_type = stat.get('type', '')
+ stat_value = stat.get('value', 0)
+
+ if stat_type == 'wins':
+ wins = int(stat_value)
+ elif stat_type == 'losses':
+ losses = int(stat_value)
+ elif stat_type == 'ties':
+ ties = int(stat_value)
+ elif stat_type == 'winpercent':
+ win_percentage = float(stat_value)
+
+ # Create record summary
+ if ties > 0:
+ record_summary = f"{wins}-{losses}-{ties}"
+ else:
+ record_summary = f"{wins}-{losses}"
+
+ standings.append({
+ 'name': team_name,
+ 'abbreviation': team_abbr,
+ 'wins': wins,
+ 'losses': losses,
+ 'ties': ties,
+ 'win_percentage': win_percentage,
+ 'record_summary': record_summary,
+ 'division': 'Overall'
+ })
+
+ elif 'children' in data:
+ # Children structure (divisions/conferences)
+ children = data.get('children', [])
+ print(f"Processing {len(children)} divisions/conferences")
+
+ for child in children:
+ child_name = child.get('displayName', 'Unknown')
+ print(f"Processing {child_name}")
+
+ standings_data = child.get('standings', {}).get('entries', [])
+
+ for entry in standings_data:
+ team_data = entry.get('team', {})
+ stats = entry.get('stats', [])
+
+ team_name = team_data.get('displayName', 'Unknown')
+ team_abbr = team_data.get('abbreviation', 'Unknown')
+
+ # Extract record from stats
+ wins = 0
+ losses = 0
+ ties = 0
+ win_percentage = 0.0
+
+ for stat in stats:
+ stat_type = stat.get('type', '')
+ stat_value = stat.get('value', 0)
+
+ if stat_type == 'wins':
+ wins = int(stat_value)
+ elif stat_type == 'losses':
+ losses = int(stat_value)
+ elif stat_type == 'ties':
+ ties = int(stat_value)
+ elif stat_type == 'winpercent':
+ win_percentage = float(stat_value)
+
+ # Create record summary
+ if ties > 0:
+ record_summary = f"{wins}-{losses}-{ties}"
+ else:
+ record_summary = f"{wins}-{losses}"
+
+ standings.append({
+ 'name': team_name,
+ 'abbreviation': team_abbr,
+ 'wins': wins,
+ 'losses': losses,
+ 'ties': ties,
+ 'win_percentage': win_percentage,
+ 'record_summary': record_summary,
+ 'division': child_name
+ })
+ else:
+ print(f"No standings or children data found for {league_key}")
+ return []
+
+ # Sort by win percentage (descending) and limit to top teams
+ standings.sort(key=lambda x: x['win_percentage'], reverse=True)
+ top_teams = standings[:league_config['top_teams']]
+
+ print(f"Fetched and processed {len(top_teams)} teams for {league_key} standings")
+ return top_teams
+
+ except Exception as e:
+ print(f"Error fetching standings for {league_key}: {e}")
+ return []
+
+def test_standings_fetch():
+ """Test the standings fetching functionality."""
+ print("Testing Standings Fetching Logic")
+ print("=" * 50)
+
+ # Test configurations
+ test_configs = [
+ {
+ 'name': 'NFL',
+ 'config': {
+ 'league': 'nfl',
+ 'standings_url': 'https://site.api.espn.com/apis/v2/sports/football/nfl/standings',
+ 'top_teams': 5,
+ 'season': 2025,
+ 'level': 1,
+ 'sort': 'winpercent:desc,gamesbehind:asc'
+ }
+ },
+ {
+ 'name': 'MLB',
+ 'config': {
+ 'league': 'mlb',
+ 'standings_url': 'https://site.api.espn.com/apis/v2/sports/baseball/mlb/standings',
+ 'top_teams': 5,
+ 'season': 2025,
+ 'level': 1,
+ 'sort': 'winpercent:desc,gamesbehind:asc'
+ }
+ },
+ {
+ 'name': 'NHL',
+ 'config': {
+ 'league': 'nhl',
+ 'standings_url': 'https://site.api.espn.com/apis/v2/sports/hockey/nhl/standings',
+ 'top_teams': 5,
+ 'season': 2025,
+ 'level': 1,
+ 'sort': 'winpercent:desc,gamesbehind:asc'
+ }
+ },
+ {
+ 'name': 'NCAA Baseball',
+ 'config': {
+ 'league': 'college-baseball',
+ 'standings_url': 'https://site.api.espn.com/apis/v2/sports/baseball/college-baseball/standings',
+ 'top_teams': 5,
+ 'season': 2025,
+ 'level': 1,
+ 'sort': 'winpercent:desc,gamesbehind:asc'
+ }
+ }
+ ]
+
+ results = []
+
+ for test_config in test_configs:
+ print(f"\n--- Testing {test_config['name']} ---")
+
+ standings = fetch_standings_data(test_config['config'])
+
+ if standings:
+ print(f"✓ Successfully fetched {len(standings)} teams")
+ print(f"Top {len(standings)} teams:")
+ for i, team in enumerate(standings):
+ print(f" {i+1}. {team['name']} ({team['abbreviation']}): {team['record_summary']} ({team['win_percentage']:.3f})")
+ results.append(True)
+ else:
+ print(f"✗ Failed to fetch standings for {test_config['name']}")
+ results.append(False)
+
+ # Summary
+ passed = sum(results)
+ total = len(results)
+
+ print(f"\n=== Test Results ===")
+ print(f"Passed: {passed}/{total}")
+
+ if passed == total:
+ print("✓ All standings fetch tests passed!")
+ return True
+ else:
+ print("✗ Some tests failed!")
+ return False
+
+if __name__ == "__main__":
+ success = test_standings_fetch()
+ exit(0 if success else 1)
diff --git a/test/test_standings_simple.py b/test/test_standings_simple.py
new file mode 100644
index 00000000..bde287de
--- /dev/null
+++ b/test/test_standings_simple.py
@@ -0,0 +1,293 @@
+#!/usr/bin/env python3
+"""
+Simple test script to verify the ESPN standings endpoints work correctly.
+"""
+
+import requests
+import json
+
+def test_nfl_standings():
+ """Test NFL standings endpoint with corrected parsing."""
+ print("\n=== Testing NFL Standings ===")
+
+ url = "https://site.api.espn.com/apis/v2/sports/football/nfl/standings"
+ params = {
+ 'season': 2025,
+ 'level': 1,
+ 'sort': 'winpercent:desc,gamesbehind:asc'
+ }
+
+ try:
+ response = requests.get(url, params=params, timeout=30)
+ response.raise_for_status()
+ data = response.json()
+
+ print(f"✓ Successfully fetched NFL standings")
+
+ # Check for direct standings data
+ if 'standings' in data and 'entries' in data['standings']:
+ standings_data = data['standings']['entries']
+ print(f" Found {len(standings_data)} teams in direct standings")
+
+ # Show top 5 teams
+ print(f" Top 5 teams:")
+ for i, entry in enumerate(standings_data[:5]):
+ team_data = entry.get('team', {})
+ team_name = team_data.get('displayName', 'Unknown')
+ team_abbr = team_data.get('abbreviation', 'Unknown')
+
+ # Get record
+ wins = 0
+ losses = 0
+ ties = 0
+ win_percentage = 0.0
+
+ for stat in entry.get('stats', []):
+ stat_type = stat.get('type', '')
+ stat_value = stat.get('value', 0)
+
+ if stat_type == 'wins':
+ wins = int(stat_value)
+ elif stat_type == 'losses':
+ losses = int(stat_value)
+ elif stat_type == 'ties':
+ ties = int(stat_value)
+ elif stat_type == 'winpercent':
+ win_percentage = float(stat_value)
+
+ record = f"{wins}-{losses}" if ties == 0 else f"{wins}-{losses}-{ties}"
+ print(f" {i+1}. {team_name} ({team_abbr}): {record} ({win_percentage:.3f})")
+
+ return True
+ else:
+ print(" ✗ No direct standings data found")
+ return False
+
+ except Exception as e:
+ print(f"✗ Error testing NFL standings: {e}")
+ return False
+
+def test_mlb_standings():
+ """Test MLB standings endpoint with corrected parsing."""
+ print("\n=== Testing MLB Standings ===")
+
+ url = "https://site.api.espn.com/apis/v2/sports/baseball/mlb/standings"
+ params = {
+ 'season': 2025,
+ 'level': 1,
+ 'sort': 'winpercent:desc,gamesbehind:asc'
+ }
+
+ try:
+ response = requests.get(url, params=params, timeout=30)
+ response.raise_for_status()
+ data = response.json()
+
+ print(f"✓ Successfully fetched MLB standings")
+
+ # Check for direct standings data
+ if 'standings' in data and 'entries' in data['standings']:
+ standings_data = data['standings']['entries']
+ print(f" Found {len(standings_data)} teams in direct standings")
+
+ # Show top 5 teams
+ print(f" Top 5 teams:")
+ for i, entry in enumerate(standings_data[:5]):
+ team_data = entry.get('team', {})
+ team_name = team_data.get('displayName', 'Unknown')
+ team_abbr = team_data.get('abbreviation', 'Unknown')
+
+ # Get record
+ wins = 0
+ losses = 0
+ ties = 0
+ win_percentage = 0.0
+
+ for stat in entry.get('stats', []):
+ stat_type = stat.get('type', '')
+ stat_value = stat.get('value', 0)
+
+ if stat_type == 'wins':
+ wins = int(stat_value)
+ elif stat_type == 'losses':
+ losses = int(stat_value)
+ elif stat_type == 'ties':
+ ties = int(stat_value)
+ elif stat_type == 'winpercent':
+ win_percentage = float(stat_value)
+
+ record = f"{wins}-{losses}" if ties == 0 else f"{wins}-{losses}-{ties}"
+ print(f" {i+1}. {team_name} ({team_abbr}): {record} ({win_percentage:.3f})")
+
+ return True
+ else:
+ print(" ✗ No direct standings data found")
+ return False
+
+ except Exception as e:
+ print(f"✗ Error testing MLB standings: {e}")
+ return False
+
+def test_nhl_standings():
+ """Test NHL standings endpoint with corrected parsing."""
+ print("\n=== Testing NHL Standings ===")
+
+ url = "https://site.api.espn.com/apis/v2/sports/hockey/nhl/standings"
+ params = {
+ 'season': 2025,
+ 'level': 1,
+ 'sort': 'winpercent:desc,gamesbehind:asc'
+ }
+
+ try:
+ response = requests.get(url, params=params, timeout=30)
+ response.raise_for_status()
+ data = response.json()
+
+ print(f"✓ Successfully fetched NHL standings")
+
+ # Check for direct standings data
+ if 'standings' in data and 'entries' in data['standings']:
+ standings_data = data['standings']['entries']
+ print(f" Found {len(standings_data)} teams in direct standings")
+
+ # Show top 5 teams
+ print(f" Top 5 teams:")
+ for i, entry in enumerate(standings_data[:5]):
+ team_data = entry.get('team', {})
+ team_name = team_data.get('displayName', 'Unknown')
+ team_abbr = team_data.get('abbreviation', 'Unknown')
+
+ # Get record with NHL-specific parsing
+ wins = 0
+ losses = 0
+ ties = 0
+ win_percentage = 0.0
+ games_played = 0
+
+ # First pass: collect all stat values
+ for stat in entry.get('stats', []):
+ stat_type = stat.get('type', '')
+ stat_value = stat.get('value', 0)
+
+ if stat_type == 'wins':
+ wins = int(stat_value)
+ elif stat_type == 'losses':
+ losses = int(stat_value)
+ elif stat_type == 'ties':
+ ties = int(stat_value)
+ elif stat_type == 'winpercent':
+ win_percentage = float(stat_value)
+ # NHL specific stats
+ elif stat_type == 'overtimelosses':
+ ties = int(stat_value) # NHL uses overtime losses as ties
+ elif stat_type == 'gamesplayed':
+ games_played = float(stat_value)
+
+ # Second pass: calculate win percentage for NHL if not already set
+ if win_percentage == 0.0 and games_played > 0:
+ win_percentage = wins / games_played
+
+ record = f"{wins}-{losses}" if ties == 0 else f"{wins}-{losses}-{ties}"
+ print(f" {i+1}. {team_name} ({team_abbr}): {record} ({win_percentage:.3f})")
+
+ return True
+ else:
+ print(" ✗ No direct standings data found")
+ return False
+
+ except Exception as e:
+ print(f"✗ Error testing NHL standings: {e}")
+ return False
+
+def test_ncaa_baseball_standings():
+ """Test NCAA Baseball standings endpoint with corrected parsing."""
+ print("\n=== Testing NCAA Baseball Standings ===")
+
+ url = "https://site.api.espn.com/apis/v2/sports/baseball/college-baseball/standings"
+ params = {
+ 'season': 2025,
+ 'level': 1,
+ 'sort': 'winpercent:desc,gamesbehind:asc'
+ }
+
+ try:
+ response = requests.get(url, params=params, timeout=30)
+ response.raise_for_status()
+ data = response.json()
+
+ print(f"✓ Successfully fetched NCAA Baseball standings")
+
+ # Check for direct standings data
+ if 'standings' in data and 'entries' in data['standings']:
+ standings_data = data['standings']['entries']
+ print(f" Found {len(standings_data)} teams in direct standings")
+
+ # Show top 5 teams
+ print(f" Top 5 teams:")
+ for i, entry in enumerate(standings_data[:5]):
+ team_data = entry.get('team', {})
+ team_name = team_data.get('displayName', 'Unknown')
+ team_abbr = team_data.get('abbreviation', 'Unknown')
+
+ # Get record
+ wins = 0
+ losses = 0
+ ties = 0
+ win_percentage = 0.0
+
+ for stat in entry.get('stats', []):
+ stat_type = stat.get('type', '')
+ stat_value = stat.get('value', 0)
+
+ if stat_type == 'wins':
+ wins = int(stat_value)
+ elif stat_type == 'losses':
+ losses = int(stat_value)
+ elif stat_type == 'ties':
+ ties = int(stat_value)
+ elif stat_type == 'winpercent':
+ win_percentage = float(stat_value)
+
+ record = f"{wins}-{losses}" if ties == 0 else f"{wins}-{losses}-{ties}"
+ print(f" {i+1}. {team_name} ({team_abbr}): {record} ({win_percentage:.3f})")
+
+ return True
+ else:
+ print(" ✗ No direct standings data found")
+ return False
+
+ except Exception as e:
+ print(f"✗ Error testing NCAA Baseball standings: {e}")
+ return False
+
+def main():
+ """Main function to run all tests."""
+ print("ESPN Standings Endpoints Test (Corrected)")
+ print("=" * 50)
+
+ results = []
+
+ # Test individual endpoints
+ results.append(test_nfl_standings())
+ results.append(test_mlb_standings())
+ results.append(test_nhl_standings())
+ results.append(test_ncaa_baseball_standings())
+
+ # Summary
+ passed = sum(results)
+ total = len(results)
+
+ print(f"\n=== Test Results ===")
+ print(f"Passed: {passed}/{total}")
+
+ if passed == total:
+ print("✓ All tests passed!")
+ return True
+ else:
+ print("✗ Some tests failed!")
+ return False
+
+if __name__ == "__main__":
+ success = main()
+ exit(0 if success else 1)
diff --git a/test/test_updated_leaderboard_manager.py b/test/test_updated_leaderboard_manager.py
new file mode 100644
index 00000000..b09a9e39
--- /dev/null
+++ b/test/test_updated_leaderboard_manager.py
@@ -0,0 +1,145 @@
+#!/usr/bin/env python3
+"""
+Test script to verify the updated leaderboard manager works correctly
+with the new NCAA Football rankings endpoint.
+"""
+
+import sys
+import os
+import json
+import time
+from typing import Dict, Any
+
+# Add the src directory to the path so we can import our modules
+sys.path.insert(0, os.path.join(os.path.dirname(__file__), '..', 'src'))
+
+from leaderboard_manager import LeaderboardManager
+from cache_manager import CacheManager
+from config_manager import ConfigManager
+
+def test_updated_leaderboard_manager():
+ """Test the updated leaderboard manager with NCAA Football rankings."""
+
+ print("Testing Updated Leaderboard Manager")
+ print("=" * 50)
+
+ # Create a mock display manager (we don't need the actual hardware for this test)
+ class MockDisplayManager:
+ def __init__(self):
+ self.matrix = type('Matrix', (), {'width': 64, 'height': 32})()
+ self.image = None
+ self.draw = None
+
+ def update_display(self):
+ pass
+
+ def set_scrolling_state(self, scrolling):
+ pass
+
+ def process_deferred_updates(self):
+ pass
+
+ # Create test configuration
+ test_config = {
+ 'leaderboard': {
+ 'enabled': True,
+ 'enabled_sports': {
+ 'ncaa_fb': {
+ 'enabled': True,
+ 'top_teams': 10
+ }
+ },
+ 'update_interval': 3600,
+ 'scroll_speed': 2,
+ 'scroll_delay': 0.05,
+ 'display_duration': 60,
+ 'loop': True,
+ 'request_timeout': 30,
+ 'dynamic_duration': True,
+ 'min_duration': 30,
+ 'max_duration': 300,
+ 'duration_buffer': 0.1,
+ 'time_per_team': 2.0,
+ 'time_per_league': 3.0
+ }
+ }
+
+ try:
+ # Initialize the leaderboard manager
+ print("Initializing LeaderboardManager...")
+ display_manager = MockDisplayManager()
+ leaderboard_manager = LeaderboardManager(test_config, display_manager)
+
+ print(f"Leaderboard enabled: {leaderboard_manager.is_enabled}")
+ print(f"Enabled sports: {[k for k, v in leaderboard_manager.enabled_sports.items() if v.get('enabled', False)]}")
+
+ # Test the NCAA Football rankings fetch
+ print("\nTesting NCAA Football rankings fetch...")
+ ncaa_fb_config = leaderboard_manager.league_configs['ncaa_fb']
+ print(f"NCAA FB config: {ncaa_fb_config}")
+
+ # Fetch standings using the new method
+ standings = leaderboard_manager._fetch_standings(ncaa_fb_config)
+
+ if standings:
+ print(f"\nSuccessfully fetched {len(standings)} teams")
+ print("\nTop 10 NCAA Football Teams (from rankings):")
+ print("-" * 60)
+ print(f"{'Rank':<4} {'Team':<25} {'Abbr':<6} {'Record':<12} {'Win %':<8}")
+ print("-" * 60)
+
+ for team in standings:
+ record_str = f"{team['wins']}-{team['losses']}"
+ if team['ties'] > 0:
+ record_str += f"-{team['ties']}"
+
+ win_pct = team['win_percentage']
+ win_pct_str = f"{win_pct:.3f}" if win_pct > 0 else "0.000"
+
+ print(f"{team.get('rank', 'N/A'):<4} {team['name']:<25} {team['abbreviation']:<6} {record_str:<12} {win_pct_str:<8}")
+
+ print("-" * 60)
+
+ # Show additional info
+ ranking_name = standings[0].get('ranking_name', 'Unknown') if standings else 'Unknown'
+ print(f"Ranking system used: {ranking_name}")
+ print(f"Data fetched at: {time.strftime('%Y-%m-%d %H:%M:%S')}")
+
+ # Test caching
+ print(f"\nTesting caching...")
+ cached_standings = leaderboard_manager._fetch_standings(ncaa_fb_config)
+ if cached_standings:
+ print("✓ Caching works correctly - data retrieved from cache")
+ else:
+ print("✗ Caching issue - no data retrieved from cache")
+
+ else:
+ print("✗ No standings data retrieved")
+ return False
+
+ print("\n✓ Leaderboard manager test completed successfully!")
+ return True
+
+ except Exception as e:
+ print(f"✗ Error testing leaderboard manager: {e}")
+ import traceback
+ traceback.print_exc()
+ return False
+
+def main():
+ """Main function to run the test."""
+ try:
+ success = test_updated_leaderboard_manager()
+ if success:
+ print("\n🎉 All tests passed! The updated leaderboard manager is working correctly.")
+ else:
+ print("\n❌ Tests failed. Please check the errors above.")
+ except KeyboardInterrupt:
+ print("\nTest interrupted by user")
+ except Exception as e:
+ print(f"Error running test: {e}")
+ import traceback
+ traceback.print_exc()
+
+if __name__ == "__main__":
+ main()
diff --git a/test_graceful_updates.py b/test_graceful_updates.py
new file mode 100644
index 00000000..3014bb45
--- /dev/null
+++ b/test_graceful_updates.py
@@ -0,0 +1,187 @@
+#!/usr/bin/env python3
+"""
+Test script to demonstrate the graceful update system for scrolling displays.
+This script shows how updates are deferred during scrolling periods to prevent lag.
+"""
+
+import time
+import logging
+import sys
+import os
+
+# Add the project root directory to Python path
+sys.path.append(os.path.dirname(os.path.abspath(__file__)))
+
+# Configure logging first
+logging.basicConfig(
+ level=logging.DEBUG,
+ format='%(asctime)s.%(msecs)03d - %(levelname)s:%(name)s:%(message)s',
+ datefmt='%H:%M:%S',
+ stream=sys.stdout
+)
+
+logger = logging.getLogger(__name__)
+
+# Mock rgbmatrix module for testing on non-Raspberry Pi systems
+try:
+ from rgbmatrix import RGBMatrix, RGBMatrixOptions
+except ImportError:
+ logger.info("rgbmatrix module not available, using mock for testing")
+
+ class MockRGBMatrixOptions:
+ def __init__(self):
+ self.rows = 32
+ self.cols = 64
+ self.chain_length = 2
+ self.parallel = 1
+ self.hardware_mapping = 'adafruit-hat-pwm'
+ self.brightness = 90
+ self.pwm_bits = 10
+ self.pwm_lsb_nanoseconds = 150
+ self.led_rgb_sequence = 'RGB'
+ self.pixel_mapper_config = ''
+ self.row_address_type = 0
+ self.multiplexing = 0
+ self.disable_hardware_pulsing = False
+ self.show_refresh_rate = False
+ self.limit_refresh_rate_hz = 90
+ self.gpio_slowdown = 2
+
+ class MockRGBMatrix:
+ def __init__(self, options=None):
+ self.width = 128 # 64 * 2 chain length
+ self.height = 32
+
+ def CreateFrameCanvas(self):
+ return MockCanvas()
+
+ def SwapOnVSync(self, canvas, dont_wait=False):
+ pass
+
+ def Clear(self):
+ pass
+
+ class MockCanvas:
+ def __init__(self):
+ self.width = 128
+ self.height = 32
+
+ def SetImage(self, image):
+ pass
+
+ def Clear(self):
+ pass
+
+ RGBMatrix = MockRGBMatrix
+ RGBMatrixOptions = MockRGBMatrixOptions
+
+from src.display_manager import DisplayManager
+from src.config_manager import ConfigManager
+
+def simulate_scrolling_display(display_manager, duration=10):
+ """Simulate a scrolling display for testing."""
+ logger.info(f"Starting scrolling simulation for {duration} seconds")
+
+ start_time = time.time()
+ while time.time() - start_time < duration:
+ # Signal that we're scrolling
+ display_manager.set_scrolling_state(True)
+
+ # Simulate some scrolling work
+ time.sleep(0.1)
+
+ # Every 2 seconds, try to defer an update
+ if int(time.time() - start_time) % 2 == 0:
+ logger.info("Attempting to defer an update during scrolling")
+ display_manager.defer_update(
+ lambda: logger.info("This update was deferred and executed later!"),
+ priority=1
+ )
+
+ # Signal that scrolling has stopped
+ display_manager.set_scrolling_state(False)
+ logger.info("Scrolling simulation completed")
+
+def test_graceful_updates():
+ """Test the graceful update system."""
+ logger.info("Testing graceful update system")
+
+ # Load config
+ config_manager = ConfigManager()
+ config = config_manager.load_config()
+
+ # Initialize display manager
+ display_manager = DisplayManager(config, force_fallback=True)
+
+ try:
+ # Test 1: Defer updates during scrolling
+ logger.info("=== Test 1: Defer updates during scrolling ===")
+
+ # Add some deferred updates
+ display_manager.defer_update(
+ lambda: logger.info("Update 1: High priority update"),
+ priority=1
+ )
+ display_manager.defer_update(
+ lambda: logger.info("Update 2: Medium priority update"),
+ priority=2
+ )
+ display_manager.defer_update(
+ lambda: logger.info("Update 3: Low priority update"),
+ priority=3
+ )
+
+ # Start scrolling simulation
+ simulate_scrolling_display(display_manager, duration=5)
+
+ # Check scrolling stats
+ stats = display_manager.get_scrolling_stats()
+ logger.info(f"Scrolling stats: {stats}")
+
+ # Test 2: Process deferred updates when not scrolling
+ logger.info("=== Test 2: Process deferred updates when not scrolling ===")
+
+ # Process any remaining deferred updates
+ display_manager.process_deferred_updates()
+
+ # Test 3: Test inactivity threshold
+ logger.info("=== Test 3: Test inactivity threshold ===")
+
+ # Signal scrolling started
+ display_manager.set_scrolling_state(True)
+ logger.info(f"Is scrolling: {display_manager.is_currently_scrolling()}")
+
+ # Wait longer than the inactivity threshold
+ time.sleep(3)
+ logger.info(f"Is scrolling after inactivity: {display_manager.is_currently_scrolling()}")
+
+ # Test 4: Test priority ordering
+ logger.info("=== Test 4: Test priority ordering ===")
+
+ # Add updates in reverse priority order
+ display_manager.defer_update(
+ lambda: logger.info("Priority 3 update"),
+ priority=3
+ )
+ display_manager.defer_update(
+ lambda: logger.info("Priority 1 update"),
+ priority=1
+ )
+ display_manager.defer_update(
+ lambda: logger.info("Priority 2 update"),
+ priority=2
+ )
+
+ # Process them (should execute in priority order: 1, 2, 3)
+ display_manager.process_deferred_updates()
+
+ logger.info("All tests completed successfully!")
+
+ except Exception as e:
+ logger.error(f"Test failed: {e}", exc_info=True)
+ finally:
+ # Cleanup
+ display_manager.cleanup()
+
+if __name__ == "__main__":
+ test_graceful_updates()
diff --git a/web_interface_v2.py b/web_interface_v2.py
index 53b88951..d255547a 100644
--- a/web_interface_v2.py
+++ b/web_interface_v2.py
@@ -815,6 +815,9 @@ api_counters = {
'stocks': {'used': 0},
'sports': {'used': 0},
'news': {'used': 0},
+ 'odds': {'used': 0},
+ 'music': {'used': 0},
+ 'youtube': {'used': 0},
}
api_window_start = time.time()
api_window_seconds = 24 * 3600
@@ -875,6 +878,27 @@ def get_metrics():
except Exception:
forecast['news'] = 0
+ # Odds ticker
+ try:
+ o_int = int(config.get('odds_ticker', {}).get('update_interval', 3600))
+ forecast['odds'] = max(1, int(api_window_seconds / max(1, o_int)))
+ except Exception:
+ forecast['odds'] = 0
+
+ # Music manager (image downloads)
+ try:
+ m_int = int(config.get('music', {}).get('POLLING_INTERVAL_SECONDS', 5))
+ forecast['music'] = max(1, int(api_window_seconds / max(1, m_int)))
+ except Exception:
+ forecast['music'] = 0
+
+ # YouTube display
+ try:
+ y_int = int(config.get('youtube', {}).get('update_interval', 300))
+ forecast['youtube'] = max(1, int(api_window_seconds / max(1, y_int)))
+ except Exception:
+ forecast['youtube'] = 0
+
return jsonify({
'status': 'success',
'window_seconds': api_window_seconds,
diff --git a/wiki/GRACEFUL_UPDATES.md b/wiki/GRACEFUL_UPDATES.md
new file mode 100644
index 00000000..ec16d06f
--- /dev/null
+++ b/wiki/GRACEFUL_UPDATES.md
@@ -0,0 +1,146 @@
+# Graceful Update System
+
+The LED Matrix project now includes a graceful update system that prevents lag during scrolling displays by deferring updates until the display is not actively scrolling.
+
+## Overview
+
+When displays like the odds ticker, stock ticker, or news ticker are actively scrolling, performing API updates or data fetching can cause visual lag or stuttering. The graceful update system solves this by:
+
+1. **Tracking scrolling state** - The system monitors when displays are actively scrolling
+2. **Deferring updates** - Updates that might cause lag are deferred during scrolling periods
+3. **Processing when safe** - Deferred updates are processed when scrolling stops or during non-scrolling periods
+4. **Priority-based execution** - Updates are executed in priority order when processed
+
+## How It Works
+
+### Scrolling State Tracking
+
+The `DisplayManager` class now includes scrolling state tracking:
+
+```python
+# Signal when scrolling starts
+display_manager.set_scrolling_state(True)
+
+# Signal when scrolling stops
+display_manager.set_scrolling_state(False)
+
+# Check if currently scrolling
+if display_manager.is_currently_scrolling():
+ # Defer updates
+ pass
+```
+
+### Deferred Updates
+
+Updates can be deferred using the `defer_update` method:
+
+```python
+# Defer an update with priority
+display_manager.defer_update(
+ lambda: self._perform_update(),
+ priority=1 # Lower numbers = higher priority
+)
+```
+
+### Automatic Processing
+
+Deferred updates are automatically processed when:
+- A display signals it's not scrolling
+- The main loop processes updates during non-scrolling periods
+- The inactivity threshold is reached (default: 2 seconds)
+
+## Implementation Details
+
+### Display Manager Changes
+
+The `DisplayManager` class now includes:
+
+- `set_scrolling_state(is_scrolling)` - Signal scrolling state changes
+- `is_currently_scrolling()` - Check if display is currently scrolling
+- `defer_update(update_func, priority)` - Defer an update function
+- `process_deferred_updates()` - Process all pending deferred updates
+- `get_scrolling_stats()` - Get current scrolling statistics
+
+### Manager Updates
+
+The following managers have been updated to use the graceful update system:
+
+#### Odds Ticker Manager
+- Defers API updates during scrolling
+- Signals scrolling state during display
+- Processes deferred updates when not scrolling
+
+#### Stock Manager
+- Defers stock data updates during scrolling
+- Always signals scrolling state (continuous scrolling)
+- Priority 2 for stock updates
+
+#### Stock News Manager
+- Defers news data updates during scrolling
+- Signals scrolling state during display
+- Priority 2 for news updates
+
+### Display Controller Changes
+
+The main display controller now:
+- Checks scrolling state before updating modules
+- Defers scrolling-sensitive updates during scrolling periods
+- Processes deferred updates in the main loop
+- Continues non-scrolling-sensitive updates normally
+
+## Configuration
+
+The system uses these default settings:
+
+- **Inactivity threshold**: 2.0 seconds
+- **Update priorities**:
+ - Priority 1: Odds ticker updates
+ - Priority 2: Stock and news updates
+ - Priority 3+: Other updates
+
+## Benefits
+
+1. **Smoother Scrolling** - No more lag during ticker scrolling
+2. **Better User Experience** - Displays remain responsive during updates
+3. **Efficient Resource Usage** - Updates happen when the system is idle
+4. **Priority-Based** - Important updates are processed first
+5. **Automatic** - No manual intervention required
+
+## Testing
+
+You can test the graceful update system using the provided test script:
+
+```bash
+python test_graceful_updates.py
+```
+
+This script demonstrates:
+- Deferring updates during scrolling
+- Processing updates when not scrolling
+- Priority-based execution
+- Inactivity threshold behavior
+
+## Debugging
+
+To debug the graceful update system, enable debug logging:
+
+```python
+import logging
+logging.getLogger('src.display_manager').setLevel(logging.DEBUG)
+```
+
+The system will log:
+- When scrolling state changes
+- When updates are deferred
+- When deferred updates are processed
+- Current scrolling statistics
+
+## Future Enhancements
+
+Potential improvements to the system:
+
+1. **Configurable thresholds** - Allow users to adjust inactivity thresholds
+2. **More granular priorities** - Add more priority levels for different update types
+3. **Update batching** - Group similar updates to reduce processing overhead
+4. **Performance metrics** - Track and report update deferral statistics
+5. **Web interface integration** - Show deferred update status in the web UI