From OTV

Jump to: navigation, search



RGMapvideo is a tool made by Jarkko Ryyppö designed to combine HeadCam video and GPS-data to make a video of a race where you see a map with your position superimposed. Stabilization is built-in via a VirtualDub plugin. The layout of the final video is template-based, and it is thus possible to have significant influence on the final look of the video with relatively little effort. In the standard layout there is a black box which bounces due to the stabilization routine used, but it is possible to remove the black box by reducing the angle of view (see example below).

RGMapvideo is an "expert tool" in the sense that it is script-based and you need some time to master it. Once the tool is mastered, setup-time for making a new video is less than 15-20 minutes and processing time for a 720p video is approximately 3-4 times the video length.

RGMapvideo can be downloaded from The Routegadget webpage.

  • Example WOC 2011 Relay course pre-run:

  • Example showing three different RGMapvideo layouts

  • Example from ski-orienteering

  • Example from MTB-O

Installation & Testing (basic version)


PLEASE See further down on the page for updated instructions by Rui Tavares under "Installation & Testing - step-by-step by Rui Tavares" - they are probably easier to follow.

 ; ffmpeg path
 FFMPEGPATH = C:\rgmapvideo\ffmpeg\ffmpeg.exe
 VIRTUALDUBPATH = C:\rgmapvideo\virtualdub\virtualdub.exe
  • Installation is ready - you are ready for testing.


  • Shoot about 5 min video with your camera and copy video file to your computer.
  • Open RGmapvideo.ini. In the beginnig there is VIDEO parameter. Type your video's name there (with correct path). Then run go.bat. Best if you open command promth window and run go command there, you'll see error messages if program exists immediately. If everything goes well you'll have to wait about 4x video's duration and youll get mp4 video file with maps, graphs and all. Then everything should is set up for real use.
  • When this works, you must use QuickRoute to calibrate map, export the map and route, and you are ready to go. Send an email to jan@kocbach.net if you need help

Installation & Testing - step-by-step by Rui Tavares

Thanks to Rui Tavares for making a more detailed set of instructions. Please add a comment below if you have questions, and Rui/Jan will try to help you. Please do not send an e-mail with questions.



The pack comes ready to use, but you may want to change a few features like:

  • CHANGE LOGO: Go to layout_default folder and copy your new logo image, replacing the logo.png file.
  • LOW CPU PERFORMANCE: you may want to reduce the frame rate for maps or reduce video resolution to 480
  • LOW DISK SPACE: This requires 15Gb of free space for 1h video. If you want to reduce used space, you can change the TEMPFOLDER2 option and set it to TEMPFOLDER2=temp1. This will replace the step 2 files while executing step 3.


To be repeated every time you want to render a video

  • 1. Copy your video files into the rgvideo folder
  • 2. Open QuickRoute and align your map with your GPS track
  • (a) Export route data from quickroute and replace ROUTE.XML file in rgvideo folder. Make sure all options are checked until lap number (inclusively)
  • (b) Change the transparency to 100% and export image, replacing the IMG.JPG file in rgvideo folder
  • 3. Open RGmapvideo.ini and set the EXECUTE options
  • (a) VIDEO – source video files
  • Make sure these files are in the folder rgvideo.
  • (b) CROPSTART and CROPEND – how much you want to cut from the movie file. The start of the movie should be in sync with the gps route. Hint: I usually start my headcam 60s before my start time and keep the same value.
  • (c) FINALVIDEO - output file name.
  • 4 Run GO.BAT and wait a few hours.

There are plenty of other configuration actions you may do, but it requires some scripting knowledge. If you want to do something else more complex, ask us a question and we might be able to help.


Explanation of the steps:

  • STEP 1: Combine all source files and prepare for VideoDUB filters
  • STEP 2: Execute VideoDub – This will execute Deshake filters in two steps and saves each frame as an image.
  • STEP 3: Render map layers and saves each frame as an image
  • STEP 4: Create final video from image frames
What do you think? Please add your opinion as a comment below.

blog comments powered by Disqus