Panotour - FAQ - Viewing the tour offline

From Autopano

Jump to: navigation, search


Why is the tour showing an error viewing the tour from the file system directly?

See Why are some plugins missing when viewing the tour from the file system directly?

Why are some plugins missing when viewing the tour from the file system directly?

The tours are made to be viewed online.
To operate correctly, the tour (Flash + HTML5 version) must be delivered via a web server: some of the plugins of Panotour and Panotour Pro are HTML5 plugins, using Javascript to work in the Flash tour, which requires a web server to function correctly, otherwise some functions are blocked by your browsers security settings (loading errors can show up if viewing locally).

Panotour Pro hosts a local server for tour testing that you can use with View last build tour Start last render icon interface button: the tour is delivered via a lightweight built-in web server (as you will see from the localhost: URL shown in your browser address bar).

HTML5 plugins concerned are:

See alternatives to Panotour Pro 2 to launch your tour locally.

How to launch a tour locally from a desktop computer without PTP ?

There are two easy solutions at the moment, our offline tour solution that is in development, Panotour Viewer, or by using the KrPano Testing Server.

How to use Panotour Viewer (PTViewer)

Panotour Viewer (PTV / PTViewer) allows you to build your tour into a single file, which can then be opened by our free viewer on any desktop computer.

You will be able to find the full documentation concerning Panotour Viewer here.

1. Build your tour, making sure that you have checked "export as .PTV file".

2. Download Panotour Viewer for desktop.

3. Install it.

4. Launch PTViewer.

Panotour Viewer window
Panotour Viewer window

5. Drag and drop your .ptv file(s) into PTViewer. If it's a signle file it will launch automatically in your browser, and if there are several .ptvs you can scroll through the list as you wish.

Drag and Drop the files
Drag and Drop the files

6. Click on the tour's thumbnail in the center of the window to launch the tour.

How to use the krpano Testing Server

The krpano Testing Server is a small, simple and easy-to-use static-file localhost server available for Mac and Windows users. Other computers and devices in the local network will be able to view the files. Additionally it's possible to control the browser caching and to limit the download-speed to simulate and test slower Internet-connections. (Related forum post:
You can also use the KrPano Testing Server to set up your tour on a CD, DVD, USB Key, etc...

1. Download KRPano Testing Server

2. Double click on the package to extract files from the package

Double click to extract into a folder
Double click to extract into a folder

3. Launch the krpano testing server file

Double click to launch krpano Testing Server
Double click to launch krpano Testing Server

4. Krpano Tesing Server is now lauched

Krpano Testing Server interface
Krpano Testing Server interface

5. Click «Browse» to select the export folder

Select the export folder of your tour
Select the export folder of your tour

6. Click on the local network address set up by krpano Testing Server

A local network address is now set up
A local network address is now set up

7. Results in your browser with file listing and a tour launched

File listing
File listing

Tour locally launched
Tour locally launched

How does the virtual tour work locally with Flash and HTML5 ?

1. The Basics

  • Exported tours from Panotour 2 don't work if launched directly from your file explorer.
  • The tour will always be launched from the HTML file outside of the data folder. If you built your tour with Flash incorporated, launching the .swf in the data folder will not work.
  • A local web server is needed to browse the tour properly. That's what Panotour 2 does when you launch the View last built tour function. You see the URL starting by: http://localhost:....... in your browser.
  • It is possible to launch a tour without Panotour started, see How to launch a tour locally from a desktop computer ?

2. About Flash viewer

  • If you built your tour with Flash, then launching the tour with the .HTML file of your tour, on a webserver or with the View Last Built Tour button, it will start in the Flash viewer automatically.
  • When using the Flash viewer locally/offline, then the External Interface of the Flash player is disabled for security reasons by default.
  • When using the Flash player 'online', that means when running the Flash player on a http:// address (or localhost server), then the external interface is always available.
  • The External Interface is necessary and important for:
    • Javascript access to and from the viewer.
    • Open externals URLs.
  • To change the Flashplayer security settings, see the Krpano page on

3. About the HTML5 viewer

  • How to test:
    • Use the HTML5 setting as URL parameter
    • Or add and enable the passQueryParameters setting in the HTML:embedpano({...., passQueryParameters:true});
  • Enter the tour URL and add ?html5=only as parameter. For example tour.html?html5=only

info Note about Google Chrome: For local testing, Chrome doesn't allow reading local files for security reasons by default. To enable that for testing add --allow-file-access-from-files as application parameter. See more at

info Note about Internet Explorer (10 and higher): For local testing, the IE Browser doesn't allow reading local files for security reasons by default. For local testing the security settings of the browser need to be changed.

4. Panotour localhost The Start last render icon View the last build tour button of Panotour loads a localhost server which gives the ability to display a tour without security limitations.

For the Flash viewer


For the HTML5 viewer by default


For the HTML5 viewer WebGL


For the HTML5 viewer CSS3D


BACK TO: Documentation / Panotour Documentation / Frequently Asked Questions

Personal tools
In other languages