3cd2402c4e | ||
---|---|---|
.github | ||
.tx | ||
.vscode | ||
appinfo | ||
docs | ||
e2e | ||
img | ||
l10n | ||
lib | ||
patches | ||
scripts | ||
src | ||
templates | ||
.gitattributes | ||
.gitignore | ||
.l10nignore | ||
.npmignore | ||
.php-cs-fixer.php | ||
.prettierrc | ||
CHANGELOG.md | ||
COPYING | ||
Makefile | ||
README.md | ||
composer.json | ||
composer.lock | ||
exiftest.jpg | ||
mkdocs.yml | ||
package-lock.json | ||
package.json | ||
playwright.config.ts | ||
psalm-ls.xml | ||
psalm.xml | ||
tsconfig.json | ||
webpack.config.ts |
README.md
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.
- 📝 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.