HEIC: Support spatial images as used for Apple Vision Pro #2046

New issue

Open

opened 2026-02-20 01:05:05 -05:00 by deekerman · 2 comments

deekerman commented

2026-02-20 01:05:05 -05:00

Owner

Originally created by @ChXWu on GitHub (Mar 23, 2024).

Describe what problem this solves and why this would be valuable to many users

As apple introduce spacial computing, more apple devices can shoot spacial photos in heic format.

Currently convert command in photoprism will create two sidecar file "IMG_0001.HEIC-1.jpg","IMG_0001.HEIC-2.jpg"from a single spacial photo named IMG_0001.HEIC.

logs being
time="2024-03-23T00:00:00" level=info msg="convert: converting IMG_0001.HEIC to IMG_0001.HEIC.jpg (heif-convert)"
time="2024-03-23T00:00:00" level=error msg="convert: no such file or directory for Mobile/ICloud/2024/01/01/IMG_0001.HEIC"

which seems like photoprism successfully creates two sidecar from one spacial photo but failed to make a connection due to their unusal naming. This would cause missing index and photo in the gallery

Describe the solution you'd like
Stack IMG_0001.HEIC,IMG_0001.HEIC-1.jpg,IMG_0005.HEIC-2.jpg together and index it properly.

Describe alternatives you've considered

An simpler solution would just be naming IMG_0001.HEIC-1.jpg as IMG_0001.HEIC.jpg and treat it as the only side car file.

Additional context
/

Originally created by @ChXWu on GitHub (Mar 23, 2024). **Describe what problem this solves and why this would be valuable to many users** As apple introduce spacial computing, more apple devices can shoot spacial photos in heic format. Currently convert command in photoprism will create two sidecar file "IMG_0001.HEIC-1.jpg","IMG_0001.HEIC-2.jpg"from a single spacial photo named IMG_0001.HEIC. logs being time="2024-03-23T00:00:00" level=info msg="convert: converting IMG_0001.HEIC to IMG_0001.HEIC.jpg (heif-convert)" time="2024-03-23T00:00:00" level=error msg="convert: no such file or directory for Mobile/ICloud/2024/01/01/IMG_0001.HEIC" which seems like photoprism successfully creates two sidecar from one spacial photo but failed to make a connection due to their unusal naming. This would cause missing index and photo in the gallery **Describe the solution you'd like** Stack IMG_0001.HEIC,IMG_0001.HEIC-1.jpg,IMG_0005.HEIC-2.jpg together and index it properly. **Describe alternatives you've considered** An simpler solution would just be naming IMG_0001.HEIC-1.jpg as IMG_0001.HEIC.jpg and treat it as the only side car file. **Additional context** /

deekerman added the

idea

help wanted

metadata

labels

2026-02-20 01:05:05 -05:00

deekerman commented

2026-02-20 01:05:06 -05:00

Author

Owner

@lastzero commented on GitHub (Mar 23, 2024):

Can you provide us with sample files for testing?
See https://www.photoprism.app/contact

@lastzero commented on GitHub (Mar 23, 2024): Can you provide us with sample files for testing? See https://www.photoprism.app/contact

deekerman commented

2026-02-20 01:05:06 -05:00

Author

Owner

@lastzero commented on GitHub (Mar 25, 2024):

We'll be happy to look into this (and fix the issue) once we've completed our work on two-factor authentication! Otherwise, please feel free to send a reminder.

@lastzero commented on GitHub (Mar 25, 2024): We'll be happy to look into this (and fix the issue) once we've completed our work on two-factor authentication! Otherwise, please feel free to send a reminder.