May 18, 2018

Documentation – Video GeoEditor

Video GeoEditor

1.Video GeoEditor - Overview

Remote GeoSystems Logo

Video GeoEditor

User Manual

Geotag, Map & Edit your videos

Contact:

Remote GeoSystems, Inc.
3307 S College Ave.
Suite 211
Fort Collins, CO 80525 USA
+1 970.367.7808
info@remotegeo.com

1.1.About Video GeoEditor

Video GeoEditor includes all features found in Video GeoTagger PRO, including:

Automatically Geotag Video – Video GeoEditor lets you easily combine any GPS log and video to automatically synchronize the video file with a GPS track with just a few clicks on the map.

Manually Geotag Video – No GPS log file? No Problem! Just select as many points along the map as you want for points of interest you want to geotag in the video. Video GeoEditor does the rest and will create geotagged video files! You can even geotag digitized historical video for documentaries and other location-based projects.

Click-on-Map Video Playback – Video GeoEditor is also a free interactive geospatial video viewer. Open any properly geotagged video for playback using the same professional Esri mapping technology used by organizations across the globe.

GPS Data Displays – Once video is properly geotagged, Video GeoEditor offers options for reviewing GPS and other data elements such as lat/lon, altitude, heading, speed and UTC time for any point during the video recording.

Virtual Dashboard Gauges – An Optional panel appears below the map with virtual navigation instruments and gauges which displays information pulled from the GPS companion file, including:  heading, speed (in MPH and KPH), UTC date and time and altitude.

DJI Drone Flight Log Support – Have you been wondering what to do with those encrypted DJI flight log .TXT files or how you can you can continuously geotag your DJI drone videos? Video GeoEditor includes a proprietary parser for creating standard .GPX files which then allows you to easily geotag your DJI videos and also show other data elements on the map.

LineVision Compatible Video – Video and GPS files created from Video GeoEditor are ready for import into Remote GeoSystems professional LineVision suite of software.

Commercial Use – Video GeoEditor offers unrestricted use for commercial, government and other for-profit projects.

Un-encrypted Geospatial Video Files – Need to use your geotagged video files in non-Remote GeoSystems, 3rd party software? Video GeoEditor allows you to save your newly-geotagged video in an unencrypted format(s).

DJI Drone Closed Captioning SRT Support – Video GeoEditor allows for simple mapping and playback of DJI videos that have GPS data in the closed captioning of the video.

Advanced GIS Map Layer Control – Video GeoEditor comes with the same Layer Control panel found in LineVision Esri Maps, offering capabilities to add map data layers to your video geotagging project. Even if you are not a traditional GIS or Esri user, you can utilize your own background maps with shapefiles, imagery and streaming endpoints and map server data produced by GIS specialists in your organization.

Esri ArcGIS Online Authentication – The Advanced GIS Map Layer Control also includes support for authenticating users against your ArcGIS Online Enterprise account for data access.

Need more advanced commercial survey inspection software? Then check out our LineVision Esri Maps options. Click Here.

2.Installation and Registration

2.1.PC System Requirements

Before you install Video GeoEditor, verify your system meets these hardware and software requirements:

Minimum

  • Processor: Intel Core i5 or better
  • RAM: 8GB Minimum
  • Operating System: Windows 7 or later
  • Hard Drive: 500 GB Minimum (or more depending on recording length. Video files can take considerable space. Therefore it is important to have ample storage available).

Recommended

  • Processor: Intel Core i7 or better
  • RAM: 16 GB Minimum
  • Operating System: Windows 7 (64 Bit or better)
  • Hard Drive: 1 TB Minimum (or more depending on recording length. Video files can take considerable space. Therefore it is important to have ample storage available).

2.2.Installing Video GeoEditor

Download the Software

The download link for the software is within the email sent to the email address entered in the request form. Click the link to be directed to the version of the software that you requested and/or purchased.

NOTE: Some web browsers may not recognize Video GeoEditor and often flag it as dangerous. The error is a false. Select Accept, Allow, or Continue.

NOTE: Even though the installer tells you to close all open applications, it is okay to leave this document open while installing.

Install the Software

1. Double-click the setup.exe file in the extracted (unzipped) Video GeoEditor folder.

IMPORTANT! If you are running Windows 8 and 10, you may encounter a security warning. Select Run or More Info > Run Anyway… to continue.

2. Select the Next once the Video GeoEditor installation wizard launches.

3. Read the License Agreement and click the I Agree radio button. By clicking on the I Agree button, you have accepted the terms of the License Agreement. Click the Next button.

4. Select the Next Button. We recommend you keep the default Installation Folder. You also have the option of allowing just yourself or anyone using the PC to access Video GeoEditor. Select the Next button.

5. Select the Next button to confirm the installation.

6. The software will start the installation on your PC.

IMPORTANT! You may have to allow this app to make changes. Select Yes.

7. Software Installation of Video GeoEditor is now complete. Check the box to launch the Remote GeoSystems Codec installer. Then click the Close button.

HOW-TO VIDEO: Checkout the Video GeoEditor installation video below. For Adobe PDF users, click here.

 

2.3.Register the Software

NOTE: You need to have an active Internet connection to complete your one-time registration.

1. When you launch Video GeoEditor for the first time, the software prompts you to enter your software license key.

PRO TRIAL USERS: If you are doing a 7-day trial of Video GeoEditor, be aware this screen will open each time you launch the software. Simply click Continue to keep using the software during your trial period.

2. To purchase the software, click select a purchase option and click Buy Now. After purchasing, you will be emailed a license code.

3. Enter the license code you received via email into License Code box. Read the End User License Agreement, and if you agree, click the I Accept checkbox then click the Continue button.

4. In a few seconds, you should receive confirmation that your software has been successfully registered.

3.Getting Started

Video GeoEditor is built on the same geospatial technology framework as Video GeoTagger, extended to include robust video-editing features.

To get started, load a geotagged video into Video GeoEditor, or you may also geotag the video first if you have a suitable companion file, such as a .GPX file.

4.Interface Overview

Once you launch the Video GeoEditor software, the application appears by default (counter-clockwise) with Video Viewer, Media Browser, Layer Control, Map Navigation, GeoTagger and Map Viewer in the factory default layout. As with traditional Windows programs, there is a Menu Bar that runs across the top of the software interface.

Video GeoEditor Interface screenshot

Video Viewer Panel

Video GeoTagger FREE Video Viewer Panel Screenshot

This panel allows you to play and control the video with and without a syncronized GPS data.

  • The arrows advance the video forward or backward. How far or little depends on the time entered in the Set Video Skip Forward/Back Time.
  • While the video plays, the GPS information shows the spatial track
  • Speed is measured in knots.

Media Browser Panel

VGE Media Browser Panel Menu

This panel shows loaded videos as items, and by right-clicking on the items you are provided a context-menu for additional options.

Map Navigation Panel

Video GeoTagger Map Navigation Panel Screenshot

This panel gives you the option to enter Latitude/Longitude coordinates to “jump” to a specific location in the Map Viewer.

Layer Control Panel

VideoGeoTagger PRO Layer Control Panel Screenshot

This panel provides options for adding additional map data layers to your geoProject. Even if you are not traditionally an Esri ArcGIS Pro or ArcMap user, you can leverage background maps, raster imagery and stream online and map server data produced by GIS experts in your organization. To hide and show layers click the checkbox to the desired setting.

GeoEditor Panel

This panel provides access to the main editing commands and functionality.

GeoTagger Panel

Video GeoTagger FREE GeoTagger Panel Screenshot

This panel offers the controls for geotagging videos.

4.1.1.File Menu

VGE File Menu

Open Single Video:

Select this menu item to navigate to your video. If your video has a GPS companion file within the same folder with the same file name as the video, or you recorded your video with the geoDVR, then your video automatically loads and zooms to the recorded location on the background map.

Open Video for Geotagging:

Select this menu item to load a video and GPS file separately for geotagging.

Open Photos:

Opens up photos. Both geotagged photos and non-geotagged photos are supported (which you can then geotag manually).

Remove All:

Removes (Unloads) all items that are loaded in the Media Browser

Save Current Layout & Settings as Default:

This menu option lets you set the current layout and selected options as the Default, which the software will use when you open Video GeoEditor in the future.

Advanced Settings & Window Positioning:

  • Load Saved Layout Settings: Select this menu to restore your custom default layout settings if you have changed them while working on your Video GeoEditor project.
  • Reset Settings to Factory Default: Select this setting to restore the panel layout and all settings to Factory Default.

Exit:

Exits the application.

4.1.2.Options Menu

Video GeoTagger Free Options Menu Screenshot

Enable Audio/Video Chaining:

Jumps from one video track to the next in sequential order when you load more than one “already-geotagged” video clip. The ideal scenarios for this is when playing back videos that were recorded at a preset time or size limit from the Remote GeoSystems geoDVR or other 3rd-party GPS-enabled DVRs. This also works well for several video clips recorded from a single drone flight.

Maintain Video Aspect Ratio:

Check this menu item if you want the video aspect ratio to remain consistent when you move and resize the video panel. It is recommended to leave this option checked.

Limit GPS Frequency to 1 Hz:

Check this menu item if you logged video with a higher GPS frequency and want to “de-cluster” the GPS points along a path. It is recommended to leave this option checked.

Play on Click Settings:

Check this menu item if you want videos to begin playing from the point you click on the map. By default, Pause Video at Click Location is checked.

Video GeoTagger Options Menu Play On Click Settings Screenshot

  • Pan to Media When Selected: Check this menu item if you want the map to “pan” to the start location of the video or point location of the photo or annotation. It is recommended to leave this option checked.
  • Always Ask for GPS Companion File: Check this menu item if you want Video GeoEditor always to ask which GPS companion file you would like to use with the video. The default is unchecked which means the application attempts to identify companion files with the same name as the video. If Video GeoEditor does not see a GPS companion file, it asks you to select a corresponding companion file. Selecting this option is recommended if your GPS companion files usually have a different name than the corresponding video file.

Warn On Missing Timecodes:

Check this menu item if you want Video GeoEditor to show a warning message if there are no timecodes detected in the video’s companion file.

NOTE: By default, this option is NOT checked.

If unchecked, Video GeoEditor automatically interpolates the timecodes. This may cause significant differences between the video position and the position on the map.

Check for Companion File Time Mismatch:

Check this menu item if you want Video GeoEditor to compare the length of the video to the length of the GPS points making up the video track.

Video GeoTagger Options Menu Companion File Mismatch Screenshot

  • Always: When checked, the length of the video is always compared to the length of the video track. A warning message displays if the length is not within a tolerance.
  • Only When Edits Aren’t Possible: When checked, the length of the video is checked against the length of the video track only if the Video GeoEditor algorithm determines that the video track has not been edited.
  • Never: When checked, the video length is not checked against the video track length. Checking this option is not recommended unless video track editing has occurred and you are aware that the video’s length does not match the GPS track length.

Turn Off Video Hardware Acceleration:

Select this menu item if you have an older computer or if you are running software that is very demanding on graphics and system resources. Since LineVision consumes a lot of resources when playing videos, you can improve the performance of your computer by leaving this menu item checked.

Set Video Skip Forward/Back Time:

Select this menu item if you want to set the frame rate to skip forward and backward in your videos.

Auto Adjust Map for Current Video Position:

Select this menu item if you want the map to automatically pan and re-center itself when the current video position cursor (yellow balloon) moves off the screen.

 

4.1.3.Geotag Menu

VGT Geotag Menu

Launch Photo GeoTagger:

Launches the Photo GeoTagger window, which allows you to manually geotag images.

Launch Video GeoTagger:

This menu brings the GeoTagger tab to the front.

Parse DJI Log File:

This menu item provides the option to take the DJI brand drone flight record text file and turn it into a format that Video GeoEditor can use to geotag video recording segments from the UAV flight.

Parse GPS from DJI Closed Captioning:

This option will parse GPS data for certain DJI UAV models that contain GPS data within their closed captioning.

HOW-TO-VIDEO: Watch a How-To video with this feature in action below. For Adobe PDF users, click here.

 

4.1.4.Map Menu

VGT Map Menu

Set to United States View:

Selecting this menu item will default the map view panel to center on the United States when you launch Video GeoEditor.

Set to World View:

Selecting this menu item will default the map view panel to center on a global view when you launch Video GeoEditor.

Change Base Layer:

Selecting this item will open a dialog allowing you to change the Base Layer (in other words, what type of map is shown in the Map Viewer panel). The default base layer is the World Street Map, but Satellite Imagery, Topographic, and Ocean maps are also available.

Change base layer dialog

Change base layer satellite imagery

Add Layer:

Selecting this menu item launches the Add Layer window where you will have the option to add a layer of local data or streaming data, such as from an organization’s ArcGIS Server or ArcGIS Online account.

Set Waypoint / GPS Point File Size:

Selecting this menu item will let you define the Video Track Point Diameter and Waypoint Diameter

Waypoint and Map Point Sizing

Add Shapefile:

Selecting this menu item allows you to load an Esri-compatible Shapefile as a map layer.

Add Raster:

Selecting this menu item allows you to load an Esri-compatible raster imagery file as a map layer.

Load KML/KMZ File:

Select this menu item if you have geographic data in a KML/KMZ format. For example, data might include pipeline leak-detection sensor data, utility & pipeline asset network, patrol waypoints, or vector & imagery data.

NOTE: KML/KMZ files imported into Video GeoEditor may not display all the data elements visible in LineVision Google Earth.

Enter Esri Runtime License:

Please enter your Esri Runtime License if applicable.

Reset Esri Runtime License:

Selecting this menu item will delete the previously entered Esri Runtime License and allow you to enter a new one.

Authenticate with Esri OAuth:

Use your ArcGIS Application ID and Application Secret to access your secure ArcGIS resources.

Uses hardware acceleration to display the map.

IMPORTANT! Not all graphics cards can support this option and may cause unexpected errors. With graphics cards that do support this option, it may cause longer map loading times.

Enable Performance Handling:

The Enable Performance Handling function will reduce the number of GPS points based on zoom level in order to optimize performance. If you wish to see all of the GPS points, make sure you uncheck Enable Performance Handling.

NOTE: Unchecking Enable Performance Handling may cause a drop in the performance of Video GeoEditor.

4.1.5.Geoedit Menu

Launch Video GeoEditor:

Brings the GeoEditor tab to the front

Overlay GPS on Video:

With this option you can add a GPS watermark to a video. The watermark includes the information included in the GPS file related to the video. If the information is available, your file will be tagged with GPS coordinates, altitude, UTC date and time, and speed.

Overlay Image/Logo on Video:

Overlays an image or logo file on top of the video

Join Videos:

Joins two videos together to create one video.

Transcode Video:

Transcode a video to an MP4, MOV, or AVI.

Advanced Options

Unload original video on edit:

Select this menu option to enable or disable Unload Original Video on Edit. By default, the option is enabled.

4.1.6.Dashboard Menu

Video GeoTagger Free Dashboard Menu Screenshot

Show Virtual Dashboard:

This item opens a dashboard near the bottom of the Map Viewer panel with virtual navigation instruments. The information is pulled from the GPS companion file, including the heading, speed (in miles per hour and knots per hour), UTC date and time, and altitude.

4.1.7.Help Menu

Video GeoTagger FREE Help Menu Screenshot

Video GeoEditor Quick Start Video:

When you select this menu item, it opens a web browser and takes you to the Video GeoEditor YouTube channel where quick start videos are located. An Internet connection is required.

Video GeoEditor User Manual:

When you select this menu item, it opens a web browser and takes you to the Video GeoEditor Online User Manual. An Internet connection is required.

Video GeoEditor Support Forum:

When you select this menu item, it opens a web browser and takes you to the Video GeoEditor official Product Support and User Forum. An Internet connection is required.

NOTE: All Video GeoEditor support questions and issues are addressed here. We do not offer email or phone support for Video GeoEditor.

Email Program Logs:

Select this menu item to report any errors should they occur while using Video GeoEditor. A window pops up and asks you for your information. The application launches a window to submit the program log.

Remote Geo Corporate Website:

When you select this menu item, it opens a web browser and takes you to Remote GeoSytems, Inc. official company website. An Internet connection is required.

Remote Geo Support Forums:

When you select this menu item, it opens a web browser and takes you to the Remote GeoSystems, Inc. official Product Support and User Forums. An Internet connection is required.

Remote Geo Product Support Website:

When you select this menu item, it opens a web browser and take you to the Remote GeoSytems, Inc. official product support website. An Internet connection is required.

About:

Select this menu item to determine your Video GeoEditor software build/version number. Remote GeoSystems technical support may ask for this number when resolving support issues.

4.2.Media Browser Functions

Right-clicking in the media browser will give you a contextual menu with additional options to manipulate and work with videos.

VGE Media Browser Panel Menu

Zoom to…:

Use the Zoom to… function when you are trying to find the Map Viewer location that corresponds to the video and/or GPS track.

Fit All Media in Map:

This function places brings all the files in the Media Browser on the same map extent.

Jump to Time:

Use the Jump to Time function when you are trying to find a section of the video that corresponds to some other data type, such as data from a gas leak detection alert. In these cases, the geoDVR and leak detection system may be logging the same GPS data stream. After you have selected Jump to Time, a screen pops up to allow you to input the Hour, Minutes and Seconds and click the Jump to Time button to go to this same time in the corresponding video.

Remove Item:

This will remove the item you have right-clicked on.

NOTE: There will be no confirmation for the removal.

Save Track as GPX File:

If you want to use only the GPS data, this will export a GPX file. After you have selected Extract Waypoints as GPX File, a File Explorer window will open asking where you would like to save the GPX File.

NOTE: This option only appears if there are continuous GPS points in the file.

View Info:

Shows the information about the video or photo.

Do Not Show on Map:

Does not show the selected item on the map.

4.3.Map Navigation Panel

Map navigation allows you to move to GPS coordinates on the map in Video GeoEditor. This can be useful if, for example, you are trying to find an important GPS location received from a customer or manager.

To use map navigation:
1. Click on the Map Navigation tab

2. Click on either the World View or USA View button.

3. Enter the coordinates you wish to view in the Latitude or Longitude boxes.

4. Click on Pan to Location button and the map will center on the coordinates you entered.

4.4.GeoEditor Panel

VGE GeoEditor Panel

The GeoEditor panel contains the bulk of the editing commands and functionality, and works in conjunction with the Video Viewer and Map Viewer panels.

Sequence of video selected, showing below video viewer and on map as gray points.

Set Begin Edit:

Sets the beginning point of a new selected sequence, to the current playback location in the video. You can also set this point by using the Map, right clicking on a GPS point along the route, and clicking Begin Edit.

Set End Edit:

Sets the end point of a new selected sequence. You can also set this point by using the Map, right clicking on a GPS point along the route and clicking End Edit.

Cancel Edit:

Clears the start point and end point of the selected sequence.

Extract Subclip:

Saves the selected sequence as a new video, extracting it.

Delete Selection & Merge:

Deletes the video within the current selection, then merges the remaining video together into one.

Delete Selection & Split:

Deletes the video within the current selection, then splits the remaining video into two files (before the deleted sequence and after the deleted sequence)

Trim From Start:

Saves the video from the beginning to the current playback position as a new video file

Trim to End:

Saves the video from the current playback position to the end as a new video file.

Split:

Splits the video into two, the first file is the beginning to the current playback position, and the second file is from the current playback position to the end.

 

4.5.GeoTagger Panel

The GeoTagger Panel is the starting point for automatic and manual geotagging and its functionality will be covered in the automatic and manual video geotagging sections below.

SCREENSHOT – GeoTagger Panel

5.Opening and Viewing Video that has Already Been Geotagged

In addition to providing an easy way to geotag videos, Video GeoEditor also offers map-based playback and of previously geotagged video files. This could be videos previously geotagged with our software (such as Video GeoTagger or LineVision Esri Maps), or from a video camera with GPS like a GoPro or DJI drone camera or specialized professional geospatial DVRs like our geoDVR.

6.Automatically Geotag Video Files Synchronizing with GPS Logs

Video GeoEditor provides the ability to automatically geotag video that has some kind of GPS data log file available to reference. The GPS data does not have to be from the same time period the video was collected, or technically even the same place, nor the same length in time as the video.

For automatic geotagging, ideally you would keep GPS log(s) that are longer in time than the video recording segments, which helps insure there is plenty of GPS data to accurately geotag your video. You can see an extreme example of this is in the snowboarding video below where the GPS is logging throughout the afternoon and the snowboarder only turns the video camera on just for the downhill runs. In this example, he loads the hour and a half GPS log file but only geotags a video clip for one of the runs.

Most GPS devices and smartphone apps will create a GPS log in GPX file formats, but Video GeoEditor also supports all of the following GPS log file formats.

  • GPX
  • CSV
  • KML
  • XML
  • SRT (some DJI UAV models)
  • DJI Drone Flight Logs (encrypted text file)

To automatically tag your video:

1. Launch Video GeoTag functionality by either 1) selecting the Geotag menu at the top > Launch Video GeoTagger or by 2) clicking on the GeoTagger Panel tab.

2. Select the video you want to geotag by clicking the Browse button to find your Video

3. Select the GPS data file you would like to sync the video with by clicking the Browse button to load the GPS data file.

4. Now click Load for Geotagging. You will see the video gets loaded to the Video Viewer and the GPS track is presented in the Map Viewer.

5. Find an obvious known visual place of reference in the video and then find that same corresponding place on the GPS track on the map.

NOTE: Often users will associate the first frame in the video with a point on the GPS track on the map (as in these screenshot examples). However it you can associate any frame in the video with its corresponding place on the GPS track, and Video GeoEditor will calculate the appropriate distance in the GPS log before and after the video frame (as in the snowboarding video in the beginning of this section.)

6. With video paused at the place selected above, right-click on the corresponding GPS point that corresponds to the location seen in the video frame, then select Geotag Video Here.

7. Now there will be a portion of the GPS track highlighted in orange that will show the section of GPS that will be synchronized with the video. If you are happy that this highlighted GPS track represents the “continuous location” of where the video was captured, then click Geotag Video.

8.  After clicking Geotag Video button, only the new shorted GPS track (now in red) is shown and a “Video Successfully Geotagged” message box appears letting you know the new (selected) GPS data has been associated with the video allowing for geospatial playback.

9. The video is now geotagged and can be played back “geospatially” where users can click on any of the GPS points and/or track and the “video location indicator” is following the approximate path the camera traveled.

 

HOW-TO VIDEO: Automatically Geotagging video

See for yourself how easy it is to automatically geotag a video below. (For Adobe PDF users, click here)

7.Manually Geotag Videos

Video GeoEditor allows you to manually geotag videos that do not have any GPS file logs to reference. With manual geotagging a user can click any number of points on a map to provide location points at any number of intervals that correspond to location content in a video frame.

To manually geotag a video:

1. Launch Video GeoTagger functionality by either 1) selecting the Geotag menu at the top > Launch Video GeoTagger or by 2) clicking on the GeoTagger Panel tab.

2. Select the video you want to geotag by clicking on the Browse button for video. Once the video is loaded to click the Load for Geotagging.

3. When no GPS content is detected, a message box appears notifying the user they are entering manual geotagging mode and some basic instruction on how to do so.

4. OPTIONAL STEP: While not necessary, the Layer Control panel lets you add more map data layers to give more details on the map for referencing video frame(s) locations to places on the maps. In this example we will add aerial/satellite imagery so that we can better identify the individual windmills on the map.

5. We zoom into the map, and in this case, use the aerial/satellite imagery to find and set a GPS start point to correspond to the location of the image for the first frame of video in our example. Once you have identified the your video’s start point in the Map Viewer, right-click on that starting point and Select Manually Add Start Point.

NOTE: You now have the option of either 1) adding points throughout your video until you get to the end, or 2) select your end point and then add points in between the start and end points to fill out your manual GPS track. In the example here, we will be using option 1), adding points throughout the video until we get to the end of our video.

NOTE: If you need to move to the end of your video to identify the last frame end location, simply move the video scrubber to the end of the video.

6.  User will typically then let the video play for an amount of time, pause the video, right-click a point corresponding to the location of the current frame of video in view and then select Manually Add Point Here at 00:00:00.

NOTE: Please be aware that where 00:00:00 shows, the time changes as you move through the video.

7. Repeat the process in step 6 above to add additional GPS points that correspond with the location of the current frame of video in view.

8. Once we have added all the point swe want an get to the end of our video, now we select Manually Add End Point.

9. Now select Geotag Video and the GPS points on the map turn red.

IMPORTANT! A message indicating the GPS data was saved appears with a path to where your video and new GPX companion file are located. In the folder with your video, you now have a GPX file that contains the GPS data. DO NOT throw this file away or you have to re-tag your video.

HOW-TO VIDEO: Manually Geotagging Videos

Check out how to manually geotag video below. For Adobe PDF users, click here.

Suggest Edit