Use rustup to install the rust compiler.
Compile the project with cargo build -r. The resulting binary is located in ./target/release/themis
Run the binary either from the ./target directory or with cargo run -r -- -h

Usage

Flags

-h, --help: Prints the help dialog
-k, --keep-aspect-ratio: Keep the aspect ratio of the original image
-V, --version: Print the current version of this program

Options

-i, --input-dir <input-dir>: Specify the path to the cover images. These images are used to compile a mosaic image from the tiles.
-m, --mosaic-size <mosaic-size: Specify the side length of tiles in the target image. A mosaic therefore consists of mosaic-size x mosaic-size tiles. The default value is 128.
-o, --output-dir <output-dir: The output directory where all finished mosaic images will be saved. The default directory is output.
--tile-size <tile-size: The side length of each tile (in pixel). This influences the image resolution inside a tile. The default value is 26.
-t, --tiles-dir <tiles-dir: The directory which contains the tiles to utilize for the mosaic.

Examples

cargo run -r -- -t ./mosaic_tiles -o ./mosaic_output -i ./cover_images -m 100 --tile-size 200

This example will take one or multiple cover images (sequentially) out of the ./cover_images directory. Themis then scales down the tiles out of ./mosaic_tiles to 200 x 200 pixels and arranges the tiles. The result will be a mosaic consisting of 100 x 100 tiles stored in ./mosaic_output.