GoPro SDK for Python

A production-ready Python SDK for controlling GoPro cameras, specifically designed and optimized for multi-camera COHN (Camera on Home Network) scenarios.

Features

• Multi-Camera Support: Efficient concurrent control of multiple GoPro cameras
• Persistent COHN Configuration: Save and restore COHN settings without reconfiguration
• Optimized Connection Management: Eliminate unnecessary connection cycles and resource waste
• Robust State Tracking: Accurate connection state management for COHN mode
• Production-Ready Error Handling: Comprehensive exception handling and recovery mechanisms

See Why This SDK? for detailed rationale and comparison with OpenGoPro.

Quick Start

uv add gopro-sdk-py
# Or use pip
pip install gopro-sdk-py

import asyncio
from gopro_sdk import GoProClient

async def main():
    client = GoProClient(identifier="GoPro 1234")
    await client.open_ble()
    await client.configure_cohn(ssid="your-wifi", password="password")
    await client.set_shutter(on=True)
    await client.close()

asyncio.run(main())

Documentation

📖 Full Documentation

• Quick Start Guide - Installation and basic usage
• API Reference - Complete API documentation
• Development Guide - Setup, testing, and contribution guidelines

Contributing

Contributions are welcome! Please check out our documentation for development setup and guidelines.

License

This project is licensed under the MIT License - see the LICENSE file for details.

Support

• GitHub Issues - Bug reports and feature requests
• GitHub Discussions - Questions and community discussion

Related Projects

• OpenGoPro - Official GoPro Open SDK and protocol specifications
• OpenGoPro Python SDK - Official Python implementation

Note: This SDK builds upon OpenGoPro's protocol specifications and reuses its protobuf definitions, BLE UUIDs, and command constants. We acknowledge and appreciate GoPro's excellent work in documenting and open-sourcing the camera control protocol.