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

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

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

## What it is and what it does

This package wraps the native macOS ScreenSaver framework, making it accessible from Python code. It allows developers to write custom screensaver modules that integrate directly with macOS's screensaver system, rather than building screensavers from scratch using lower-level APIs.

The package is part of the larger PyObjC project and provides thin bindings to the underlying Objective-C framework. It has no built-in documentation of its own; users must consult Apple's official ScreenSaver framework documentation and PyObjC's general documentation to understand how to translate Objective-C patterns into Python code. The package depends on pyobjc-core and pyobjc-framework-Cocoa, and is actively maintained with support for Python 3.10 through 3.15.

Use it for:

- Build a custom macOS screensaver that displays live data, animations, or system information.
- Create a branded screensaver for distribution to macOS users as part of a larger application.
- Prototype screensaver behavior in Python before porting to native Objective-C if performance requires it.
- Integrate Python-based graphics or logic into a screensaver that runs in the macOS screensaver system.

## Worth the install?

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

Provides Python bindings to macOS's ScreenSaver framework, enabling you to write custom screensaver modules in Python that integrate with the native macOS screensaver system.

Yes, if you are developing a custom screensaver for macOS and prefer to work in Python. The package is actively maintained, has no known vulnerabilities, and carries a permissive license. Install friction is moderate due to platform specificity and native compilation, but this is unavoidable for macOS framework bindings. Not applicable for non-macOS development.

## Install

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

## Installing pyobjc-framework-ScreenSaver

Before you install: Medium install friction due to platform-specific wheels (macOS only, multiple Python versions). Actively maintained with recent releases; depends on pyobjc-core and pyobjc-framework-Cocoa, which are standard PyObjC dependencies.

License in practice: MIT license is permissive; you can use, modify, and distribute this package with minimal restrictions, making it suitable for both open-source and proprietary projects.

Quickstart:

pip install pyobjc-framework-screensaver

from ScreenSaver import ScreenSaverView
# Subclass ScreenSaverView to create your custom screensaver

macOS only; requires Python 3.10 or later; requires a macOS development environment with Xcode command-line tools to compile native extensions.

Verify before relying:

- Whether the package includes example screensaver implementations or only raw framework bindings.
- Whether additional setup steps (e.g., code signing, system preferences configuration) are needed to deploy a screensaver built with this package.

## Package facts

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

## Tags

macos screensaver python, pyobjc screensaver framework, custom screensaver development, macos native screensaver bindings, python screensaver module, objective-c screensaver wrapper, macos-only, screensaver, pyobjc

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