52 lines
No EOL
1.7 KiB
Markdown
52 lines
No EOL
1.7 KiB
Markdown
# Immich Selfie Timelapse Tool
|
|
|
|
This tool helps create selfie timelapses from your Immich instance.
|
|
It uses the powerful machine learning features of Immich to gather all the photographs where a particular individual appears, retrieves the bounding box metadata, and automatically crops and aligns the photos.
|
|
|
|
<p align="center">
|
|
<img src="resources/example.jpg" alt="Example Image">
|
|
</p>
|
|
|
|
<p align="center">
|
|
<img src="resources/example_gif.gif" alt="Example GIF">
|
|
</p>
|
|
|
|
|
|
## Features
|
|
|
|
- Automatically fetch images featuring a specified individual from your Immich instance.
|
|
- Extract bounding box metadata and crop/align photos using machine learning.
|
|
- Discard photos with low resolution (set by threshold).
|
|
- Discard photos where the subject is viewed from the side.
|
|
- Adds timestamp in the filename for easy chronological ordering.
|
|
|
|
## Docker compose setup
|
|
|
|
```yml
|
|
services:
|
|
immich-selfie-timelapse:
|
|
image: arnaudcayrol/immich-selfie-timelapse
|
|
container_name: immich-selfie-timelapse
|
|
ports:
|
|
- "5000:5000"
|
|
volumes:
|
|
- ./immich_selfie_timelapse:/app/output
|
|
environment:
|
|
- IMMICH_API_KEY=abcdefghijklmnopqrstuvwxyz
|
|
- IMMICH_BASE_URL=http://192.168.1.94:2283/api
|
|
```
|
|
|
|
Once the service is started, access the webpage to configure the tool: http://127.0.0.1:5000.
|
|
|
|
<p align="center">
|
|
<img src="resources/webpage.jpg" alt="Example GIF">
|
|
</p>
|
|
|
|
## Additional Notes
|
|
|
|
- For best looking results, I still recommand a manual pass over the final image folder to remove some outliers. The face orientation detection is not perfect at all. Hopefully someday I can get a better results.
|
|
- Contributions and improvements are welcome.
|
|
|
|
## License
|
|
|
|
This project is open source and available under the MIT License. |