memories/README.md

85 lines
6.0 KiB
Markdown
Raw Normal View History

2022-10-16 04:45:29 +00:00
![Screenshot](appinfo/screenshot.jpg)
2022-08-18 03:36:37 +00:00
2022-10-31 19:21:26 +00:00
# Memories: Photo Management for Nextcloud
2022-10-31 19:20:38 +00:00
[![Discord](https://dcbadge.vercel.app/api/server/7Dr9f9vNjJ)](https://discord.gg/7Dr9f9vNjJ)
[![Website](https://img.shields.io/website?down_color=red&down_message=offline&label=website&style=for-the-badge&up_color=brightgreen&up_message=online&url=https%3A%2F%2Fmemories.gallery)](https://memories.gallery)
[![Demo](https://img.shields.io/website?down_color=red&down_message=offline&label=demo&style=for-the-badge&up_color=brightgreen&up_message=online&url=https%3A%2F%2Fdemo.memories.gallery)](https://demo.memories.gallery/apps/memories/)
[![Nextcloud Store](https://img.shields.io/badge/nextcloud_store-blue?style=for-the-badge)](https://apps.nextcloud.com/apps/memories)
2022-10-31 19:20:38 +00:00
![GitHub](https://img.shields.io/github/license/pulsejet/memories)
[![GitHub issues](https://img.shields.io/github/issues/pulsejet/memories)](https://github.com/pulsejet/memories/issues)
2022-11-14 08:05:29 +00:00
[![GitHub Sponsor](https://img.shields.io/github/sponsors/pulsejet?logo=GitHub)](https://github.com/sponsors/pulsejet)
2022-10-20 00:35:03 +00:00
[![e2e](https://github.com/pulsejet/memories/actions/workflows/e2e.yaml/badge.svg)](https://github.com/pulsejet/memories/actions/workflows/e2e.yaml)
[![static analysis](https://github.com/pulsejet/memories/actions/workflows/static-analysis.yaml/badge.svg)](https://github.com/pulsejet/memories/actions/workflows/static-analysis.yaml)
![Shepherd](https://shepherd.dev/github/pulsejet/memories/coverage.svg)
Memories is a _batteries-included_ photo management solution for Nextcloud with advanced features
## 🎁 Features
2022-08-13 01:58:37 +00:00
2022-10-28 19:11:08 +00:00
- **📸 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](https://github.com/nextcloud/recognize) and [facerecognition](https://github.com/matiasdelellis/facerecognition).
2022-10-28 19:11:08 +00:00
- **🖼️ Albums**: Create albums to group photos and videos together. Then share these albums with others.
2022-10-31 19:09:28 +00:00
- **🫱🏻‍🫲🏻 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.
2023-03-09 00:16:45 +00:00
- **✏️ Edit Metadata**: Edit dates and other metadata on photos quickly and in bulk.
2022-10-28 19:11:08 +00:00
- **📦 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.
2023-02-09 19:16:03 +00:00
- **🗺️ 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.
2022-08-13 01:58:37 +00:00
2022-08-16 01:28:40 +00:00
## 🚀 Installation
2022-08-13 01:58:37 +00:00
1. Install the app from the Nextcloud [app store](https://apps.nextcloud.com/apps/memories).
1. Perform the recommended [configuration steps](https://memories.gallery/config/).
1. Run `php occ memories:index` to generate metadata indices for existing photos.
2022-10-31 19:09:28 +00:00
1. Open the 📷 Memories app in Nextcloud and set the directory containing your photos.
2022-08-13 01:58:37 +00:00
## 📱 Mobile Apps
An Android client for Memories is available in early access on [Google Play](https://play.google.com/store/apps/details?id=gallery.memories).
For automatic uploads, you can use the official Nextcloud mobile apps. These are available for [Android](https://play.google.com/store/apps/details?id=com.nextcloud.client) ([F-Droid](https://f-droid.org/en/packages/com.nextcloud.client/)) and [iOS](https://apps.apple.com/us/app/nextcloud/id1125420102).
2022-10-31 19:09:28 +00:00
## 🏗 Development Setup
2022-08-13 01:58:37 +00:00
2023-03-08 04:49:39 +00:00
1. ☁ Clone this into your `custom_apps` folder of your Nextcloud.
2023-09-29 18:20:58 +00:00
1. 📥 Install [Composer](https://getcomposer.org/) and [Node.js 18](https://nodejs.org)
2022-08-16 01:28:40 +00:00
1. 👩‍💻 In a terminal, run the command `make dev-setup` to install the dependencies.
1. 🏗 To build/watch the UI, run `make watch-js`.
2022-08-16 01:28:40 +00:00
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](https://marketplace.visualstudio.com/items?itemName=bmewburn.vscode-intelephense-client): For PHP intellisense and static analysis
- [PHP-CS-Fixer](https://marketplace.visualstudio.com/items?itemName=muuvmuuv.vscode-just-php-cs-fixer): For PHP formatting (alternatively, `make php-cs-fixer`)
- [Psalm](https://marketplace.visualstudio.com/items?itemName=getpsalm.psalm-vscode-plugin): For PHP static analysis (alternatively, `make psalm`)
- [Prettier](https://marketplace.visualstudio.com/items?itemName=esbenp.prettier-vscode): For autoformatting Vue and Typescript
- [Volar](https://marketplace.visualstudio.com/items?itemName=Vue.volar): For Vue intellisense and static analysis
- [Volar Typescript](https://marketplace.visualstudio.com/items?itemName=Vue.vscode-typescript-vue-plugin): For Vue Typescript support
2022-08-13 01:58:37 +00:00
## 🤝 Support the project
2022-10-31 19:20:38 +00:00
2022-11-14 07:48:44 +00:00
1. **🌟 Star this repository**: This is the easiest way to support Memories and costs nothing.
1. **🪲 Report bugs**: Report any bugs you find on the issue tracker.
1. **📝 Contribute**: Read and file or comment on an issue and ask for guidance.
1. **🪙 Sponsorship**: You can support the project financially at [GitHub Sponsors](https://github.com/sponsors/pulsejet).
2022-10-31 19:20:38 +00:00
2022-11-14 08:03:46 +00:00
A shout out to the current and past financial backers of Memories! See the sponsors page for a full list.
[<img src="https://github.com/mpodshivalin.png" width="42" />](https://github.com/mpodshivalin)
2023-01-15 21:49:16 +00:00
[<img src="https://github.com/k1l1.png" width="42" />](https://github.com/k1l1)
2023-03-08 18:53:03 +00:00
[<img src="https://github.com/ChickenTarm.png" width="42" />](https://github.com/ChickenTarm)
[<img src="https://github.com/ChildLearningClub.png" width="42" />](https://github.com/ChildLearningClub)
[<img src="https://github.com/mpanhans.png" width="42" />](https://github.com/mpanhans)
2022-11-14 08:03:46 +00:00
## 📝 Changelog
2022-11-14 17:54:19 +00:00
For the full changelog, see [CHANGELOG.md](CHANGELOG.md).
## 🙏 Special Thanks
2022-10-28 19:11:08 +00:00
To the great folks building Nextcloud, PHP, Vue and all the other dependencies that make this project possible.