---
id: pyobjc-framework-screentime
version: "12.2.2"
license: MIT
license_treatment: permissive
maintenance: active
---

# pyobjc-framework-ScreenTime — Wrappers for the framework ScreenTime on macOS

License: permissive · Maintenance: active · Downloads: 647.9K/mo

## What it is and what it does

pyobjc-framework-screentime is a thin Python wrapper around Apple's native ScreenTime framework on macOS. It uses PyObjC to bridge Objective-C classes and methods, making them callable from Python code. The package does not provide its own documentation; instead, it directs users to Apple's official ScreenTime framework documentation and PyObjC's general translation guides.

This is a framework binding package, not a high-level utility library. It is intended for developers who need direct programmatic access to macOS ScreenTime features—such as querying screen time data or managing parental controls—and who are comfortable reading Apple's native documentation and translating Objective-C patterns to Python via PyObjC conventions.

Use it for:

- Query screen time statistics for applications and categories on a macOS device.
- Build parental control or device monitoring tools that integrate with macOS ScreenTime.
- Automate screen time reporting or analytics collection on macOS systems.
- Develop macOS system utilities that need to access or respond to screen time events.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Provides Python bindings to Apple's ScreenTime framework on macOS, allowing programmatic access to screen time data and parental control settings.

Yes, if you are developing on macOS and need programmatic access to the ScreenTime framework. The package is actively maintained, has no known vulnerabilities, and carries a permissive license. Install only if you have a specific need for ScreenTime integration; it is a low-level binding and requires familiarity with both Apple's framework documentation and PyObjC's translation model.

## Install

pip install pyobjc-framework-screentime
uv add pyobjc-framework-screentime
poetry add pyobjc-framework-screentime

## Installing pyobjc-framework-ScreenTime

Before you install: Low friction installation with a pure-Python wheel. Actively maintained with a release 3 days old. Requires pyobjc-core and pyobjc-framework-Cocoa as runtime dependencies.

License in practice: MIT license permits unrestricted use, modification, and distribution with minimal restrictions—suitable for both open-source and commercial projects.

Quickstart:

pip install pyobjc-framework-screentime

from ScreenTime import STScreenTimeConfiguration
# Access ScreenTime framework classes via PyObjC bindings

macOS only; requires Python 3.10 or later and a macOS system with the ScreenTime framework available.

Verify before relying:

- Whether the ScreenTime framework is available on all supported macOS versions or only recent releases.
- Whether parental control or user permission requirements apply when accessing ScreenTime data programmatically.

## Package facts

- License: MIT (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 647.9K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

macos screentime api python, screen time framework bindings, pyobjc screentime wrapper, parental controls programmatic access, macos app usage monitoring, screentime data python, macos-only, framework-binding, pyobjc

[View on SkillFed](https://skillfed.io/packages/pyobjc-framework-screentime) · [View on PyPI](https://pypi.org/project/pyobjc-framework-screentime/)