Skip to main content

Quak logo: a yellow duck with a camera lens for an eye

Quak

An open-source remote for the GoPro HERO11 Black: a command-line tool and an app for desktop and Android.

English · Português (Brasil) · Español · Français · Deutsch · Русский · 简体中文 · 日本語

Quak on desktop and phone, showing a live preview from a simulated camera

Quak talks to the camera over Bluetooth and the camera's own Wi-Fi, using GoPro's public Open GoPro API. No account and no cloud.

Status: early, and tested on one camera. It's built around one HERO11 Black (firmware 2.20). Other models get a warning and may not work. See what has been tested before you rely on it.

Try it without a camera

Quak includes a simulated camera that speaks the real protocol, so you can try everything first. You need Python 3.11 or newer.

pipx install 'quak-camera[gui]'               # or pip, in a virtual environment

quak --sim info                               # the command line
quak --sim schedule arm +2m --duration 15s
quak-gui --sim                                # the app (the first launch downloads about 45 MB)

Or download a ready-made app for Linux, Windows or Android from Releases. The install guide has the details for each system.

The quak command reading a simulated camera and arming a scheduled capture

What it does

  • Remote control: record, take photos, tag HiLights, change presets and every HERO11 setting.
  • Scheduled capture: arm the camera for a time and a length, with its clock synced first. It starts and stops by itself, even if you switch it off after arming.
  • Live preview over the camera's Wi-Fi. The camera can't stream while it records, so preview pauses until you stop.
  • Media: browse the card, download clips, and delete them, with a confirmation that names the file.
  • In your language: the app follows your system's language, or you can choose in More: English, Português (Brasil), Español, Français, Deutsch, Русский, 简体中文 or 日本語. The command line stays in English.
  • Livestream to an RTMP server such as YouTube or Twitch. This is experimental: see known issues.

The Cameras screen, showing battery, card space and clock An armed scheduled capture with a countdown Camera settings, with Pro-only settings greyed out and the reason shown

The desktop Media screen: a grid of clips and the details of the selected one

Screenshots come from the simulated camera, with a drawn scene instead of real footage.

Use it with your camera

Install it as above, plus what the install guide lists for your system. Then pair once. On the camera, open Preferences > Connections > Connect Device > GoPro Quik App, and leave that screen open while you run:

quak pair          # finds the camera on its pairing screen and remembers it
quak info
quak record --seconds 5
quak schedule arm +2m --duration 15s
quak media list

quak --help lists every command. In the app, use Add camera, which walks you through the same steps.

Android: download the APK from Releases. It needs Android 10 or newer.

Before you use it for real, read what Quak changes on your computer and camera. In short:

  • On a computer, viewing media or the preview moves a Wi-Fi adapter onto the camera's network for a while. Quak avoids the adapter you're online through, and asks first if it's the only one.
  • A scheduled capture changes the camera's Duration setting and leaves it changed, which also limits recordings you start by hand. Quak tells you when this happens.

Bluetooth carries controls and settings. The camera's own Wi-Fi carries preview and media. For a livestream, the camera joins your Wi-Fi.

What has been tested

Tested on one real HERO11 Black, with the end-to-end suites on Linux and by hand on one Android phone:

Feature Linux Android Windows
Pairing and reconnecting Tested Tested Not tested
Status, clock sync Tested Tested Not tested
Recording Tested Tested Not tested
HiLights, presets, settings Tested Not tested Not tested
Scheduled capture Tested Not tested Not tested
Live preview Tested Tested Not tested
Media: list, download, delete Tested Tested Not tested
Livestream Experimental Not tested Not tested

Windows is experimental. The Windows build compiles and its unit tests pass, but it has never been launched or used with a camera. Livestream worked end to end, then stopped working on the test camera for a reason that isn't known yet. docs/testing.md has the details.

Documentation

How it was built

Quak was built with heavy AI assistance. Claude wrote most of the code, tests, documentation and the logo, and ran the test suites on a real camera, directed by a person who also tried it on the camera and phone. The hardware claims above come from those tests, and from nothing else.

Licence and disclaimer

MIT: see LICENSE. The packaged apps include other software under its own licences, including LGPL libraries: see THIRD_PARTY_NOTICES.md.

Quak is an independent project, not affiliated with, endorsed by or sponsored by GoPro, Inc. GoPro, HERO and Quik are trademarks of GoPro, Inc. See NOTICE.

Metadata

Release files for quak-camera 0.2.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for quak-camera 0.2.0
File Size Uploaded Provenance Actions
quak_camera-0.2.0.tar.gz 1.1 MB With provenance Details for quak_camera-0.2.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for quak-camera 0.2.0
File Interpreter ABI Platform Actions
quak_camera-0.2.0-py3-none-any.whl Python 3 none any Details for quak_camera-0.2.0-py3-none-any.whl

Total release size: 2.2 MB

Release files / quak_camera-0.2.0.tar.gz

Download URL quak_camera-0.2.0.tar.gz
Size 1.1 MB
Tags Source
SHA-256 checksum
How to use checksums
ab54455f06ddfeec860d0999812a43bcc534a9d46876bc417217b41c3c1d96c9
BLAKE2b-256 checksum
How to use checksums
ff503e2548d972acb833fd3dbe1e545ca88d68cc830fad226905832452d46740
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 7, 2026.

Transparency log

Release files / quak_camera-0.2.0-py3-none-any.whl

Download URL quak_camera-0.2.0-py3-none-any.whl
Size 1.1 MB
Tags Python 3
SHA-256 checksum
How to use checksums
71b174d9c43ca5f39d6cc6f1ff7d531411107dc77aeb6a0bc3ab54c4bbc37ef3
BLAKE2b-256 checksum
How to use checksums
c9906b87315d47151476321798e6ac4790545a190fdb42521033734dd5f28bd7
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 7, 2026.

Transparency log

Security for quak-camera 0.2.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

Both files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for quak_camera-0.2.0.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 7, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

0.2.0 This release

2 release files Full provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page