pxl let's you create beautiful image galleries as a static site that you
can host on any webserver. The generated site is fast and works without
There is a live demo here. Take a look around, see what you think.
The general architecture is finished. The code is usable and gradually stabilizing. Internals may change at any point, so don't write code against them.
The CLI is usable, but requires some UNIX knowledge to get working. We don't offer packages for distributions yet. However, getting started is simple enough if you have a few tools installed.
TODO: we need a picture.
pxl organises your photo library into albums which are stored on
S3-compatible buckets under unique, unguessable paths. It then generates a
static HTML site which you can deploy as you see fit.
Say you have a couple of directories of image files and you want to turn them
pxl site on
photos.example.com. There are four steps:
pxlto be able to write to an S3 bucket.
- Upload photos to an S3 bucket under public but unguessable paths.
- Generate a static website based on bucket state.
- Deploy the static HTML files to
In order to get started with
pxl, you need:
- An S3-compatible bucket to hold your photo library.
- A webserver to host your HTML. You might be able to re-use your bucket for this if your cloud provider supports it.
- A copy of the Python 3.7 programming language and some development tools.
If this sounds within the realm of possibilities, read on for more precise installation instructions.