ref: 02fee7ace414632306cce20330396e6165ed1109 gopro-utils/README.md -rw-r--r-- 1.8 KiB
02fee7acMatthew Johnston Adds jpegoptim to the organize step 5 months ago

#GoPro Utils

A tool to help aid in the organization and automation of your GoPro file importing.



Copy the gopro file somewhere into your path.

Or simply execute it with python path/to/gopro.



Takes the crazy format that GoPro stores the files as and moves them into their respective directories.

The directory structure is as follows:

  • timelapse
    • chapter
  • videos
    • thumbnails
    • low-res
    • hi-res

Timelapse files will be optimized with jpegoptim which is a lossless optimization. There is roughly a 6% reduction in each file size.

Timelapse files will also be archived using tar. This is so that after converting the timelapse to an mp4 the directory of all the images can be deleted and the archive can be moved to a NAS or backed up elsewhere. Transferring thousands of small 2MB files over a network has a lot of overhead that a single tar file will suffice.

  • --archive - Set to --archive no to disable archiving the timelapse files. Default is enabled.
  • --optimize - Set to --optimize no to disable jpegoptim. Default is enabled.


Converts the timelapse images into a single mp4 file.

  • --fps - Set the frames per second you wish the timelapse to use. Default is 30 fps.
  • --output-dir - The output directory to store the mp4 file.
  • --name - The name of the timelapse file without the extension. Default is the parent directory name.
  • --width - The final width of the video.
  • --height - The final height of the video.
  • --rotate - The amount of degrees to rotate the video by. It is pinned to increments of 90 degrees.