You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
1.0 KiB
1.0 KiB
random-image-server
Serves a random image from a directory. Listens to file system events to automatically update available images.
NOTE: I threw together this program to serve random backgrounds to my homelab (homepage)[https://gethomepage.dev/]. I have not done any testing. Software provided as-is.
Usage
Simply run the program with no arguments.
Two environment variables are available:
IMAGE_DIR: The directory to scan for images. Default:/imagesALLOWED_EXTENSIONS: Extensions to be considered by the program. Comma-separated list. Default:.png,.jpg,.jpeg,.webp
Installation
Docker
Docker run example:
docker run -p 8080:8080 --volume /path/to/images:/images:ro gabehf/random-image-server
From Source
Clone the repository:
git clone github.com/gabehf/random-image-server
Download dependencies:
go mod download
Build & run the program
go build -o random-image-server . && ./random-image-server
Then navigate to localhost:8080 and you will be served a random image from the directory.