Skip to content
pubscout

refresh_rate

2.0.1, released 2 months ago by afewgoodcoders.com

Request display refresh rates and measure Flutter frame cadence, benchmarks, and performance telemetry.

WASM-ready
$ flutter pub add refresh_rate
Source repository

What it does

Allows requesting high refresh rates on Android and provides multi-platform diagnostics, live overlays, and benchmark reporting. It captures frame cadences, phase overruns, and session statistics.

AI-written summary of version 2.0.1, based on the package's README and metadata. Report an inaccuracy

Use it when

  • You need to request higher refresh rates (e.g. 120 Hz) on Android devices for smoother animations or games.
  • You want to measure frame cadence, UI/raster budget overruns, and export performance benchmark reports.

Skip it when

  • You are relying on it to directly control refresh rates on iOS, macOS, Windows, Linux, or Web where engine control is unsupported.
  • You are looking for general state management or standard widget libraries.

Strengths

  • Supports fine-grained preference management via leases, declarative scopes, and automatic policies.
  • Provides comprehensive session benchmarks, threshold evaluations, and diagnostic exports.

Weaknesses

  • Native refresh rate control is platform-dependent and primarily effective on Android.
  • Physical presentation FPS cannot be directly measured on certain platforms.

Setup

Kind
Plugin (native code)
Effort
Low
Code generation
No
Direct dependencies
2

For iOS ProMotion devices, you may add the CADisableMinimumFrameDurationOnPhone boolean to your Info.plist dictionary.

void main() {
  WidgetsFlutterBinding.ensureInitialized();
  runApp(const MyApp());
  WidgetsBinding.instance.addPostFrameCallback((_) async {
    await RefreshRate.enable();
  });
}

Alternatives

Packages that do the same job and could replace refresh_rate.

Works with

Packages commonly used together with refresh_rate: ones it builds on, ones built on it, and its own family.