gopro-ingester/README.md

37 lines
1.7 KiB
Markdown
Raw Normal View History

2022-11-10 10:17:31 +00:00
# GoPro-Ingester
A simple tool for ingesting footage from a GoPro media card.
### Getting Started
You can either directly download one of the executable binaries available on the **releases** page, or follow the instructions below to build it yourself:
```shell
git clone git@github.com:andrewlalis/gopro-ingester.git
cd gopro-ingester
dub build
```
> You'll need to have the D compiler toolchain and Dub installed to do this.
### Ingesting Footage
To ingest footage, simply run the executable. It will search for a GoPro media card on your file system, and if one is found, it'll begin copying data to an output directory. By default, it copies to a directory named `raw`, relative to where you invoked the program.
It'll only copy `.MP4` and `.WAV` files, and ignores `.THM` and `.LVM` files that are only used by GoPro's own apps.
This tool comes with a variety of options, which you can view by running `gopro-ingester --help`. I've also included a brief overview of them here:
- `--mediaDir` - The base directory from which to begin searching for a GoPro media card.
- `--outputDir` - The directory to copy data to.
- `--force` - Forcibly overwrite existing files.
- `--dryRun` - Perform a dry-run (and don't actually copy anything).
- `--bufferSize` - The size of the memory buffer for copying.
2022-11-10 16:26:24 +00:00
- `--clean` - Delete copied items from the GoPro's media card afterwards.
2022-11-10 10:17:31 +00:00
- `--help` - Shows help information.
2022-11-10 16:26:24 +00:00
### System Compatibility
Currently, this software is known to work with the following GoPro models:
- Hero 9
And the following operating systems:
- Linux/Ubuntu
- MacOS
If you've got the time and hardware, I'd greatly appreciate if you could test this software on your own device, and make a PR to add it to the list here, or an issue if something doesn't work.