immich-app/immich
1
0
Fork 0
mirror of https://github.com/immich-app/immich.git synced 2026-07-16 05:34:30 +03:00
Code Issues 783 Packages Projects Releases 22 Wiki Activity

360 video is flattened #1705

New Issue
Open
opened 2026-02-05 03:12:55 +03:00 by OVERLORD · 7 comments
OVERLORD commented 2026-02-05 03:12:55 +03:00
Owner
Copy Link

Originally created by @JesseWebDotCom on GitHub (Dec 1, 2023).

Originally assigned to: @mertalev on GitHub.

The bug

When re-encoding 360 video, immich flattens the video.

To confirm:

  • take a 360 degree mp4 video, open in VLC, and confirm you can properly rotate the video in 360 degrees
  • now have immich re-encode that video (HEVC in my case) and do the same test in VLC - you will not be able to rotate the video

My theory is immich loses the 360 side data when using FFmpeg to re-encode. For example, here is some ffprobe side data for a 360 video that I believe immich loses:

  Stream #0:0[0x1](und): Video: hevc (Main) (hvc1 / 0x31637668), yuv420p(tv, bt709), 4096x2048 [SAR 1:1 DAR 2:1], 28334 kb/s, 29.97 fps, 29.97 tbr, 90k tbn (default)
    Metadata:
      creation_time   : 2022-07-27T13:27:56.000000Z
      handler_name    : VideoHandler
      vendor_id       : [0][0][0][0]
    Side data:
      spherical: equirectangular (0.000000/0.000000/0.000000)

When re-encoding, immich needs to add -strict unofficial flag to the ffmpeg command line in order to copy the video projection metadata. See here for more detail: https://stackoverflow.com/questions/44760588/preserving-side-data-information-for-360-video-transcoding-using-ffmpeg/48147865#48147865

The OS that Immich Server is running on

Ubuntu 22.10

Version of Immich Server

v1.89.0

Version of Immich Mobile App

v1.89.0

Platform with the issue

  • Server
  • Web
  • Mobile

Your docker-compose.yml content

n/a

Your .env content

n/a

Reproduction steps

see above

Additional information

No response

Originally created by @JesseWebDotCom on GitHub (Dec 1, 2023). Originally assigned to: @mertalev on GitHub. ### The bug When re-encoding 360 video, immich flattens the video. To confirm: - take a 360 degree mp4 video, open in VLC, and confirm you can properly rotate the video in 360 degrees - now have immich re-encode that video (HEVC in my case) and do the same test in VLC - you will not be able to rotate the video My theory is immich loses the 360 side data when using FFmpeg to re-encode. For example, here is some ffprobe side data for a 360 video that I believe immich loses: ``` Stream #0:0[0x1](und): Video: hevc (Main) (hvc1 / 0x31637668), yuv420p(tv, bt709), 4096x2048 [SAR 1:1 DAR 2:1], 28334 kb/s, 29.97 fps, 29.97 tbr, 90k tbn (default) Metadata: creation_time : 2022-07-27T13:27:56.000000Z handler_name : VideoHandler vendor_id : [0][0][0][0] Side data: spherical: equirectangular (0.000000/0.000000/0.000000) ``` When re-encoding, immich needs to add -strict unofficial flag to the ffmpeg command line in order to copy the video projection metadata. See here for more detail: https://stackoverflow.com/questions/44760588/preserving-side-data-information-for-360-video-transcoding-using-ffmpeg/48147865#48147865 ### The OS that Immich Server is running on Ubuntu 22.10 ### Version of Immich Server v1.89.0 ### Version of Immich Mobile App v1.89.0 ### Platform with the issue - [X] Server - [X] Web - [X] Mobile ### Your docker-compose.yml content ```YAML n/a ``` ### Your .env content ```Shell n/a ``` ### Reproduction steps ```bash see above ``` ### Additional information _No response_
OVERLORD added the format label 2026-02-05 03:12:55 +03:00
OVERLORD commented 2026-02-05 03:13:03 +03:00
Author
Owner
Copy Link

@johmicrot commented on GitHub (Aug 1, 2024):

I'm on the latest release (v.1.111.0) and this is still a persisting issue

@johmicrot commented on GitHub (Aug 1, 2024): I'm on the latest release (v.1.111.0) and this is still a persisting issue
OVERLORD commented 2026-02-05 03:13:08 +03:00
Author
Owner
Copy Link

@mertalev commented on GitHub (Oct 20, 2024):

Sorry, we have to revert the PR for this for now. It had the side effect of breaking playback when the source video uses Dolby Vision. The transcode ends up having incompatible DOVI metadata that players try and fail to use. It's surprisingly difficult to remove this and just this metadata, but will be easier in FFmpeg 7.1.

@mertalev commented on GitHub (Oct 20, 2024): Sorry, we have to revert the PR for this for now. It had the side effect of breaking playback when the source video uses Dolby Vision. The transcode ends up having incompatible DOVI metadata that players try and fail to use. It's surprisingly difficult to remove this and *just* this metadata, but will be easier in FFmpeg 7.1.
OVERLORD commented 2026-02-05 03:13:12 +03:00
Author
Owner
Copy Link

@Dunky13 commented on GitHub (Jan 14, 2025):

I have a whole batch of Garmin 360 video & photos. This would be a great feature for me 🙏

@Dunky13 commented on GitHub (Jan 14, 2025): I have a whole batch of Garmin 360 video & photos. This would be a great feature for me 🙏
OVERLORD commented 2026-02-05 03:13:14 +03:00
Author
Owner
Copy Link

@Rambomst commented on GitHub (Feb 7, 2025):

I recently purchased an Insta360 x4 and came across this issue, at least I can view the front camera view but it would be great if this was implemented.

@Rambomst commented on GitHub (Feb 7, 2025): I recently purchased an Insta360 x4 and came across this issue, at least I can view the front camera view but it would be great if this was implemented.
OVERLORD commented 2026-02-05 03:13:17 +03:00
Author
Owner
Copy Link

@jarrah31 commented on GitHub (Aug 1, 2025):

I too would like this feature so that I can watch 360 videos from my Insta360 X5 on the Immich mobile app and web views.

@jarrah31 commented on GitHub (Aug 1, 2025): I too would like this feature so that I can watch 360 videos from my Insta360 X5 on the Immich mobile app and web views.
OVERLORD commented 2026-02-05 03:13:23 +03:00
Author
Owner
Copy Link

@tienli commented on GitHub (Aug 27, 2025):

This probably is something need to be fixed (or implemented) from photo side up.
Use a 360 picture and save it in either Google photo or Immich server. I can see 360 degree photo in browser both in Google and Immich, while doing the same in apps will only see 360 degree photo in Google's app; not in Immich's mobile app (I used iPhone, yet tried Android). It makes me thinking that rendering is without a problem. Since browser can do it, there must be something missing or wrong where app implemented. Hopefully I'd remember to upload a 360-degree picture here later so anyone can try it out.
Should I open a new issue?

@tienli commented on GitHub (Aug 27, 2025): This probably is something need to be fixed (or implemented) from photo side up. Use a 360 picture and save it in either Google photo or Immich server. I can see 360 degree photo in browser both in Google and Immich, while doing the same in apps will only see 360 degree photo in Google's app; not in Immich's mobile app (I used iPhone, yet tried Android). It makes me thinking that rendering is without a problem. Since browser can do it, there must be something missing or wrong where app implemented. Hopefully I'd remember to upload a 360-degree picture here later so anyone can try it out. Should I open a new issue?
OVERLORD commented 2026-02-05 03:13:27 +03:00
Author
Owner
Copy Link

@danieldietzler commented on GitHub (Sep 11, 2025):

Should I open a new issue?

No, why should you? There's no need to duplicate an existing issue lol

@danieldietzler commented on GitHub (Sep 11, 2025): > Should I open a new issue? No, why should you? There's no need to duplicate an existing issue lol
Sign in to join this conversation.
No Branch/Tag Specified
Branches Tags
Labels
Clear labels
accessibility
changelog:enhancement
changelog:security
changelog:skip
changelog:translation
cli
date-time
dependencies
documentation
external-library
format
good first issue
mobile-beta
mobile-beta
mobile-beta
needs-answer
nice to have
pull-request
Mirrored from GitHub Pull Request
 sharing
tech-debt
📱mobile
🖥️web
🗄️server
🧠machine-learning
No Label format
Milestone
No items
No Milestone
Projects
Clear projects
No project
Assignees
Clear assignees
OVERLORD
No Assignees
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: immich-app/immich#1705
Delete Branch "%!s()"

Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?