gabehf/random-image-server
1
0
Fork 0
mirror of https://github.com/gabehf/random-image-server.git synced 2026-03-11 00:00:29 -07:00
Code Issues Projects Releases Packages Wiki Activity Actions
No description
3 commits 1 branch 0 tags 34 KiB
Find a file
Gabe Farrell 386d5d3c4b add license
2025-02-24 18:40:04 -05:00
Dockerfile First 2025-02-24 18:17:26 -05:00
go.mod First 2025-02-24 18:17:26 -05:00
go.sum First 2025-02-24 18:17:26 -05:00
LICENSE add license 2025-02-24 18:40:04 -05:00
main.go First 2025-02-24 18:17:26 -05:00
README.md update README 2025-02-24 18:35:05 -05:00

README.md

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: /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

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.