GoPro Control Arduino

This is a library to interface with GoPro cameras over WiFi, just press a button and turn on your GoPro action camera using an Arduino!

Have you ever thought about the possibility to control your action camera with your Arduino? Well if you are here because you googled that you may be interested in watching this video

Supported actions

take a picture
start and stop a video
change the mode (photo, video, etc)
delete last file or format the SD
turn the camera on/off
change the field of view (FOV)
change frame rate
change photo and video resolution
turn the localization on/off
change the orientation
more?

Supported boards:

ESP32
ESP8266
MKR1000
MKR WiFi 1010
MKR VIDOR 4000
UNO WiFi Rev.2
any arduino boards (UNO, nano, 101, etc.) attached to an ESP8266 (ESP01) using AT commands with this library

Supported cameras:

HERO3
HERO4
HERO5
HERO6
HERO7
FUSION

I made the library with a style which would be quite easy to add other cameras (not only GoPro). I would be very happy to accept pull requests 😃

Installation

Arduino IDE:
- Go to Tools > Manage libraries
- Search for GoProControl
PlatformIO:
- From command line: run pio lib install "GoProControl"
- Or if you prefer a GUI from Platformio IDE
Manually:
- cd $HOME/Arduino/libraries (see Arduino library paths for other operating systems)
- git clone https://github.com/aster94/GoProControl.git
- Restart Arduino IDE

Examples

Important: Rename the Constants.h.example to Constants.h and change the SSID, Password and camera model. If you have a GoPro HERO4 or newer you should add also the mac address (in a future release this would be done automatically).

Supported Options

Mode	HERO3	HERO4,5,6,7
VIDEO_MODE	✔	✔
PHOTO_MODE	✔	✔
BURST_MODE	✔	✔
TIMELAPSE_MODE	✔	✔
TIMER_MODE	✔	✔
PLAY_HDMI_MODE	✔	✔
MULTISHOT_MODE		✔

Orientation	HERO3	HERO4,5,6,7
ORIENTATION_UP	✔	✔
ORIENTATION_DOWN	✔	✔
ORIENTATION_AUTO		✔

Video Resolution	HERO3	HERO4,5,6,7
VR_4K		✔
VR_2K		✔
VR_2K_SuperView		✔
VR_1440p		✔
VR_1080p_SuperView		✔
VR_1080p	✔	✔
VR_960p	✔	✔
VR_720p_SuperView		✔
VR_720p	✔	✔
VR_WVGA	✔	✔

Field Of View	HERO3	HERO4,5,6,7
WIDE_FOV	✔	✔
MEDIUM_FOV	✔	✔
NARROW_FOV	✔	✔
LINEAR_FOV		✔

Frame Rate	HERO3	HERO4,5,6,7
FR_240	✔	✔
FR_120	✔	✔
FR_100	✔	✔
FR_90		✔
FR_80		✔
FR_60	✔	✔
FR_50	✔	✔
FR_48	✔	✔
FR_30	✔	✔
FR_25	✔	✔
FR_24	✔
FR_15	✔
FR_12p5	✔
FR_12	✔

Video Encoding	HERO3	HERO4,5,6,7
NTSC	✔	✔
PAL	✔	✔

Photo Resolution	HERO3	HERO4,5,6,7
PR_12MP_WIDE		✔
PR_12MP_MEDIUM		✔
PR_12MP_NARROW		✔
PR_12MP_LINEAR		✔
PR_11MP_WIDE	✔	✔
PR_8MP_WIDE	✔	✔
PR_8MP_MEDIUM		✔
PR_7MP_WIDE		✔
PR_7MP_MEDIUM		✔
PR_5MP_WIDE	✔	✔
PR_5MP_MEDIUM		✔

Time Lapse	HERO3	HERO4,5,6,7
60	✔	✔
30	✔	✔
10	✔	✔
5	✔	✔
1	✔	✔
0.5	✔	✔

Continuous Shot	HERO3	HERO4,5,6,7
10	✔
5	✔
3	✔
0	✔

NOTE: Not all the options are available for all the cameras (for example on a HERO3 you can't set 1080p at 240 frame per second 😲). You can see the possibilities on the manual of your camera of here for HERO3 and here for HERO4 and newer

To Do list and known issues

Missing get status which gives info like mode (photo, video), fow and so on: see here
Wait for the ESP32 core to make a stable BLE core, right now it has many issues, especially, if used together with wifi: see here
No confirm pairing for HERO4: see here
Missing some modes for HERO4 and newer camera: see here
The arduino class String() could cause memory leaks (I never had problem yet), move to char array? 🤔
BSSID() and macAddress() not perfectly compatible with arduino API: see here
make gopro_mac_address field optional

Reference

All the commands came from: https://github.com/KonradIT/goprowifihack

The idea of making a GoPro library for arduino comes from another library https://github.com/agdl/GoPRO which works only on arduino WiFi boards and only with GoPro HERO3.

RobsyRocket/GoProControl