#                               _)
#    _` |   -_)   _ \    \ \ \ / |   -_) \ \  \ /
#  \__,_| \___| \___/ _| _| \_/ _| \___|  \_/\_/
#        aeonview - a simple timelapse tool

aeonview is a Python-based tool for generating timelapse videos from webcam images using ffmpeg. It supports automated image downloading, video stitching, and is fully scriptable via CLI. Includes developer tooling and tests.

Low-quality sample: aeonview 2min preview/Tampere Jan. 2008

Features

Timelapse image capture (--mode image)
Video generation (--mode video)
Support for daily, monthly, yearly video runs (daily implemented)
Uses ffmpeg and Python requests
Fully tested with pytest
Linting and formatting via ruff
Pre-commit hooks and CI-ready

Requirements

Python 3.13+
ffmpeg (system tool)
uv for dependency management
lots of hard drive space

Installation

# Clone the repo
git clone https://github.com/ivuorinen/aeonview.git
cd aeonview

# Install dependencies (creates .venv automatically)
uv sync --all-groups

# Install pre-commit hooks
uv run pre-commit install

Usage

# Capture an image
uv run python aeonview.py \
  --mode image \
  --project example \
  --url "https://example.com/webcam.jpg"

# Generate a video from yesterday's images
uv run python aeonview.py --mode video --project example

Development

# Format code
make format

# Lint code
make lint

# Run tests
make test

# Lint and test with pre-commit
uv run pre-commit run --files <changed files>

System Setup for ffmpeg

sudo apt update
sudo apt install ffmpeg

README.md

aeonview