Cool VL Viewer forum

View unanswered posts | View active topics It is currently 2022-01-21 19:41:34

This topic is locked, you cannot edit posts or make further replies.  [ 5 posts ] 
Linux installation HOWTO 
Author Message

Joined: 2009-03-17 18:42:51
Posts: 4809
Here are the installation steps (in this example, for v1.28.2.24):

  • 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.

    Before clicking the "Finish" button, and if it is the first time you install the viewer, you might yet want to check for the proper presence of all the system libraries dependencies. To do so, press the "Verify libraries dependencies" button and you will get something like this:
    In the event a library is missing, use the software manager of your Linux distribution to find and install the corresponding package.

    If you wish to use voice, and even if (like in the above example) you got all the 32 bits libraries needed by the deprecated 32 bits voice client, you yet might want to install the up to date Windows client, that will be ran via Wine. The "Install Wine SLVoice.exe" button is there for this purpose (it launches the installed script); note however, that this is a per-Linux-account installation (in our example, and since we installed the viewer as root, only the root user would have the Wine voice client installed), and in such a case you should instead run the script directly from the Linux account(s) you will actually use the viewer with.

  • With recent versions of some Linux distributions (e.g. Fedora 33), the OpenAL libraries are not installed by default any more, and since they are not distributed with the viewer, this would cause a failure for the latter to start. Simply make sure that OpenAL is installed on your system (you may also use './cool_vl_viewer --check-libs' to check for any missing dependencies).
  • Make sure you installed all the gstreamer v1.0 and gstreamer plugins packages ("good", "bad", "ugly", "libav", "ffmpeg", etc) of your Linux distribution if you wish to be able to play streaming media.
  • The old Linux 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 this message for using a newer voice client.
  • 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)

2009-06-02 18:16:02
Profile WWW

Joined: 2009-03-17 18:42:51
Posts: 4809
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.28.2

2011-11-12 18:26:13
Profile WWW

Joined: 2009-03-17 18:42:51
Posts: 4809
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.28.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.28.2.23) before updating to a newer release (e.g. v1.28.2.24): 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.

2011-11-12 18:29:54
Profile WWW

Joined: 2009-03-17 18:42:51
Posts: 4809
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 assets cache 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 assets cache (after restart)" entry: this is only required to get rid of the sounds that have already been cached (possibly from other grids).
  • 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 ~/.secondlife/user_settings/ui_sounds/ directory instead of fetching them from the asset server of the grid you are connected to.

2011-11-12 19:01:10
Profile WWW

Joined: 2009-03-17 18:42:51
Posts: 4809
A long time ago, Linden Lab and Vivox stopped providing updated voice clients for Linux.

The "last known good" Linux voice client is bundled with the Cool VL Viewer, but it is not guaranteed to properly work any more (in particular, it may fail to connect, fail to update the speakers list in a timely manner, or fail to do peer to peer voice sessions with a resident using a newer voice client). It also requires 32 bits libraries (glibc and a few others, usually found in an "ia32-libs" package of Linux distributions).

If you do need voice under Linux, I recommend that you install Wine (either of the 32 or 64 bits versions will do) and fire the provided script in order to let it setup SLVoice.exe support for the viewer (this is a per-Linux-user-account installation that needs to performed only once and for all, but for each Linux user account from which you are using the viewer); the script gives all the explanations about what it is doing. Once the Windows version of the voice client has been successfully installed, the viewer will use it instead of the deprecated Linux SLVoice client...

EDIT: also now accepts the "-c" (or "--config") and "-r" (or "--regedit") options, which launch, respectively, winecfg and regedit for the ~/.wine-slvoice prefix. This allows to reconfigure and/or fine-tune your Wine SLVoice installation.

2020-11-21 10:57:56
Profile WWW
Display posts from previous:  Sort by  
This topic is locked, you cannot edit posts or make further replies.   [ 5 posts ] 

Who is online

Users browsing this forum: No registered users and 2 guests

You cannot post new topics in this forum
You cannot reply to topics in this forum
You cannot edit your posts in this forum
You cannot delete your posts in this forum
You cannot post attachments in this forum

Search for:
Jump to:  
Powered by phpBB® Forum Software © phpBB Group
Designed by ST Software.