Skip to content
Blender Script that generates an accurate stopwatch or timer overlay for your video.
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.
LICENSE set start and end frame May 29, 2017 Fixed negative ending number bug May 29, 2017

Video Sequence Editor Stopwatch & Timer for Blender

  • Quickly add a stopwatch or timer to your blender video
  • Count Up [Stopwatch] or Count Down [Timer]
  • Places a sequential timestamp inside of each video frame using "Text Effect" strips.
  • Encapsulates all the frames into a metastrip making it easy to select, move, and group property settings.
  • Resize it, move it, change its color, add a shadow, use it with effect strips or even animate the property settings with keyframes.
  • Script creates accurate timestamps when using integer frame rates such as 24, 25, 30, 50, 60, 120 fps. (Reason Why)

Demo (Timer followed by Stopwatch)


(Background video: (CC) Blender Foundation -


  1. Right Click on "Raw" -> "Save Link as..." on the following page:

  1. Open your Blender project

  2. Set Project FPS, Start and End Frame (Script will create a timer between start and end frame)

  3. Switch an "Editor Window" to "Text Editor" by the editor type from the Editor Menu

Here is what an Editor Menu is:

  1. Press "Open" and select "" in "Text Editor" window

  2. Press "Run Script"

Demo of Fastest way to use the script

  1. Drag it to your text editor
  2. Edit User Preferences
  3. Set Start and End Frame of the blender project (Script will create a timer between start and end frame)
  4. Run Script


Download a Source Code Editor that supports Python

At times you will need to edit this Python Script. So I would advise that you download a free Source Code editor for your platform of choice. Here are my recommendations (I use Gedit):

User Preferences

  • Simply change the values listed below to alter the size and look
  • Note: A Stopwatch counts forward [default setting]. A Timer counts in reverse - aka a countdown


  • Change timer position:
    • Right click on the Meta Strip
    • Select "Image Offset"
    • Change X or Y values

Get Font Color Values

  • Blender use RGBA floating point values. This means if you try to put in RGBA values that you got from a Color Picker online, the values won't give you the correct color. The easiest way to get the Text Color values, is to use Blender's color picker for the Text Effect Strip.

Here is how you get the color values that can be used in place of the 1's in the following script variables:

  • time_color = (1,1,1,1) [value is White]
  • shadow_color = (0,0,0,1) [value is black]
    • an example of a blender RGBA value setting would be (0,0.001,1,1) which is blue


How long should the script take to create Timestamps

(These are the results when using my INTEL i5 3570K 3.4Ghz processor)


  • That's right... It takes 10 1/2 hours to create 300,000 timestamps.
  • Setting put_in_meta_strip = False may improve render time, but the Metastrip is easier to manipulate in the VSE.
  • It is also important to note that Render Resolution doesn't seem to have any affect on script run time.

Special thanks:

Support Me

I consider this script a work in progress. If you have any suggestions on features, find bugs, or if you have added some feature that you think I should include, send me an email at . If you want to help me out, you can send me a Paypal donation at my Yahoo address or help me make the code better by giving me your Python tips for better code. In addition, visit my website at and see what I'm up to lately. I am dedicated to providing cross platform resources and instructional videos free of charge. Checkout my Blender Video Editing Series at the following link:

Send a Donation to Mikeycal

You can’t perform that action at this time.