How to Troubleshoot Video Wall Sync Issues
Synchronisation issues in video walls create visible tearing, content misalignment, and professional credibility problems. This guide provides systematic troubleshooting steps to identify and resolve common sync problems. Whether you're seeing occasional glitches or persistent misalignment, these steps will help restore seamless playback.
Before You Start
- Access to video wall CMS and player settings
- Network access to all media players
- Understanding of video wall configuration
- Test content with horizontal motion
Identify the Symptom
Characterize the sync issue precisely. Common symptoms include: horizontal tearing (visible line where content doesn't match across screens), gradual drift (sync starts good but degrades over time), random jumps (occasional sudden misalignment), or complete desync (screens clearly showing different frames). The symptom points to different root causes. Record when the issue occurs and how often.
- — Record video of the issue for reference
- — Note if issue is consistent or intermittent
- — Check if issue affects all displays or just some
Check Time Synchronisation
All players in a sync group must agree on time to within milliseconds. In SPARC, view each player's status to see its time offset from the server. Offsets greater than 50ms can cause visible sync issues. Verify all players are connected to the same NTP server and receiving updates. Time sync issues cause gradual drift that worsens over time.
- — Use a single NTP source for all players
- — Consider local NTP server for large installations
- — Check that NTP isn't blocked by firewalls
Verify Network Connectivity
Inconsistent network latency disrupts sync coordination. Run continuous ping tests from each player to the CMS server and between players. Look for packet loss, high latency (>100ms), or variable latency (jitter). Wired Ethernet is strongly recommended; WiFi introduces too much variability. Check for network congestion during sync issues.
- — Use wired Ethernet for all video wall players
- — Check for network hardware issues (failing switches, bad cables)
- — Monitor network traffic during problem periods
Examine Player Hardware
Different player hardware can decode video at different speeds. Ensure all players in a sync group use identical hardware specifications—same CPU, GPU, RAM, and storage type. Mixed hardware is a common cause of persistent sync issues. Check that players aren't throttling due to heat (CPUs reduce speed when hot) by monitoring temperatures.
- — Standardize on one player model for video walls
- — Ensure adequate ventilation for all players
- — Check player resource usage (CPU, memory) during playback
Review Content Encoding
Content encoding problems cause playback inconsistencies. Verify all content uses constant frame rate (CFR), never variable frame rate (VFR). Check that keyframe intervals are consistent and not too long (every 1-2 seconds is ideal). Use the same codec settings for all video wall content. Re-encode problem content with strict settings.
- — Export with constant frame rate explicitly set
- — Use fixed keyframe intervals (1-2 seconds)
- — Test with known-good content to isolate encoding issues
Check Display Refresh Rates
All displays in a video wall should run at the same refresh rate. Mixed 60Hz and 59.94Hz displays will drift apart. Check display settings and force all to the same rate. If using hardware genlock, verify the sync signal reaches all displays and they're locked to it. Refresh rate mismatches cause slow drift visible over minutes.
- — Set explicit refresh rate, don't rely on auto-detect
- — Verify refresh rate in display service menu if needed
- — Check video cable types support required refresh rate
Examine Sync Configuration
Review your video wall sync configuration in SPARC. Verify all players are assigned to the correct sync group. Check that the sync mode is appropriate for your installation (frame sync for tight walls, loose sync for distributed displays). Confirm the designated primary player is reliable and consistently available. Misconfigured sync groups cause unpredictable behavior.
- — Designate the most stable player as sync primary
- — Verify player positions match physical layout
- — Check sync logs for configuration warnings
Test with Simple Content
Isolate content from infrastructure issues by testing with simple content. Create a basic test file—solid color with frame counter or simple horizontal scrolling bar. If test content syncs properly but production content doesn't, the issue is content-related. If test content also fails, the issue is infrastructure or configuration.
- — Use SPARC's built-in sync test patterns
- — Test at different times to catch intermittent issues
- — Document which content types have problems
Review Logs and Diagnostics
Check player logs and SPARC diagnostics for sync-related errors or warnings. Look for messages about time sync failures, buffer underruns, or decode errors. SPARC's diagnostic tools show real-time sync status across all players. Correlate logged issues with observed symptoms to pinpoint the cause.
- — Enable verbose logging temporarily for more detail
- — Compare logs from synced vs unsynced time periods
- — Look for patterns in timing of logged errors
Implement and Verify Fix
Based on your diagnosis, implement the appropriate fix—network improvements, hardware standardization, content re-encoding, or configuration changes. After implementing, test thoroughly with the problematic content and conditions. Monitor for several hours or days to ensure the issue is truly resolved and not just temporarily better.
- — Change one thing at a time to identify the effective fix
- — Document what fixed the issue for future reference
- — Set up monitoring to catch recurrence quickly
Sync issues usually stem from network, timing, hardware, or content inconsistencies. Systematic troubleshooting identifies the root cause and enables targeted fixes. For persistent issues, SPARC support can analyze diagnostic data and recommend solutions specific to your installation.
Troubleshooting
Sync works initially but drifts over hours
Check NTP synchronisation. Verify all displays have matching refresh rates. Look for thermal throttling in players.
Random sync jumps but overall alignment is good
Check for network packet loss. Look for keyframe issues in content. Verify player storage isn't causing read delays.
Only one or two screens are out of sync
Focus on those specific players. Check their network, cables, and hardware. Verify they're correctly configured in sync group.
Sync issues only with certain content
Re-encode problem content with strict settings (CFR, fixed keyframes). Test encoding with media analysis tools.