Parallax

Parallax is a simple CLI tool to join multiple .png's and output a layered .gif parallax animation.

Demo

parallax.py -i l1.png l2.png l3.png l4.png -os 2.0 -ls 1 2 4 8 -o forest

Output:

Loading l1.png
Loading l2.png
Loading l3.png
Loading l4.png
Layer speeds: [1, 2, 4, 8]
Saving 'forest.gif', 180 frames, (360, 180) px
Done!

Installation

To use this tool, ensure you have uv installed. You can install the required dependencies and set up the virtual environment with:

uv sync

Usage

You can run the script using uv run:

uv run parallax.py

This will get all .png's in cwd and set layer speeds automatically.

usage: parallax.py [-h] [-i [INPUT ...]] [-fd FRAME_DURATION] [-os OUTPUT_SCALE] [-ls [LAYER_SPEEDS ...]] [-d DIRECTION] [-o OUTPUT]

Takes multiple .png's and creates a scrolling parallax animation with them.

options:
  -h, --help            show this help message and exit
  -i [INPUT ...], --input [INPUT ...]
                        Paths to the .png layer files to use in the animation, if not specified, it will use all .png's in current folder.
  -fd FRAME_DURATION, --frame-duration FRAME_DURATION
                        Length of the animation in frames, default to the width in pixels.
  -os OUTPUT_SCALE, --output-scale OUTPUT_SCALE
                        Scale factor for output image, defaults to 1.0.
  -ls [LAYER_SPEEDS ...], --layer-speeds [LAYER_SPEEDS ...]
                        Sets the speed in pixels per frame for each layer. Number of elements needs to be the same as the amount of layers. Leave empty for automatic speeds.
  -d DIRECTION, --direction DIRECTION
                        Sets the movement direction of the animation. (1) - Left (default) (-1) - Right
  -o OUTPUT, --output OUTPUT
                        Sets the output filename.