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

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

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

## What it is and what it does

This package wraps Apple's GameController framework for use in Python, allowing developers to detect, enumerate, and read input from game controllers connected to macOS. It sits atop PyObjC's bridge layer and requires understanding of both the underlying Objective-C framework and PyObjC's translation conventions.

The package is actively maintained and supports Python 3.10 through 3.15, with wheels built for multiple architectures. It has no known security vulnerabilities and carries a permissive MIT license. Installation requires macOS and the compiled dependencies pyobjc-core and pyobjc-framework-Cocoa; the package itself does not include documentation beyond references to Apple's official GameController documentation.

Use it for:

- Build a macOS game or interactive application that reads input from connected game controllers
- Detect and enumerate available game controllers on a macOS system programmatically
- Monitor controller connection and disconnection events in a macOS application
- Access raw input data from game controllers in Python on macOS

## Worth the install?

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

Provides Python bindings to macOS's GameController framework, enabling access to game controller input and device management on macOS.

Yes, if you are developing on macOS and need programmatic access to game controller input. The package is actively maintained, carries no security issues, and has a permissive license. Install friction is moderate due to platform specificity and compiled dependencies, but that is inherent to the task. Not applicable on non-macOS platforms.

## Install

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

## Installing pyobjc-framework-GameController

Before you install: Medium install friction due to platform-specific wheels and compiled dependencies. Actively maintained with release 3 days ago and no known vulnerabilities.

License in practice: MIT license permits commercial and private use with minimal restrictions; suitable for most projects without licensing concerns.

Quickstart:

pip install pyobjc-framework-gamecontroller
import GameController

macOS 10.9 or later required; also requires pyobjc-core and pyobjc-framework-Cocoa as runtime dependencies.

Verify before relying:

- Whether the GameController framework supports all modern macOS game controllers and input devices
- Performance characteristics when polling multiple controllers simultaneously
- Compatibility with third-party controller manufacturers beyond Apple's ecosystem

## Package facts

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

## Tags

macos game controller input, gamepad joystick python macos, pyobjc gamecontroller bindings, macos controller device access, python gamepad support macos, macos-only, game-input, pyobjc-bridge

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