{"id":45800606,"url":"https://github.com/xxroxxerxx/integration_immich","last_synced_at":"2026-05-11T11:06:21.081Z","repository":{"id":340347885,"uuid":"1165518127","full_name":"xXRoxXeRXx/integration_immich","owner":"xXRoxXeRXx","description":"Browse your Immich photo library directly inside Nextcloud — timeline, albums, people, map and more.","archived":false,"fork":false,"pushed_at":"2026-05-08T13:46:30.000Z","size":6210,"stargazers_count":31,"open_issues_count":4,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2026-05-08T15:42:16.264Z","etag":null,"topics":["albums","app","gallery","immich","media","nextcloud","nextcloud-app","photos","php","selfhosted","vue"],"latest_commit_sha":null,"homepage":"","language":"Vue","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"agpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/xXRoxXeRXx.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"COPYING","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-02-24T08:52:26.000Z","updated_at":"2026-05-08T13:46:25.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/xXRoxXeRXx/integration_immich","commit_stats":null,"previous_names":["xxroxxerxx/integration_immich"],"tags_count":14,"template":false,"template_full_name":null,"purl":"pkg:github/xXRoxXeRXx/integration_immich","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/xXRoxXeRXx%2Fintegration_immich","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/xXRoxXeRXx%2Fintegration_immich/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/xXRoxXeRXx%2Fintegration_immich/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/xXRoxXeRXx%2Fintegration_immich/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/xXRoxXeRXx","download_url":"https://codeload.github.com/xXRoxXeRXx/integration_immich/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/xXRoxXeRXx%2Fintegration_immich/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32891989,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-10T13:40:02.631Z","status":"online","status_checked_at":"2026-05-11T02:00:05.975Z","response_time":120,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["albums","app","gallery","immich","media","nextcloud","nextcloud-app","photos","php","selfhosted","vue"],"created_at":"2026-02-26T12:38:28.164Z","updated_at":"2026-05-11T11:06:21.075Z","avatar_url":"https://github.com/xXRoxXeRXx.png","language":"Vue","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n\n\u003cimg src=\"img/app-dark.svg\" width=\"80\" alt=\"Immich Integration\"\u003e\n\n# Immich Integration for Nextcloud\n\n**Browse your [Immich](https://immich.app) photo library directly inside Nextcloud.**  \nTimeline, albums, people, map, explore — all seamlessly integrated.\n\n[![License: AGPL v3](https://img.shields.io/badge/License-AGPL%20v3-blue.svg)](COPYING)\n[![Nextcloud](https://img.shields.io/badge/Nextcloud-30%2B-0082C9?logo=nextcloud\u0026logoColor=white)](https://nextcloud.com)\n[![Immich](https://img.shields.io/badge/Immich-compatible-4AC37C)](https://immich.app)\n\n\u003c/div\u003e\n\n---\n\n## 📸 Screenshots\n\n\u003ctable\u003e\n  \u003ctr\u003e\n    \u003ctd align=\"center\"\u003e\u003cstrong\u003eTimeline\u003c/strong\u003e\u003c/td\u003e\n    \u003ctd align=\"center\"\u003e\u003cstrong\u003eAlbums\u003c/strong\u003e\u003c/td\u003e\n    \u003ctd align=\"center\"\u003e\u003cstrong\u003ePeople\u003c/strong\u003e\u003c/td\u003e\n  \u003c/tr\u003e\n  \u003ctr\u003e\n    \u003ctd\u003e\u003cimg src=\"screenshots/allmedia.png\" alt=\"Timeline view\" width=\"280\"\u003e\u003c/td\u003e\n    \u003ctd\u003e\u003cimg src=\"screenshots/album.png\" alt=\"Albums view\" width=\"280\"\u003e\u003c/td\u003e\n    \u003ctd\u003e\u003cimg src=\"screenshots/people.png\" alt=\"People view\" width=\"280\"\u003e\u003c/td\u003e\n  \u003c/tr\u003e\n\u003c/table\u003e\n\n---\n\n## ✨ Features\n\n| Feature | Description |\n| --- | --- |\n| 🖼️ **Timeline** | Lazy-loaded photo \u0026 video timeline, grouped by date with smooth infinite scroll |\n| 📁 **Albums** | Browse all your Immich albums with cover thumbnails, create, rename and delete albums |\n| 👤 **People** | Face recognition — explore your library by recognized person |\n| 🗺️ **Map** | Interactive map of all geotagged photos with cluster markers |\n| 🔍 **Explore** | Browse by city, country, state, object or tag |\n| 🔎 **Lightbox** | Full-screen viewer with keyboard navigation, pinch-to-zoom and EXIF metadata panel |\n| ⭐ **Favorites** | Mark and unmark photos as favorites directly from Nextcloud |\n| 🗑️ **Delete** | Delete files from Immich (moved to trash if enabled) via lightbox or selection menu |\n| 💾 **Save to Nextcloud** | Select photos and videos and save the originals directly to your Nextcloud Files |\n| ⬆️ **Upload to Immich** | Send photos and videos from Nextcloud Files to Immich via the file action menu |\n| ☑️ **Multi-select** | Select multiple assets across any view for batch operations |\n| 🌍 **Translations** | German, French, Spanish, Dutch and Portuguese included |\n| ⚙️ **Admin Settings** | Configure Immich server URL and API key per user |\n\n---\n\n## 🔧 Requirements\n\n- **Nextcloud** 27 or newer\n- **PHP** 8.2 or newer\n- A running [Immich](https://immich.app) instance (with API access enabled)\n\n---\n\n## 🚀 Installation\n\n### Via Nextcloud App Store *(recommended)*\n\n1. Open **Nextcloud → Apps → Search** for `Immich Integration`\n2. Click **Install**\n\n### Via Release Tarball (manual)\n\n1. Download `integration_immich.tar.gz` from the [latest release](https://github.com/xXRoxXeRXx/integration_immich/releases/latest)\n2. Extract into your Nextcloud `apps/` directory:\n   ```bash\n   tar -xzf integration_immich.tar.gz -C /path/to/nextcloud/apps/\n   ```\n3. Enable the app:\n   ```bash\n   php occ app:enable integration_immich\n   ```\n\n---\n\n## ⚙️ Configuration\n\n1. Open **Nextcloud → Personal Settings → Immich Integration**\n2. Enter your **Immich server URL** (e.g. `https://photos.example.com`)\n3. Enter your **API key** — found in Immich under *Account Settings → API Keys*\n4. Click **Test connection** to verify, then **Save**\n5. The **Immich** entry now appears in the Nextcloud top navigation\n\n### 🔑 Required Immich API Key Permissions\n\nWhen creating an API key in Immich (*Account Settings → API Keys → New API key*), the following permissions are required:\n\n| Permission | Used for |\n| --- | --- |\n| `asset.view` | Thumbnails and video streaming |\n| `asset.read` | Timeline, asset details, EXIF metadata |\n| `asset.update` | Mark / unmark favorites |\n| `asset.upload` | Upload files from Nextcloud to Immich |\n| `asset.download` | Download originals and archives to Nextcloud |\n| `asset.delete` | Delete assets from Immich (moves to trash if enabled) |\n| `album.read` | List all albums and album contents |\n| `album.create` | Create new albums |\n| `album.update` | Rename albums |\n| `album.delete` | Delete albums |\n| `albumAsset.create` | Add assets to albums |\n| `albumAsset.delete` | Remove assets from albums |\n| `person.read` | List recognized people and their thumbnails |\n| `map.read` | Load map markers for the Map view |\n\n\u003e **Tip:** Immich lets you create multiple API keys with different scopes. Creating a dedicated key for the Nextcloud integration (with only the permissions above) is recommended over using a full-access key.\n\u003e\n\u003e The connection validation on the settings page (`POST /auth/validateToken`) does not require any additional permission — it works with any valid API key.\n\n---\n\n## 🛠️ Development\n\n```bash\nnpm install\nnpm run dev      # development build (unminified)\nnpm run watch    # watch mode with hot rebuild\nnpm run build    # production build\n```\n\nThe app uses **Vue 3** + **Pinia** for state management and the official `@nextcloud/*` component libraries.\n\n---\n\n## 🤝 Contributing\n\nPull requests and bug reports are welcome!  \nPlease open an [issue](https://github.com/xXRoxXeRXx/integration_immich/issues) for feature requests or bug reports.\n\n---\n\n## 📄 License\n\nThis project is licensed under the [AGPL-3.0-or-later](COPYING) license.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fxxroxxerxx%2Fintegration_immich","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fxxroxxerxx%2Fintegration_immich","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fxxroxxerxx%2Fintegration_immich/lists"}