Archived

Watch

Python App for serving up multiple images in a Web Browser

This repository has been archived on 2026-09-02. You can view files and clone it, but you cannot make any changes to its state, such as pushing and creating new issues, pull requests or comments.

Python 34.2%
Jinja 26.1%
CSS 26%
JavaScript 13.7%

Find a file

Repository files (latest commit first)
Filename	Latest commit message	Latest commit date
Chris Pressland f1577a2870 Minor Readme updates		2024-01-21 21:53:55 +00:00
.github/workflows	Initial commit	2024-01-21 20:56:29 +00:00
httpcarousel	Oops, forgot `.parent`	2024-01-21 21:25:45 +00:00
.gitignore	Initial commit	2024-01-21 20:56:29 +00:00
LICENSE	Initial commit	2024-01-21 20:56:29 +00:00
poetry.lock	Initial commit	2024-01-21 20:56:29 +00:00
pyproject.toml	Rename package to 'httpcarousel'	2024-01-21 20:58:32 +00:00
README.md	Minor Readme updates	2024-01-21 21:53:55 +00:00

README.md

Carousel

Serve images via HTML / JavaScript which rotate every N seconds.

Installation

Via Pipx:

pipx install httpcarousel

Sample systemd unit:

sudo tee -a /etc/systemd/system/httpcarousel.service > /dev/null <<EOF
[Unit]
Description=httpcarousel
After=network.target

[Service]
Type=simple
User=debian
Group=debian
Environment="CAROUSEL_IMAGE_DIRECTORY=/home/debian/images"
ExecStart=/home/debian/.local/pipx/venvs/httpcarousel/bin/carousel
ExecReload=/bin/kill -s HUP $MAINPID
KillMode=mixed
TimeoutStopSec=5
PrivateTmp=true

[Install]
WantedBy=multi-user.target

EOF

sudo systemctl daemon-reload
sudo systemctl start httpcarousel
sudo systemctl enable httpcarousel

Environment Variables

Name	Description	Default
CAROUSEL_PORT	The HTTP Port that Carousel should listen on	`6502`
CAROUSEL_INTERVAL	How often the displayed image should change in seconds	`45`
CAROUSEL_IMAGE_DIRECTORY	The directory to find images	`/tmp/images`