Home

Overview

freepano is a WebGL panorama viewer based on three.js.

Dependencies

freepano has been tested on Ubuntu 14.04 LTS and comes with the following package dependencies:

• apache2 (or any webserver)
• node.js (optional, tested on 0.10.25)
• npm (optional, tested on 1.3.10)

Installation

Go to Apache's document root (or your webserver's document root):

$ cd /var/www/html/

Clone the repository using the command:

$ git clone --recursive https://github.com/3d4pi/freepano.git

To use the remote control feature, please install the its dependencies using npm:

$ cd /var/www/html/freepano/js/nodejs/remotecontrols/
$ npm install

Usage (example implementation)

Using your browser, go to the following address:

http://<web-server-ip>/freepano/example/

Remote control (example implementation)

To use the remote control feature, start the websocket server using node.js:

$ cd /var/www/html/freepano/js/nodejs/remotecontrols/
$ nodejs index.js

Using a motion-enabled device (like a smartphone), go to the following address:

http://<web-server-ip>:3000/

Follow the calibration process on the desktop screen. This has been tested on Firefox Mobile 36.0 on Android 4.2.2.