Jekyll Themes & Templates Logo Jekyll Themes & Templates
Photo Stream screenshot

Photo Stream

Author Avatar Theme by Waschinski
Updated: 8 Nov 2024
474 Stars

Self-hosted, super simple photo stream

Github Live Preview

Overview

Photo Stream is a self-hosted platform for sharing photos, originally created by @maxvoltar and now maintained by @waschinski, @boerniee, and their team. It provides an easy-to-use interface with no tracking and allows users to have full control over their photos.

Features

  • Lazy loading to save bandwidth
  • Supports PNG, JPG, JPEG, GIF, and WebP files
  • Photo tints for enhancing visual appeal
  • Keyboard shortcuts for easy navigation
  • Unique URLs for each photo
  • RSS feed integration for auto-posting to social networks
  • Drag, drop, commit workflow for adding photos
  • Optimized light and dark themes

Installation

Using Docker

  1. Pull the image from Docker Hub using the command docker pull [image-name].
  2. Alternatively, download the docker-compose.yml file and modify the configuration as necessary. Then, run the command docker-compose up -d to start Photo Stream.
  3. Mount the photos folder as a volume, ensuring that your photos are placed in a subfolder called original.

Manually

  1. Download the latest version of Photo Stream from the release page and extract it.
  2. Ensure that you meet the following requirements:
    • Build tools: Install these based on your operating system. Debian users can use sudo apt-get install build-essential, while MacOS users can use xcode-select --install.
    • Ruby (v3+ recommended): Check if Ruby is already installed by running ruby -v. If not, follow the installation instructions provided here.
    • libvips: Install libvips using the instructions provided here.
    • Jekyll: Install Jekyll by running gem install bundler jekyll in the terminal.

Summary

Photo Stream is a self-hosted platform for sharing photos. It offers various features like lazy loading, support for multiple image formats, keyboard shortcuts, and social media integration. The installation process can be done either using Docker or manually. With Photo Stream, users have full control over their photos and can easily create their own photo sharing website.