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. You can create searchable HTML galleries containing your favorite QuickTake photos and QuickTime VR movies.

From organizing to viewing to sharing, Vintage Viewer brings these forgotten formats back to life.

Getting started

Explore the samples

If you're just starting out, you might want to explore the sample library that's included with Vintage Viewer. You’ll find some spectacular panoramas contributed by some pioneers in panoramic and object photography. I've also included some vintage panos that I made in the 1990s and shot with QuickTake cameras. And the Apollo moon mission panos are just plain cool.

Explore Vintage Viewer's features: create a folder, drag some items into it. Check out the Info window, where you can create captions. Hide the left-side panels to give yourself more image area. Play around!

Create or open a library

Ready to start storing your own vintage images? Choose New Library on the welcome screen. Vintage Viewer creates a library whose filename ends 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.

Note: When you import an item, Vintage Viewer makes a copy of it in your library. The original is left untouched in its original location.

Find and organize items

Use the Library panel to see All Items, Favorites, QuickTake Photos, QTVR Panoramas, QTVR Objects, and folders you create.
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.
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.
You can change the order of folders by dragging them up and down.
To make an item as a favorite, click the star beside its name.
You can give each item and each folder a descriptive caption of up to 1000 characters. Click the small Info (i) item next to the item's or folder'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. Click within the Search box or press Command-F, then start typing. Click the X to clear the search and return to All Items.

Viewing media

Panoramas

To view a panorama, select it. Vintage Viewer loads it and displays it in interactive mode. 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.

To pan left and right, click and drag; 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. Click the hotspot to view a different scene.
When 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.

Note: A large panorama — high resolution, multiple nodes, or a combination of the two — can yield an HTML file that's too big to download at a reasonable speed. If Vintage Viewer determines that this might be the case, it offers to reduce the size of the exported panorama. To take advantage of this, choose Automatic. To export in higher resolution, choose Higher quality. This resizing applies only to the HTML export; the original in your library are never resized.

Creating a web gallery

You can turn a folder of images and movies into a web gallery that will open in any laptop or desktop browser. (To view these galleries on an iPhone or iPad, you’ll need to publish them on a website. Those devices don't permit an HTML file to be opened.)

To create a web gallery, put the items you want to share in a folder. If you’d like your gallery to have some introductory text at the top of its home page — for example, These are a few of the panoramas that I created while on my cross-country road trip in 1997 — select the folder, choose File > Get Info, then type or paste the introductory text.

Next, choose File > Export Folder as Collection or Export Folder as Collection in the folder's contextual menu.

Vintage Viewer exports the folder's contents in alphabetical order. If your folder contains more than one item, Vintage Viewer creates one or more thumbnail pages. If you've added descriptive information for items using the Get Info command, that information appears on their web pages.

Note: As with a single-pano export (discussed above), if a collection contains particularly large panoramas, it could result in large HTML pages that take too long to view or download. In that case, Vintage Viewer displays a message offering to resize large items in the exported pages. Choose Automatic to do this. To export in higher resolution — at the expense of slower loading — choose Higher quality. This resizing applies only to the versions in HTML pages; the originals in your library are never resized.

Keep the exported folder intact — don't move the items within its folders. To view the gallery, open index.html in a desktop browser, or compress the entire folder in Finder to share it. You can also upload it to a web server; you’ll need to do this to view it on an iPhone or iPad.

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.

Known issues and updating

macOS 27 Golden Gate note: A macOS focus issue can prevent clicking in the Library or Files panel from fully activating that panel. The selection may change, but some menu commands can remain unavailable or apply to the previously active panel. If this happens, press Tab until the desired panel has focus, or Control-click/right-click an item in that panel to activate it. This doesn't happen in earlier macOS versions; I've reported this apparent bug to Apple.

Playback problems? 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.

Check for updates. 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 along with a summary of what's new. Click the button 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.

Known issue. In version 1.0, dragging one or more items out of the Vintage Viewer window doesn't make a copy of the item(s). Instead, the app creates a small file whose name begins Vintage Viewer internal item selection. It's safe to delete this file. (It's also safe to say "oops" when this happens.) To export an item, select it and choose Export Original from the Export pop-up menu.

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. 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 16 and 17 panoramas
Source photography, NASA Apollo 16 and 17 image galleries. QuickTime VR panoramas 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.

Morning in Mendocino, December 1997
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