video-player-log-analyzer/README.md

Video Player Log Analyzer

HTML-based log analyzer for the Moonlight Drive-In Theater NFC video player system. Features real-time statistics dashboards, interactive charts, video playback analytics, and print-ready activity reports.

Features

Interactive Dashboard

• Real-time Statistics: Track total NFC scans, unique videos, trailers played, and average time between scans
• Dynamic Charts: 4 interactive Chart.js visualizations with filtering options
• Video Details: Click any video to see detailed playback timeline and statistics

Visualization Types

1. Event Timeline: Scatter plot showing all NFC scans, videos, and trailers over time
2. Hourly Activity: Bar chart showing event distribution across 24-hour period
3. Top 15 Videos: Horizontal bar chart ranking most-played content
4. Time Between Scans: Line graph tracking intervals between consecutive NFC scans

Print Report

• One-click comprehensive PDF report generation
• Includes all 4 charts optimized for print
• Complete tables of NFC scans and trailer playback
• Summary statistics at-a-glance
• Professional purple theme with clean layout

Log Parsing

• Accurate Scan Detection: Correctly identifies actual runtime NFC scans vs configuration loading
• Mapping Resolution: Automatically resolves NFC IDs to video/folder names from log configuration
• Folder Support: Recognizes sequential folder playback patterns
• Trailer Tracking: Monitors randomization and prevents repeat detection

Usage

1. Open the HTML File: Simply open video_player_log_analyzer.html in any modern web browser (Chrome, Firefox, Edge, etc.)

2. Load Log File: Click "📁 Load Log File" and select your video_player_YYYYMMDD_HHMMSS.log file

3. Explore Data:

   • View statistics cards at the top
   • Use chart type dropdown to switch between visualizations
   • Apply event filters (All Events / NFC Scans Only / Trailers Only)
   • Click on videos in the list to see detailed playback timelines

4. Generate Report: Click "🖨️ Print Report" button to create a comprehensive PDF report with all charts and tables

Technical Details

Dependencies

• Chart.js (3.x): Interactive charts and graphs
• date-fns (2.29.3): Date/time formatting utilities

All dependencies are loaded from CDN - no installation required!

File Format

Works with log files generated by the Moonlight Drive-In Theater video player system. Expected log patterns:

• Processing NFC input: [id] - Actual NFC scan events
• Mapped NFC [id] -> [video/folder] - Configuration mappings
• Selected trailer: [filename] - Trailer playback
• Queued specific video: [filename] - Video queuing
• Folder '[name]': Playing video [x]/[total] - Sequential folder playback

Browser Compatibility

• Chrome 90+
• Firefox 88+
• Edge 90+
• Safari 14+

Print Report Features

Summary Statistics

• Total NFC Scans
• Videos Played
• Trailers Played
• Average Time Between Scans

Charts (Print-Optimized)

• Event Timeline (800x200px)
• Hourly Activity (800x300px)
• Top 15 Videos (800x400px)
• Time Between Scans (800x300px)

Detailed Tables

• NFC Scans: Scan #, Timestamp, NFC ID, Video/Folder Name
• Trailers: Trailer #, Timestamp, Filename

Print CSS

• Professional purple theme (#7c3aed)
• Alternating row colors for readability
• Page break controls
• Optimized headers and borders

Development History

Version 1.0

• Initial release with NFC scan tracking
• Basic chart visualizations
• Video playback statistics

Version 1.1 (Current)

• Fixed: Parser now correctly identifies actual NFC scan events
• Added: NFC mapping lookup to eliminate "Unknown" entries
• Added: Comprehensive print report feature
• Added: Error handling and debugging
• Improved: Statistics accuracy (585 actual scans vs 72 config lines)

Project Structure

video-player-log-analyzer/
├── video_player_log_analyzer.html    # Single-file application
└── README.md                          # This file

License

Created for the Moonlight Drive-In Theater project.

Author

Jess @ Hideaway Gaming

• Gitea: https://gitea.hideawaygaming.com.au/jessikitty
• Email: jess@hideawaygaming.com.au

Related Projects

• Moonlight Drive-In Theater: Main NFC-based video player system
• NFC Mapping Configuration: Tag ID to video/folder mapping system
• Trailer Randomization: Anti-repeat logic for trailer selection