Garmin FITファイルをカンタンに編集する方法

January 03, 2022 (Last Modified: February 10, 2026)

Garminのデバイスで使用されるFITファイルはバイナリなので、直接編集するのは骨が折れる。

ここではGarmin FIT SDKに含まれるFIT CSV Toolを使って簡易的に編集する方法を説明する。

※ ここでいう「カンタンに」「簡易的に」とは「バイナリを直接編集する場合に比べれば」という比喩表現ですのでご注意を

Feb. 10 2026 追記

実験的にブラウザ上でFitCSVTool.jarを実行する簡単なウェブサイトを作成したので、以下のJava実行環境のインストールやFIT SDKのインストールは不要。

コマンドを打つ代わりに上記ページでFITファイルやCSVファイルを選択すればOK。
なぜか本来のJava環境で動かしたときと若干異なるデータを返すことがあるため、うまく行かない場合は下記の手順通りJavaをインストールしてほしい。

FitCSVToolはJava製なので、Javaの実行環境(JRE)をまずはインストールする必要がある。

バージョンは1.8.0以降ならOK。

Get the SDK | FIT SDK | Garmin DevelopersのFIT SDK Toolsから、 GitHubのリポジトリ > 画面右にあるReleasesと進み、FitCSVTool.jarをダウンロードする。

FitCSVTool.jarと変換元のFITファイルを同じフォルダに移動する。

ターミナル(Windowsの場合はコマンドプロンプト)を開き、以下を実行する。

java -jar FitCSVTool.jar -b (変換元FITファイル名) (変換先CSVファイル名)

なお、WindowsならGitHubリポジトリのFitCSVTool/FitToCSV.batを同じフォルダに持ってきて、FITファイルをFitToCSV.batにドラッグアンドドロップしてもOK。

Excelなどで作成したCSVファイルを編集する。

このとき、unknownという文字列を検索し、存在した場合は3列単位で削除(左詰め)する。

その後、行を追加・削除したりして欲しいデータに加工する。

基本的に、同じフィールドが並んでいる部分であれば追加・変更・削除しても大丈夫。

そうでない場合はFITファイルの構造の知識が必要(参考: FIT Protocol | FIT SDK | Garmin Developers)になる。

したがって元のFITファイルに含まれないフィールドやデータタイプを追加するのは少し大変なので、元のデータを作成するときに手作業で編集したいデータを入れておく(例えば、コースデータでコースポイントを編集したい場合は、ダミーでも良いのでコースポイントを入れたFITファイルを作成しておく)のが良い。

ターミナル(コマンドプロンプト)で、以下を実行してFITファイルを作成する。

java -jar FitCSVTool.jar -c (変換元CSVファイル名) (変換先FITファイル名)

GarminデバイスとUSBで接続し、Garmin/NewFilesフォルダに作成したFITファイルをコピーした後、Garminデバイスの電源を入れると、FITファイルを認識するはず。

公式の編集方法の記述はこちら(unknownを削除する必要があることは記述されていないことに注意) FIT CSV Tool | FIT SDK | Garmin Developers。