sanspie/photodock
1
0
Fork 0
mirror of https://github.com/Alexander-D-Karpov/photodock.git synced 2026-03-16 22:06:35 +03:00
Code Issues Actions Packages Projects Releases Wiki Activity
a small self-hosted photo gallery written with go
10 Commits 1 Branch 0 Tags 138 KiB
Go 40.3%
HTML 24.8%
JavaScript 20.3%
CSS 14.2%
Makefile 0.2%
Other 0.2%
master
Go to file
sanspie 963aa23b8c major stats and internal improvements
2026-03-09 23:52:18 +03:00
cmd/photodock major stats and internal improvements 2026-03-09 23:52:18 +03:00
internal major stats and internal improvements 2026-03-09 23:52:18 +03:00
.env.example initial commit 2025-12-29 01:16:11 +03:00
.gitignore folder and cache refactoring 2025-12-29 17:48:38 +03:00
docker-compose.yml folder and cache refactoring 2025-12-29 17:48:38 +03:00
Dockerfile refactor: update navigation links and improve viewer functionality 2025-12-29 13:06:19 +03:00
go.mod initial commit 2025-12-29 01:16:11 +03:00
go.sum initial commit 2025-12-29 01:16:11 +03:00
Makefile refactor: update navigation links and improve viewer functionality 2025-12-29 13:06:19 +03:00
nginx.conf folder and cache refactoring 2025-12-29 17:48:38 +03:00
photodock.service initial commit 2025-12-29 01:16:11 +03:00
README.md refactor: update navigation links and improve viewer functionality 2025-12-29 13:06:19 +03:00

README.md

PhotoDock

A self-hosted photo gallery with automatic organization, EXIF extraction, and thumbnail generation.

Features

  • Automatic scanning - Recursively scans directories for photos
  • EXIF extraction - Extracts and displays camera metadata (camera model, lens, aperture, shutter speed, ISO, etc.)
  • GPS stripping - Automatically removes GPS data from photos for privacy
  • Thumbnail generation - Creates small and medium thumbnails with lazy loading
  • Blurhash placeholders - Generates blur placeholders for smooth image loading
  • Folder organization - Hierarchical folder structure with cover photos
  • Admin panel - Web-based management interface
  • SEO-friendly URLs - Clean URL paths for photos and folders
  • Responsive design - Works on desktop and mobile
  • Dark mode - Automatic dark/light theme based on system preference
  • Photo viewer - Full-screen viewer with zoom, pan, and keyboard navigation
  • Chunked uploads - Support for large file uploads

Requirements

  • Go 1.23+
  • PostgreSQL 12+

Installation

From source

git clone https://github.com/Alexander-D-Karpov/photodock.git
cd photodock
go build -o photodock ./cmd/photodock

Configuration

Variable Description Required
DATABASE_URL PostgreSQL connection string Yes
MEDIA_ROOT Directory containing your photos Yes
CACHE_DIR Directory for thumbnails and cache (defaults to MEDIA_ROOT/.photodock_cache) No
LISTEN_ADDR Address to listen on (default :8080) No
ADMIN_USER Admin username (default admin) No
ADMIN_PASS Admin password Yes

Database setup

createdb photodock

The application automatically runs migrations on startup.

Running

./photodock

Or with systemd (see photodock.service):

sudo cp photodock.service /etc/systemd/system/
sudo systemctl daemon-reload
sudo systemctl enable --now photodock

Usage

Web interface

  • Gallery: /
  • Admin panel: /admin

Admin panel

The admin panel allows you to:

  • Scan folders for new photos
  • Upload photos via drag-and-drop
  • Organize photos into folders
  • Edit photo metadata (title, description, notes)
  • Set folder cover photos
  • Hide/show photos
  • Delete photos and folders
  • Clean orphaned database entries