If the content rate (in frames per second) of your media does not match a multiple of the refresh rate (in hertz) of your video output, then you may notice video playback juddering or stuttering.

AutoRefresh uses MediaInfo to inspect the frame rate of your media (just before playback begins) and then sets your video output to a suitable matching refresh rate.

Downloading and Installing

Download: AutoRefresh.zip (1.2 MB, 9490 downloads)

To install, simply extract the zip's contents into NextPVR's Data Directory.

(For NPVR 2.6, you must use AutoRefresh-NPVR2.zip instead)


You must be using a NextPVR video renderer that is compatible with having its refresh rate changed dynamically. EVR is known to work well.


All settings for the plugin can be configured using NextPVR's Settings dialog (right-click, and select Settings). These settings are written to \Plugins\AutoRefresh\AutoRefresh.xml.

Monitor Settings:

  • Enable content rate detection and automatic refresh rate switching - enables or disables the plugin.
  • Restore desktop refresh rate whenever video playback ends - if selected, the display will return to the refresh rate selected under Desktop whenever video playback ends.

You can configure a range of content rate/monitor refresh rate pairings. Any rates chosen must match those available for your video card/display device. There are three special options:

  • Desktop/NPVR (no video playing) - specifies a rate to use when not playing video. The plugin can switch to this rate when a video ends if the Restore desktop option (above) is selected.
  • Default/Live TV/unknown - specifies the default media refresh rate, which is usually selected for Live TV (as MediaInfo cannot detect this), or other unknown or unusual media files.
  • Blu-ray discs/folders (index.bdmv) - specifies the refresh rate to use when playing Blu-ray discs or folder rips.

If you have a multi-monitor setup, then you can also select which monitor any refresh rate changes will affect. Monitor 0 is the default (and primary) as seen by Windows.

If you have media files containing frame rates different to those configurable in the Settings dialog, then you can add a custom rate for them by editing AutoRefresh.xml and adding extra RefreshRate elements, for example:

<RefreshRate content="15.000">30</RefreshRate>

Forcing a Redraw:

On some systems, you may find NextPVR does not redraw its interface if a refresh rate change occurs at the end of video playback. You can edit the following AutoRefresh.xml entry to specify a time (in milliseconds) to wait - after playback ends and the refresh rate is changing - before requesting NextPVR to do a redraw.


Manual Overrides:

There may be times when MediaInfo incorrectly detects framerates, or when you wish to use an alternative rate (for instance if using ReClock and 23.976fps is desired with NTSC DVDs rather than 29.970fps).

You can manually override the detected framerate by including either a <videoname>.autorefresh file or a folder.autorefresh file, the latter allowing you to apply a single override to an entire folder of videos at once.

The override file should include a single line of text stating the framerate, for example: 23.976

Using the Plugin

AutoRefresh runs automatically, detecting and switching refresh rates just before any video playback begins. On some digital displays or TVs you may notice a small delay or screen-blackout while this happens.


For help, discussion, or reporting any issues with this plugin, please use the 3rd Party Plugins area of the NextPVR forum.


To uninstall the plugin, simply remove the AutoRefresh folder from \Plugins. You can temporarily disable the plugin by renaming \Plugins\AutoRefresh to \Plugins\_AutoRefresh (adding the underscore).


Developed by imilne. The source code for the AutoRefresh plugin is available upon request.


2014-05-03 : v3.14.05.03

  • Added an extra setting so that the desktop rate can be set independently of any media playback rates

2013-10-27 : v3.13.10.27

  • Added support for specifying which monitor to use in multi-monitor setups

2013-10-11 : v3.13.10.11

  • Updated for NextPVR 3 (and .NET 4) compatibility
  • Fixed a minor issue with unnecessary refresh changes when playing music

2012-12-21 : v2.12.12.21

  • Settings are now stored in /Plugins/AutoRefresh/AutoRefresh.xml rather than config.xml
  • Updated MediaInfo to version 0.7.61
  • Added an additional option to control how much logging is produced
  • Added functionality to support changing refresh rates when called by the MovieTrailers plugin

2012-04-13 : v2.12.04.13

  • Added a specific override setting for blu-ray discs (or folder rips)

2012-02-18 : v2.12.02.18

  • Fixed a problem that stopped AutoRefresh working with the YouTube plugin

2011-09-25 : v2.11.09.25

  • Added support for additional refresh rates
  • Added support for ForceRepaintWaitTimeMS in config.xml
  • Added support for overriding video rates via .autorefresh files on disk


  • Initial public release for alpha feedback


Page last modified on May 03, 2014, at 07:31 AM