photos/README.md

2.0 KiB

Nextcloud Photos

📸 Your memories under your control

Work in progress screenshot of Nextcloud Photos App

Why is this so awesome?

  • 📸 Beautiful Photo and Video Timeline
  • Favorites and Tagging: Favorite and tag your photos!
  • Slideshow and easy sharing: Show slideshows and share your photos or albums easily
  • Albums: Create albums from your contents

🚀 Installation

In your Nextcloud, simply enable the Photos app through the Apps management. The Nextcloud Photos app is included in Nextcloud 18 and higher.

Optional add-ons that make the Photos app even better:

  • Install Recognize for Nextcloud for AI-powered automatic face and object recognition. Includes automated tagging/categorizing.
  • Install the preview generator if pre-generating thumbnails is desired.
  • Install Imaginary to speed up preview generation.

Mobile Photos

Use the Android/iOS App to view your photos. It's possible to auto-upload them.

Maintainers

If you'd like to join, just go through the issues list and fix some!

🏗 Development setup

This app requires the Viewer app to be installed and enabled. Follow its development setup and then continue here.

  1. ☁ Clone this into your apps folder of your Nextcloud.
  2. 👩‍💻 In a terminal, run the command make dev-setup to install the dependencies.
  3. 🏗 Then to build the Javascript whenever you make changes, run make build-js. To create a pull request use make build-js-production. Watch changes with: make watch-js.
  4. Enable the app through the app management of your Nextcloud.
  5. 🎉 Partytime!
  6. 💻 Fix easily linting issues with npm run lint:fix.