/goprowifihack

Unofficial GoPro WiFi API Documentation - HTTP GET requests for commands, status, livestreaming and media query.

Apache License 2.0Apache-2.0

GoPro Wifi Hack

The unofficial API for GoPro cameras (The WiFi enabled models)

This repository won't be updated regularly, and users are encouraged to switch to OpenGoPro

Read why

Choose the GoPro:

A note on HERO8: For GoPro Connect (Webcam Mode), use Hero9 commands; For other commands, use Hero7 commands.


This is a community effort to document the API calls between GoPro cameras and GoPro's Smartphone App via WiFi. It has 4 sections for each camera model:

  • WiFi commands: a list of WiFi commands you can use for the camera.
  • Livestreaming: methods of getting a live video feed off the camera.
  • Media Browsing: Instructions on getting media off the SD card via wifi.
  • Camera Status: List of camera status meanings

Note: HERO4 camera is now the base for the future API, since the calls will be the same for HERO4 and above.

Does GoPro offer an official API, SDK or mobile library?

They did offer a mobile library - but they shut it down. This repository will continue to be updated until GoPro stops releasing cameras and ceases operations.

But... Now they offer BLE/WiFi API documentation, tutorials and examples over at OpenGoPro.

This vs OpenGoPro

This is an effort to document the mobile app APIs used by GoPro, internally called gpControl APIs or Smarty APIs. OpenGoPro V2 supports all commands over WiFi and USB, making this effort largely useless these days. Fortunately they've kept the BLE part 100% identical to what we documented over here.

This repository will just be updated to cover the gpControl APIs, if they change at all between future cameras, which might reveal new features and/or support endpoints not covered by OpenGoPro. Users are encouraged to switch to the OpenGoPro spec.

OpenGoPro supports Hero9 Black, Hero10 and Hero11 (at least officially - their BLE commands are compatible with older BLE-enabled cams given the proper characteristic). This repository covers nearly a decade of GoPro camera releases.

This repository will get updates only if the gpControl API is kept available, if the GoPro App ceases to use gpControl and switches to OpenGoPro, what's the point?

Libraries:

3rd Party Library/API wrappers list

Bluetooth:

Bluetooth is used to turn camera on after WiFi AP is disabled in deep sleep, as well as for turning on/off wifi.

But on Hero9, it's used for status retrieval, all commands and changing settings, turning on,

Acknowledgements/credits

  • Konrad Iturbe - main developer
  • dough29 - HERO2 research
  • EvilWombat - general and HERO3
  • 3v1n0 - HERO4 research
  • Maelstrom Napalm - HERO4 research
  • fraannk - HERO4 research
  • Sonof8Bits - Python script
  • krystof-k - Bluetooth API and wake up commands
  • Mark Kirschenbaum - Bluetooth commands info
  • GitHub contributors
  • and finally GoPro for allowing us to tinker with their cameras and not shutting down this unofficial API like instagram or snapchat, that means a lot.