[WIN32] fixed some _WIN32PC leftovers.
[xbmc:xbmc.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
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 libsdl-sound1.2-dev libfribidi-dev liblzo2-dev libfreetype6-dev libsqlite3-dev libogg-dev libasound-dev python-sqlite libglew-dev libcurl4-dev x11proto-xinerama-dev libxinerama-dev libxrandr-dev libxrender-dev libmad0-dev libogg-dev libvorbis-dev 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
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.4/+download/libmms-0.4.tar.gz"
49    # tar zxvf libmms-0.4.tar.gz
50    # cd libmms-0.4
51    # ./configure --prefix=/usr
52    # make
53    # sudo make install
54 --------------------------------------------------------------
55 3.2. Use a single command to get all build dependencies
56 --------------------------------------------------------------
57
58 For this, you need to specify the PPA in your apt sources. Please find them on the forum
59
60 http://xbmc.org/forum/showthread.php?t=33327
61
62 Update apt :
63    # sudo apt-get update
64
65 Here is the magic command to get the build dependencies (used to compile the version on the PPA).
66    #  sudo apt-get build-dep xbmc
67
68
69
70 *** For developers and anyone else who compiles frequently it is recommended to use ccache
71 sudo apt-get install ccache
72
73 *** A tip for those with multiple computers at home is to check out distcc (totally unsupported from xbmc ofcourse)
74 sudo apt-get install distcc
75
76 -----------------------------------------------------------------------------
77 4. How to compile
78 -----------------------------------------------------------------------------
79 See README.linux
80
81 -----------------------------------------------------------------------------
82 5. Uninstalling
83 -----------------------------------------------------------------------------
84 $ sudo apt-get remove xbmc*
85
86 -----------------------------------------------------------------------------
87 6. Endword
88 -----------------------------------------------------------------------------
89
90 Have fun!
91
92 EOF
93