Panotour - FAQ - Viewing the tour offline
- 1 Viewing and Players
- 2 Troubleshooting offline viewing
- 2.1 Why aren't some of my updates showing up when I view the tour?
- 2.2 Why is the tour showing an error viewing the tour from the file system directly?
- 2.3 Why are does my tour not work correctly when I open my project in the explorer?
- 2.4 Local usage with file:// urls is limited due to browser security restrictions!
- 2.5 Why are does my tour not work correctly when viewing the tour from the file system directly?
Viewing and Players
How to launch a tour locally from a desktop computer without PTP ?
Your tour must be viewed through a webserver to work correctly, be it online or offline.
For viewing offline, there are two easy solutions at the moment, our offline tour solution that is in development, , or by using the KrPano Testing Server.
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...
2. Double click on the package to extract files from the package
3. Launch the krpano testing server file
4. Krpano Tesing Server is now lauched
5. Click «Browse» to select the export folder
6. Click on the local network address set up by krpano Testing Server
7. The tour will launch in your default browser
How to use Panotour Viewer
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".
3. Install it.
4. Launch PTViewer.
5. Drag and drop your .ptv file(s) into PTViewer. If it's a single file it will launch automatically in your browser, and if there are several .ptvs you can scroll through the list as you wish.
6. Click on the tour's thumbnail in the center of the window to launch the tour.
How does the virtual tour work locally with Flash and HTML5 ?
- 1. The Basics
- Exported tours from Panotour don't work if launched directly from your file explorer.
- The tour must 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 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 the HTML5 viewer
- Default player used in your tour from Panotour 2.5 onwards.
- Certain features that were available in Flash are not yet available in HTML5.
- 3. About the Flash player
- If you built your tour integrating the Flash player, then you will still have to launch the tour with the .HTML file of your tour, on a webserver or with the View Last Built Tour button.
- From Panotour 2.5, the Flash player is only kept as a fallback player for browsers that are too ancient to use HTML5.
- You can modify your url or the the html file to use the Flash player first.
- 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
localhostserver), then the external interface is always available.
The External Interface is necessary and important for:
- - Opening externals URLs.
- To change the Flashplayer security settings, see the Krpano page on http://krpano.com/docu/localusage/#changesecuritysettings
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 http://www.chrome-allow-file-access-from-file.com/
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
For the Flash viewer
For the HTML5 viewer by default
For the HTML5 viewer WebGL
For the HTML5 viewer CSS3D
Troubleshooting offline viewing
Why aren't some of my updates showing up when I view the tour?
This is most likely due to a browser cache problem.
Solution: Try a hard reload (Ctrl+F5 or Shift+Ctrl+F5 depending on the browser), emptying your entire browser cache or copying the localhost link into another browser or a private navigation window (Ctrl+Shift+N in Chrome, Ctrl+Shift+P in Firefox and IE).
Also have a look at these useful extensions/add-ons that you can use to delete the cache of your current page:
- On Google Chrome:
- On Firefox:
Why is the tour showing an error viewing the tour from the file system directly?
Why are does my tour not work correctly when I open my project in the explorer?
Local usage with file:// urls is limited due to browser security restrictions!
Added in Panotour 2.5.3 which uses KrPano 1.19 pre-release 4, this message shows up when you try to view the tour locally without at a webserver, which doesn't work (depending on the browser it could go from being completely blocked to only some elements not showing up), so this clearer message was added.
Why are does my tour not work correctly when viewing the tour from the file system directly?
The tours are made to be viewed online.
To operate correctly, the tour must be delivered via a web server, otherwise some features including plugins and web access (links, web maps..) are blocked by your browser's security settings and won't work. From Panotour 2.5 onwards, viewing locally from the file system is completely blocked to avoid the loading of half-functional tours.
Panotour hosts a local server for tour testing that you can use with the View last build tour 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).
See alternatives to Panotour to launch your tour locally.