Cool VL Viewer forum

Linux installation HOWTO
Page 1 of 1

Author:  Henri Beauchamp [ 2009-06-02 18:16:02 ]
Post subject:  Linux installation HOWTO

Here are the installation steps (in this example, for v1.26.18.15):

  • First, download the viewer from the website. In our example, the package is named: CoolVLViewer-

  • You then need to make the downloaded package executable (because the file permissions are alas not preserved with web downloads). There are two ways to do this: either via the command line in a terminal, or from your preferred file manager.
    Since there is a gazillion of different file managers for Linux, I'll assume you know yours or can find out how to make a file executable with it...
    Let's show here the (old fashioned but universal) command line way:


    As you can see, the key command is "chmod +x CoolVLViewer-", after which you can launch the installer with "./CoolVLViewer-".

  • Once the installer is launched, you will go through the following dialogs:

    Image Image
    Note that since, in this example, this is the "root" user doing the installation, the installer suggests to install the viewer in "/usr/local/". For a normal user, it would suggest the user's home directory (but you can install the viewer anywhere provided you got file creation permission for the directory you choose).
    Whatever the directory you choose to install the viewer into, it will be automatically remembered by the installer as the default installation directory for future updates.

    Nothing to say about this simple, progress dialog... Just watch and relax ! :)

    And we are done !... Note that if the viewer was installed by "root" (like in the above example), the menu entry is created system-wide (and will be available to all the users), while when installed by a non-root user, only that user will get the entry in their menu.

  • Make sure you installed all the gstreamer (either gstreamer v0.10 or v1.0: the Cool VL Viewer got a media plugin for each) and gstreamer plugins packages ("good", "bad", "ugly", "libav", "ffmpeg", etc) of your Linux distribution if you wish to be able to play streaming media (if you wish to use gstreamer v1.0 with the viewer, make sure to check the "Use gstreamer10 plugin" entry in the "Advanced" -> "Media" menu).
  • The SLVoice client is a 32 bits application: you need the proper 32 bits support libraries to be able to run it under 64 bits Linux.
  • See also the README-linux.txt file, in the installation directory, chapter 3 (INSTALLING & RUNNING), especially about the checking option for missing libraries, and, for sound issues, chapter 5 (ADVANCED TROUBLESHOOTING)

Author:  Henri Beauchamp [ 2011-11-12 18:26:13 ]
Post subject:  Linux unattended installation HOWTO

Unattended/silent/GUI-less installations are possible with the Cool VL Viewer installer: just type "--help" in the installer command line to list the various options.

A typical silent installation would be performed with:
./CoolVLViewer- --mode silent
In which case the viewer is installed in the default directory or, when another destination directory was specified during the installation of a former release of the same viewer version, the installer then installs in that directory.

You may also specify the destination directory in the command line with, for example:
./CoolVLViewer- --mode silent --destination /usr/local/games/CoolVLViewer-1.26.18

Author:  Henri Beauchamp [ 2011-11-12 18:29:54 ]
Post subject:  Linux uninstalling HOWTO

Uninstalling can be done by simply executing the "uninstall" program present in the Cool VL Viewer installation directory.

"uninstall" removes all the files part of the Cool VL Viewer installation, the menu entry, and the file used to save the destination directory of the installed viewer (~/.secondlife/.CoolVLViewer-1.26.X.installdir). It won't uninstall any supplementary files that you would have added to the viewer installation directory.

Please note that you do not need to uninstall a release (e.g. v1.26.18.14) before updating to a newer release (e.g. v1.26.18.15): simply install the new release in the same directory as the old one if you don't want to keep the old release, or choose another destination directory to install the new release if you wish to keep the old release at hand.

Author:  Henri Beauchamp [ 2011-11-12 19:01:10 ]
Post subject:  Linux static UI sounds installation HOWTO

The Cool VL Viewer is capable of using "static" UI sounds instead of UI sounds downloaded from the grid asset server. This has several advantages:
  • Static UI sounds play without delay (they do not require a first download, and they are pre-decoded).
  • Static UI sounds can play at the login screen (i.e. before the viewer connects to the grid).
  • Static UI sounds prevent the UI sounds mix encountered when you log in different grids (since non-static UI sounds are stored in the viewer cache (VFS file) and are different in SL and OpenSim grids but yet share the same UUID, you can get a mix of them when you log in various grids).
Alas, Linden Lab does not allow TPV developers to distribute SL's default UI sounds together with their viewer (this is pretty stupid, since they allow to distribute all the other UI components, such as the icons... but LL does a lot of stupid things, alas !).

So, to take benefit from the static UI sounds feature of the viewer, you will have to install them yourself via the following procedure...

Proceed as follow:
  • Log in and in the "Advanced" -> "Caches" menu, select the "Clear VFS Cache (after restart)" entry: this is only required to get rid of the sounds that have have been cached in the saved VFS.
  • Log off/close the viewer and launch it again/log into SL.
  • Make sure the master audio and UI audio are not muted and their level set so that UI sounds are audible (else they won't play at all and therefore won't get decoded).
  • Go to the "Advanced" -> "User Interface" menu, and choose "Decode all UI sounds". You should hear all the UI sounds playing in sequence.
  • Once all UI sounds have been heard (this may take a few seconds for the viewer to download them all), still in the "Advanced" -> "User Interface" menu, click the "Save decoded UI sounds" entry.

Done ! From now on, the Cool VL Viewer will use the (now static) decoded sound files present in the user_settings/ui_sounds/ directory instead of fetching them from the asset server of the grid you are connected to.

Page 1 of 1 All times are UTC
Powered by phpBB® Forum Software © phpBB Group