Import media and create AIVU files in Apple Immersive Video Utility

Use this method to import either a low-quality, HEVC MP4 file and its AIME file, or a finished AIVU file at delivery-spec quality.

1. In Apple Immersive Video Utility on Mac, do one of the following:

   • Select an existing playlist: Click a playlist in the sidebar.

   • Create a new playlist: Click in the sidebar, enter a new name for the playlist, then press Return.

2. Click in the toolbar, choose Import Media, then select the media file you want to import.

3. If you want to use HDR (high dynamic range) PQ color space, select the PQ P3-D65 checkbox.

   To see the PQ P3-D65 checkbox, you may need to click Show Options at the bottom of the dialog.

4. Click Open.

The import queue opens, showing import progress. When the file finishes importing, it’s added to the selected playlist.

Use this method to import all the files required to create a high-quality packaged AIVU file. To check the requirements for AIVU files, see Requirements for video and audio.

1. In Apple Immersive Video Utility on Mac, do one of the following:

   • Select an existing playlist: Click a playlist in the sidebar.

   • Create a new playlist: Click in the sidebar, enter a new name for the playlist, then press Return.

2. Click in the toolbar, then click Create .aivu File.

   Note: To import multiple packages at the same time, Command-click to select multiple folders, or click one folder containing multiple folders. During import, Apple Immersive Video Utility separates the folders and relevant metadata combinations.

3. In the dialog, select a folder that contains the following required files:

   • An MV-HEVC video file

   • An AIME metadata file

   • An MP4 audio file encoded in Apple Spatial Audio Format (ASAF)

   • A presentation track file to signal camera changes and transitions

4. If you want to use HDR PQ color space, select the P3-D65 PQ checkbox.

   To see the P3-D65 PQ checkbox, you may need to click Show Options at the bottom of the dialog.

5. Click Open.

   The import queue opens, showing import progress. When the files finish importing, they’re combined into a single AIVU file and added to the selected playlist.

You can import an existing HTTPS live stream (HLS) packaged in another workflow, or a remote stream such as a network or server-hosted HLS. HLS and remote streams can be used for live feeds or for testing purposes.

1. In Apple Immersive Video Utility on Mac, click in the toolbar.

2. Do one of the following:

   • Add an HLS stream: Click Create .aivu file, select the folder that contains the .m3u8 playlist file, then click Open.

     If there are multiple HLS streams, put each .m3u8 file into its own folder in the Finder. When you import, select the parent folder.

   • Add a remote stream: Click Remote Stream, add the URL path that points to the .m3u8 playlist file, then click Save.

In Apple Immersive Video Utility on Mac, do any of the following:

• Open the import queue: Click in the toolbar.

• Cancel an active import: In the import queue, click to the right of the importing item.

• Close the import queue: Click outside the import queue.

If you have Apple Immersive Video files on your Apple Vision Pro, you can import them directly into Apple Immersive Video Utility on Apple Vision Pro. If your Apple Vision Pro is connected to a Mac, you can also save media from Mac to Apple Vision Pro so you can view them even when you’re not connected to a Mac.

1. Open Apple Immersive Video Utility on your Apple Vision Pro, then do either of the following:

   • Import Apple Immersive Video from your Apple Vision Pro storage: Tap Saved in the tab bar, tap Add Media, then choose the files you want from the Files app.

     Tip: To share media to the Files app from another device (for example, a device that’s not signed in to your Apple Account), you can also use AirDrop, then import using the steps above.

   • Save Apple Immersive Video from your library on Mac to Apple Immersive Video Utility on Apple Vision Pro: Connect Apple Vision Pro to your Mac, pinch and hold a video in Apple Immersive Video Utility on Apple Vision Pro, then tap Save.

     

2. To view imported or saved files, tap Saved in the tab bar.