1) GET PANINI Head to this address and get the source code of Panini by clicking the green rectangular button visible in the middle of the following screenshot:
When prompted, save the file in your computer and remember were it has been saved. After the download has finished, locate the Panini zipped package with a file browser and extract it by right-clicking and selecting "extract here" (as illustrated in the following screenshot).
A new folder will be created containing all the Panini source code.
2) GET THE DEPENDENCIES Now we are going to get the needed packages to successfully build Panini. Open a terminal window by selecting "Applications->Accessories->Terminal" In the window that appears, paste (or write) the following command:
When the password is entered and the enter command pressed, the terminal will show you a list of all packages that it is going to install. In the following screenshot, taken after issuing the command in a clean install of Ubuntu 9.10 Karmic Koala, you could see that are going to be downloaded more than 200MB of files (that's pretty much but without them you will not be able to install Panini).
Type "Y" when prompted and then press "Enter". After some time, depending on your internet and pc speed, the installation ends and will be the time to proceed to next step.
3) BUILD THE PROGRAM Again from a terminal window, navigate with the "cd" command to the directory where the Panini source code was extracted in step 1. When in this folder, type the command:
When it has finished, type (this command will take some time to execute):
If you didn't get any error message, open a file browser and navigate to the Panini source code folder; here you will find a file named "Panini". That's the executable file! by double-clicking on it Panini should start!
That could be enough to use Panini but if you want to integrate it better with the Desktop environment, read the following last step.
4) CREATE THE FANCY MENU SHORTCUT To create the menu entry for Panini, we will use the Ubuntu Menu editor. Go to "System->Preferences->Main Menu" as shown below:
On the window that will open, select the "Graphics" entry on the left pane and press "New Item" in the upright corner as shown in the next screenshot:
A dialog will popup in which are present some empty fields that need to be filled up. In particular, set the name as "Panini" and the comment as "Panorama viewer". After this we need to complete the command field by selecting the Panini executable. Press the "Browse..." button next to the command field and navigate in the file browser window that will appear, to the Panini executable in the main folder where the Panini source code was extracted and compiled (see the following screenshot):
Finally we need to select an icon for the program. So click on the icon button on the left upper corner, navigate (by pressing the "browse button") to the path where panini source code was extracted and select the "/ui" subdirectory. Select the icon with the .jpg extension and press "Ok"
All the fields all now completed; you can press "Ok" in the "Create Launcher" dialog and close the main menu editor window
Close the menu editor and that's it!
Now if you go to Applications->Graphics you will find the Panini entry and, by clicking it, Panini will start!
Now is possible to open in Panini equirectangular images like those and move the view to your liking. Enjoy your views!