{"repo":"nichtlegacy/screentime","free":true,"listed":false,"github":"https://github.com/nichtlegacy/screentime","clone":"git clone https://github.com/nichtlegacy/screentime.git","description":"Export Apple Screen Time data from Mac and iOS devices to Home Assistant, InfluxDB & Grafana","language":"Python","stars":20,"topics":["apple","automation","grafana","home-assistant","influxdb","ios","iphone","macos","productivity","python"],"license":"MIT","category":"mobile-apps","readme_excerpt":"Apple Screen Time Exporter Own your screen time data. Collect, analyze, and visualize your Mac and iOS device usage — without Apple's restrictions. Quick Start • Features • Configuration • Dashboard • Troubleshooting --- Features - Mac Data — Reads directly from Apple's knowledgeC.db Screen Time database - iOS Data — Syncs iPhone and iPad via iCloud using aw-import-screentime - Multi-Device — Track multiple iPhones, iPads with custom names - Home Assistant — Creates sensors for dashboards and automations - InfluxDB + Grafana — Long-term storage with beautiful visualizations - Deduplication — Run as often as you want, no duplicate entries - Automation — Built-in launchd support for scheduled collection --- How It Works --- Quick Start Prerequisites - macOS Ventura, Sonoma, or Sequoia - Python 3.10+ - iOS devices synced via iCloud - Terminal with Full Disk Access Installation Grant Full Disk Access 1. Open System Settings → Privacy & Security → Full Disk Access 2. Add Terminal.app (from /Applications/Utilities/ ) 3. Restart Terminal Run Example Output --- Device Configuration Finding Device IDs Test each device to identify it: Single Device Multiple Devices Each device appears separately in the dashboard and Home Assistant. Full Configuration --- Home Assistant Integration Sensors are created dynamically based on your configured devices: Sensor Description -------- ------------- sensor.screentime total Total screen time today (minutes) sensor.screentime Per-device usage (e.g., ","default_branch":null,"files":null,"tree":[],"storefront":"/r/nichtlegacy","claimed":false,"request_supported":{"post":"https://gitbuyer.com/r/nichtlegacy/screentime/request-supported","requests":0},"note":"indexed from public GitHub; nothing is for sale on this page. Clone it from GitHub. Paid listings live at /search."}