Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with
or
.
Download ZIP
Newer
Older
100644 184 lines (136 sloc) 7.644 kB
7ec5182 added: Very competent 'build.sh' script created by AlTheKiller.
pike2k authored
1 TOC
2 1. Introduction
3 2. Getting the source code
4 3. Installing the required Ubuntu packages
5 4. How to compile
6 4.1 Using build.sh
7 4.2 Manual build
8 5. How to run
9 6. Tips n' Tricks section
10 7. Endword
11
3b8696d added: analog/axis support for joysticks/gamepads. See Keymap.xml for…
d4rkm4ster authored
12 -----------------------------------------------------------------------------
7ec5182 added: Very competent 'build.sh' script created by AlTheKiller.
pike2k authored
13 1. Introduction
3b8696d added: analog/axis support for joysticks/gamepads. See Keymap.xml for…
d4rkm4ster authored
14 -----------------------------------------------------------------------------
7ec5182 added: Very competent 'build.sh' script created by AlTheKiller.
pike2k authored
15
3b8696d added: analog/axis support for joysticks/gamepads. See Keymap.xml for…
d4rkm4ster authored
16 This is a very early port of XBMC to Linux. It's target is developers
17 and not end-users. We don't offer end-user support yet, and we're not
18 really interrested to hear about bugs unless you can help track it
19 down and possibly help with fixing it. We currently recommend Ubuntu
20 7.04 (Feisty Fawn) as a development platform. A gfx-adapter with
21 OpenGL acceleration is highly recommended and 24/32 bitdepth is
22 required with OpenGL.
7ec5182 added: Very competent 'build.sh' script created by AlTheKiller.
pike2k authored
23
907815a updated: README.linux. Clarification for new linux users.
d4rkm4ster authored
24 NOTE TO NEW LINUX USERS: All lines that are prefixed with the '#'
25 character are commands that need to be typed into a terminal window /
26 console (similar to the command prompt for Windows). Note that the '#'
27 character itself should NOT be typed as part of the command.
28
3b8696d added: analog/axis support for joysticks/gamepads. See Keymap.xml for…
d4rkm4ster authored
29
30 -----------------------------------------------------------------------------
7ec5182 added: Very competent 'build.sh' script created by AlTheKiller.
pike2k authored
31 2. Getting the source code
3b8696d added: analog/axis support for joysticks/gamepads. See Keymap.xml for…
d4rkm4ster authored
32 -----------------------------------------------------------------------------
7ec5182 added: Very competent 'build.sh' script created by AlTheKiller.
pike2k authored
33
34 # sudo apt-get install subversion
35 # cd $HOME
36 # svn checkout https://xbmc.svn.sourceforge.net/svnroot/xbmc/branches/linuxport/XBMC
37
3b8696d added: analog/axis support for joysticks/gamepads. See Keymap.xml for…
d4rkm4ster authored
38
39 -----------------------------------------------------------------------------
7ec5182 added: Very competent 'build.sh' script created by AlTheKiller.
pike2k authored
40 3. Installing the required Ubuntu packages
3b8696d added: analog/axis support for joysticks/gamepads. See Keymap.xml for…
d4rkm4ster authored
41 -----------------------------------------------------------------------------
7ec5182 added: Very competent 'build.sh' script created by AlTheKiller.
pike2k authored
42
665bb8b Fixed: packages required to compile XBMC on Gutsy Gibbon
yuvalt authored
43 For Ubuntu 7.04 (Feisty Fawn):
44
7ec5182 added: Very competent 'build.sh' script created by AlTheKiller.
pike2k authored
45 # sudo apt-get install make g++-4.1 gcc-4.1 libsdl1.2-dev libsdl-image1.2-dev libsdl-gfx1.2-dev libsdl-mixer1.2-dev libsdl-sound1.2-dev libsdl-stretch-dev libcdio6 libcdio-dev libfribidi0 libfribidi-dev liblzo1 liblzo-dev libfreetype6 libfreetype6-dev libsqlite3-0 libsqlite3-dev libogg-dev libsmbclient-dev libsmbclient libasound2-dev python2.4-dev python2.4 python-sqlite libglew1 libglew-dev libcurl3-dev g++ gawk x11proto-xinerama-dev libxinerama-dev
46
665bb8b Fixed: packages required to compile XBMC on Gutsy Gibbon
yuvalt authored
47 For Ubuntu 7.10 (Gutsy Gibbon):
48
49 # sudo apt-get install make g++-4.1 gcc-4.1 libsdl1.2-dev libsdl-image1.2-dev libsdl-gfx1.2-dev libsdl-mixer1.2-dev libsdl-sound1.2-dev libsdl-stretch-dev libcdio6 libcdio-dev libfribidi0 libfribidi-dev liblzo1 liblzo-dev libfreetype6 libfreetype6-dev libsqlite3-0 libsqlite3-dev libogg-dev libsmbclient-dev libsmbclient libasound2-dev python2.4-dev python2.4 python-sqlite libglew1.4 libglew1.4-dev libcurl3-dev g++ gawk x11proto-xinerama-dev libxinerama-dev
3b8696d added: analog/axis support for joysticks/gamepads. See Keymap.xml for…
d4rkm4ster authored
50
51 -----------------------------------------------------------------------------
7ec5182 added: Very competent 'build.sh' script created by AlTheKiller.
pike2k authored
52 4. How to compile
3b8696d added: analog/axis support for joysticks/gamepads. See Keymap.xml for…
d4rkm4ster authored
53 -----------------------------------------------------------------------------
7ec5182 added: Very competent 'build.sh' script created by AlTheKiller.
pike2k authored
54
3b8696d added: analog/axis support for joysticks/gamepads. See Keymap.xml for…
d4rkm4ster authored
55 ----------------------------------------
7ec5182 added: Very competent 'build.sh' script created by AlTheKiller.
pike2k authored
56 4.1 Using build.sh
3b8696d added: analog/axis support for joysticks/gamepads. See Keymap.xml for…
d4rkm4ster authored
57 ----------------------------------------
58
59 AlTheKiller has made a fantastic script that makes it a breeze to
60 build a working (depending on state of SVN naturally) XBMC solution.
61 It handles the SVN update, build process and the copying of all needed
62 files to the folder of your choice. ./BUILD is the default target
63 location. The script also creates a backup of your UserData, scripts
64 and 3rd party skin/s folders. Do './build.sh --help' to get all
65 options.
7ec5182 added: Very competent 'build.sh' script created by AlTheKiller.
pike2k authored
66
67 Usage (examples):
68
3b8696d added: analog/axis support for joysticks/gamepads. See Keymap.xml for…
d4rkm4ster authored
69 .1 Make a 3D version with debug (requires OpenGL hardware acceleration
70 support on gfx-adapter)
7ec5182 added: Very competent 'build.sh' script created by AlTheKiller.
pike2k authored
71 # ./build.sh
72
3b8696d added: analog/axis support for joysticks/gamepads. See Keymap.xml for…
d4rkm4ster authored
73 .2 Make a SDL 2D version (very slow) + no debug (more CONFIGOPT's are
74 listed below in section 4.2)
7ec5182 added: Very competent 'build.sh' script created by AlTheKiller.
pike2k authored
75 # ./build.sh CONFIGOPT=--disable-gl CONFIGOPT=--disable-debug
76
3b8696d added: analog/axis support for joysticks/gamepads. See Keymap.xml for…
d4rkm4ster authored
77 build.sh supports reading options from an external file:
78 '~/.xbmc-build-settings'. The options are delimited with space,
79 here's an example line which disables debug and never ask for
80 confirmation unless an error occur: 'CONFIGOPT=--disable-debug
81 CONFIRM'(remove the ''). Do build.sh --help for more options
82
83 ----------------------------------------
7ec5182 added: Very competent 'build.sh' script created by AlTheKiller.
pike2k authored
84 4.2 Manual build
3b8696d added: analog/axis support for joysticks/gamepads. See Keymap.xml for…
d4rkm4ster authored
85 ----------------------------------------
7ec5182 added: Very competent 'build.sh' script created by AlTheKiller.
pike2k authored
86
87 To create the XBMC executable manually perform these two steps:
3b8696d added: analog/axis support for joysticks/gamepads. See Keymap.xml for…
d4rkm4ster authored
88
7ec5182 added: Very competent 'build.sh' script created by AlTheKiller.
pike2k authored
89 .1 # ./configure <option1> <option2> <etc>
3b8696d added: analog/axis support for joysticks/gamepads. See Keymap.xml for…
d4rkm4ster authored
90
7ec5182 added: Very competent 'build.sh' script created by AlTheKiller.
pike2k authored
91 These configure options exist:
92 --disable-debug disable debug mode (default is enabled)
93 --disable-gl disable OpenGL rendering and instead use 2D SDL (default is enabled). This is not recommended.
e97d7f8 git-svn-id: https://xbmc.svn.sourceforge.net/svnroot/xbmc/branches/li…
pike2k authored
94 --enable-profiling enable gprof profiling (default is disabled)
7ec5182 added: Very competent 'build.sh' script created by AlTheKiller.
pike2k authored
95 --disable-joystick disable SDL joystick support (default is enabled)
e97d7f8 git-svn-id: https://xbmc.svn.sourceforge.net/svnroot/xbmc/branches/li…
pike2k authored
96 --help shows all options, useful fallback if this README becomes outdated
7ec5182 added: Very competent 'build.sh' script created by AlTheKiller.
pike2k authored
97
98 .2 # make
3b8696d added: analog/axis support for joysticks/gamepads. See Keymap.xml for…
d4rkm4ster authored
99
100 Tip: by adding -j<number> to the make command, you describe how many
101 concurrent jobs will be used. So for dualcore the command is:
102
7ec5182 added: Very competent 'build.sh' script created by AlTheKiller.
pike2k authored
103 # make -j2
104
3b8696d added: analog/axis support for joysticks/gamepads. See Keymap.xml for…
d4rkm4ster authored
105 -----------------------------------------------------------------------------
7ec5182 added: Very competent 'build.sh' script created by AlTheKiller.
pike2k authored
106 5. How to run
3b8696d added: analog/axis support for joysticks/gamepads. See Keymap.xml for…
d4rkm4ster authored
107 -----------------------------------------------------------------------------
7ec5182 added: Very competent 'build.sh' script created by AlTheKiller.
pike2k authored
108
3b8696d added: analog/axis support for joysticks/gamepads. See Keymap.xml for…
d4rkm4ster authored
109 ----------------------------------------
110 5.1 build.sh
111 ----------------------------------------
112 If using build.sh with default options, simply:
7ec5182 added: Very competent 'build.sh' script created by AlTheKiller.
pike2k authored
113 # cd BUILD
114 # ./XboxMediaCenter
115
3b8696d added: analog/axis support for joysticks/gamepads. See Keymap.xml for…
d4rkm4ster authored
116 ----------------------------------------
117 5.2 Manual
118 ----------------------------------------
119 If compiling manually you can use build.sh to prepare the BUILD
7ec5182 added: Very competent 'build.sh' script created by AlTheKiller.
pike2k authored
120 What it does:
121 * Copies needed files & folders to a BUILD folder incl. main executable
122 * Backs up UserData, scripts and 3rd party skin/s folders
123 * Fixes case sensitivity issues by renaming some files & folders
63ac5d6 Added: new script 'noT3CH.sh' that removes the need for T3CH build.
pike2k authored
124 Usage:
7ec5182 added: Very competent 'build.sh' script created by AlTheKiller.
pike2k authored
125 # ./build.sh NOUPDATE NOCOMPILE
126 # cd BUILD
127 # ./XboxMediaCenter
128
3b8696d added: analog/axis support for joysticks/gamepads. See Keymap.xml for…
d4rkm4ster authored
129
130 -----------------------------------------------------------------------------
7ec5182 added: Very competent 'build.sh' script created by AlTheKiller.
pike2k authored
131 6. Tips n' Tricks section
3b8696d added: analog/axis support for joysticks/gamepads. See Keymap.xml for…
d4rkm4ster authored
132 -----------------------------------------------------------------------------
7ec5182 added: Very competent 'build.sh' script created by AlTheKiller.
pike2k authored
133
3b8696d added: analog/axis support for joysticks/gamepads. See Keymap.xml for…
d4rkm4ster authored
134 ----------------------------------------
7ec5182 added: Very competent 'build.sh' script created by AlTheKiller.
pike2k authored
135 6.1 Fullscreen
3b8696d added: analog/axis support for joysticks/gamepads. See Keymap.xml for…
d4rkm4ster authored
136 ----------------------------------------
dace9de updated:
d4rkm4ster authored
137
3b8696d added: analog/axis support for joysticks/gamepads. See Keymap.xml for…
d4rkm4ster authored
138 Toggle FS with the \ key while XBMC is running. To start XBMC in
139 fullscreen mode append a '-fs' to the command line.
dace9de updated:
d4rkm4ster authored
140
3b8696d added: analog/axis support for joysticks/gamepads. See Keymap.xml for…
d4rkm4ster authored
141 ----------------------------------------
7ec5182 added: Very competent 'build.sh' script created by AlTheKiller.
pike2k authored
142 6.2 Multi-monitor Fullscreen
3b8696d added: analog/axis support for joysticks/gamepads. See Keymap.xml for…
d4rkm4ster authored
143 ----------------------------------------
144
145 If you have a multi-monitor setup and you want to run XBMC fullscreen
146 only on one monitor, then make sure to set the environment variable
147 SDL_VIDEO_FULLSCREEN_HEAD to the display no. which you want to use.
dace9de updated:
d4rkm4ster authored
148
3b8696d added: analog/axis support for joysticks/gamepads. See Keymap.xml for…
d4rkm4ster authored
149 For e.g. "SDL_VIDEO_FULLSCREEN_HEAD=1 ./XboxMediaCenter" to tell XBMC
150 to use display no.1.
dace9de updated:
d4rkm4ster authored
151
2555e3e added: [ 1776998 ] linux: improved description of nvidia twinview iss…
spiff_ authored
152 Note: Nvidia Twinview users should be aware that X treats the twinviewed displays as the same head.
153 If you want to run fullscreen XBMC on one display and start it from the other you must configure X with
154 two "Device" sections against the same physical card. See chapter 16 of the Nvidia user guide for
155 information on how to do this.
dace9de updated:
d4rkm4ster authored
156
3b8696d added: analog/axis support for joysticks/gamepads. See Keymap.xml for…
d4rkm4ster authored
157 ----------------------------------------
7ec5182 added: Very competent 'build.sh' script created by AlTheKiller.
pike2k authored
158 6.3 Channel downmixing
3b8696d added: analog/axis support for joysticks/gamepads. See Keymap.xml for…
d4rkm4ster authored
159 ----------------------------------------
160
161 If your machine only has 2 speakers and you would like to watch movies
162 with more channels (e.g. 5.1) then you need to configure your
163 .asoundrc file. The .asoundrc file is a configuration file located in
164 the user's home directory. A sample configuration named "demo-asoundrc"
165 can be found in same folder as this README, so:
166
7ec5182 added: Very competent 'build.sh' script created by AlTheKiller.
pike2k authored
167
168 .1 backup your .asoundrc if it exists (e.g. # cp ~/.asoundrc ~/.asoundrc.backup)
3b8696d added: analog/axis support for joysticks/gamepads. See Keymap.xml for…
d4rkm4ster authored
169
7ec5182 added: Very competent 'build.sh' script created by AlTheKiller.
pike2k authored
170 .2 copy the demo asoundrc - # cp demo-asoundrc ~/.asoundrc
171
3b8696d added: analog/axis support for joysticks/gamepads. See Keymap.xml for…
d4rkm4ster authored
172 .3 you can edit the file and change the downmix setup by changing the
173 "ttable" values. The values range from 0.0 to 1.0 and are actaully the
174 volume pct from the original channels volume.
175
176
177 -----------------------------------------------------------------------------
7ec5182 added: Very competent 'build.sh' script created by AlTheKiller.
pike2k authored
178 7. Endword
3b8696d added: analog/axis support for joysticks/gamepads. See Keymap.xml for…
d4rkm4ster authored
179 -----------------------------------------------------------------------------
180
181 Don't expect too much, yet.
2fc6262 demo file for downmixing playback to 2 channels.
vulkanr authored
182
665bb8b Fixed: packages required to compile XBMC on Gutsy Gibbon
yuvalt authored
183 EOF
Something went wrong with that request. Please try again.