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. 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: /images
• ALLOWED_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

Docker compose example:

services:
  random-image-server:
    image: gabehf/random-image-server:latest
    container_name: random-image-server
    environment:
      ALLOWED_EXTENSIONS: .png,.jpg # comma-separated; default: .png,.jpg,.jpeg,.webp
    ports:
      - 8080:8080
    volumes:
      - /path/to/my/images/:/images:ro
    restart: unless-stopped

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.