# extract-goprodata

> A command line utility to extract the meta data from a GoPro video.

Latest version **1.0.13** (published 2022-12-07) · ISC license · 0 weekly downloads

## Install

```sh
npm install extract-goprodata
pnpm add extract-goprodata
yarn add extract-goprodata
bun add extract-goprodata
```

Provides the command `extract-goprodata`.

## Health

**Score 15/100 (F)** — status: abandoned.

Positive: no vulnerabilities.

Warnings: low downloads; no types; no esm support.

Negative: abandoned; low maintenance score.

## Facts

| | |
|---|---|
| Version | 1.0.13 |
| Published | 2022-12-07 |
| First published | 2022-04-22 |
| Weekly downloads | 0 |
| License | ISC |
| TypeScript types | none |
| Module format | CommonJS |
| Dependencies | 4 |
| Unpacked size | 7.8 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 0 |
| Author | Joshua Amsler |
| Maintainers | joshyour |

## Links

- npm: https://www.npmjs.com/package/extract-goprodata
- Repository: https://github.com/JoshYouR/extract-goprodata
- Homepage: https://github.com/JoshYouR/extract-goprodata#readme
- Issues: https://github.com/JoshYouR/extract-goprodata/issues
- npm.io page: https://npm.io/package/extract-goprodata

## Dependencies (4)

- [yargs](https://npm.io/package/yargs.md) ^17.6.2
- [fluent-ffmpeg](https://npm.io/package/fluent-ffmpeg.md) ^2.1.2
- [gopro-telemetry](https://npm.io/package/gopro-telemetry.md) ^1.1.41
- [@joshyour/ffprobe-client](https://npm.io/package/@joshyour/ffprobe-client.md) ^1.1.7

## Recent versions

- 1.0.13 (latest) — 2022-12-07
- 1.0.12 — 2022-12-07
- 1.0.11 — 2022-10-03
- 1.0.10 — 2022-10-03
- 1.0.9 — 2022-10-03
- 1.0.8 — 2022-10-02
- 1.0.7 — 2022-10-02
- 1.0.6 — 2022-10-02
- 1.0.5 — 2022-10-02
- 1.0.4 — 2022-07-28
- 1.0.3 — 2022-07-04
- 1.0.1 — 2022-05-02
- 1.0.0 — 2022-04-22

## README

## Basic CLI for extracting meta data from GoPro Videos
### Prerequisites
This CLI uses ffmpeg and ffprobe, which are not included in this package.

You must have ffmpeg and ffprobe installed on your system, and you must set your system `PATH` environment variable to include the
path to the ffmpeg and ffprobe executables.

They can be found on [ffmpeg's downloads page](https://ffmpeg.org/download.html).

### Installation
Install with `npm i -g extract-goprodata`.

Global installation is necessary for the CLI to be used in any directory in the terminal.

### Usage
In terminal shell, use `extract-goprodata --input path/to/video-name [--format output-format] [--name name-within-gpx-file] [--output path/to/file-name]`.

Telemetry output format:
Formats can be any of those found at [JuanIrache/gopro-telemetry](https://github.com/JuanIrache/gopro-telemetry#presets). Returns a JSON formatted document if specified format is not valid.

Alternatively, use:
- `-i` instead of `--input`
- `-f` instead of `--format`
- `-n` instead of `--name`
- `-o` instead of `--output`

Defaults:
- `--format` defaults to `gpx`.
- `--output` defaults to the name of the input file, using the format for the extension.
- `--name` defaults to input file name.

Only some file formats include the `--name` string within the file, eg gpx.

> Don't add the file extension to the `--output` name.

If your GPX file contains no points, it is likely that the camera did not have a GPS lock when you started recording. 
GPX points are only recorded if the device has a GPS lock, which can take a minute or longer on device start up.

### Credit
- ffmpeg
- fluent-ffmpeg/node-fluent-ffmpeg
- ffprobe
- ScottyFillups/ffprobe-client
- JuanIrache/gopro-telemetry
- yargs/yargs

---
_Source: https://npm.io/package/extract-goprodata · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._