Written Guide
Last updated: Feb 2025
Geometry-based object and camera tracking add-on for your favourite 3D creation suite. Easily track objects in your videos and bring them to life in 3D space, all within Blender.
Installation
If you already have any other KeenTools add-on installed in Blender, just update it. The new GeoTracker tab will appear on the sidebar (Shortcut: N
— hide/show).
Blender 4.2: Download KeenTools Blender Pack, open Blender Preferences > Add-ons, click on the little arrow in the top right corner and select Install from Disk
. Navigate to the downloaded zip file and install it. If you’re on Mac, find ZIP in the downloaded DMG file.
For Blender versions 2.8–4.1 check out this installation video
Next, install Core Library. You can do it either online or offline.
Unfold KeenTools extension
and agree to the Licence Agreement. If your machine is connected to the internet, simply press Install online
. Core Library will be downloaded and installed automatically.
For offline installation, download Core Library manually from our website. After download, press Install from disk
and navigate to the downloaded file. Please keep in mind that the add-on and the core library versions should match.
Inputs
Start by pressing N
to view the sidebar and then click on the GeoTracker
tab to open the main panel. Press Create new GeoTracker
. This will open the main panel with Inputs
on the top. The fields marked in red are empty fields that must be filled to proceed to tracking.
Camera
By default, GeoTracker picks up the Camera from your Blender scene. If you accidentally delete it, you can create a new camera by clicking Add > Camera in the top left of the viewport.
You can plug a new camera into the Camera Input from the dropdown list or directly from the viewport with the picker (Shortcut: E).
Clip
Click on the folder icon next to the Clip
field and load your footage. This can be either an image sequence or a movie file.
When loading an image sequence, GeoTracker reads the name of the first file in that sequence and if there’s a suffix, it sets it as the start frame on the Blender timeline. E.g. Sequence_1001.png will automatically set the playback to start off with frame 1001.
You can reposition the playback on Blender timeline by entering a specific frame number in the Start frame
selector just below the Clip
input. Be mindful that setting the start frame for your playback has to be done before analysing and tracking takes place.
For faster tracking you will need to analyse the clip. Press Analyse
, select the frame range and hit OK
. GeoTracker will scrub through the timeline forward and backwards and create an advanced motion vector file (.precalc
) on your disk, which you can use later for tracking other objects in the same shot. By default, it will be saved in your temporary folder on MAC or disk C on Windows. But, of course, you can choose a different location.
Geometry
Select Geometry
that you will use to track the target object in your clip. By default, GeoTracker picks the cube from the Blender startup scene. You can use any model from your scene, including imported 3D models (File
> Import
). Click on the field next to Geometry to select it from the dropdown list, or use the object picker (Shortcut: E) to select it right in the viewport.
Similar to Geometry, GeoTracker picks up the default Camera from your Blender scene. If you accidentally delete it, you can create a new camera by clicking Add
> Camera
in the upper left of the viewport. You can always pick the right camera from the dropdown list or use the picker (Shortcut: E).
Before moving on to tracking, it’s important to press Analyse
and hit OK
. GeoTracker will analyse the clip and save the analysis data as a .precalc file on your disk. By default, it will be saved in your temporary folder on MAC or disk C on Windows. But, of course, you can choose a different location. This will make tracking much faster, though you can skip it by deselecting Use analysis cache file
.
Pinning
Next step is overlaying Geometry on top of the target object in the clip. Press Start pinmode
in the Tracking
tab. Click anywhere on the mesh to create the first pin. Drag it to align the model with the object you’re going to track. Create more pins and adjust their positions to ensure a precise fit. Right-click on the pins you want to remove. Note that pins are only used for adjusting the model’s position. Their number and exact positions will not affect your tracking.
Wireframe colour and opacity are adjustable, and so are the size and sensitivity of the pins. You will find basic settings in the Appearance tab. More settings in
Preferences
>Add-ons
.
Camera setup
The key to good tracking results is correct camera settings. If you know the focal length and film size of the camera on the set, just type them in in the dedicated Camera
tab. In case you don’t or unsure about your camera data, you can tick Estimate focal length
checkbox to get that value calculated for you. Note that automatic focal length estimation works only for the current frame while you’re pinning the model, and you need to have at least 4 pins set on the wireframe to activate it.
Tracking
Select tracking mode depending on your needs using these buttons in the Tracking tab:
Geometry
— to follow the motion of an object
Camera
— to track the camera position in a physical space (e.g. when tracking static objects).
Click on the Track Forward
button. You’ll see GeoTracker estimating the position of the target object in the consequent frames. Whenever you see the mesh is off, pause tracking and adjust its position manually using the existing pins or creating new ones if necessary. GeoTracker will store the adjusted position and rotation by creating new keyframes. Note that the manual keyframes created this way do not affect the tracking data stored in the other keyframes. Press Refine
to update the tracking data after each adjustment. Keep on refining your tracking until the motion of your 3D model is smooth and accurate.
Improve tracking accuracy with the Lock View option
Sometimes it’s hard to assess the tracking quality especially when dealing with dynamic shots. Use the Lock View
button or keyboard shortcut L
to stabilize the clip in the viewport. With no pins selected, GeoTracker will snap the view to your Geometry. But you can also lock the view to a specific point on your 3D model by selecting one or a group of pins. Learn more about this feature in our video tutorial.
Masks
Oftentimes various elements in the video get in the way of tracking, and that results in Geometry slipping away from the target object. Masking is a technique that lets you exclude problematic areas from tracking. GeoTracker offers not just one but three types of masks to deal with almost any occlusion you might encounter: Surface
, Compositing
, and Sequence
masks.
Surface
mask allows you to select polygons right on the surface of your Geometry to exclude them from tracking. This can be useful when dealing with reflection or when you need to take out certain elements, like adjacent parts, of your 3D model from tracking.
To apply a Surface
mask, switch to Edit Mode
and select the polygons you want to mask out, then go to the Object Data
tab in the Properties
, create a new vertex group by clicking on +
, and press the Assign
button below. Return to Object Mode
and select the newly created group in the Surface mask
dropdown list. You can then switch to Pinmode to view the mask.
Another way to fight off occlusions is 2D masking, which works for most overlays like the character’s hand or other elements in the foreground crossing the path of the track. You can either draw a 2D mask right in Blender using the Compositing
mask option or import a pre-made mask using the Sequence
option. Note that you can’t select both Compositing
and Sequence
masks within one tracking session. You can only use one at a time.
In order to use Compositing
mask, go to Movie Clip Editor
and select your clip. Switch the Tracking mode
to Mask
and click on Add
> Circle
(or other shapes that fit your situation). You can now press Move
and place your mask over the element you want GeoTracker to ignore when tracking. Learn more about editing masks in Blender on this page.
You can adjust your mask position in other frames by creating new keyframes. Note that the keyframes you create in the Movie Clip Editor are independent of those generated by GeoTracker. Once you’re happy with the mask shape and position, go back to the 3D viewport and select your mask in the Compositing
mask tab. Go to Pinmode to see your mask in action.
If you have a pre-made mask, you can import it using the Sequence
mask option. You can then choose which of the RGBA channels you want to use for masking.
Just like with the loaded clip, GeoTracker reads the name of the first file in the mask sequence and if there’s a suffix, it sets it as the start frame on the Blender timeline. E.g. Mask_1001.png will set the mask to start off with frame 1001. If you need to adjust its position on the timeline, enter a specific frame number in the
Start frame
selector below.
Scene Tab
You can easily manipulate your scene from the Scene
tab on the GeoTracker panel. The Transform section lets you Scale
and Position
your scene with the two corresponding buttons. You can scale either the whole scene relative to the selected Pivot point
or Geometry
relevant to Camera
, or Camera
relevant to Geometry
. And when doing the latter, you can also lock the camera visualisation scale.
You can select either Camera
or Geometry
as the pivot point to Position
your scene in 3D space. You can set the Location
and Rotation values manually or use preset positions such as World Origin
and 3D Cursor
.
The Rig
button lets you create an Empty with parented Camera and/or Geometry that you can use as a handle when building your 3D scene.
Go to the Animation
section when you need to convert your Camera animation to Geometry or vice versa. Note that if both the Camera and Geometry are animated, pressing the Convert
button will convert all animation to one, and then this operation will not be reversible!
Press Bake
if you need to unparent Camera and/or Geometry. This will bake them, along with their animation, to World space.
Important! If your model rotates more than 360° between certain keyframes, we recommend using the Unbreak Rotation
option. The algorithm behind it will go through all keyframes and make rotation continuous thus avoiding 360 degree jumps. It means that if rotation was 355° in the keyframe #24 and 10° in the keyframe #25, pressing this button will add 360° to keyframe #25, so the resulting rotation of the model will be 370°. It works backwards as well: going from 10° to 355° will make it -5°.
You have to be careful if your model rotates both forward and backwards between the nearest keyframes — then this operation will most likely make things worse.
Texturing
The Texture tab lets you grab texture from the tracked object in the video and then bake it onto the 3D model. You will first need to choose which frames you want GeoTracker to take the texture from. Go to the source frame on the timeline and press +
. The snapshotted frame will then appear in the Add frames
list. If you want to remove it, click -
.
For best results, choose frames where the object is clearly seen from different angles to provide GeoTracker with ample data for creating texture. Avoid frames that are blurry or have something in the foreground that blocks the view of the object.
As you click Create Texture
, GeoTracker projects the texture from the selected frames and bakes it onto your Geometry. Click the gear icon to access Texturing settings
. Here, you can adjust the size of your texture and also set up things like Angle Strictness
, allowing you to control how much the pixel color will be affected depending on the viewing angle, and Expand Texture Edges
which lets you cover dark spots on the texture by expanding the edges.
Click Export
to get your texture as a PNG, JPEG, or EXR file.
You can also save the texture from all frames as an animated sequence by clicking the Save to Sequence
button.
Export
Empty
In the Export
tab you can export one or multiple Empties by specifying the source in the dropdown menu and pressing the Export
button below it:
Geometry
— geometry animation
Camera
— camera animation
Selected pins
— one or multiple Empties (drop a pin on the mesh and set its orientation before export)
Check Linked
to keep exported animation synced with further changes in the tracking data.
Render Wireframe
You can render playback with overlaid wireframe or just animated wireframe by pressing the Render Wireframe
button. In the render output panel you can adjust controls like wireframe line width and color, and use options like Lit wireframe
, Backface culling
, Highlight facial features
. If you need to render only animated wireframe without the playback, deselect Use background
. It will be rendered out as a series of images according to the selected file format: PNG
, JPEG
or EXR
.
Video tutorials
Check out these video guides to find out more about GeoTracker for Blender.
More tutorials are on their way!
Follow us: Facebook, Linkedin, Twitter, Instagram, YouTube, Discord, Reddit