Vintage Viewer Help — Vintage Viewer

Welcome to the past.

Vintage Viewer is a Mac app for preserving, organizing, viewing, and exporting QuickTime VR panorama and object movies as well as Apple QuickTake 100 and 150 photographs. It gives these older formats a place to live in a modern, portable library.

Vintage Viewer doesn’t just convert these vintage formats; it preserves the original files in their original formats. You can export QuickTake pictures to modern image formats and export QuickTime VR movies as interactive HTML files, but exporting is optional.

Getting started

Create or open a library

If you're just starting out, choose New Library on the welcome screen. Vintage Viewer creates a library whose filename ending with .vvlibrary. This is a macOS package file that contains your preserved originals and their organization, including folders, favorites, and item descriptions.

When you launch Vintage Viewer, it opens your most recently used library. You can create multiple libraries if you like and switch between them using the commands in the File menu, or by double-clicking the desired library at the Finder.

Import items into your library

You can add QuickTake 100 or 150 photos and QuickTime VR movies to your library in a few ways.

Drag files or folders into the Vintage Viewer window
Click the Import button near the upper-right corner of the Vintage Viewer window
Choose File > Import Files or Folders

Newly imported items appear in All Items, even if you were viewing a folder when you imported them. Vintage Viewer examines supported files by their contents, so a missing .mov extension or an old QuickTake filename need not prevent import.

Find and organize items

Use the Library panel to see All Items, Favorites, QuickTake Photos, QTVR Panoramas, QTVR Objects, and folder you creat.
To sort the file list, use the Sort by menu below Search. You can sort by Name, Date added, or Type.
Use folders to organize items — for example, all panoramas of a particular place. Drag items from the file list into a folder, or Control-click on an item and choose the destination folder from the contextual menu.
You can change the order of folders by dragging them up and down.
To select multiple items, use Shift-click or Command-click. Drag selected items to a folder, or use Move to Folder in the contextual menu. You can also create a new folder that will contain whatever you've selected by choosing File > New Folder from Selection.
To move an item out of a folder, select it and choose Unfiled Items in an item's Move to Folder menu.
To make an item as a favorite, click the star beside its name.
You can give each item a descriptive caption of up to 1000 characters. Click the small Info item next to the item's name or choose Edit > Get Info (keyboard shortcut: Command-I. A description can also contain a clickable web address.
The Search box lets you search names and descriptions. Press Command-F to focus Search; click its X to clear the search and return to All Items.

Viewing media

Panoramas

Select a QTVR panorama and choose Interactive in the view menu above the image. Vintage Viewer reconstructs supported cylindrical and cubic panoramas from their image samples. A partial panorama stops at its left and right limits rather than wrapping all the way around.

Click and drag to pan; release after a quick movement to glide to a stop. Use the arrow keys for smaller movements.
On a Magic Mouse, swipe across the mouse surface to pan. Keep the pointer over the panorama.
On a laptop trackpad or Magic Trackpad, pinch to zoom in or out. You can also zoom in and out with the keyboard by pressing Shift to zoom in or Option to zoom out. The floating controls at the bottom of the panorama display provide another way to move and zoom.
Panoramas can have multiple scenes, called nodes, which are accessed with on-screen hotspots (for example, a door might be a hotspot that takes the viewer to an outside panorama). When your mouse pointer reaches a hotspot, its shape changes to an arrow.
If a panorama contains multiple scenes, a Scenes menu appears above the panorama. Use it to jump right to a specific scene.
The floating toolbar at the bottom of the panorama area contains a hotspot tool; click it to display the hotspots in the panorama.

Viewing size

Choose View > Original Size for a centered, smaller 16:9 panorama viewport based on the source image's pixels. This is often the best setting when viewing older panoramas that were published on the web.

To enlarge the panorama to fill the window size, choose View > Fill Window. Older, small panoramas may look pixelated when enlarged.

The button at the upper right corner of the Vintage Viewer window switches between these two view settings.

Object movies

To rotate an object, drag horizontally. If the movie includes several tilt rows, drag vertically to change the viewing angle. The Rotate and Tilt sliders provide precise control when those dimensions are available. Some movies also have a View state menu above the image. Earlier or unusual object layouts may show extracted frames instead of full navigation.

Other view controls

The menu above a panorama can show its Flat Image or Cube Faces, Source Tiles, and, when present, the movie's Legacy Preview. These views can help you inspect a movie that does not reconstruct as expected.

Viewing tips

Hiding and showing the panels. You can hide the two left panels to create a larger viewing area for QuickTime VR movies or QuickTake photos — this can be useful on smaller laptop screens. To hide (or show) the panels, click the rectangular button near the upper-right corner of the app window (or Press Command-P or use the command in the View menu).

Switching between dark and light mode. Choose View > Dark Mode or use the upper-right button to switch appearance.

Exporting

You can export QuickTake photos in three formats: JPEG, PNG, or TIFF. Select one or more images, then choose the desired format from the Export menu above the image area.

For QuickTime VR movies, you can export in a few different ways: a flat (long) image, a set of the frames that make up a panorama, or — most exciting — an HTML page that will display a panorama in a modern web browser.

Any export operation doesn't change the original item(s) in your library, which are always stored in their original (QuickTake or QTVR) formats.

You can also make a duplicate of an item in its original format by choosing Export Original from the Export menu.

Exporting a panorama for publishing on the web

Choose Interactive HTML from the Export pop-up menu. Vintage Viewer creates one self-contained HTML file for the displayed panorama scene or object movie.
Open that file locally in a browser and double-check its navigation.
Upload the HTML file to your website and open its public web address.
Follow the instructions that appear below the panorama to add the panorama to an existing web page.

The iframe loads the same HTML file in its viewer-only mode. The page you embed it in displays the interactive scene, without the export page's instructions. Multi-scene hotspots and directional audio are not included in the current HTML export; multi-scene panoramas provide a menu that lets users navigate between scenes.

*** very large panos; resizing options

Switching and sharing libraries

Choose File > Open Library or File > Open Recent Library to switch collections. Vintage Viewer closes the current library before opening the chosen one. Choose File > New Library (Shift-Command-N) to start a separate collection.

A library, whose name ends with .vvlibrary, appears as one item in Finder. To share it, close it first or choose File > Save a Copy of Library and send the copy.

A library is a macOS "package" file. The package keeps original media and resource-fork information together. Do not edit the same open library on two Macs or inside a live multi-user sync workflow.

Don't rename, move, or delete files inside a library using Finder's Show Package Contents command. Manage items within in Vintage Viewer. Editing the package directly can leave catalog items without originals.

Tips and tricks

To select all visible items, press Command-A. Press Shift-Command-A to deselect them.
Use an item's contextual Rename command (Control-click) to change its displayed movie name. Its name updates in every folder where it appears.
Choose Edit > Undo Move after moving items to the wrong folder. Folder deletion can also be undone and redone.
Remove an item with its small X or the contextual menu. Edit > Undo Remove restores it to the list. Removal does not immediately erase the preserved original.
Save a copy of an important library to another disk from time to time.

Troubleshooting

A panorama looks wrong or only its tiles appear

QTVR movies used several generations of metadata, compression schemes, tile layouts, and projections. Vintage Viewer handles many cylindrical, partial, cubic, and multi-scene arrangements, but it may be unable to reconstruct a damaged or uncommon file. Try the alternate views above the image. Keep the original movie and report the exact error or unexpected image; Source Tiles and a shareable copy of the movie help diagnose the layout.

“No QuickTime movie header (moov atom) was found”

A classic Mac movie may have stored its header in a resource fork, which can be lost during copying. Vintage Viewer can recover some headerless panoramas but cannot reconstruct every missing header. If possible, return to the original disk and transfer the movie in a ZIP archive or disk image that preserves resource forks, then import that copy.

An original is marked as missing

The preserved file was probably moved or deleted inside the library package outside Vintage Viewer. Reimport a matching original; the app can repair the managed copy while retaining its caption, favorite, and folder assignment. A saved library copy omits originals that are still missing and reports what was omitted.

An item is not in the file list

Clear Search with its X, choose All Items, and check the sort order. An item assigned to a folder is still in the library. If it was removed recently, try Edit > Undo Remove.

The hotspot button is disabled

The current panorama scene has no usable scene links.

Reporting a problem

Include your macOS version, the Vintage Viewer version shown in About, the exact message, and what happened just before the problem. For a decoding issue, share the original movie only if you have permission.

Staying current and installing updates

QuickTime VR movies have used a variety of different formats: different compression schemes, different configurations of image slices, and more. As a result, you may encounter a movie that doesn't load or play back properly. If this happens, consider emailing the movie to me: jim [at] heidsite.com.

As I add features and additional compatibility, I'll release updates to Vintage Viewer. To see if an update is available, choose Vintage Viewer > Check for Updates. If a new version is available, an Update Now button will appear. Click it to go to the Vintage Viewer website, where you can grab the latest version.

After downloading the update, delete the old version from your Applications folder, then copy the update to your Applications folder. Your existing libraries won't need updating.

Credits and thanks

Vintage Viewer includes the following open-source compatibility components.

FFmpeg 8.0
This software uses code of FFmpeg licensed under the LGPL version 2.1 or later.
https://ffmpeg.org/
Vintage Viewer builds FFmpeg without --enable-gpl or --enable-nonfree and without external codec libraries.

Neither project is affiliated with or endorses Vintage Viewer.

Sample Library Credits

Apollo 17 panorama
Source photography, NASA Apollo 17, frames AS17-145-22159 through AS17-145-22183. QuickTime VR panorama stitched and assembled by Jim Heid for Vintage Viewer

Space shuttle cockpit panorama
Photography by Bob Sauls, John Frassanito & Associates, Inc., March 20, 2000. Used with permission.

Community festival in Elk, California, 1996
The historic Albion River Bridge, 1996
Mt. Shasta and Black Butte lava dome, Shasta, CA, 1997
Downtown Ritzville, Washington, 1997
Mendocino, California, 1996
Wheat farm, Ritzville, Washington, 1977
Jackson, Montana, 1997

Echo City on beach in Dungeness: panorama with sound loops made in SoundsaVR with Giles Perring
Object movie: Patek Philippe Star Caliber, 2000
Object movie: Patek Philippe Rose Gold 5053 Watch, 2001
The Giant's Causeway, Northern Ireland - World Heritage Site, seven-scene cubic tour, 2008

Apple orchard, Kent, England, 2005
Big Sky Kite Festival 2008
Kitesurfers, Camber Sands, England, 2007 (composite "timelapse" panorama)
The Big Sky Kite Festival, Margate, England, 2009 (composite "timelapse" panorama)
The Iron Age broch Dun Troddan, Glen Elg, Highlands of Scotland, 2008
Above the Devil's Kneading Trough, Kent Downs National Landscape, England, 2008

*** to be completed ***

Requirements and privacy

Vintage Viewer requires macOS 13 or later. It bundles its QuickTake and QuickTime VR compatibility components; no additional software installation is needed. The app does not upload your media or library, nor does it track user behavior or capture any personal data. Choosing Vintage Viewer Help opens this page on the web.

Using Vintage Viewer