📊 System Overview
XMLSync is a secure, real-time file synchronization system designed specifically for ESPN Valparaiso University sports statistics. It automatically syncs XML stats files between the stats operator and graphics systems.
📝 Stats Person
Creates XML File
➡️
🔄 XMLSync
Auto Upload
➡️
🖥️ Graphics Person
Auto Download
⬇️ Download XMLSync Client
No Python installation required! Just download and run the executable.
✅ Ready to Use: Both executables are pre-configured for the ESPN server and include all necessary dependencies.
🚀 Key Features
🔐 Secure Authentication
API key-based security ensures only authorized clients can sync files
👀 Real-time Monitoring
Automatically detects file changes and uploads within 10 seconds
📱 User-Friendly GUI
Intuitive interface with sender/receiver modes and live status updates
📋 Activity Logging
Complete audit trail of all file operations and system activities
⚡ No Installation
Portable executables run on any Windows system without setup
🔄 Automatic Recovery
Handles network interruptions and automatically reconnects
📊 For Stats Person (Sender Mode)
Quick Setup:
- Download and run XMLSync GUI
- Click the "📤 Sender Mode" tab
- Click "Browse..." and select your XML stats file
- Click "Start Monitoring"
- Your file will automatically upload whenever it changes!
That's it! The system will now monitor your file and upload changes automatically with a 10-second cooldown to prevent spam uploads.
Command Line Usage:
# Upload a file once
XMLSync_CLI.exe upload --file "game_stats.xml"
# Monitor file for changes (auto-upload)
XMLSync_CLI.exe watch --file "game_stats.xml"
🖥️ For Graphics Person (Receiver Mode)
Quick Setup:
- Download and run XMLSync GUI
- Click the "📥 Receiver Mode" tab
- Click "Browse..." and select where to download files
- Click "Start Listening"
- Files will automatically download when stats update!
Always Fresh Data! The system creates a "latest.xml" file in your folder that's always the most current stats.
Command Line Usage:
# Download latest file once
XMLSync_CLI.exe download --output "latest_stats.xml"
# Check server status
XMLSync_CLI.exe status
🔧 Technical Details
Server Configuration
URL: https://espn.signalmedia.live/xml
Security: SHA256 API Key Authentication
File Limit: 10MB maximum file size
File Requirements
Format: XML files only (.xml extension)
Encoding: UTF-8 recommended
Monitoring: 10-second upload cooldown
System Requirements
OS: Windows 7 or later
Network: Internet connection required
Disk: 50MB free space recommended
🔌 API Endpoints
For developers and advanced integration:
Available Endpoints:
POST /upload.php - Upload XML files
GET /download.php - Download files
GET /notifications.php - Get update notifications
GET /status.php - Server health check
GET /download_client.php - Download XMLSync clients
⚠️ API Key Required: All endpoints require the X-API-Key header for authentication.
🔧 Troubleshooting
Common Issues & Solutions:
❌ Connection Failed
• Check internet connection
• Verify server URL in settings
• Test connection in Settings tab
❌ Upload/Download Failed
• Check file permissions
• Ensure file is under 10MB
• Verify XML file format
❌ File Not Monitoring
• Ensure file exists
• Check file is not locked
• Restart monitoring
💡 Pro Tip: Check the "📋 Logs" tab in the GUI for detailed error information and activity history.
📞 Support
For technical support, questions, or feature requests:
📧 Contact
Developer: Mitchell Moss
Organization: Signal Media
Purpose: ESPN Valparaiso University
📊 Server Status
Real-time server status available in the XMLSync GUI or via the status endpoint.