API
First create a camera instance:
camera = GoProHero([ip, password, loglevel])
- initialize a camera object
Then, the follow methods are available on the camera instance:
password(password)
- get or set the password of a camera objectcommand(param, value)
- send one of the supported commandsstatus()
- get status packets and translate themimage()
- get an image and return it as a base64-encoded PNG stringtest(url)
- a simple testing interface to try out HTTP requests
The following class methods are also available:
@classmethod config()
- returns a dictionary with the current configuration
Commands
These commands are used for both camera.command()
and the goproctl
command line interface.
Parameter | Values |
---|---|
power | sleep , on |
record | off , on |
preview | off , on |
orientation | up , down |
mode | video , still , burst , timelapse , timer , hdmi |
volume | 0 , 70 , 100 |
locate | off , on |
picres | 5MP wide , 5MP med , 7MP med , 7MP wide , 8MP med , 11MP wide , 12MP wide |
vidres | WVGA , 720p , 960p , 1080p , 1440p , 2.7K , 2.7K 17:9 Cinema , 4K , 4K 17:9 Cinema , 1080p SuperView , 720p SuperView |
fov | 170 , 127 , 90 |
fps | 12 , 12.5 , 15 , 24 , 25 , 30 , 48 , 50 , 60 , 100 , 120 , 240 |
looping | off , 5 minutes , 20 minutes , 60 minutes , 120 minutes , max |
protune | off , on |
delete_last | n/a |
delete_all | n/a |
Status
The following status parameters are interpreted from the GoPro status endpoints: power
, batt1
, batt2
, mode
, defaultmode
, spotmeter
, autooff
, fov
, picres
, minselapsed
, secselapsed
, orientation
, charging
, picsremaining
, npics
, minsremaining
, nvids
, record
, vidres
, fps
, lowlight
, looping
, attachment
, name
, model
, and firmware
. View the source file for a complete list of possible values for each status parameter.