<!--
{
  "documentType" : "article",
  "framework" : "QuickTime File Format",
  "identifier" : "/documentation/QuickTime-File-Format/QuickTime_VR_file_format",
  "metadataVersion" : "0.1.0",
  "role" : "collectionGroup",
  "title" : "QuickTime VR file format"
}
-->

# QuickTime VR file format

A file format used to store a QuickTime VR movie on disk.

## Overview

> Important: VR Media is deprecated in the QuickTime file format. The information that follows documents existing content containing VR Media and should not be used for new development.

A QuickTime VR movie is stored on disk in a format known as the QuickTime VR file format. Beginning in QuickTime VR 2.0, a QuickTime VR movie could contain one or more nodes. Each node is either a panorama or an object. In addition, a QuickTime VR movie could contain various types of hot spots, including links between any two types of nodes.

> Important: This section describes the file format supported by version 2.1 of the QuickTime VR Manager.

All QuickTime VR movies contain a single QTVR track, a special type of QuickTime track that maintains a list of the nodes in the movie. Each individual sample in a QTVR track contains general information and hot spot information for a particular node.

If a QuickTime VR movie contains any panoramic nodes, that movie also contains a single panorama track, and if it contains any object nodes, it also contains a single object track. The panorama and object tracks contain information specific to the panoramas or objects in the movie. The actual image data for both panoramas and objects is usually stored in standard QuickTime video tracks, hereafter referred to as image tracks. (An image track can also be any type of track that is capable of displaying an image, such as a QuickTime 3D track.) The individual frames in the image track for a panorama make up the diced frames of the original single panoramic image. The frames for the image track of an object represent the many different views of the object. Hot spot image data is stored in parallel video tracks for both panoramas and objects.

## Topics

### Storing QuickTime VR files

[Single-node panoramic movies](/documentation/QuickTime-File-Format/Single-node_panoramic_movies)

Store a QTVR track, a panorama track, and a panorama image track in a single-node panoramic movie.

[Single-node object movies](/documentation/QuickTime-File-Format/Single-node_object_movies)

Store a QTVR track, an object track, and an object image track in a single-node object movie.

[Multinode movies](/documentation/QuickTime-File-Format/Multinode_movies)

Store any number of object and panoramic nodes in a multinode QuickTime VR movie.

[Getting the name of a QuickTime VR node](/documentation/QuickTime-File-Format/Getting_the_name_of_a_QuickTime_VR_node)

Retrieve information from a QuickTime VR node with QuickTime atom container functions.

[Adding custom atoms in a QuickTime VR movie](/documentation/QuickTime-File-Format/Adding_custom_atoms_in_a_QuickTime_VR_movie)

Provide additional information about a QuickTime VR movie using custom atoms.

[Adding atom containers in a QuickTime VR Movie](/documentation/QuickTime-File-Format/Adding_atom_containers_in_a_QuickTime_VR_Movie)

Add node information to your QuickTime VR world.

[Optimizing QuickTime VR movies for web playback](/documentation/QuickTime-File-Format/Optimizing_QuickTime_VR_movies_for_web_playback)

Prevent having to download an entire movie before starting playback.



---

Copyright &copy; 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)