Skip to content

πŸš€ Self-hosted photo sharing platform for photographers & events. Open-source alternative to PicDrop/Scrapbook with time-limited galleries, password protection, custom branding & no monthly fees. Built with React + Node.js πŸ“Έ

License

Notifications You must be signed in to change notification settings

laurinberli/picpeak

Β 
Β 

πŸ“Έ PicPeak - Open Source Photo Sharing for Events

PicPeak Logo

License: MIT Docker Node.js React

PicPeak is a powerful, self-hosted open-source alternative to commercial photo-sharing platforms like PicDrop.com and Scrapbook.de. Designed specifically for photographers and event organizers, PicPeak makes it simple to share beautiful, time-limited photo galleries with clients while maintaining full control over your data and branding.

PicPeak Gallery Preview

🌟 Why Choose PicPeak?

Unlike expensive SaaS solutions, PicPeak gives you:

  • πŸ’° No Monthly Fees - One-time setup, unlimited galleries
  • πŸ”’ Complete Data Control - Your photos stay on your server
  • 🎨 White-Label Ready - Full branding customization
  • πŸ“± Mobile-First Design - Beautiful on all devices
  • πŸš€ Lightning Fast - Optimized performance and caching
  • 🌍 Multi-Language - Built-in i18n support (EN, DE)

✨ Key Features

For Photographers

  • πŸ“ Drag & Drop Upload - Simply drop photos into folders
  • ⏰ Auto-Expiring Galleries - Set expiration dates (default: 30 days)
  • πŸ” Password Protection - Secure client galleries
  • πŸ“§ Automated Emails - Creation confirmations and expiration warnings
  • πŸ“Š Analytics Dashboard - Track views, downloads, and engagement
  • 🎨 Custom Themes - Match your brand perfectly

For Clients

  • πŸ–ΌοΈ Beautiful Galleries - Clean, modern interface
  • πŸ“± Mobile Optimized - Swipe through photos on any device
  • ⬇️ Bulk Downloads - Download all photos with one click
  • πŸ” Smart Search - Find photos quickly
  • πŸ“€ Guest Uploads - Optional client photo uploads

Technical Excellence

  • 🐳 Docker Ready - Deploy in minutes
  • πŸ”„ Auto-Processing - Automatic thumbnail generation
  • πŸ’Ύ Smart Storage - Automatic archiving of expired galleries
  • πŸ›‘οΈ Security First - JWT auth, rate limiting, CORS protection
  • πŸ“ˆ Scalable - From small studios to large agencies

πŸš€ Quick Start

Get PicPeak running in under 5 minutes:

# Clone the repository
git clone https://github.com/the-luap/picpeak.git
cd picpeak

# Copy environment template
cp .env.example .env

# Edit configuration (required: JWT_SECRET)
nano .env

# Start with Docker Compose
docker-compose up -d

# Access at http://localhost:3005

πŸ“– Documentation

🎯 Use Cases

Perfect for:

  • πŸ’’ Wedding Photographers - Share ceremony photos securely
  • πŸŽ‚ Event Photography - Birthday parties, corporate events
  • πŸ“Έ Portrait Studios - Client galleries with download limits
  • 🏒 Corporate Events - Internal photo sharing with branding
  • πŸŽ“ School Photography - Secure parent access with expiration

πŸ—οΈ Tech Stack

  • Backend: Node.js, Express, SQLite/PostgreSQL
  • Frontend: React, Tailwind CSS, Framer Motion
  • Storage: File-based with automatic archiving
  • Email: SMTP with customizable templates
  • Analytics: Privacy-focused with Umami integration

πŸ’» System Requirements

Minimum Requirements

  • CPU: 2 CPU cores
  • RAM: 2GB minimum
  • Storage: 20GB minimum (plus photo storage needs)
  • OS: Linux (Ubuntu 20.04+), macOS, or Windows with WSL2
  • Node.js: v18.0.0 or higher
  • Database: SQLite (included) or PostgreSQL 12+

Docker Requirements (Recommended)

  • Docker: v20.10.0+
  • Docker Compose: v2.0.0+

🀝 Contributing

We love contributions! PicPeak is built by photographers, for photographers. Whether you're fixing bugs, adding features, or improving documentation, your help is welcome.

See our Contributing Guide for details.

πŸ“Š Comparison with Alternatives

Feature PicPeak PicDrop Scrapbook.de
Self-Hosted βœ… ❌ ❌
Custom Branding βœ… Full Limited Limited
Monthly Cost $0 $29-199 €19-99
Storage Limit Unlimited* 50-500GB 100-1000GB
Client Uploads βœ… βœ… βœ…
API Access βœ… Paid ❌
Open Source βœ… ❌ ❌

*Limited only by your server storage

πŸ›‘οΈ Security

PicPeak takes security seriously:

  • πŸ” Password hashing with bcrypt
  • 🎫 JWT-based authentication
  • 🚦 Rate limiting on all endpoints
  • πŸ›‘οΈ CORS protection
  • πŸ“ Activity logging
  • πŸ”’ Secure file access

Found a security issue? Please open a security issue on GitHub

πŸ“Έ Screenshots

πŸŽ›οΈ Admin Dashboard

Get a complete overview of your photo galleries, analytics, and system status.

PicPeak Admin Dashboard

πŸ“Š Analytics & Insights

Track gallery performance, view statistics, and monitor user engagement.

PicPeak Analytics Dashboard

πŸ“ Event Management

Organize and manage your photo galleries with intuitive event management tools.

PicPeak Events Management

✨ Key Interface Highlights

πŸ‘† Click to see more interface details

What makes PicPeak's interface special:

  • 🎨 Clean Design: Modern, photographer-friendly interface
  • πŸ“± Responsive: Perfect on desktop, tablet, and mobile
  • ⚑ Fast Loading: Optimized for quick photo browsing
  • πŸ”’ Secure Access: Password-protected galleries with expiration
  • πŸ“€ Easy Uploads: Drag & drop functionality for effortless photo management
  • 🎯 Client-Focused: Intuitive gallery experience for your clients

πŸ—ΊοΈ Roadmap

We're constantly improving PicPeak and welcome contributions from our community! If you have ideas for new features or want to help implement existing ones, please open an issue or submit a pull request. Your contributions help make PicPeak better for everyone.

Feature Description Priority Status
Backup & Restore Comprehensive backup system with S3/MinIO support, automated scheduling, and safe restore functionality High βœ… Implemented
Gallery Templates Additional gallery layouts and themes (masonry, slideshow, story-style) for different event types Medium πŸ”„ Open
Face Recognition AI-powered face detection to help guests find their photos and create automatic person-based albums Low πŸ”„ Open
Gallery Feedback Allow guests to like, rate, and comment on photos with admin notifications and moderation Medium βœ… Implemented (not tested)
Video Support Upload and display videos alongside photos in galleries with streaming support Low πŸ”„ Open
Multiple Administrators Support for multiple admin accounts with role-based permissions and activity tracking Low πŸ“‹ Planned

Status Legend: βœ… Implemented | 🚧 In Progress | πŸ”„ Open | πŸ“‹ Planned

πŸ™ Acknowledgments

PicPeak is inspired by the best features of commercial platforms while remaining completely open source. Special thanks to all contributors who make this project possible.

πŸ€– AI-Assisted Development

This project was generated with the assistance of AI technology, but has been:

  • βœ… Fully tested end-to-end by human developers
  • πŸ”’ Security audited with comprehensive security checks
  • πŸ‘¨β€πŸ’» Human-reviewed for code quality and best practices
  • πŸ§ͺ Production-tested in real-world scenarios

We believe in transparent development practices and the responsible use of AI as a tool to accelerate development while maintaining high standards of quality and security.

πŸ“„ License

PicPeak is released under the MIT License. Use it freely for personal or commercial projects.

πŸš€ Ready to Get Started?

  1. ⭐ Star this repository to show your support
  2. πŸ“– Read the Deployment Guide
  3. πŸ› Report issues or request features
  4. 🀝 Join our community and contribute!

Made with ❀️ by photographers, for photographers
GitHub β€’ Documentation β€’ Support

About

πŸš€ Self-hosted photo sharing platform for photographers & events. Open-source alternative to PicDrop/Scrapbook with time-limited galleries, password protection, custom branding & no monthly fees. Built with React + Node.js πŸ“Έ

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • JavaScript 54.8%
  • TypeScript 44.5%
  • Other 0.7%