alegoria

Alegoria is a web aggregator for image galleries and collections from several hosting sites.

Installation

There's a Docker Compose file available which you can run locally like this:

cd /path/to/alegoria
docker compose up -d

Configuration

You can edit the default gallery-dl config.json file locally with the supported configuration options, such as to change the extractors browser, the included subcategories, the order of posts, and so on.

Development Setup

Enter the dev shell to install dependencies:

nix develop

Then start the front-end and back-end processes with this:

# Add `-- -D` if you want to detach the processes
nix run .

Adding a new extractor

To add support for a new gallery-dl extractor, first inspect the API response shape by running the backend and hitting the posts endpoint:

curl -s "http://localhost:5000/api/v1/posts/<url>" | jq .