Skip to content
Simple script for creating timelapse videos on Linux
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.



A simple PHP script that takes screenshots in regular time intervals and then combines them into “timelapse”. Take a look at this video to see an example of a timelapse.

Inspired by Ludum Dare, ChronoLapse and Linux Desktop Time-lapse Creation Script by winferno.


  • ./timelapse start [interval] [offset] - starts timelapse script with given interval in seconds (default: 10). ‘offset’ parameter sets the initial frame name. By specifying it, you can continue a recording that was previously interrupted.
  • ./timelapse compile [framerate] - compiles all screenshots in current directory to a movie. It starts from 0000.jpg. If not specified, framerate defaults to 10 frames per second.
  • ./timelapse clean - removes all .jpg files from current directory

Required tools

  • php
  • scrot
  • ImageMagick
  • ffmpeg


If for some reason typing ./timelapse [args] fails to execute the script, try: php timelapse [args].

You can’t perform that action at this time.
You signed in with another tab or window. Reload to refresh your session. You signed out in another tab or window. Reload to refresh your session.