Skip to Content
Platform.Ontology

Screen brightness

Reads the screen brightness setting with no prompt.

Gets silentlyDevice detailsDisplayAndroid and iPhoneWhen the app opensWhile you use it

In one line

Can check your screen brightness with no prompt, and change it while the app is open

Reads the screen brightness setting with no prompt.

Reveals indoor or outdoor use and whether the person left auto-brightness. Mostly a context hint.

What it can and can't do

What the user does: Nothing to check it. You tap a feature like Full brightness for a ticket or code

It can

  • See your brightness level, from 0 to 255 on Android
  • See if brightness is set to automatic on Android
  • Change brightness for its own screen on iPhone while the app is open
  • Change brightness system wide on Android, if you allow Modify system settings

It cannot

  • Change Android system brightness without the special Modify system settings switch
  • Keep a changed brightness on iPhone after you leave the app; it goes back
  • See the light level in the room on iPhone; no public sensor reading exists

How it differs between platforms: Android needs a special settings switch to change brightness for everything. On iPhone a change reverts when the app closes.

On Android and iPhone

AndroidiPhone
StatusSupportedSupported
First versionAndroid 1.0 (API 1)iOS 2.0
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
APISettings.System.SCREEN_BRIGHTNESS (0 to 255), SCREEN_BRIGHTNESS_MODERead and write; writes revert at app exit, no ambient lux API
NotesReadable with no permission; writing needs WRITE_SETTINGSNone

Data you get

What comes back: Brightness value
Shape: float
How often: On poll

FieldTypeUnitRangePrecision
android_brightnessintegerlevel0 to 2551 step
ios_brightnessfloatfraction0.0 to 1.0about 1 percent

Technical limits

  • iOS apps cannot read the ambient light sensor, only brightness

The story

What it is

An app can read how bright your screen is set.

For you

You never see this check. A brightness reading can hint at whether you are outside in the sun, in bed at night or in a dark room.

For makers

Makers use it to adapt colors, show dark mode hints and boost readability. It is a small context signal, rarely used alone for tracking.

Where you see it

TypeExampleApps
mediaA video app switches to dark theme when brightness is very low at night.None named
fitnessA running app boosts text contrast when brightness is high outdoors.None named
creativeA photo editor warns that colors may look wrong because the screen is very dim.None named
ar-vrAn AR game raises its overlay contrast in bright sun so you can still see targets.None named
accessibilityA reading app suggests larger text when brightness is low.None named
adsAn ad firm adds brightness to a list of device details for time and place guesses.None named

Risks

  • Hints at where you are
  • Minor privacy impact

Android and iPhone in short

  • Android: Read as a system setting with no prompt.
  • iPhone: Read through UIScreen brightness with no prompt.

Good uses and abuse

Legitimate uses

  • Adapt UI

Known abuse

  • Little

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 bits1Rough identifying entropy, when known

History

  • 2008-09, Android 1.0 (API 1): SCREEN_BRIGHTNESS readable

Same idea on the web

Sources

How well checked: Based on official documentation.

On this page