Build the Viewer on Linux

The following are instructions for building the Second Life viewer on linux. This process has been used on debian and debian based systems like ubuntu, and also on Fedora. For other platforms, see Get source and compile.
== Required tools ==
There are a number of tools that need to be installed first.
* hg [package: mercurial]
* cmake [package: cmake]
** Currently (snowglobe 1.3.2 and higher) cmake 2.6.2 is the minimum required version.
* yacc or compatible tool [suggested package: bison]
* lex or compatible tool [suggested package: flex]
* python [package: python]
** python 2.4.3 is the minimum required version.
** All more recent 2.x versions should work, too. If you encounter problems or deprecation warnings, please report them.
** python 3.x hasn't been tested yet.
* g++ [package: g++]
** Note (not relevant for standalone): gcc 4.4 (which is in recent Ubuntu and debian) won't work in versions prior to 2.0 (or Snowglobe 1.3) if you are not building standalone (see below), because it chokes on some parts of boost prior to 1.37 (http://svn.boost.org/trac/boost/ticket/2069). The solution is to install GCC 4.3 and to run 'export CXX=/usr/bin/g++-4.3' or whatever your binary is before trying to compile. 
:Another workaround is to use update-alternatives; for example, if you already have 4.4 installed, try this:
 sudo apt-get install g++-4.3
 sudo update-alternatives --remove-all gcc
 sudo update-alternatives --install /usr/bin/gcc gcc /usr/bin/gcc-4.3 43 --slave /usr/bin/g++ g++ /usr/bin/g++-4.3 --slave /usr/bin/gcov gcov /usr/bin/gcov-4.3
 sudo update-alternatives --install /usr/bin/gcc gcc /usr/bin/gcc-4.4 44 --slave /usr/bin/g++ g++ /usr/bin/g++-4.4 --slave /usr/bin/gcov gcov /usr/bin/gcov-4.4
:then choose 4.3:
 sudo update-alternatives --config gcc
* Linden Lab has backported gcc-4.6.3 to Debian Squeeze; this port and its associated libraries are used when building the official Linux viewer.
:The sources and Debian packages for this backport are available from Debian GCC Backport
* libboost-program-options-dev was needed on Ubuntu 8.04 to use cmake, but it's not needed anymore to build a 1.23-render-pipeline on Ubuntu 9.04-beta (nor Snowglobe 2 on Ubuntu 9.10)
* make (package: make)
* bzip2 (package: bzip2)
The build process may use the following optional tools:
* distcc distributed compiler (useful if you have multiple PCs.)
* ccache a fast compiler cache (speed up recompilation, a must if you intend to do development.)
== What does 'Standalone' mean? ==
The current sources no longer use the term "standalone"; it has been replaced by "usesystemlibs".
A standalone build of the viewer refers to building a viewer against the shared libraries that are installed on your system instead of using precompiled libraries provided by Linden Lab.
In order to build standalone, you will have to configure using --standalone, see configuration below.
The advantage of building standalone is that you might use less RAM: you'll be using the same shared libraries
that other applications use. However this is a rather minor advantage. The disadvantages of building standalone is a long list of potential problems: you will have to manually install all the development packages of many many libraries. In some cases there isn't a package for it from your distribution, so you have to especially get those sources separately and compile and install them in a way that the viewer can find them. Building standalone is not supported officially by Linden Lab and therefore not tested. Hence, it might not work at all (although the open source snowglobe developers usually make sure that it works for snowglobe). Nevertheless, every now and then it happens that the viewer won't build with some new released library (ie, boost), in which case you most likely will have to use the latest source code retrieved with subversion.
Nevertheless, there might be reasons that you want to do a standalone build anyway. The most important one being that Linden Lab also doesn't support 64-bit: they do not provided shared libraries for 64-bit; so, if you want to build native 64 bit you must use standalone. Another reason might be that Linden Lab is using a few rather old library versions that are incompatible with newer versions. If you have any reason to use a newer version for some library, then chances are that things will break unless you build standalone. One reason would be if you want to debug a library and fix it because it is buggy.
Conclusion: if you are building the viewer for the first time, and you are building for 32-bit, then you should not use standalone.
== Getting the source ==
The source for the official Viewer's 2.x codebase resides in mercurial repositories hosted on http://bitbucket.org/lindenlab (a.k.a. http://bitbucket.org/lindenlab).
To check out the lindenlab/viewer-release branch, do
 hg clone http://bitbucket.org/lindenlab/viewer-release
This will create a new folder called viewer-release inside your current working directory, containing the source tree. (You can optionally specify a different target directory. See hg help clone.) Other long-lived branches of interest are lindenlab/viewer-beta and lindenlab/viewer-development. Contributions should usually be based on viewer-development.
== Installing the required libraries (that Linden Lab can not or does not provide)==
Even non-standalone still uses a few shared libraries from your system.
This paragraph deals with those libraries. For standalone you will
need a lot more (see later on).
=== Libraries and header files that usually come with a Linux distribution ===
Make sure the libraries and header files for the following packages are installed on your system:
Library 	Debian/Ubuntu 	Fedora/Red Hat
libc.so 	libc6-dev 	glibc-devel
libstdc++.so.6	libstdc++6 	libstdc++-devel
libX11.so 	libx11-dev 	libX11-devel
libGL.so 	nvidia-glx-dev or libgl1-mesa-dev	mesa-libGL-devel
libXrender.so 	libxrender-dev 	libXrender-devel
libidn.so 	libidn11-dev 	libidn11-devel
==== shortcut commands for the above ====
Debian/Ubuntu:
 sudo apt-get install libc6-dev libstdc++6 libx11-dev libxrender-dev libidn11-dev [libgl1-mesa-dev|nvidia-current-dev|...]
Fedora/Red Hat:
 sudo yum install glibc-devel libstdc++-devel libX11-devel mesa-libGL-devel libXrender-devel libidn11-devel
=== Recommended libraries and headers ===
The following packages are required when building standalone, but even if you are building non-standalone you should probably install them.
Library 	Debian/Ubuntu 	Fedora/Red Hat
libGLU.so 	libglu1-mesa-dev 	mesa-libGLU-devel
libz.so 	zlib1g-dev 	zlib-devel
libssl.so 	libssl-dev 	openssl-devel
libogg.so 	libogg-dev 	libogg-devel
libpng12.so 	libpng12-dev 	libpng-devel
libdbus-glib-1.so 	libdbus-glib-1-dev	dbus-glib-devel
libatk-1.0.solibcairo.solibgdk-x11-2.0.solibgdk_pixbuf-2.0.solibgmodule-2.0.solibglib-2.0.solibgtk-x11-2.0.solibgthread-2.0.solibpango-1.0.soand many more	libgtk2.0-dev 	atk-devel cairo-devel gtk2-devel glib2-devel pango-devel
==== shortcut commands for the above (2) ====
Debian/Ubuntu:
<nowiki>
sudo apt-get install libglu1-mesa-dev zlib1g-dev libssl-dev libogg-dev libpng12-dev libdbus-glib-1-dev libgtk2.0-dev
</nowiki>
Fedora/Red Hat:
<nowiki>
sudo yum install mesa-libGLU-devel zlib-devel openssl-devel libogg-devel libpng-devel dbus-glib-devel \
 atk-devel cairo-devel gtk2-devel glib2-devel pango-devel
</nowiki>
== Necessary libraries when building standalone ==
=== Existing package names ===
If you want to build 'standalone', then the following packages are required in addition:
Library 	Debian/Ubuntu 	Fedora/Red Hat 	openSUSE
libopenal.so 	libopenal-dev 	openal-soft-devel 	openal-soft-devel
libvorbis.solibvorbisenc.solibvorbisfile.so 	libvorbis-dev 	libvorbis-devel 	libvorbis-devel
libalut.so 	libalut-dev 	freealut-devel 	freealut-devel
libapr-1.so 	libapr1-dev 	apr-devel 	libapr1-devel
libaprutil-1.so 	libaprutil1-dev 	apr-util-devel 	libapr-util1-devel
libboost_program_options.solibboost_regex.solibboost_signals.so	libboost-dev 	boost-devel 	boost-devel
libcares.so 	libc-ares-dev 	c-ares-devel 	libcares-devel
libxmlrpc-epi.so 	libxmlrpc-epi-dev 	? 	libxmlrpc-epi0-devel
libopenjpeg.so 	libopenjpeg-dev 	openjpeg-devel 	openjpeg-devel
libjpeg.so 	libjpeg62-dev (libjpeg-dev) 	libjpeg-devel 	libjpeg62-devel
libSDL.so 	libsdl1.2-dev 	SDL-devel 	libSDL-devel
libgstreamer-0.10.so 	libgstreamer0.10-dev 	gstreamer-devel 	gstreamer-0_10-devel
gstreamer-0.10 plugins 	libgstreamer-plugins-base0.10-dev	gstreamer-plugins-base-devel	gstreamer-0_10-plugins-base-devel
libgmock.so 	google-mock (Snowglobe 2 only) 	? 	?
==== shortcut commands for the above (3) ====
Debian/Ubuntu:
<nowiki>
sudo apt-get install libopenal-dev libvorbis-dev libalut-dev libapr1-dev libaprutil1-dev libboost-dev \
 libc-ares-dev libxmlrpc-epi-dev libopenjpeg-dev libjpeg62-dev libgtk2.0-dev libsdl1.2-dev \
 libgstreamer0.10-dev libgstreamer-plugins-base0.10-dev google-mock
</nowiki>
Fedora/Red Hat:
<nowiki>
sudo yum install openal-soft-devel libvorbis-devel freealut-devel apr-devel apr-util-devel boost-devel \
 c-ares-devel openjpeg-devel libjpeg-devel SDL-devel gstreamer-devel gstreamer-plugins-base-devel
</nowiki>
openSUSE:
You will have to add the buildservice repository home:lemmy04:snowglobe (http://download.opensuse.org/repositories/home:/lemmy04:/snowglobe/) to your package sources.
<nowiki>
sudo zypper install openal-soft-devel libvorbis-devel freealut-devel libapr1-devel libapr-util1-devel \
 boost-devel libcares-devel libxmlrpc-epi0-devel openjpeg-devel libjpeg62-devel libSDL-devel gstreamer-0_10-devel gstreamer-0_10-plugins-base-devel
</nowiki>
=== More problematic libraries (standalone) ===
Easy so far, now here's where the trouble starts.
Not all required packages are in debian, not to mention you might not even be using debian
of course; but we (standalone builders) rely for the most part on the tremendous work
done by 64-bit pioneer User:Robin_Cornelius who happens to use debian. Although many
required packages are now in debian, some still need to be downloaded from Robin's
private repository (assuming you're on debian). TODO: Add instructions for those not
using ubuntu/debian.
Edit your /etc/apt/sources.list and add the following lines:
 # Repository for SecondLife.
 deb http://apt.byteme.org.uk squeeze main
 deb-src http://apt.byteme.org.uk squeeze main
or
 # Repository for SecondLife.
 deb http://apt.byteme.org.uk lenny main
 deb-src http://apt.byteme.org.uk lenny main
depending on whether you are using testing (squeeze) or stable (lenny).
Note that you won't be able to compile Snowglobe 2.x on lenny because the Qt library is too old.
Run apt-get update to get the Package files from byteme as usual.
You can ignore the warning about the missing public key, or do what is
described at the bottom of this page under 'GPG Keys and Signed repository' (note the remark about not using root), thus:
 % gpg --keyserver hkp://keyserver.ubuntu.com --recv-key 0x729A79A23B7EE764
 % gpg --export 0x729A79A23B7EE764 | sudo apt-key add -
or for ubuntu users we use the openmetaverse repo, run this command to add the repo:
 # Openmetaverse repo
 sudo add-apt-repository ppa:openmetaverse/ppa
NOTE: If you are on Ubuntu 12.04 ("Precise") you will also need to edit the file /etc/apt/sources.list.d/openmetaverse-ppa-precise.list so that it refers to the "lucid" distro instead of "precise" because the maintainers haven't made packages for "precise" yet.
Change /etc/apt/source.list.d/openmetaverse-ppa-precise.list from:
 deb http://ppa.launchpad.net/openmetaverse/ppa/ubuntu precise main
 deb-src http://ppa.launchpad.net/openmetaverse/ppa/ubuntu precise main
To be:
 deb http://ppa.launchpad.net/openmetaverse/ppa/ubuntu lucid main
 deb-src http://ppa.launchpad.net/openmetaverse/ppa/ubuntu lucid main
and of course to add the keys (only on Debian)
 gpg --keyserver hkp://keyserver.ubuntu.com --recv-key 0x50A40F50
 gpg --export 0x50A40F50 | sudo apt-key add -
and always remember to update after adding repos
 apt-get update
Finally install these packages:
Library 	Debian/Ubuntu
libcurl-cares.so	libcurl4-cares-dev
llqtwebkit 	libllqtwebkit-dev (Snowglobe 1) orlibllqtwebkit2-dev (Snowglobe 2)
JsonCpp 	libjsoncpp-dev
libndofdev 	libndofdev-dev (optional, needed if you have a Space Navigator joystick)
glh-linear 	glh-linear (Snowglobe 2 only)
boost-coroutine 	boost-coroutine (Snowglobe 2 only)
Shortcut commands for the above
 sudo apt-get install libcurl4-cares-dev libllqtwebkit2-dev glh-linear boost-coroutine libndofdev-dev
If you are on lenny you will also (automatically) install the packages cmake, libopenjpeg-dev and libopenjpeg2 from byteme. This is because the packages in lenny contain bugs.
The libjsoncpp-dev installs a library called /usr/lib/libjson.so, but the viewer is looking for one called libjson_linux-gcc-${_gcc_COMPILER_VERSION}_libmt.so in '/usr/lib' and '/usr/local/lib'. Therefore execute the following command as root:
 # This is not needed on Snowglobe 1.4.1 and higher.
 % ln -s /usr/lib/libjson.so /usr/local/lib/libjson_linux-gcc-$(g++ -dumpversion)_libmt.so
In order to run the tests, you need a template library called 'tut'. Because this is a template library, we can just use the library archive from Linden Lab for any architecture. Therefore, to install tut, run:
 % scripts/install.py tut
Until recently for some completely mysterious reason, the source code includes <tut/tut.hpp> while
configure checks for tut.h in /usr/lib and /usr/local/lib only (CXXFLAGS?
Never heard of that).
In order to fix this brokenness for non-Snowglobe viewers or based on older snowglobe versions (prior to 1.4, or 2.1),
execute the following (2.x viewers older than 2.1 and 1.x viewers older than 1.4 only):
 # This is not needed on Snowglobe 1.4.1 and higher.
 % sudo touch /usr/local/include/tut.h
which satisfies the configure check. The installed tut.hpp is still used anyway since libraries/include is in the include search path by default. Alternatively, edit indra/cmake/Tut.cmake and comment out these two lines:
 #include(FindTut)
 #include_directories(${TUT_INCLUDE_DIR})
Oh WAIT! On 2.0 standalone libraries/include is NOT included anymore, and it seems impossible
to fix the cmake spaghetti so here's what you have to do on top of the above:
 sudo cp -r libraries/include/tut /usr/local/include
Sorry but there is no other way.
However, if you are using snowglobe 1.4 or a later 1.x, or snowglobe 2.1 or later, or a viewer based on those,
then the viewer actually looks for tut/tut.hpp. So, you can still install it in /usr/local/include/tut/,
but you can also install it in -say- /somewhere/include/tut/ and set the environment variable CMAKE_INCLUDE_PATH
(a colon separated list of paths) to include /somewhere/include before configuration. Note that due to
a cmake problem/bug it will find /somewhere/include but still use the include path of any other library,
including /usr/include or /usr/local/include, so make sure you remove any other tut installation from common
paths if you use the latter method.
=== Get voice chat working (standalone) ===
The voice binaries downloaded for non-standalone builds can be used in for standalone builds, too. Because they'll run as a separate process, this even works with 64-bit builds of the viewer (assuming your system is set up for also running 32-bit binaries). To download and unpack the binaries (which doesn't happen automatically when building standalone) run:
 ${SOURCE_DIR}/scripts/install.py slvoice
After building, you'll have to copy the binaries into the right place
(-- I don't think this is correct as this will also link the viewer against those libraries.
Instead you have to use a script for SLVoice that sets the right LD_LIBRARY_PATH and
then runs the real SLVoice --Aleric Inglewood 12:03, 13 July 2010 (UTC)):
 cp ${SOURCE_DIR}/indra/newview/vivox-runtime/i686-linux/SLVoice ${BUILD_DIR}/newview/packaged/bin/
 cp ${SOURCE_DIR}/indra/newview/vivox-runtime/i686-linux/*.so* ${BUILD_DIR}/newview/packaged/lib/
If you want, you can then remove the voice binaries again from the source tree with
 ${SOURCE_DIR}/scripts/install.py --uninstall vivox
=== Remaining issues (standalone) ===
In order to run the viewer you need to create a 'package' (a directory really, to which everything is copied that is needed to run it).
Unfortunately, if you are building standalone on a 32-bit machine, it still tries to happily copy the Linden Lab provided shared libraries over, which we never even downloaded mind you, causing the packaging to fail. Therefore, edit indra/newview/viewer_manifest.py and comment out the following lines in class Linux_i686Manifest(LinuxManifest):
<nowiki>
 #self.path("libapr-1.so.0")
 #self.path("libaprutil-1.so.0")
 #self.path("libdb-4.2.so")
 #self.path("libcrypto.so.0.9.7")
 #self.path("libexpat.so.1")
 #self.path("libssl.so.0.9.7")
 #self.path("libuuid.so.1")
 #self.path("libSDL-1.2.so.0")
 #self.path("libELFIO.so")
 #self.path("libopenjpeg.so.1.3.0", "libopenjpeg.so.1.3")
 #self.path("libalut.so")
 #self.path("libopenal.so", "libopenal.so.1")
 self.end_prefix("lib")
 # Vivox runtimes
 #if self.prefix(src="vivox-runtime/i686-linux", dst="bin"):
 # self.path("SLVoice")
 # self.end_prefix()
 #if self.prefix(src="vivox-runtime/i686-linux", dst="lib"):
 # self.path("libortp.so")
 # self.path("libvivoxsdk.so")
 # self.end_prefix("lib")
</nowiki>
Also, until VWR-9475 really gets fixed (it was fixed before, but not really),
you need to install the 'SDL' precompiled library on standalone in order to get the needed cursor bitmaps (not necessary for Snowglobe 2.x):
 % scripts/install.py SDL
However, if you are building standalone on 32-bit, that would also cause the wrong (non-system) headers and library to be included, so you will need to remove those again on 32-bit (from libraries/i686-linux/include/ and libraries/i686-linux/lib_release_client/).
== Installing the Non-Free Shared Libraries ==
Needs to be redone - Oz Linden
== Compiling ==
This page describes how to build the Second Life viewer with CMake. CMake is a system for generating per-platform build files. On Linux, it will generate your choice of Makefiles or KDevelop project files.
NOTE: These instructions are for the viewers using cmake (versions 1.21 and beyond). For older viewers (1.20 and earlier) see Compiling the viewer with SCons (Linux)
== Build the viewer with autobuild ==
Configuring and building with autobuild works the same on all platforms. Full instructions may be found at Build_Viewer_With_Autobuild.
=== Configuration notes ===
* To build for 'standalone' (see `What does 'standalone' mean?` above) choose an OpenSourceStandAlone option.
* If you want to use KDevelop add -G KDevelop3.
* Configuring a "non-standalone" version of the source code tree will cause the required (32-bit) third party library packages (as built by Linden Lab) to be downloaded during the CMake build process.
* OpenSource configurations do not install FMOD (which will be disabled).
* The environment variables CC and CXX are picked up automatically as usual. However, this is not the case of CXXFLAGS and LDFLAGS. You can pass the following to the configure commandline: -DCMAKE_CXX_FLAGS:STRING="$CXXFLAGS" -DCMAKE_EXE_LINKER_FLAGS:STRING="$LDFLAGS" to enable the use of these environment variables.
* You can make the build process more verbose (make it print the compiler commands it executes) by passing -DCMAKE_VERBOSE_MAKEFILE:BOOL=ON as well.
* As of version 2.0, passing -DLL_TESTS:BOOL=FALSE will stop running any tests (if any; depends on standalone and viewer version).
* If you want to restart the configuration process from scratch without any cached values affecting the configuration, erase the CMakeCache.txt in the build directory.
* Autobuild appears to bind the CXX and CC env. variables at configuration time. So the following should work if done once:
** CXX=g++-4.1 CC=gcc-4.1 autobuild configure -c Release
=== Where's the built viewer? ===
On Linux, your build will be at
 build-linux-ARCH/newview/packaged
where "ARCH" should be something like "i686" or "x86_64" (depending on your platform).
=== Using ccache ===
It is very highly recommended that you use and install ccache even before
the first compile; it will speed up subsequent compiles with a factor of 10 in case you need to redo the compile!
The easiest way to start using ccache is to make symbolic links to ccache
from /usr/local/bin. Make sure that /usr/local/bin comes first in your PATH,
before the real g++. Thus, as root and assuming you are using gcc/g++ (don't do this if you are using distcc, see below),
 % apt-get install ccache
 % cd /usr/local/bin
 % ln -s ../../bin/ccache gcc
 % ln -s ../../bin/ccache g++
And then to test, as normal user (make sure you are not in /usr/local/bin anymore),
 % which g++
This should print /usr/local/bin/g++, if not fix you PATH.
Note that by default ccache puts the cache in $HOME/.ccache and will grow till about 1 GB, so make sure you have that diskspace there. Alternatively you can set the environment variable CCACHE_DIR to change the location of the cache.
=== Using distcc ===
If you have multiple PCs, you can speed up the build process by using distcc.
You probably should still use ccache which has to be run before distcc, therefore
both have to be specified in the CXX environment variable, by adding ccache to them.
To use distcc, you need to pass an environment variable CXX containing the distcc command prefix to develop.py when configuring, e.g., 
 CXX="ccache distcc g++" ./develop.py configure
Or, if you are using a heterogeneous rows of PCs, you need to add a config prefix to g++, e.g. (in my case, as a Fedora user),
 CXX="ccache distcc i386-redhat-linux-g++" ./develop.py configure
Once you did so, the generated makefiles contain instructions to use distcc. You don't need to specify anything special when invoking develop.py to build. The number of concurrent jobs (i.e., -j option to make command) to run is automatically determined by develop.py.
If you invoke make command by yourself, don't forget to add the -j option with an appropriate number.
= What to do if it doesn't work for you =
* Ask for help on IRC (irc.freenode.net #opensl)
* Find someone on the opensource-dev mailing list
* Fix it: Modifying CMake Files‎ (and please, submit a patch!)
* If you are building on openSUSE 11.2 or newer, and your builds fail with lots of "undefined reference to ..." message: set the environment variable SUSE_ASNEEDED to 0 before building.
= Submitting Patches =
This is probably far down the road, but if you make changes to the source and want to submit them, see the page about submitting patches.
----
= Prebuilt libraries vs. standalone builds =
For standalone builds, we'd really like to beef up the checks for system libraries so that for example cmake will fail if a required library (such as OpenJPEG) isn't installed. We welcome all patches that help out with this.
* cmake-SL: a script for standalone, pre-built and mixed libraries viewer builds under Linux.
* Problems when compiling a standalone Linux viewer
== Testing and packaging the client ==
=== Testing the result from inside the tree ===
You may find it simpler and less error-prone to follow the instructions in the Packaging the client section below to run the client under the same conditions as an end-user would.
* 2008-05-29 (Ochi Wolfe): Compiling the 1.20.7 r88152 viewer, it seems like even when compiling as "release" the viewer is built ready-to-go inside the newview/packaged/ directory including the message_template.msg and message.xml in the right place. Try to cd to the newview/packaged/ directory and run SL from there with the ./secondlife command as you would normally do.
Otherwise:
* Preparing to run 'in-tree'
** ensure that you have indra/newview/app_settings/static_*.db2 - if not, you'll find it in the slviewer-artwork download (a zip file).
** now, from the indra directory:
 $ cp ../scripts/messages/message_template.msg newview/app_settings/
 $ cp ../etc/message.xml newview/app_settings/
Important: Starting from version 1.18.0, copying message.xml is also required. Missing it will cause group IMs to fail to work, although the viewer will run fine otherwise.
* Running it: The LD_LIBRARY_PATH stuff ensures that the binary looks for its libraries in the right places. From the indra directory:
 $ ( cd newview && LD_LIBRARY_PATH="`pwd`"/../../libraries/i686-linux/lib_release_client:"`pwd`"/app_settings/mozilla-runtime-linux-i686:${LD_LIBRARY_PATH}:/usr/local/lib ./secondlife-i686-bin )
==== The client seems kinda slow. ====
By default, the open-source Second Life Viewer uses the open-source OpenJPEG library to decode the (many) JPEG-2000 texture images it receives from the servers. This isn't quite of comparable speed to the proprietary third-party library which the Linden Lab viewer builds have traditionally used, for which we are not permitted to redistribute the source.
However, the slviewer-linux-libs package includes two pre-built libraries which facilitate the use of this slightly faster image decoding method: libkdu_v42R.so and libllkdu.so. These are provided for your testing; again, we are not permitted to grant you the right to re-distribute these libraries to downstream users, but the viewer will still work (albeit slightly slower) without them.
To use these faster image-decoding libraries, they simply need to be put into the right places relative to the viewer runtime directory - nothing needs to be reconfigured or recompiled. If you're running the client from the source tree, the following will make the KDU libraries available:
 cp "$SLSRC/libraries/i686-linux/lib_release_client/libllkdu.so" "$SLSRC/indra/newview/libllkdu.so"
 mkdir "$SLSRC/indra/lib"
 cp "$SLSRC/libraries/i686-linux/lib_release_client/libkdu_v42R.so" "$SLSRC/indra/lib/libkdu_v42R.so"
The file indra/newview/viewer_manifest.py contains some commented-out entries describing where these libraries belong; if you uncomment the two lines corresponding to libllkdu and libkdu then they will be automatically copied into the right place in the runtime directory when you follow the 'Packaging the client' instructions below.
==== File Dialogs Don't Work on 64 bit system ====
If you run a 64 bit system, and your file dialogs don't work, or they worked before and stopped after you installed an update, it may be due to a mismatch between the headers used to compile the viewer and the library it's using. The log will contain something like this:
 2007-06-21T01:28:35Z INFO: ll_try_gtk_init: Starting GTK Initialization.
 2007-06-21T01:28:36Z INFO: ll_try_gtk_init: GTK Initialized.
 2007-06-21T01:28:36Z INFO: ll_try_gtk_init: - Compiled against GTK version 2.10.11
 2007-06-21T01:28:36Z INFO: ll_try_gtk_init: - Running against GTK version 2.10.6
 2007-06-21T01:28:36Z WARNING: ll_try_gtk_init: - GTK COMPATIBILITY WARNING: Gtk+ version too old (micro mismatch)
What happens here is that your distribution includes 32 bit GTK libraries, but the package only includes the libraries themselves and not the headers. When building, the SL client will build against the headers included with the main 64 bit GTK package. This will work if the 64 bit version of the library is the same or older than the 32 bit one. However, if your 32 bit library is older, then the viewer will detect the mismatch (built with headers for a newer version of GTK than it's using) and turn GTK off.
Possible solutions:
* Download the source for the version of the 32 bit GTK libraries your distribution comes with, and build your viewer against those headers.
* Upgrade your 32 bit GTK package so that it's the same or newer as the 64 bit one.
* Downgrade your 64 bit package (may not be a good idea).
=== Packaging the client ===
If you substitute 'BUILD=release' with 'BUILD=releasefordownload' in the 'Compiling' section above, then packaging the resulting code, libraries, data and documentation into a tarball for the end-user will be done automatically as the final stage of the build process; the pristine end-user client distribution has been assembled into the directory indra/newview/SecondLife_i686_1_X_Y_Z/ and has also been tarred into indra/newview/SecondLife_i686_1_X_Y_Z.tar.bz2
The file which controls what (and where) files go into the end-user runtime viewer directory is indra/newview/viewer_manifest.py
== Resident contributed instructions ==
=== Automated libraries and headers adjustments, compilation and packaging ===
Here are two scripts (one for v1.20 and older, and one for v1.21 and newer viewers) that basically do all what is described above, and more, and entitle you to compile a SL client very easily:
* User:Henri Beauchamp/Automated Linux Build Script (1.20 and earlier)
* User:Henri Beauchamp/Building the viewer with CMake/cmake-SL script
* Please also see the (user contributed) instructions at User:Michelle2_Zenovka/cmake
=== FreeBSD ===
A list of patches is given for Compiling the viewer (FreeBSD). They are obsolete, and no longer work.
Category:Compiling viewer
Category:Articles_in_need_of_updating