Our take
- Activity
- 19
- Community
- 26
- Issues
- 21
- Pull requests
- 20
+6 stars in the last 30 days
- Fewer contributors than 86% of the projects we track
Project history
Daily GitHub snapshots since Oct 7, 2026. History covers stars and forks; health signals are not tracked historically.
Stars
636Forks
34Change since Nov 17, 2026: 0 stars·0 forks
Overview
immich-drop provides a guest-facing upload page for an Immich server. An administrator creates public-by-URL invite links, which recipients can use to send photos and videos without creating an account or receiving access to browse the server’s media.
It suits Immich owners who need a simple way to gather files from friends, family, or event participants. Uploads are handled by a Python web app using a server-side Immich API key, with session-local status rather than a media library interface.
Key Features
- Create invite links that can be one-time or reusable, with optional expiry and passwords.
- Upload files to Immich, optionally assigning them to a configured or invite-specific album.
- Show per-file upload progress through WebSockets and retry failed uploads.
- Check for duplicates using a local SHA-1 cache and optionally Immich’s bulk upload check.
- Support optional chunked uploads for large files.
- Provide a responsive uploader with dark mode and drag-and-drop or file selection.
- Keep the Immich API key on the server and limit displayed upload items to the current session.
Use Cases
- Immich administrators collecting photos from guests who should not need an Immich account.
- Families or groups sharing an invite link for a gathering, with uploads directed to an album.
- Event organizers collecting participant photos while avoiding a shared media-browsing account.
- Self-hosters receiving large files through a reverse-proxy setup where chunked uploads may help with upload-size limits.
Getting Started
The project provides a Docker image and Compose setup. Configure the Immich API URL and API key, then start the service:
docker compose pull
docker compose up -d
See the README for configuration, local development, and deployment details.
Alternatives
| Project | Language | License | Stars | Status |
|---|---|---|---|---|
| immich-drop | Python | MIT | 627 | Not checked yet |
| Lychee | PHP | MIT | 4.3k | Active |
| zipline | TypeScript | MIT | 3.5k | Active |
Considerations
- Requires a running Immich server and an API key with the permissions needed for the selected upload and album features.
- Invite links are public to anyone who has the URL. Optional invite passwords are available, but links should still be shared carefully.
- Production deployment should use HTTPS and a suitably restricted reverse proxy configuration.
- The app does not provide media browsing. Its uploader shows only uploads associated with the current browser session.
- The project is not archived, but repository activity and issue counts do not by themselves establish maintenance guarantees.
Found this useful?
Share it with someone who would like immich-drop.