GitHunt
FE

FelixKohlhas/ScreenFlux

A script that imports Screen Time data into InfluxDB

ScreenFlux

Import Screen Time data into InfluxDB

Requirements for reading iOS Screen Time

  • MacOS device signed into the same iCloud account
  • Screen Time "Share across devices" enabled

More info in my blog post Exporting and analyzing iOS Screen Time usage

Installing

Clone repository and install requirements

git clone https://github.com/FelixKohlhas/ScreenFlux
cd ScreenFlux
pip3 install -r requirements.txt

Usage

Configuring

Configure

db_url = "..."
db_token = "..."
db_org = "..."
db_bucket = "screentime"

in screenflux.py

Running

Run using

python3 screenflux.py

Languages

Python100.0%

Contributors

Created June 6, 2023
Updated December 20, 2025