/librephotos

A self-hosted open source photo management service. This is the repository of the backend.

Primary LanguagePythonMIT LicenseMIT

Quality Gate Status Discord Website Read the docs GitHub contributors Translation status

LibrePhotos

Mockup designed by rawpixel.com / Freepik

Installation

Step-by-step installation instructions are available in our documentation

Contributions

  • Development: Get started contributing in less than 30 minutes by following the guide here
  • Documentation: Contributing to it is as simple as submitting a pull request to the documentation repository
  • Testing: If you want to help find bugs, use the dev tag and update it regulary. If you find one, open an issue.
  • Outreach: Talk about LibrePhotos with other people and help them to get started too!
  • Translation: LibrePhotos uses Weblate for its translations. Feel free to contribute or view existing translations at weblate.

Features

  • Support for all types of photos including raw photos
  • Support for videos
  • Timeline view
  • Scans pictures on the file system
  • Multiuser support
  • Generate albums based on events like "Thursday in Berlin"
  • Face recognition / Face classification
  • Reverse geocoding
  • Object / Scene detection
  • Semantic image search
  • Search by metadata

What does it use?

  • Image Conversion: ImageMagick
  • Video Conversion: FFmpeg
  • Exif Support: ExifTool
  • Face detection: face_recognition
  • Face classification/clusterization: scikit-learn
  • Image captioning: im2txt,
  • Scene classification places365
  • Reverse geocoding: Mapbox: You need to have an API key. First 50,000 geocode lookups are free every month.