Repolode
Submit
xemle

xemle/home-gallery

Self-hosted web gallery for browsing personal photos and videos, with tagging, mobile-friendly UI, and similar-image and face search.

Open-source alternative to:Google Photos

View on GitHubWebsite
Stars
1,201
Forks
107
Open issues
54
Last commit
7 days ago

What is it?

HomeGallery is a self-hosted web gallery for browsing personal photos and videos. It is designed to run on your own machine or NAS, indexing media from one or more local source directories so that the originals never need to be served from a cloud service.

The gallery offers an endless photo stream with virtual scrolling, single and multi-select tagging, and an expressive query language with and, or, and not operators. It also provides reverse image lookup to find visually similar photos, face detection with search by similar faces, reverse geocoding of GPS coordinates to addresses, and video transcoding. The interface works as a PWA on phones.

Media are identified by content, so duplicate files are processed once and renames do not trigger re-generation of previews. Metadata can be exported to XMP sidecar files, and the gallery can be exported as a static site. Installation is available as prebuilt binaries for Linux, macOS and Windows, or as a Docker image.

Key features

  • 01Endless photo stream with virtual scrolling
  • 02Tagging with single and multi selection
  • 03Similar image search and face search
  • 04Video transcoding and Chromecast streaming
  • 05GEO location reverse lookup
  • 06Content-based deduplication and fast change detection
  • 07Export to XMP sidecar files and static sites

Use cases

  • Browsing a family photo archive stored on a home NAS from a phone
  • Finding similar sunset or food photos in a large personal library without manual tagging
  • Serving media from offline or read-only external drives after a one-time indexing
  • Publishing a static snapshot of a photo collection

Quick start

  1. 1

    Download the prebuilt binary

    curl -sL https://dl.home-gallery.org/dist/latest/home-gallery-latest-linux-x64 -o gallery
  2. 2

    Make the binary executable

    chmod 755 gallery
  3. 3

    Init the configuration with your media source

    ./gallery init --source ~/Pictures
  4. 4

    Start the server, then open localhost:3000

    ./gallery run server

Things to know

  • The whole media database is loaded into the browser, so very large libraries may perform poorly.
  • Object detection and face recognition use the project's public API by default, which sends preview images off your machine unless you run it locally.
  • The project describes itself as a private spare-time project without any warranty.

Topics

#self-hosted#photo-gallery#face-recognition#image-search#tagging#video#nodejs#pwa#calculate-previews#exif

FAQ

What is home-gallery?
Self-hosted web gallery for browsing personal photos and videos, with tagging, mobile-friendly UI, and similar-image and face search. HomeGallery is a self-hosted web gallery for browsing personal photos and videos. It is designed to run on your own machine or NAS, indexing media from one or more local source directories so that the originals never need to be served from a cloud service.
Is home-gallery free to use? What license does it have?
home-gallery is open source under the MIT license. Check the license terms before using it in commercial products.
Is home-gallery still maintained?
Actively maintained. The last commit to home-gallery was on Oct 13, 2026.
What can I use home-gallery for?
Browsing a family photo archive stored on a home NAS from a phone Finding similar sunset or food photos in a large personal library without manual tagging Serving media from offline or read-only external drives after a one-time indexing Publishing a static snapshot of a photo collection
How do I install home-gallery?
Download the prebuilt binary: curl -sL https://dl.home-gallery.org/dist/latest/home-gallery-latest-linux-x64 -o gallery Make the binary executable: chmod 755 gallery Init the configuration with your media source: ./gallery init --source ~/Pictures Start the server, then open localhost:3000: ./gallery run server
Where can I get home-gallery?
The source code and installation instructions are on GitHub: https://github.com/xemle/home-gallery

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects