Skip to Content
Platform.Ontology

Display refresh rate and HDR

Reads the screen refresh rate and HDR support with no prompt.

Gets silentlyDevice detailsDisplayAndroid and iPhoneWhen the app opensWhile you use it

In one line

Can see your screen refresh rate and whether it shows HDR, with no prompt

Reads the screen refresh rate and HDR support with no prompt.

60, 90, 120 or 144 Hz plus HDR format list separates device tiers and models. Used for animation pacing.

What it can and can't do

What the user does: Nothing. Games and video apps check when they start

It can

  • See the refresh rate, such as 60, 90, 120 or 144 Hz
  • See which refresh rate options your screen supports on Android
  • See if the screen supports HDR on Android
  • See if an iPhone has a 120 Hz ProMotion screen

It cannot

  • Change the screen's hardware refresh options
  • Force a rate your screen does not support
  • Tell who you are from the screen alone

How it differs between platforms: Android lists many refresh modes. iPhone shows 60 or 120 Hz, with ProMotion on Pro models since 2021.

On Android and iPhone

AndroidiPhone
StatusSupportedSupported
First versionAndroid 6.0 (API 23)iOS 10.3
Permission or entitlementNot listednone
Protection levelnonenone
How access is grantednonenone
What the user seesNot listedNot listed
How long it lastsNot listedNot listed
How to take it backNot listedNot listed
Store policyNone listedNone listed
APIDisplay.getRefreshRate(), getSupportedModes() (API 23), getHdrCapabilities() (API 24)60 or 120 Hz (ProMotion); ProMotion on Pro models since 2021
NotesRates 60, 90, 120, 144 HzNone

Data you get

What comes back: Refresh rate, HDR types
Shape: object
How often: Static or on mode change

FieldTypeUnitRangePrecision
refresh_hzfloatHz60 to 1440.1 Hz

Technical limits

  • Low entropy

The story

What it is

An app can see how fast your screen redraws and whether it supports HDR.

For you

You see smoother scrolling and games on a fast screen. The app also learns whether your phone has a 60, 90, 120 or 144 Hz display, which shows the phone tier.

For makers

Makers match animation speed to the screen and decide whether to offer HDR video. The mix of rate and HDR formats helps separate phone models for fingerprinting.

Where you see it

TypeExampleApps
gamesA racing game offers a 120 frames per second mode only on phones that can show it.None named
videoA streaming app plays HDR movies only if your screen supports the format.Netflix
creativeA drawing app matches pen lag to the screen speed so strokes feel instant.None named
socialA feed app speeds up scrolling animations on a 120 Hz display.None named
ar-vrAn AR app picks a target frame rate that matches the camera and screen.None named
adsAn ad firm uses refresh rate and HDR formats to tell similar phones apart.None named

Risks

  • Reveals phone tier
  • Adds to a fingerprint

Android and iPhone in short

  • Android: Reads the display modes and HDR list with no prompt.
  • iPhone: Reads the maximum frame rate and HDR support with no prompt.

What the platform says

  • Google: Frame rate on Android. Developer guide: let your app choose a frame rate that fits the display for smooth motion and better battery life.

Good uses and abuse

Legitimate uses

  • Smooth animation

Known abuse

  • Fingerprint

Scores

ScoreValueMeaning
Sensitivity1 of 5How revealing the data is
Utility2 of 5How useful it is to honest apps
Friction0 of 5How much the user has to do
Fingerprint bits2Rough identifying entropy, when known

History

  • 2015-10, Android 6.0 (API 23): Display modes list exposed

Same idea on the web

Sources

How well checked: Based on official documentation.

On this page