Skip to content

Latest commit

 

History

History
719 lines (538 loc) · 24.2 KB

WifiCommands.md

File metadata and controls

719 lines (538 loc) · 24.2 KB

Wifi Commands for HERO4

Cameras covered: GoPro HERO4 Black, Silver (Firmware HD4.02.05.00.00 Oct 2016) and Session (Firmware April 2016)

Important notes:

  • The HERO2/3/3+ commands also work with HERO4 but its not recommended to use them!**
  • HERO4 do not need any password in the URL
  • These protune commands ARE FOR HERO4 BLACK/SILVER only!! For HERO4 Session Protune commands, use the HERO4 Session doc

Basic controls:

Shutter
Default Boot Mode:
Primary modes:
Secondary modes:
Tag moment:
Locate:
Power:
  • Power Off: http://10.5.5.9/gp/gpControl/command/system/sleep
  • Power On: To power ON a HERO4 Black/Silver camera, use WoL with these parameters: MAC ADDRESS OF THE CAMERA, 10.5.5.9 as IP ADDRESS, Subnet Mask 255.255.255.0, Port 9. For the Hero4 Session, this magic packet has to be sent when your project wants to operate with the camera.
Code Pairing:

GoPro HERO4 cameras need a code authentication in order to connect to a device for the first time, this is done in the GoPro app when you firt connect your GoPro, a 4 digit PIN is displayed on the camera and that PIN needs to be entered in the GoPro app. Video explaining HERO4 pairing process

First make sure to connect go GOPRO-BP-(numbers) password: "goprohero" and call this URL:

https://10.5.5.9/gpPair?c=start&pin=XXXX&mode=0

XXXX is the 4 digit PIN on the GoPro front screen.

And to finish pairing:

https://10.5.5.9/gpPair?c=finish&pin=XXXX&mode=0

Set GoPro WiFi name/password:

GOPRONAME = GoPro new WiFi name

GOPROPASS = GoPro new WiFi password

Capture Mode settings:

Video:

Resolutions (HERO4 Black):
Resolutions (HERO4 Silver):
Resolutions (HERO4 Session):
Frame Rate (HERO4 Black/Session):
Frame Rate (HERO4 Silver):
FOV
Low Light:
Video Looping Duration:
Video+Photo Interval:
Video Timelapse Interval:
Spot Meter:
ProTune:
White Balance:
Color:
ISO Limit:
ISO Mode/Lock:
Sharpness:
Manual Video Exposure:

EV compensation is enabled ONLY in Auto mode.

EV Steps:
Value URL
+2 http://10.5.5.9/gp/gpControl/setting/15/0
+1.5 http://10.5.5.9/gp/gpControl/setting/15/1
+1 http://10.5.5.9/gp/gpControl/setting/15/2
+0.5 http://10.5.5.9/gp/gpControl/setting/15/3
0 http://10.5.5.9/gp/gpControl/setting/15/4
-0.5 http://10.5.5.9/gp/gpControl/setting/15/5
-1 http://10.5.5.9/gp/gpControl/setting/15/6
-1.5 http://10.5.5.9/gp/gpControl/setting/15/7
-2 http://10.5.5.9/gp/gpControl/setting/15/8

Photo:

Photo resolution for Photo Modes (incl. SubModes):
Exposure time for NightPhoto:
Spot Meter:
Continuous photo rate:
ProTune:
White Balance:
Color:
ISO Limit:
ISO Min:
Sharpness:
EV Steps:
Value URL
+2 http://10.5.5.9/gp/gpControl/setting/26/0
+1.5 http://10.5.5.9/gp/gpControl/setting/26/1
+1 http://10.5.5.9/gp/gpControl/setting/26/2
+0.5 http://10.5.5.9/gp/gpControl/setting/26/3
0 http://10.5.5.9/gp/gpControl/setting/26/4
-0.5 http://10.5.5.9/gp/gpControl/setting/26/5
-1 http://10.5.5.9/gp/gpControl/setting/26/6
-1.5 http://10.5.5.9/gp/gpControl/setting/26/7
-2 http://10.5.5.9/gp/gpControl/setting/26/8

MultiShot:

Exposure time for NightLapse:
Interval for NightLapse
Photo resolution for MultiShot Modes (incl. SubModes):
Timelapse Interval (TIMELAPSE MODE on MultiShot):
Spot Meter:
Burst Rate:
ProTune:
White Balance:
Color:
ISO Limit:
ISO Min:
Sharpness:
EV Steps:
Value URL
+2 http://10.5.5.9/gp/gpControl/setting/39/0
+1.5 http://10.5.5.9/gp/gpControl/setting/39/1
+1 http://10.5.5.9/gp/gpControl/setting/39/2
+0.5 http://10.5.5.9/gp/gpControl/setting/39/3
0 http://10.5.5.9/gp/gpControl/setting/39/4
-0.5 http://10.5.5.9/gp/gpControl/setting/39/5
-1 http://10.5.5.9/gp/gpControl/setting/39/6
-1.5 http://10.5.5.9/gp/gpControl/setting/39/7
-2 http://10.5.5.9/gp/gpControl/setting/39/8

General Camera Settings:

Orientation:
Quick Capture:
LED Blink:
Beeps:
Video Format:
LCD Display:
On Screen Display:
LCD Brightness:
LCD Lock:
LCD Timeout sleep:
Auto Off:
Set date and time

The hex string at the end is the same as for HERO3, so in the example: 11 = (20)17, 0b = 11 (November), 10 = 16, 11 = 17, 29 = 41, 2c = 44. Example bash code for date string, see ztzhang/GoProWifiCommand#3.

Streaming tweaks:

Stream BitRate :

Supports any number ( like 7000000), but limited by wifi throughput, packet loss and video glitches may appear. Correct parameter ID is 62!

Stream Window Size:

Sizes with 720 height are tested on Hero 5 Black.

WiFi AP Settings:

Media Commands:

Delete file:

http://10.5.5.9/gp/gpControl/command/storage/delete?p=file (eg. /100GOPRO/G0010124.JPG)

Delete Last media taken:

http://10.5.5.9/gp/gpControl/command/storage/delete/last

Reformat SD Card (CAUTION!):

http://10.5.5.9/gp/gpControl/command/storage/delete/all

Tag moment in video file:

http://10.5.5.9/gp/gpControl/command/storage/tag_moment/playback?p=XXXGOPRO/XXXXXX.MP4&tag=Miliseconds

XXXGOPRO is the folder, XXXXXX.MP4 is the video and Miliseconds are the miliseconds offset from the start of the video.

For example:

http://10.5.5.9/gp/gpControl/command/storage/tag_moment/playback?p=103GOPRO/GOPR1359.MP4&tag=2000

will make a HiLight Tag on 2 seconds of the video GOPR1359.MP4

Extracting a clip from a video (GoPro Clips): (Works on HERO4)

To start a video conversion:

http://10.5.5.9/gp/gpControl/command/transcode/request?source=DCIM/[XXXGOPRO]/GOPRXXXX.MP4&res=VIDEO_RESOLUTION&fps_divisor=FPS&in_ms=In_MS&out_ms=Out_MS

Parameters:

  • VIDEO_RESOLUTION:
    • 1080 = 0
    • 960 = 1
    • 720 = 2
    • WVGA = 3
    • 640p = 4
    • 432x240 (live preview resolution) = 5
    • 320x240 = 6
  • FPS: (Divide FPS by)
    • 1/1 = 0 (Leave it as is)
    • 1/2 = 1
    • 1/3 = 2
    • 1/4 = 3
    • 1/8 = 4

Output:

{"status":{"id":STATUS_ID,"source":"DCIM\XXXGOPRO\GOPRXXXX.MP4","status":0,"failure_reason":0,"estimate":1,"completion":0,"output":""}}

If you did it right.

status values:

  • 0 = Started
  • 1 = In Progress
  • 2 = Finished
  • 3 = Cancelled
  • 4 = Conversion failed

failure_reason values:

  • 0 = No fail
  • 1 = Bad file
  • 2 = Bad parameters
  • 3 = No space left on the device
  • 4 = Camera is busy converting something else

To get the status of a conversion:

http://10.5.5.9/gp/gpControl/command/transcode/status?id=STATUS_ID (from the previous command)

Output:

{"status":{"id":STATUS_ID,"source":"DCIM\XXXGOPRO\GOPRXXXX.MP4","status":2,"failure_reason":0,"estimate":1,"completion":0,"output":"DCIM/XXXGOPRO/GOPRXXXX.MP4"}}

You can now download the output url, add http://10.5.5.9/videos/ to it.

To cancel a conversion:

http://10.5.5.9/gp/gpControl/command/transcode/cancel?id=STATUS_ID

Bluetooth Pairing:

Allows the camera to be paired to a GoPro Bluetooth metadata device

Returns (example):

{
  "list_id": 1,
  "total": 1,
  "index": 0,
  "index_count": 1,
  "device_array": [
    {
      "address": "device_address",
      "address_type": 0,
      "rssi": -92,
      "name": "",
      "profile_uuid16": [
        "9ffe"
      ]
    },
    ...
  ]
}

Returns:


{"pairing_status":0}