Welcome to the Open GoPro API documentation!

This document describes the format, capabilities, and use of Bluetooth Low Energy (BLE) as it pertains to communicating with GoPro cameras via the Open GoPro API.

Supported Cameras

Below is a table of cameras that support GoPro’s public BLE API, sorted by release date.

Open GoPro API Supported Cameras

Model ID	Model Code	Marketing Name	Firmware Download Link	Serial Prefix	Release Date
65	H24.01	HERO13 Black	https://gopro.com/en/us/update/hero13-black	C353	2024-09-10
62	H23.01	HERO12 Black	https://gopro.com/en/us/update/hero12-black	C350	2023-09-13
60	H22.03	HERO11 Black Mini	https://gopro.com/en/us/update/hero11-black-mini	C349	2022-11-18
58	H22.01	HERO11 Black	https://gopro.com/en/us/update/hero11-black	C347	2022-09-14
57	H21.01	HERO10 Black	https://gopro.com/en/us/update/hero10-black	C346	2021-09-16
55	HD9.01	HERO9 Black	https://gopro.com/en/us/update/hero9-black	C344	2020-09-16

Warning

The documentation assumes that the GoPro is always updated to the most recent version. This is relevant in cases where functionality changes between versions.

Getting Started

First, read through the protocol section to understand how to send and receive BLE messages via the Open GoPro protocol:

• Protocol
  • BLE Setup
  • Data Protocol
  • State Management
  • ID Tables
  • Protobuf Documentation

Then see any of the subsequent feature sections to perform desired functionality:

• Control
• Query
• Access Point
• Live Streaming
• Camera on the Home Network
• Hilights
• Presets
• Settings
• Statuses

Tip

Additionally, there are walk-through tutorials available to demonstrate basic BLE functionality as well as complete demos in various programming languages.

Limitations

General

• The camera will reject requests to change settings while encoding; for example, if Hindsight feature is active, the user can not change settings

• Querying the value for a setting that is not associated with the current preset/core mode results in an undefined value. For example, the user should not try to query the current Photo Digital Lenses (FOV) value while in a video-based Preset.