Skip to content


Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time
June 17, 2017 16:22
November 17, 2019 12:11
July 28, 2018 12:31
December 19, 2022 12:50
December 19, 2022 12:50
March 23, 2017 18:30
September 21, 2020 22:17
March 15, 2021 16:50
September 23, 2018 20:08
August 31, 2020 01:05
November 17, 2019 12:11
November 17, 2019 12:11
April 18, 2016 16:28
February 14, 2021 18:51
December 19, 2022 12:50

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?


3rd Party Library/API wrappers list


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,


  • 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.


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




Code of conduct





No releases published


No packages published