Photon Screenshot Dashboard

A modern, self-hosted PHP screenshot and media management dashboard with powerful organization features, sharing capabilities, and a clean web interface.

The project consists of three main components:

Photon Dashboard (photon): Web interface for managing screenshots.
Photon Worker (worker): Background processes (OCR and thumbnail generation).
MariaDB Database (db): Stores metadata and application data.

Keep up-to-date on new releases by following the changelog.

Features

Smart Organization: Organize screenshots with folders and tags.
Advanced Search: Find images quickly by name or content using OCR.
Easy Sharing: Built-in public sharing URLs.
Media Support: JPG, PNG, GIF, and MP4 (experimental) file support.
Bulk Operations: Select and manage multiple files at once.
Sorting Options: Sort by date, size, or filename.
Trash Management: Safe deletion with trash functionality.
Background Processing: Dedicated worker for compression and OCR processing.
Database Storage: MariaDB backend for reliable data persistence.

An external authentication proxy is recommended to protect your dashboard from unwanted eyes.

Quick Start

Clone the repository

git clone <repository-url>
cd photon-dashboard

Configure environment

cp .env.example .env
# Edit .env with your settings

Create data directory

mkdir data
# Copy your screenshots to ./data/

Deploy with Docker Compose

docker-compose -f examples/compose-default.yml up -d

Access the dashboard
- Open http://localhost:8090 in your browser

Configuration

Deployment Options

Standard Deployment

Use examples/compose-default.yml for simple deployments:

docker-compose -f examples/compose-default.yml up -d

Traefik – Custom Domains

Use examples/compose-traefik.yml for reverse proxy setups, authentication and custom domains.

Project Structure

photon-dashboard/
├── examples/
│   ├── compose-default.yml    # Default example for basic usage.
│   ├── compose-traefik.yml    # Traefik example for custom domain routing.
│   └── .env.example           # Environment configuration
│
└── changelog.md               # Version history

Updates

Container images are available at:

Dashboard: git.jrdn.dev/photon/photon-dashboard:latest
Worker: git.jrdn.dev/photon/photon-worker:latest

View version history: Container Registry

Logs

# View photon logs
docker logs photon_dashboard

# View worker logs  
docker logs photon_worker

# View database logs
docker logs photon_db

3.2 KiB Raw Blame History Unescape Escape