An http API to control multiple GoPro cameras over wifi.
This program can be used to control multiple GoPro cameras via the goprohero Python library. When ran from a Linux machine with compatible wireless card, this program is capable of automatically negotiating between the different ad-hoc wireless networks that each cameras makes.
A user interface is available for this API as a standalone package. See GoProControllerUI.
The backbone of GoProApp is a program called GoProProxy that runs asynchronously to the server. This proxy periodically grabs the status of every camera in the database and sends commands to cameras when appropriate. The proxy uses wifi to jump between networks and goprohero to handle the communication to the cameras. A Django app is used to persist data from the proxy and serve API endpoints.
Note: The xml version of the above diagram can be modified with https://www.draw.io/.
First, download the code:
git clone https://github.com/joshvillbrandt/GoProController.git ~/GoProController
sudo ln -s ~/GoProController /home/GoProControllerIf you are running Ubuntu, use the setup.sh script to automatically set up the application in a production mode:
sudo /home/GoProController/setup.shUpon completion of setup.sh, you should now be able to navigate to http://localhost/ and see the API. In addition, the GoProApp/proxy.py file is also now running continuously to the local wifi adapter and communicate with the cameras.
You can interact with the server and proxy using service and initctl:
sudo service apache2 status
sudo initctl status gopro-proxyLogs for both are also available:
tail /var/log/apache2/error.log
tail -f /var/log/gopro-proxy.logTo set a specific interface for wifi control, add the following to upstart.conf:
env GOPRO_WIFI_INTERFACE=wlan1
To run GoProApp without Apache and Upstart, launch the site with the Django development server:
git clone https://github.com/joshvillbrandt/GoProController.git ~/GoProController
cd ~/GoProController
sudo python setup.py install
python manage.py runserver 0.0.0.0:8000In another terminal window, launch the proxy to communicate with the cameras:
sudo python ~/GoProController/proxy.py # sudo needed for logging (or add yourself to syslog in Ubuntu)You should now be able to navigate to http://localhost:8000/ and see the API.
To set a specific interface for wifi control, add the following environment variable before the proxy command:
sudo GOPRO_WIFI_INTERFACE='wlan1' python ~/GoProController/proxy.pyThis API provides the following endpoints:
| Endpoint | Actions |
|---|---|
/cameras |
GET, POST |
/cameras/:id |
GET, PUT |
/commands |
GET, POST |
/commands/:id |
GET, PUT |
The API if build on the Django REST Framework. Please reference their documentation for detailed querying information.
This project uses semantic versioning.
- Added
GOPRO_SNAPSHOTSenvironment flag to turn off grabbing snapshots images if desired - The proxy now fails commands when it can't find the camera instead of leaving them in the queue to block everybody else
- Added spammer.py - try
sudo goprospammer -p record -v on - Added logger.py - try
goprologger -d output
- Updated
goproheroandwirelesslibrary versions
- Pagination is now supported; try
?page=1&limit=20 - Basic sorting/ordering is now supported; try
?ordering=-date_added - Fixed a schema bug that prevented commands without values from being saved (commands like
delete_allanddelete_last)
- Updated for library change from
goprotogoprohero - Fixed bugs in
setup.sh - Moved API root to
/apiwhen using the Apache config - Added the
/api/configendpoint - Added support to serve GoProControllerUI static content at
/
- Renamed project from
GoProApptoGoProController - Refactored user interface out of the project and into GoProControllerUI
- Now contains a RESTful API for cameras and commands
- Bug fixes
- Initial release
There is a memory leak that will cause the program to crash after a couple hours of use with two or more cameras. (It will crash quicker with just one camera since the program runs quicker without network hops.) I've spent a few hours trying to track down the issue to no avail. It seems as though there are uncollectable objects from both the Django side and the GoPro/urllib2 side. I tried replacing urllib2 with python-requests/urllib3, but that didn't help. I used gc and objgraph to help debug.
Pull requests to the develop branch are welcomed!
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent