genaigallery

Usage

Download the pre-compiled binary for your operating system from the Releases page. Extract the archive, and run the binary from your terminal or double-click the exe on Windows.

# On Linux
./genaigallery-linux-amd64

# On Windows
genaigallery-windows-amd64.exe

By default, the application runs on the first available port starting at 5775 and serves images from the directory it was launched in. It will automatically open your default web browser upon startup.

Configuration

You can configure the application using command-line flags or environment variables:

Flag	Environment Variable	Default	Description
-images-dir	IMAGES_DIR	Current Directory	The path to the directory containing your GenAI images.
-db-path	DB_PATH	<images-dir>/genaigallery.db	Where to store the SQLite database.
-port	PORT	Auto (Starts at 5775)	The specific port to bind the web server to.
-require-auth	REQUIRE_AUTH=true	false	Force Basic/Bearer authentication for all networks.
-ffmpeg-path	FFMPEG_PATH	-	Path to the ffmpeg executable. Needed for video previews.

Example using flags:

./genaigallery-linux-amd64 -images-dir /path/to/my/comfyui/outputs -port 8080

Creating a Windows Shortcut with Flags

If you are using Windows and want to always launch the gallery with specific flags (e.g., a custom images directory):

1. Right-click the genaigallery-windows-amd64.exe file and select Create shortcut.
2. Right-click the newly created shortcut and select Properties.
3. In the Target field, append your desired flags after the executable path. (Example: "C:\path\to\genaigallery-windows-amd64.exe" -images-dir "D:\AI\Outputs" -port 8080)
4. Click OK. You can now double-click this shortcut to launch the gallery with your custom settings.

Remote Access & Authentication

By default, access from the local machine (localhost) and machines on your local network (e.g., 192.168.x.x) is allowed without authentication.

If you access the gallery from an external or public network, or if you launch the application with -require-auth, security is strictly enforced:

• Web UI Access: You will be prompted by your browser with an HTTP Basic Auth login prompt. Leave the username blank and use the password generated by the app.
• API Access: Include an Authorization: Bearer <TOKEN> header.

The secure token and password will be generated automatically on your first run and securely stored in your local genaigallery.db file. The credentials will be prominently printed in your terminal every time the server starts.

Development

Easiest way to develop is using Podman (docker alternative). Install podman and podman-compose and run:

podman-compose up

By default it runs the app in port 5775, but if that port is already used in your machine, create a file named .env with contents:

WEB_HOST_PORT=5776  # or any other number

After starting the app it will be available at http://localhost:5775 (adjust the port if necessary).