**A complete Python GoPro module made easy.**
At the moment this module only works with the newest GoPro Hero 4.
Sadly the earlier versions of GoPro are not backwards/forwards compatible.
Easy install with Github or PyPi
Installing the **latest version from GitHub**.
$ git clone https://github.com/DenisCarriere/gopro.git
$ cd gopro
$ python setup.py install
Installing the **tested version from PyPi**.
$ sudo pip install gopro
Once the installation is complete you are ready to start! :)
The default `IP` address for the GoPro is using `10.5.5.9`.
You must first be connected to the GoProApp Wifi connection.
Launch your favorite `ipython` or standard `python`
>>> from gopro import GoPro
>>> camera = GoPro()
'storage': '31.3 GB',
## Take a Photo or Video
With very simple commands you can tell your GoPro to start recording or take a photo.
The screen will automaticly change to the approriate page.
## Camera modes
Makes it easy to cycle threw each available modes.
## Locate (Beep! Beep!)
Can't find your device?? Call the locate function and it will Beep endlessly until there is no more battery.
To turn off the beeps, simply press the `mode` button on the device or use the `off` as a parameter.
The camera will turn itself off, the Wi-Fi will still be active.
At the moment there is no working commands to turn the device back on.
To reactivate the device, press the `mode` button.
## Delete Photos
Might be useful to dump all those photos from your GoPro.
**Warning** once you delete photos/videos you cannot retrieve them back.
The `erase` function does the same as the delete all.
You can explore the different types of settings & status by getting the raw JSON response or selecting a specific pre-parsed attribute
### Processed attributes
**Status - Screen**
This will let you know which page your GP is currently active.
There are only 4 available outcomes.
### Raw JSON Responses
The original response from the GoPro device.
## Date & Time
It is a good idea to sync your GoPro with the same clock as your computer.
An easy way to do this is use the `datetime` & `time_offset` attribute.
Try to aim your GoPro to have less than 1 second offset.
The `time_offset` is measured in (+/-) seconds.
## File Storage
Here is how you can retrieve the total file storage in (KB) or pretty human readeable format.
Want to explore & troubleshoot the device a bit, you can retrieve the following properties from your device.
A big thanks to all the people who have helped contribute!
To be a contributor, please message me with requests on [Twitter](https://twitter.com/DenisCarriere)/[Github issues](https://github.com/DenisCarriere/gopro/issues)
- @[Denis Carriere](https://github.com/DenisCarriere)
- @[Konrad Iturbe](https://github.com/KonradIT)
- @[Jason Moiron](https://github.com/jmoiron)
The MIT License (MIT)
Copyright (c) 2014-2015 Denis Carriere
TODO: Brief introduction on what you do with files - including link to relevant help section.