Awesome Open Source
Awesome Open Source

GoPro Wifi Hack

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

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 is somewhat limited in what endpoints are available over WiFi. Fortunately they've kept the BLE part 100% identical to what we documented over here.

OpenGoPro only supports the Hero9 Black (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.
Related Awesome Lists
Top Programming Languages
Top Projects

Get A Weekly Email With Trending Projects For These Topics
No Spam. Unsubscribe easily at any time.
Camera (16,886
Wifi (8,742
Hack (6,387
Unofficial (5,778
Hero (3,258
Apidoc (2,317
Gopro (331
Hero4 (5
Gopro Cameras (4
Hero3 (3
Hobbyists (3