for English

GoPro Overlay GUI Tool

GoProのテレメトリ（GPS/速度など）やダッシュボード風の情報を、動画にオーバーレイ（合成）するためのGUIツールです。
ドライブ映像用と360度映像用の機能を持たせています。

time4tea さんの超素晴らしく超ありがたい gopro-dashboard-overlay をGUIで簡単に使えるようにしました。

Windows / macOSに対応しています。

このリポジトリは GPL-3.0 で公開しています。LICENSE を参照してください。

使い方

・ モード 『Overlay (MP4 Batch)』

GPSデータを含む複数のMP4を、結合せず1本ずつ順番にオーバーレイ処理します。
完成動画は、指定した Output folder に 元ファイル名_output.mp4 として出力されます。Save in input file folder をオンにすると入力MP4と同じフォルダに保存されます。
出力解像度がOriginalの場合は事前の解像度変換を行いません。2Kの場合も入力幅が1920px以下なら変換を省略し、1920pxより大きい場合だけ2Kへ変換します。

・ モード 『Merge + Overlay』

長時間連続撮影を行うと、ファイルが自動的に分割されます。
時系列順にリストにMP4ファイルをD&Dすると、1本のMP4に結合し、GPSデータを合成します。Load File List または TXT のD&Dでファイルリストを読み込んだ場合は、TXTに記載された順で結合します（1行1パス、または ffconcat の file 'パス' 形式）。相対パスはTXTの保存場所を基準に解決されます。

・ モード 『Batch Overlay』

360度動画用のモードです。
GoProPlayer等でキーフレームを設定し、4Kで出力します。
出力はカットなしのフル尺でしてください、GPS情報と動画がズレる恐れがあるかもしれません。
GPSデータ読み込みのため、出力された.MP4と元の.360ファイルの両方をD&Dしてください。
複数セットのバッチ処理が可能です。

・ エンコーダの選択

4パターンから選択できます。

• ソフトウェアエンコード
• CPU HWエンコード（Intel / Apple Silicon）
• NVIDIA HWエンコード（Windowsのみ）
• AMD Radeon AMF HWエンコード（Windowsのみ、Ryzen AI Max+ 395 / Radeon 8060S対応）

・ 出力解像度

4Kと2Kが選択できます。 4Kを選択すると1080pへのトランスコード工程がスキップできます。
が、オーバーレイ処理に時間がかかります。

・ タイムラプス

長時間のドライブ映像用にx5、x10が選択できます。
x1がタイムラプスなしです。

・ オーバーレイのタイムゾーン

日時オーバーレイに使用するタイムゾーンを選択できます。
デフォルトは日本（Asia/Tokyo）です。海外で撮影した動画では、たとえばフィンランドなら Europe/Helsinki を選択してください。地域名を使うため、夏時間も自動的に反映されます。

・ 中間ファイル削除

これにチェックを入れると、完了後に不要な中間ファイルが削除されます。

構成

• gopro_overlay_GUI.py — メインのGUIツール
• build.spec — PyInstaller でスタンドアロン実行ファイルを作るための spec
• requirements.txt — Python依存パッケージ一覧
• third_party/ — 同梱しているサードパーティ（FFmpeg、Robotoフォント、gopro-dashboard など）

サードパーティのライセンス詳細は THIRD_PARTY_NOTICES.md を参照してください。

必要環境

• Apple Silicon Mac（推奨）
• Windows 10/11（推奨）
• Python 3.14 で確認
• FFmpeg は third_party/ffmpeg/ に同梱しています（ffmpeg.exe / ffprobe.exe）

EXEのビルド（PyInstaller）

■Windows

仮想環境の準備：

python -m venv venv
venv\Scripts\activate

依存パッケージをインストール：

pip install -U pip
pip install -r requirements.txt

同梱の spec を使ってビルド：

PyInstaller -y build.spec

出力は dist/ 配下に生成されます（フォルダ名は spec の内容に依存します）。

補足:

• このbuild.specは third_party/ 配下の同梱物（FFmpeg、フォント等）を参照しビルドしています。
• パスを変更した場合は build.spec 側も合わせて修正してください。

■macOS

仮想環境の準備：

python3 -m venv venv
source venv/bin/activate

依存パッケージをインストール：

pip install -U pip
pip install -r requirements.txt

同梱の spec を使ってビルド：

PyInstaller -y build.spec

出力は dist/ 配下に生成されます（フォルダ名は spec の内容に依存します）。

補足:

• このbuild.specは third_party/ 配下の同梱物（FFmpeg、フォント等）を参照しビルドしています。
• パスを変更した場合は build.spec 側も合わせて修正してください。

クレジット / サードパーティ

同梱コンポーネント：

• FFmpeg / FFprobe — Windowsビルドの再配布（third_party/ffmpeg/） 本リポジトリは Windows向けの FFmpeg バイナリを以下に同梱しています。 third_party/ffmpeg/ffmpeg.exe
third_party/ffmpeg/ffprobe.exe
  これらは gyan.dev のビルドを再配布しています。
  
  third_party/ffmpeg/ffmpeg
third_party/ffmpeg/ffprobe
  これらは evermeet.cx のビルドを再配布しています 。 詳細は third_party/ffmpeg/LICENSE を参照してください。

• Roboto フォント — googlefonts/roboto-3-classic（OFL-1.1、third_party/Roboto/）

• gopro-dashboard overlay script — time4tea/gopro-dashboard-overlay から未改変で同梱（GPL-3.0、third_party/gopro-dashboard/） 詳細は THIRD_PARTY_NOTICES.md を参照してください。

ライセンス

• 本プロジェクト：GPL-3.0（LICENSE）
• サードパーティ：THIRD_PARTY_NOTICES.md および third_party/ 配下の各ライセンスファイルを参照してください。