aeonview/README.md

                               _)
    _` |   -_)   _ \    \ \ \ / |   -_) \ \  \ /
  \__,_| \___| \___/ _| _| \_/ _| \___|  \_/\_/
        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 curl
• Fully tested with pytest
• Linting and formatting via ruff
• Pre-commit hooks and CI-ready

Requirements

• Python 3.11+
• ffmpeg and curl (system tools)
• lots of hard drive space
• Optional: pyenv for managing Python versions (see pyenv_requirements)

Installation

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

# Install dependencies
python3 -m venv venv
source venv/bin/activate
pip install -r requirements.txt

# Install pre-commit hooks
pre-commit install

Usage

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

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

Development

# Format code
make format

# Lint code
make lint

# Run tests
make test

System Setup for ffmpeg

sudo apt update
sudo apt install ffmpeg curl

License

MIT License © 2025 Ismo Vuorinen