README

!Screenshot

 Memories: Photo Management for Nextcloud






!GitHub










Memories is a _batteries-included_ photo management solution for Nextcloud with advanced features

 🎁 Features

- 📸 Timeline: Sort photos and videos by date taken, parsed from Exif data.
- ⏪ Rewind: Jump to any time in the past instantly and relive your memories.
- 🤖 AI Tagging: Group photos by people and objects, powered by recognize and facerecognition.
- 🖼️ Albums: Create albums to group photos and videos together. Then share these albums with others.
- 🫱🏻‍🫲🏻 External Sharing: Share photos and videos with people outside of your Nextcloud instance.
- 📱 Mobile Support: Work from any device, of any shape and size through the web app.
- ✏️ Edit Metadata: Edit dates and other metadata on photos quickly and in bulk.
- 📦 Archive: Store photos you don't want to see in your timeline in a separate folder.
- 📸 Advanced Formats: Support for Ultra-HDR and RAW image formats.
- 📹 Video Transcoding: Transcode videos and use HLS for maximal performance.
- 🗺️ Map: View your photos on a map, tagged with accurate reverse geocoding.
- 📦 Migration: Migrate easily from Nextcloud Photos and Google Takeout.
- ⚡️ Performance: Do all this very fast. Tested on instances with over a million photos.

 🚀 Installation

1. Install the app from the Nextcloud app store.
1. Perform the recommended configuration steps.
1. Run php occ memories:index to generate metadata indices for existing photos.
1. Open the 📷 Memories app in Nextcloud and set the directory containing your photos.

 📱 Mobile Apps

- An Android client for Memories is available on Google Play, F-Droid or GitHub Releases.
- For automatic uploads, you can use the official Nextcloud mobile apps. 
   - Android: Google Play, F-Droid
   - iOS: App Store.

 🏗 Development Setup

You can use the dev container to quickly fire up an instance of Nextcloud with Memories pre-installed.
See .devcontainer/README.md for more information.



To set up a development instance manually, follow these steps:

1. ☁ Clone this monorepo into the custom_apps folder of your Nextcloud.
1. 📥 Install Composer and Node.js
1. 👩‍💻 In a terminal, run the command make dev-setup to install the dependencies.
1. 🏗 To build/watch the UI, run make watch-js.
1. ✅ Enable the app through the app management of your Nextcloud.
1. ⚒️ (Strongly recommended) use VS Code for development and install these extensions (Ctrl+Shift+P  Show Recommended Extensions).
   - PHP Intelephense: For PHP intellisense and static analysis
   - PHP-CS-Fixer: For PHP formatting (alternatively, make php-format)
   - Psalm: For PHP static analysis (alternatively, make psalm)
   - Prettier: For autoformatting Vue and Typescript
   - Volar: For Vue intellisense and static analysis
1. If using PHP Intelephense, search for @builtin php-language-features in the extensions tab and disable it.

This monorepo is organized into the following packages:
- lib: Backend and database migrations (PHP).
- src: Frontend fo

Top issues

Latest release

Hotfix release for v11.1.1. See the changelog.
Full Changelog: https://github.com/pulsejet/memories/compare/v11.1.1...v11.1.2