Setup Guide — Fine Print

Prerequisites

Go 1.22+ — go.dev/dl
Node.js 20+ — nodejs.org
CUPS — Pre-installed on macOS. On Linux: sudo apt install cups

Development

            
# Clone the repo
git clone https://github.com/scout-kit/fine-print.git
cd fine-print

# Install Go and Node dependencies
make deps

# Run in dev mode (port 8080, no hotspot)
make dev

# With HTTPS for camera access
FINEPRINT_TLS=1 FINEPRINT_PORT=8443 make dev
            
        

Production Build

            
# Build frontend + Go binary
make all

# Output: bin/fine-print (single binary)
./bin/fine-print -config config.yml

Raspberry Pi

            
# Cross-compile for ARM64
make build-pi

# Copy to Pi and run
scp bin/fine-print-linux-arm64 pi@raspberrypi:~/fine-print
ssh pi@raspberrypi
./fine-print -config config.yml
            
        

Service Installation

Install as a system service that starts on boot:

            
# Build first
make all

# Install service (detects macOS/Linux)
sudo ./scripts/install-service.sh

This installs the binary to /usr/local/bin/fine-print, creates config at /etc/fine-print/config.yml, and sets up launchd (macOS) or systemd (Linux).

Configuration

Copy the example config and customize:


cp configs/fine-print.example.yml config.yml

Setting	Default	Description
`server.port`	80	HTTP port
`database.driver`	sqlite	sqlite or mysql
`admin.password`	changeme	Initial admin password
`tls.enabled`	false	Auto-generate HTTPS cert
`printer.media`	4x6	Print media size
`hotspot.ssid`	Fine Print	WiFi network name

Environment variables override config: FINEPRINT_DEV=1, FINEPRINT_PORT=8080, FINEPRINT_TLS=1, etc.

First Run

Start the app and open it in a browser
Go to /admin and log in with the default password
Go to Settings — detect and enable a printer
Go to Projects — create a project (standard or photo booth)
Configure the project template (overlays, text, colors)
Share the project link or QR code with guests