headcam: your GoPro video with the oSplit map beside it
=======================================================

Most computers do not need this program: oSplit makes the finished video itself, in Chrome or Edge.
You need it when oSplit says your computer's browser cannot read the camera's video (HEVC), or when
you want ffmpeg to make the video.

You need: this program and ffmpeg (a free program that makes the video). You do NOT need Node.js.

1. In oSplit (Chrome or Edge on a computer), open the race's replay, then More > Headcam video.
   Choose the folder with your GoPro files, check the preview, and press
   "Render panel for the headcam program". oSplit writes two files into the folder:
   GX0123.overlay.mp4 and GX0123.headcam.json.

2. Run headcam:
     - Drag the GX0123.headcam.json file onto headcam.exe (makes the YouTube video), or
     - Double-click headcam.exe, drag the file into the window and choose from the menu:
       the YouTube video, a quick sync check, a short of one leg, or a smaller 1440p video.
   The first time, it offers to install ffmpeg for you (Windows: it uses winget, part of Windows).
   You get GX0123-youtube.mp4 and GX0123-chapters.txt next to your files.

3. Upload the video to YouTube and paste the chapters file into the description.

Windows may say "Windows protected your PC" the first time, because the program is new and not
yet signed: choose "More info", then "Run anyway". On a Mac: right-click the program, choose Open,
then Open again. The program only reads your video files and writes the finished video next to them.

Help, options and troubleshooting: https://osplit.app/help/headcam-program.html
