moving things around / clarification

Author: time4tea

docs/bin/README.md

@@ -54,7 +54,57 @@ You'll need to create a profile - see [FFMPEG Profiles](#ffmpeg-profiles)
 venv/bin/gopro-dashboard.py --profile nvgpu ~/layouts/my-layout.xml ~/gopro/GH020073.MP4 GH020073-dashboard.MP4
 ```
 
-*Create a movie with alpha channel, using only GPX file, without video from GoPro*
+
+## Omitting Widgets
+
+If the layout you are using has a widget you don't want, you can use `--include <name> <name>.. ` or `--exclude <name> <name>...`
+on the command line to include or exclude that widget.  To get the name of the widget, currently you need to look at the xml file. (linked above)
+
+## Skipping Containers
+
+If you didn't want to render a container, you could add `--exclude <container-name>` when running the program, and this
+container would be skipped.
+
+## FFMPEG Profiles
+
+Create a file `~/.gopro-graphics/ffmpeg-profiles.json`, and put FFMPEG parameters to control the `input` and `output`
+
+Both `input` and `output` sections are mandatory.
+
+The ffmpeg command line arguments are a bit of a minefield, so when using this, then it definitely is out-of-warranty. (There's no warranty anyway!)
+
+Please consider contributing useful settings, particularly those that control GPU outputs.
+
+```json
+{
+  "profile-name": {
+    "input": ["list", "of", "input", "options"],
+    "output": ["list", "of", "output", "options"]
+  }
+}
+```
+
+Example:
+
+```json
+{
+  "nvgpu": {
+    "input": ["-hwaccel", "nvdec"],
+    "output": ["-vcodec", "h264_nvenc", "-rc:v", "cbr", "-b:v", "50000k", "-bf:v", "3", "-profile:v", "high", "-spatial-aq", "true"]
+  },
+  "low-fr": {
+    "input": [],
+    "output": ["-r", "10"]
+  }
+}
+```
+
+## Creating Videos using only GPX File
+
+### Create a movie with alpha channel, using only GPX file, without any video at all
+
+This is when you want to use external software to do the final video - combining the "dashboard" video and some other video using Lightworks
+or whatever 
 
 You'll need to create a profile - see [FFMPEG Profiles](#ffmpeg-profiles)
 
@@ -95,13 +145,20 @@ then execute (NOTE: extension is `webm`)
 venv/bin/gopro-dashboard.py --use-gpx-only --gpx ~/Downloads/Morning_Ride.gpx --profile overlay --overlay-size 1920x1080 GH020073-dashboard.webm
 ```
 
-*Create a movie from GPX and video not created with GoPro*
+### Create a movie from GPX and video not created with GoPro
+
+This is currently quite hard to align things properly!
+
+#### Ensure file time matches GPX times
 
 Make sure that the time of the file is correct and when aligned to the timezone of your computer matches the data in GPX file 
 (this might not be the case if video is recorded abroad). 
+
 If it is not correct you can fix it using `touch -d '2022-08-29T11:17:44Z' file.mp4`. 
+
 To get the correct time you can try with different dates available from `exiftool file.mp4` or `exiftool thumbnail_image_of_the_video.thm` 
 (if thumbnail image exist), from SRT/flight log viewer/CSV from Airdata, etc. 
+
 But first make sure that you have set the correct date and time of the camera BEFORE recording the video.
 
 ```shell
@@ -118,49 +175,6 @@ venv/bin/gopro-dashboard.py --video-time-end file-created --use-gpx-only  --gpx
 venv/bin/gopro-dashboard.py --video-time-end file-modified --use-gpx-only --gpx ~/Downloads/Morning_Ride.gpx ~/recording/sail.MP4 GH020073-dashboard.MP4
 ```
 
-## Omitting Widgets
-
-If the layout you are using has a widget you don't want, you can use `--include <name> <name>.. ` or `--exclude <name> <name>...`
-on the command line to include or exclude that widget.  To get the name of the widget, currently you need to look at the xml file. (linked above)
-
-## Skipping Containers
-
-If you didn't want to render a container, you could add `--exclude <container-name>` when running the program, and this
-container would be skipped.
-
-## FFMPEG Profiles
-
-Create a file `~/.gopro-graphics/ffmpeg-profiles.json`, and put FFMPEG parameters to control the `input` and `output`
-
-Both `input` and `output` sections are mandatory.
-
-The ffmpeg command line arguments are a bit of a minefield, so when using this, then it definitely is out-of-warranty. (There's no warranty anyway!)
-
-Please consider contributing useful settings, particularly those that control GPU outputs.
-
-```json
-{
-  "profile-name": {
-    "input": ["list", "of", "input", "options"],
-    "output": ["list", "of", "output", "options"]
-  }
-}
-```
-
-Example:
-
-```json
-{
-  "nvgpu": {
-    "input": ["-hwaccel", "nvdec"],
-    "output": ["-vcodec", "h264_nvenc", "-rc:v", "cbr", "-b:v", "50000k", "-bf:v", "3", "-profile:v", "high", "-spatial-aq", "true"]
-  },
-  "low-fr": {
-    "input": [],
-    "output": ["-r", "10"]
-  }
-}
-```
 
 ## GPU Learnings