2020-01-07 10:22:34 +00:00
# Nextcloud Photos
2020-01-17 11:24:08 +00:00
2019-12-20 09:46:46 +00:00
**📸 Your memories under your control**
2019-11-04 17:54:03 +00:00
2020-01-17 11:24:08 +00:00
![Work in progress screenshot of Nextcloud Photos App ](screenshots/screenshot1.png )
2019-12-20 09:46:46 +00:00
## Why is this so awesome?
2020-01-17 11:24:08 +00:00
2020-10-31 03:16:09 +00:00
* **📸 Beautiful Photo and Video Timeline**
2020-01-17 11:24:08 +00:00
* **⭐ Favorites and Tagging:** Favorite and tag your photos!
2022-04-05 16:38:59 +00:00
* **Slideshow and easy sharing:** Show slideshows and share your photos or albums easily
2020-01-17 11:24:08 +00:00
* **Albums:** Create albums from your contents
## 🚀 Installation
2020-01-14 22:29:37 +00:00
In your Nextcloud, simply enable the Photos app through the Apps management.
2024-02-28 07:20:45 +00:00
The Nextcloud Photos app is included in Nextcloud 18 and higher.
2020-01-14 22:29:37 +00:00
2023-06-20 21:05:44 +00:00
Optional add-ons that make the Photos app even better:
* Install [Recognize for Nextcloud ](https://github.com/nextcloud/recognize ) for AI-powered automatic face and object recognition. Includes automated tagging/categorizing.
* Install the [preview generator ](https://github.com/rullzer/previewgenerator ) if pre-generating thumbnails is desired.
* Install [Imaginary ](https://docs.nextcloud.com/server/latest/admin_manual/installation/server_tuning.html#previews ) to speed up preview generation.
2020-01-17 11:24:08 +00:00
2019-12-20 09:46:46 +00:00
## Mobile Photos
2020-01-17 11:24:08 +00:00
2020-01-08 09:25:28 +00:00
Use the Android/iOS App to view your photos. It's possible to auto-upload them.
2019-12-20 09:46:46 +00:00
2020-01-17 11:24:08 +00:00
## Maintainers
* [John Molakvoæ ](https://github.com/skjnldsv )
If you'd like to join, just go through the [issues list ](https://github.com/nextcloud/photos/issues ) and fix some!
2019-12-20 09:46:46 +00:00
## 🏗 Development setup
2020-01-17 11:24:08 +00:00
2023-12-13 10:33:16 +00:00
This app requires the [Viewer app ](https://github.com/nextcloud/viewer ) to be installed and enabled.
2023-12-06 13:25:12 +00:00
Follow its development setup and then continue here.
2020-01-17 11:24:08 +00:00
1. ☁ Clone this into your `apps` folder of your Nextcloud.
1. 👩💻 In a terminal, run the command `make dev-setup` to install the dependencies.
2021-02-26 06:44:54 +00:00
1. 🏗 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` .
2020-01-17 11:24:08 +00:00
1. ✅ Enable the app through the app management of your Nextcloud.
1. 🎉 Partytime!
1. 💻 Fix easily linting issues with `npm run lint:fix` .