6.4 KiB
6.4 KiB
Memories: Photo Management for Nextcloud
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.
- 📹 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.
🚀 Installation
- Install the app from the Nextcloud app store.
- Perform the recommended configuration steps.
- Run
php occ memories:index
to generate metadata indices for existing photos. - Open the 📷 Memories app in Nextcloud and set the directory containing your photos.
📱 Mobile Apps
- An Android client for Memories is available in early access on Google Play.
- For automatic uploads, you can use the official Nextcloud mobile apps.
- Android: Google Play, F-Droid
- iOS: App Store.
🏗 Development Setup
- ☁ Clone this into your
custom_apps
folder of your Nextcloud. - 📥 Install Composer and Node.js 18
- 👩💻 In a terminal, run the command
make dev-setup
to install the dependencies. - 🏗 To build/watch the UI, run
make watch-js
. - ✅ Enable the app through the app management of your Nextcloud.
- ⚒️ (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-cs-fixer
) - Psalm: For PHP static analysis (alternatively,
make psalm
) - Prettier: For autoformatting Vue and Typescript
- Volar: For Vue intellisense and static analysis
- Volar Typescript: For Vue Typescript support
🤝 Support the project
- 🌟 Star this repository: This is the easiest way to support Memories and costs nothing.
- 🪲 Report bugs: Report any bugs you find on the issue tracker.
- 📖 Translate: Help translate Memories into your language on Transifex.
- 📝 Contribute: Read and file or comment on an issue and ask for guidance.
- 🪙 Sponsorship: You can support the project financially at GitHub Sponsors.
A shout out to the current and past financial backers of Memories! See the sponsors page for a full list.
📝 Changelog
For the full changelog, see CHANGELOG.md.
🙏 Special Thanks
To the great folks building Nextcloud, PHP, Vue and all the other dependencies that make this project possible.
Thanks to GitHub, CircleCI and BrowserStack for sponsorship for Open Source projects for CI / testing on different devices.