What Is Match Frame Rate?
Match Frame Rate (also called Rate Switch or Display Mode Switching) is a technique where the TV's display refresh rate is changed to exactly match the video frame rate at the start of playback.
| Without Match FR | With Match FR |
|---|---|
| 24p film on 60 Hz display → judder / 3:2 pulldown | 24p film on 24 Hz display → perfectly smooth |
How JellyWatch Handles It
When playback starts, JellyWatch queries Display.getSupportedModes() and selects the best matching mode based on:
- Video frame rate - matches or divides evenly (e.g. 120 Hz for 24p)
- Video resolution - optionally matches 1080p → 1080p, 4K → 4K
On playback stop or when leaving the player, the original display mode is restored automatically.
Configuration
Go to Settings → Playback:
| Setting | Description |
|---|---|
| Match Refresh Rate | Enable automatic Hz switching to match video fps |
| Match Resolution | Enable automatic resolution switching to match video dimensions |
Both can be enabled independently.
Seamless vs Non-Seamless Switches
- Seamless switch (e.g. 60 Hz → 120 Hz on the same resolution): no visible interruption.
- Non-seamless switch (e.g. 60 Hz → 24 Hz): the display goes blank for ~2 seconds while the TV locks onto the new signal. JellyWatch detects this and waits before starting the player, so you never miss the first frames.
Supported Devices
Match Frame Rate works on any Android TV / Google TV device that exposes multiple display modes via Display.getSupportedModes(). Most Nvidia Shield, Sony Bravia (Google TV), and Chromecast with Google TV devices support this. Some budget devices only expose a single mode and the feature has no effect.
Troubleshooting
| Issue | Solution |
|---|---|
| Display does not switch | Verify your TV/device supports multiple modes (check TV manual) |
| Black screen on switch | Normal for non-seamless switches - wait 2–3 seconds |
| Judder persists | Ensure your HDMI cable supports the target bandwidth (HDMI 2.0+ for 4K@60) |
| Mode not restored | Force-close and reopen the app to reset the display mode |
