Jump to: navigation, search

Panotour Viewer Documentation

Introduction

When you export a virtual tour, you usually get dozens of folders and hundreds of files used to display the virtual tour properly. This is meant for web publication.
Panotour or Panotour Pro allows you to export your tours in .PTV format. This option exports the whole tour as a single .PTV file that you can easily share.

The free Panotour Viewer app lets anyone open your tours on their computer or mobile device without the need of an internet connection. It is available on Desktop (Mac and Windows), Android mobiles and iOS devices. Find information on Panotour Viewer.

To install, simply download from our download center.



Getting Started

On Desktop

  • Intro screen on PC Desktop Computers

Pt Viewer Main Screen rev1.png

  • Intro screen on Mac Desktop Computers

Pt Viewer Main Screen Mac rev1.png

Opening .ptv files

  • Drag 'n' Drop

Simply drag 'n' drop one or more .ptv files into the main screen of Panotour Viewer.
Pt Viewer Drag n Drop rev1.png

  • With one .ptv file: Panotour Viewer launches the virtual tour automatically in your default web browser.
  • With several .ptv files: Panotour Viewer displays each visit thumbnail into a slide with previous and next button and swipe gesture function.
  • Double-click

To open a .ptv file, you can double-click on the main screen of Panotour Viewer and select the .ptv file(s) you wish to open.

  • File Menu

Click «File» menu and select «Open a .ptv», then select the .ptv file(s) you wish to open.

Navigating through .ptv files

  • With one .ptv file

Panotour Viewer launches the virtual tour automatically in your default web browser when the .ptv file is opened. If not launched automatically, you can double-click on the thumbnail to launch the virtual tour.

  • With several .ptv files

Pt Viewer Main Screen Next Button rev1.png

  • Panotour Viewer displays each visit into a slide with previous and next button.
  • You can switch between every opened virtual tour by clicking on left and right arrows or using the swipe gesture function.
  • To launch a virtual tour, double-click on the thumbnail.


On Android

Intro screen on Android Devices

Getting the .ptv files on your device

  • Plug your device in to your computer.
  • Access the SD card, and create a folder called "ptv". The current version of PTViewer will search for this folder containing your tours.
  • Place all your .ptv tours in this folder.

Opening .ptv files

  • Launch PTViewer
  • Select the tour you want to view (if there are several), and double tap on it's thumbnail. The tour will be launched using your device's native browser.

Navigating through .ptv files

Pt Viewer Swipe rev1.png

  • Swipe between the different tour's thumbnails
  • Press on the left or right arrows to browse

On iOS

Intro screen on iOS Devices

Getting the .ptv files on your device

  • Plug your device in to your computer.
  • Open iTunes.
  • Use the iTunes File Sharing interface to import your .ptv files to the PTV app.

Opening .ptv files

  • Launch PTViewer
  • Select the tour you want to view (if there are several), and double tap on it's thumbnail to launch it.

Navigating through .ptv files

Pt Viewer Swipe rev1.png

  • Swipe between the different tour's thumbnails
  • Press on the left or right arrows to browse



Advanced

What is a .ptv file?

A .ptv file is a zip archive file with a .ptv extension, containing a webpage and its resources. This archive file should contain a info.pti file at the root of the archive. The infos.pti file describes the .ptv file and its content.


Content of the infos.pti file

Some informations are mandatory, and others, optional, should be added to enhance user experience in the Panotour Viewer. Here is the structure of this file :

   [PTV]
   version=1
   [tour]
   name="My tour name"
   author="The author of the tour"
   entryFile=tour.html
   thumbnailFile=tourdata/thumbnail.jpg


The 2 sections [PTV] and [tour] have to exist.


PTV section

  • version: Version of the .ptv file. If your .ptv file follows current description, the version should be 1.


Tour section

  • name: Name of the .ptv content (it can be empty).
  • author: Name of the author of the .ptv file (it can be empty).
  • entryFile: Relative path of the HTML file to open.
  • thumbnailFile: Relative path of the thumbnail of the .ptv file (it can be empty).


Editing your PTV

If, for some reason you wish to edit your PTV (to modify or add some files for example, especially if you have linked to local .html files in your tour which are not percieved as part of the built tour) then you can open your PTV file to make your edits.
Here's how:


On Windows

  • Rename the PTV's extension to .zip.
  • Open the zip archive (do not unzip it)
  • Add or modify the desired files
  • Rename the PTV's extension back to .ptv


On Mac

Mac computers do not allow direct editing of Zip archives natively, some software must be downloaded.

  • Download BetterZip 3 for Mac (or a similar app which allows direct editing of zip archives).
  • Rename the PTV's extension to .zip.
  • Open the zip archive (do not unzip it)
  • Add or modify the desired files
  • Rename the PTV's extension back to .ptv



Compatibility Issues

See the FAQ: Are there any limitations to viewing a tour on a mobile?







BACK TO: Documentation