gopro / OpenGoPro

An open source interface specification to communicate with a GoPro camera with accompanying demos and tutorials.
https://gopro.github.io/OpenGoPro/
MIT License
717 stars 155 forks source link

Open GoPro Developer README

Current Version: 2.0

GoPro Logo

This README is only for a developer who wants to modify or contribute to this repo. If you are a user (i.e. you don't want to make changes to this repo), see the Open GoPro Github Pages site for specs and getting started with Open GoPro.

If you are just looking for demos, you can browse the demos folder here.

If you are looking for the Python SDK, see its documentation.

Overview

This repo consists of the following types of content:

Demos

Demos are runnable examples in various languages / frameworks and can be found in the demos folder. Demos exist, from their own perspective, independent to the Jekyll-based documentation described below. To create a demo, follow the "Contributing" section of the README in the demos folder.

Capabilities

These are various specifications to describe specific camera / firmware version capabilities. For more information, see the BLE or HTTP spec.

Tools

These are utilities to perform various functionality needed by demos or tutorials. See the README of each tool directory for more information.

Copyright

All relevant source files shall contain a copyright. This is managed via the "Pre Merge Checks" Github Action. When a pull request is opened (or updated), this action will search for any missing / incorrect copyrights, add / fix them, and update the branch. If for some reason this needs to be done manually, it can be done via:

make copyright

A file can be excluded from this process by adding the following in a comment on the first line:

No (C) Copyright