GoPro2GPX 项目下载及安装教程

GoPro2GPX 项目下载及安装教程

gopro2gpx Parse the gpmd stream for GOPRO moov track (MP4) and extract the GPS info into a GPX (and kml) file. 项目地址: https://gitcode.com/gh_mirrors/go/gopro2gpx

1. 项目介绍

GoPro2GPX 是一个 Python 脚本，用于解析 GoPro 相机录制的 MP4 视频文件中的 gpmd 流，并从中提取 GPS 信息，生成 GPX 和 KML 文件。该项目适用于 GoPro 5 及以上型号的相机，支持 Windows 和 MacOS 系统。

2. 项目下载位置

GoPro2GPX 项目托管在 GitHub 上，可以通过以下命令克隆项目到本地：

git clone https://github.com/juanmcasillas/gopro2gpx.git

3. 项目安装环境配置

3.1 安装 Python 3

确保你的系统上已经安装了 Python 3。可以通过以下命令检查 Python 版本：

python3 --version

如果没有安装 Python 3，可以从 Python 官方网站 下载并安装。

3.2 安装 FFmpeg 和 FFprobe

GoPro2GPX 依赖于 FFmpeg 和 FFprobe 工具来处理 MP4 文件。你需要确保这两个工具已经安装在你的系统上。

3.2.1 Windows 系统

1. 下载 FFmpeg 和 FFprobe 的二进制文件，可以从 FFmpeg 官方网站 下载。
2. 将下载的二进制文件解压到一个目录，例如 C:\ffmpeg。
3. 将 C:\ffmpeg\bin 添加到系统的环境变量 PATH 中。

3.2.2 MacOS 系统

你可以使用 Homebrew 来安装 FFmpeg 和 FFprobe：

brew install ffmpeg

3.3 配置文件

在安装 GoPro2GPX 之前，你需要创建一个配置文件来指定 FFmpeg 和 FFprobe 的路径。

3.3.1 Windows 系统

在 %APPDATA%\gopro2gpx\ 目录下创建一个名为 gopro2gpx.conf 的文件，内容如下：

[ffmpeg]
ffmpeg = C:\path\to\ffmpeg\bin\ffmpeg.exe
ffprobe = C:\path\to\ffmpeg\bin\ffprobe.exe

3.3.2 MacOS 系统

在 $HOME/.config/gopro2gpx/ 目录下创建一个名为 gopro2gpx.conf 的文件，内容如下：

[ffmpeg]
ffmpeg = /usr/local/bin/ffmpeg
ffprobe = /usr/local/bin/ffprobe

4. 项目安装方式

4.1 通过 pip 安装

如果你已经安装了 Git，可以通过 pip 直接安装 GoPro2GPX：

pip install git+https://github.com/juanmcasillas/gopro2gpx

4.2 手动安装

1. 克隆项目到本地：

   git clone https://github.com/juanmcasillas/gopro2gpx.git
   

2. 进入项目目录：

   cd gopro2gpx
   

3. 运行安装脚本：

   python setup.py install
   

5. 项目处理脚本

安装完成后，你可以使用 gopro2gpx 命令来处理 GoPro 视频文件。以下是一些常用的命令示例：

5.1 基本用法

gopro2gpx -vvv samples/hero6.mp4 hero6

该命令将从 samples/hero6.mp4 文件中提取 GPS 信息，并生成 hero6.gpx 和 hero6.kml 文件。

5.2 跳过无效 GPS 点

gopro2gpx -s -vvv samples/hero6.mp4 hero6

该命令将跳过无效的 GPS 点（GPSFIX=0），生成更准确的 GPX 和 KML 文件。

5.3 从二进制文件中读取数据

gopro2gpx -b -vvv samples/hero6.bin hero6

该命令将从二进制文件 samples/hero6.bin 中读取 GPS 数据，而不是从 MP4 视频文件中读取。

通过以上步骤，你可以成功下载、安装并使用 GoPro2GPX 项目来处理 GoPro 视频文件中的 GPS 信息。

gopro2gpx Parse the gpmd stream for GOPRO moov track (MP4) and extract the GPS info into a GPX (and kml) file. 项目地址: https://gitcode.com/gh_mirrors/go/gopro2gpx