fixed: accidentally deleted character from README.ubuntu
[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. Uninstalling
7
8 -----------------------------------------------------------------------------
9 1. Introduction
10 -----------------------------------------------------------------------------
11
12 We currently recommend Ubuntu Hardy(8.04) or later.
13 A gfx-adapter with OpenGL acceleration is highly recommended and 24/32 
14 bitdepth is required with OpenGL.
15
16 NOTE TO NEW LINUX USERS: All lines that are prefixed with the '#'
17 character are commands that need to be typed into a terminal window /
18 console (similar to the command prompt for Windows). Note that the '#'
19 character itself should NOT be typed as part of the command.
20
21 -----------------------------------------------------------------------------
22 2. Getting the source code
23 -----------------------------------------------------------------------------
24
25    # sudo apt-get install subversion
26    # cd $HOME
27    # svn checkout http://xbmc.svn.sourceforge.net/svnroot/xbmc/trunk xbmc
28
29 -----------------------------------------------------------------------------
30 3. Installing the required Ubuntu packages
31 -----------------------------------------------------------------------------
32
33 Two methods exist to install the required Ubuntu packages:
34
35 --------------------------------------------------------------------
36 3.1. Copy and paste the following line corresponding to your system
37 --------------------------------------------------------------------
38
39 For Ubuntu (all versions >= 7.04):
40
41    # 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 libmicrohttpd-dev libmodplug-dev
42
43 On 8.10 and older versions, libcurl is outdated and thus XBMC will not compile properly.
44 In this case you will have to manually compile the latest version.
45    # wget http://curl.sourceforge.net/download/curl-7.19.7.tar.gz
46    # tar -xzf curl-7.19.7.tar.gz
47    # cd curl-7.19.7
48    # ./configure --disable-ipv6 --without-libidn --without-libssh2 --disable-ldap --prefix=/usr
49    # make
50    # sudo make install
51
52 On 8.04 and older versions, libmms is outdated and thus XBMC will not compile properly.
53 In this case you will have to manually compile the latest version.
54    # wget "http://launchpad.net/libmms/trunk/0.5/+download/libmms-0.5.tar.gz"
55    # tar zxvf libmms-0.5.tar.gz
56    # cd libmms-0.5
57    # ./configure --prefix=/usr
58    # make
59    # sudo make install
60
61 On 8.04 and older versions, libmodplug is outdated and thus XBMC will not compile properly.
62 In this case you will have to manually compile the latest version. Luckly the source is
63 already in the XBMC source code tree.
64    # apt-get remove libmodplug-dev
65    # cd lib/libmodplug
66    # ./configure
67    # make
68    # sudo make install
69
70 --------------------------------------------------------------
71 3.2. Use a single command to get all build dependencies
72 --------------------------------------------------------------
73
74 For this, you need to specify the PPA in your apt sources. Please find them on the forum
75
76 http://forum.xbmc.org/showthread.php?t=33327
77
78 Update apt:
79    # sudo apt-get update
80
81 Here is the magic command to get the build dependencies (used to compile the version on the PPA).
82    #  sudo apt-get build-dep xbmc
83
84 *** Avoid using "aptitude" for the build-dep command. It doesn't resolve everything.
85
86 *** For developers and anyone else who compiles frequently it is recommended to use ccache
87 sudo apt-get install ccache
88
89 *** A tip for those with multiple computers at home is to check out distcc (totally unsupported from xbmc of course)
90 sudo apt-get install distcc
91
92 -----------------------------------------------------------------------------
93 4. How to compile
94 -----------------------------------------------------------------------------
95 See README.linux
96
97 -----------------------------------------------------------------------------
98 5. Uninstalling
99 -----------------------------------------------------------------------------
100 $ sudo apt-get remove xbmc*
101
102 EOF
103