Skip to content

A web frontend for queueing ffmpeg conversion of timelapses

License

Notifications You must be signed in to change notification settings

jheidel/timelapse-queue

Repository files navigation

Timelapse Queue

Build Status

A web frontend FFmpeg wrapper for easy, user-friendly generation of timelapses from image sequences.

Output files are 1080p MP4 files intended to work with Adobe Premiere for further editing.

This web frontend is well-suited to run on an on-site server. In my configuration, it runs on a local machine that also hosts a NAS. A network client can then process timelapses directly on the NAS.

This project is used for the HikeArt YouTube Channel.

Getting Started

The easiest way to start using this project is by installing the public Docker image. The image is automatically built from this repository using Travis CI.

If you're not familiar with running a Docker container see: https://docs.docker.com/get-started/

To download and run the timelapse-queue image:

# Point this at a directory containing timelapses you wish to process.
# The path must be absolute.
TIMELAPSE_DIR=/home/jeff/

docker run \
    -p 8080:80 \
    --mount type=bind,source=${TIMELAPSE_DIR?},target=/mnt/fsroot \
    jheidel/timelapse-queue

Once it's running, navigate to http://localhost:8080.

TODO: provide some guidance for running this as a service.

Software Overview

Timelapses are configured via a web application, written using Polymer 3.

The backend is a monolithic Go binary which is responsible for serving the web frontend as well as processing the timelapses.

The timelapse server reads images sequentially and applies any resizing & cropping & image stacking effects. The images are then piped to a FFmpeg binary run as a subprocess which writes out the video file. The server manages queueing of jobs so that at most one FFmpeg operation is running at a time.

Build Instuctions

  1. Run make
  2. Resolve errors (probably missing dependencies)
  3. Repeat until success

This project was developed on Ubuntu 18.04 (and will likely work with other platforms with a couple rough edges).

It has only been tested on Google Chrome and may encounter issues with other browsers.

To build the Docker image:

docker build -t timelapse-queue .

Also available on Docker Hub:

https://hub.docker.com/r/jheidel/timelapse-queue/

Project Status

Initial implementation complete. Some further development is planned as I have time, mostly for an archival feature to convert large image sequences into a high quality 4k archive format which can later be re-processed into timelapses.

Screenshots

A timelapse job starts with a file browser. Images are grouped into timelapse sequences.

file browser

The timelapse job then requires some simple configuration.

timelapse configuration

Photo stacking effects are available.

stacking

Timelapse jobs go into a queue and are processed sequentially using FFmpeg.

queue

About

A web frontend for queueing ffmpeg conversion of timelapses

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published