added: ticket #8540 - Enable visualizer when playing audio-only files via DVDPlayer...
[xbmc:xbmc-antiquated.git] / README.ubuntu
1 TOC
2 1. Introduction
3 2. Getting the source code
4 3. Installing the required Ubuntu packages
5 4. How to compile
6 5. How to run
7 6. Uninstalling
8 7. Endword
9
10 -----------------------------------------------------------------------------
11 1. Introduction
12 -----------------------------------------------------------------------------
13
14 We currently recommend Ubuntu Hardy(8.04), Intrepid(8.10), or Jaunty(9.04). 
15 A gfx-adapter with OpenGL acceleration is highly recommended and 24/32 
16 bitdepth is required with OpenGL.
17
18 NOTE TO NEW LINUX USERS: All lines that are prefixed with the '#'
19 character are commands that need to be typed into a terminal window /
20 console (similar to the command prompt for Windows). Note that the '#'
21 character itself should NOT be typed as part of the command.
22
23
24 -----------------------------------------------------------------------------
25 2. Getting the source code
26 -----------------------------------------------------------------------------
27
28    # sudo apt-get install subversion
29    # cd $HOME
30    # svn checkout https://xbmc.svn.sourceforge.net/svnroot/xbmc/trunk xbmc
31
32 -----------------------------------------------------------------------------
33 3. Installing the required Ubuntu packages
34 -----------------------------------------------------------------------------
35
36 Two methods exist to install the required Ubuntu packages :
37
38 --------------------------------------------------------------------
39 3.1. Copy and paste the following line corresponding to your system
40 --------------------------------------------------------------------
41
42 For Ubuntu (all versions >= 7.04):
43
44    # sudo aptitude install subversion make g++ gcc gawk pmount libtool nasm automake cmake gperf unzip bison libsdl-dev libsdl-image1.2-dev libsdl-gfx1.2-dev libsdl-mixer1.2-dev libfribidi-dev liblzo2-dev libfreetype6-dev libsqlite3-dev libogg-dev libasound-dev python-sqlite libglew-dev libcurl3 libcurl4-openssl-dev x11proto-xinerama-dev libxinerama-dev libxrandr-dev libxrender-dev libmad0-dev libogg-dev libvorbisenc2 libsmbclient-dev libmysqlclient-dev libpcre3-dev libdbus-1-dev libhal-dev libhal-storage-dev libjasper-dev libfontconfig-dev libbz2-dev libboost-dev libfaac-dev libenca-dev libxt-dev libxtst-dev libxmu-dev libpng-dev libjpeg-dev libpulse-dev mesa-utils libcdio-dev libsamplerate-dev libmms-dev libmpeg3-dev libfaad-dev libflac-dev libiso9660-dev libass-dev libssl-dev fp-compiler gdc libwavpack-dev libmpeg2-4-dev
45
46 On 8.04 and older versions, libmms is outdated and thus XBMC will not compile properly.
47 In this case you will have to manually compile the latest version.
48    # wget "http://launchpad.net/libmms/trunk/0.5/+download/libmms-0.5.tar.gz"
49    # tar zxvf libmms-0.5.tar.gz
50    # cd libmms-0.5
51    # ./configure --prefix=/usr
52    # make
53    # sudo make install
54
55 On 8.10 and older versions, libcurl is outdated and thus XBMC will not compile properly.
56 In this case you will have to manually compile the latest version.
57    # wget http://curl.sourceforge.net/download/curl-7.19.7.tar.gz
58    # tar -xzf curl-7.19.7.tar.gz
59    # cd curl-7.19.7
60    # ./configure --disable-ipv6 --without-libidn --without-libssh2 --disable-ldap --prefix=/usr
61    # make
62    # sudo make install
63
64 --------------------------------------------------------------
65 3.2. Use a single command to get all build dependencies
66 --------------------------------------------------------------
67
68 For this, you need to specify the PPA in your apt sources. Please find them on the forum
69
70 http://xbmc.org/forum/showthread.php?t=33327
71
72 Update apt :
73    # sudo apt-get update
74
75 Here is the magic command to get the build dependencies (used to compile the version on the PPA).
76    #  sudo apt-get build-dep xbmc
77
78 *** Avoid using "aptitude" for the build-dep command. It doesn't resolve everything.
79
80 *** For developers and anyone else who compiles frequently it is recommended to use ccache
81 sudo apt-get install ccache
82
83 *** A tip for those with multiple computers at home is to check out distcc (totally unsupported from xbmc ofcourse)
84 sudo apt-get install distcc
85
86 -----------------------------------------------------------------------------
87 4. How to compile
88 -----------------------------------------------------------------------------
89 See README.linux
90
91 -----------------------------------------------------------------------------
92 5. Uninstalling
93 -----------------------------------------------------------------------------
94 $ sudo apt-get remove xbmc*
95
96 -----------------------------------------------------------------------------
97 6. Endword
98 -----------------------------------------------------------------------------
99
100 Have fun!
101
102 EOF
103