gabehf
/
random-image-server
mirror of https://github.com/gabehf/random-image-server.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity
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.
3 Commits
1 Branch
0 Tags
27 KiB
 
 
Branches Tags
${ item.name }
Create tag ${ searchTerm }
Create branch ${ searchTerm }
from '386d5d3c4b'
${ noResults }
Go to file
Gabe Farrell 386d5d3c4b
add license 		10 months ago
Dockerfile First 10 months ago
LICENSE add license 10 months ago
README.md update README 10 months ago
go.mod First 10 months ago
go.sum First 10 months ago
main.go First 10 months ago

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.