Captura

Bring your own backend screen recorder

Bring Your Own Backend (Protocol version 1.0)

Captura allows you to define a URL that will be used to POST the recording.

The Request

A POST will be made to the request, with the payload containing the binary contents of the file. You can expect the following headers:

User-Agent: Captura/1.0
Content-Type: video/mp4 or image/gif, depending on the output format selected.

Authentication / Authorization

We will only do a POST request, so if you need any type of keys or user identifiers, include them in the URL itself (eg. via path elements or in the query parameters)

Expected Response

If the upload is successful, the response MUST be a JSON object containing a key called url with a value of type string corresponding to the URL where the file is available. The status code MUST be 201 Created.

Any response code other than 201 Created will be treated as an error. Captura will not re-attempt an upload.

Building

For development, build the app using xcode. For release, a makefile is provided with commands to archive and package. If you just want the built and signed app you can use make archive. To generate the whole package use make distribute

Signing

There's no automated handling of signing. For the app to be signed correctly, update the signing configuration in the xcode project.