✅ Feature Toggles
LibrePhotos feature toggles
In some cases you might want to enable or disable certain LibrePhotos features to preserve hardware resources or make use of some more advanced features. You can do that by referring to the following table.
Feature toggles are implemented as environment variables you would have to configure before starting up backend.
| Feature | Description | Status | Environment variable |
|---|---|---|---|
| Embedded media | Extract embedded media from "live photos" | 🟢 | FEATURE_PROCESS_EMBEDDED_MEDIA=true |
| Video | Import video files during a scan | 🟢 | FEATURE_VIDEO=true |
| Face detection | Find faces in your photos | 🟢 | FEATURE_FACE_DETECTION=true |
| Face clustering | Group the faces that were found into people you can label | 🟢 | FEATURE_FACE_CLUSTER=true |
| Image captioning | Describe photos with an automatically generated caption | 🟢 | FEATURE_IMAGE_CAPTIONING=true |
| Reverse geocoding | Turn GPS coordinates into place names | 🟢 | FEATURE_REVERSE_GEOCODING=true |
| Scene classification | Tag photos by what is in them (beach, kitchen, sunset, ...) | 🟢 | FEATURE_SCENE_CLASSIFICATION=true |
All of these default to on. See Advanced docker-compose usage for what turning each one off actually stops, and for the matching .env keys of the bundled Compose setup.
The Embedded media switch is checked only the first time a file is imported. Enabling it on a library that has already been scanned extracts nothing for the photos that are already there, not even with Rescan All Photos, which skips extraction for files it has already imported. Only files added afterwards are affected. Turning it off never removes clips that were already extracted; those stay on disk under protected_media/embedded_media/.
Legend
| 🟢 | Implemented |
| 🔴 | Planned, not implemented |
| 🟡 | In progress |
| ⚪ | Not planned |