Skip to content

r00t-tsai/Timelapse-Recorder

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

30 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

record-button

Timelapse Recorder

A simple timelapse recorder that captures frames at a configurable interval and compiles them into an MP4 or AVI video using OpenCV and FFmpeg.

Download Count


Overview

This application is an interval-based capture and compile system timelapse recorder that doesn't interfere much with the performance of the device, making it good for art timelapses.

Updates

4/14/2026 - New version 1.2.1 that fixes most errors encountered in the previous versions. The newer version now supports high-effeciency codec (H.264) that results in high-quality rendered video timelapses.


Settings Reference

Some of these settings can also be manually edited inside the config.py

Setting Description
Mode Full Screen or specific Window
Monitor 1-based monitor index
Interval (sec) Seconds between captures
Max Frames Auto-stop after N frames (0 = unlimited)
Playback FPS Speed of the compiled video (24–30 recommended)
Codec avc1 (H.264, default), mp4v (MPEG-4V), XVID, MJPG
Resolution Scale Downscale captures (saves disk space)
Frame Format PNG (lossless) or JPEG (smaller)
JPEG Quality 1–100, only applies when JPEG is chosen
Keep Frames Whether to retain individual frame images after compiling
Auto-Compile Automatically compile video when stopped

Workflow

Note that this app requires administrator privileges to work properly and to avoid compiling issues.

  1. Tweak your settings inside the application.
  2. Press RECORD to begin capturing. The app will be minimized in the system tray.
  3. Optionally PAUSE / RESUME at any time.
  4. Press STOP and the app compiles the timelapse automatically.
  • If progress is lost due to an unexpected interference like a device shutdown, the program in the second startup will automatically save your progress and prompts you to either compile or delete it. If you choose to ignore this and start a new recording session, the data that you recorded before will be overwritten/deleted.
  • During recording, the recorder will be minimized in the system tray. You can find it there if you ever need to take a break to pause or to finish your recording session.

Images

Screenshot 1 Screenshot 2
Screenshot 3 Screenshot 4

Downloads

Check the releases.


References

FFmpeg OpenCV