KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#dsh #dsh-plugin #developer-tools #ai-agent #claude-code #codex #typescript #ai-agents #deepseek-harness #mcp #cli #rust

iPhoneCinematicDepthTo3D

★ 48 Open GitHub ↗

This is a sample C# project that extracts Depth and Color information from videos shot in iPhone's Cinematic mode and outputs each as separate videos, along with a sample Unity project for 3D playback of these videos.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# iPhone CinematicDepth To 3D

## 1. Overview
This is a sample C# project that extracts Depth and Color information from videos shot in iPhone's Cinematic mode and outputs each as separate videos, along with a sample Unity project for 3D playback of these videos.

This sample consists of three projects:
- DepthExtractor:  
A C# sample project for separating Depth and Color from videos shot in Cinematic mode.
- DepthPlayer:  
A Unity sample project to display Depth and Color videos in 3D.
- DepthPlayer_LKG:  
A Unity sample project to display Depth and Color videos in 3D using Looking Glass.

[![](https://img.youtube.com/vi/MR8TF1z-nTg/0.jpg)](https://www.youtube.com/watch?v=MR8TF1z-nTg)

## 2. Cinematic Mode Compatibility
Refer to [Apple Support](https://support.apple.com/en-us/HT212778).  
Additionally, the iPhone 15 Series is compatible.

## 3. iPhone Settings

### Camera Settings
1. Settings -> Camera -> Formats
2. Choose "High Efficiency" under the Camera Capture section

### File Transfer Settings
1. Settings -> Photos
2. Select "Keep Originals" under the TRANSFER TO MAC OR PC section

## 4. Transfer Video Files to PC

### [USB Transfer]

#### For Windows
1. Connect the iPhone to your PC with a USB cable
2. Using Explorer, locate the cinematic video you wish to use
3. Copy it to any folder on your PC  
   **Note:** When shooting a video, filenames like IMG_0001.MOV and IMG_E0001.MOV might be generated. Make sure to select files without the "E", such as IMG_0001.MOV.

#### For Mac
1. Connect the iPhone to your Mac using a USB cable
2. Launch the Photos app on your Mac
3. Choose "iPhone" from the list on the left side of the window
4. Select the video you wish to import and click the Import button
5. Choose "Imports" from the list on the left side of the window
6. From the menu bar at the top, select File -> Export
7. Click on "Export Unmodified Original for 1 Video"
8. Hit the Export button
9. Save to your desired folder

### [Network Transfer (iOS 17 and above)]
1. Launch the Photos app on your iPhone
2. Select the cinematic video and tap the Share button
3. Tap "Export Unmodified Original"
4. Select a destination folder and tap the Save button
5. Open the Files app
6. Share the video saved in step 4 as you see fit, e.g., through Google Drive.

## 5. Separating Depth and Color Videos (Windows Only)
1. Navigate to the DepthExtractor_Win folder
2. Start DepthExtractor.exe from the Executable folder or run the project in the Project folder using Visual Studio
3. Click the Open button and select a cinematic video
4. Hit the Convert button and wait for "Done" to be displayed
5. `color_output.webm` and `depth_output.webm` will be generated in the same directory as the video you selected in step 3.  
   **Note:** The depth video size is either 512x288 or 288x512, while the color video size is 512x512.

## 6. Display in 3D within Unity
1. Open the DepthPlayer or DepthPlayer_LKG project in Unity
2. Place `color_output` and `depth_output` into any directory under the Assets folder  
   e.g., within the VideoFiles directory
3. Double-click on DepthPlayer inside the Scenes directory
4. In the Hierarchy, select the [Main] object
5. Drag & drop `color_output` onto "Color Video" in the Inspector
6. Drag & drop `depth_output` onto "Depth Video" in the Inspector
7. At the top of the UnityEditor, click the Play button  
   **Note 1:** To change the display size, position, or angle, please modify the Transform parameters of the [DepthMeshRoot] object.  
   **Note 2:** To adjust only the depth direction scale, you can modify the Depth Scale value (Default=1.5) of the [Main] object.
   **Note 3:** To change viewpoints, please use the Scene View. Viewpoint control within the Game View have not been implemented.

## 7. License
While this sample is under the MIT License, be aware of the following dependencies and their respective licenses:
- [GPAC2.2](https://gpac.wp.imt.fr/) - License: [GNU Lesser General Public License, version 2.1]
- [FFmpeg](https://ffmpeg.org/) - License: [GNU Lesser General Public License, version 2.1]
- [Looking Glass Unity PlugIn](https://lookingglassfactory.com) - License: [See [here](https://github.com/TakashiYoshinaga/iPhoneCinematicDepthTo3D/blob/main/DepthPlayer_LKG/Assets/Holoplay/LICENSE.txt)]

## 8. Acknowledgements
In the development of Depth Extractor, the trial and error results by [Jan Kaiser](https://twitter.com/jankais3r) proved to be invaluable.  
You can see the details in [this tweet](https://twitter.com/jankais3r/status/1442466943697489923).

## 9. Feedback
Feel free to provide feedback on my project via social media. I appreciate your insights and comments.  
Connect with me on [X (Well know as Twitter) @Tks_Yoshinaga](https://twitter.com/Tks_Yoshinaga).

iPhoneCinematicDepthTo3D

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README