Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP

Loading…

Readme updates #5011

Merged
merged 2 commits into from

5 participants

@uNiversaI

Cleanup and formatting and adding audio binary addons info to readme.linux

Both README.linux and README.ubuntu updated.

If there are any dependencies changing please let me know so I can update these docs accordingly at the same time.

docs/README.linux
((23 lines not shown))
-
------------------------------------------------------------------------------
+-----------------------------------------------------------------------------------------------------------
@Jalle19 Collaborator
Jalle19 added a note

Why change the length of these lines? I think the idea is that the lines shouldn't wrap when viewed in an 80 character wide terminal.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
docs/README.linux
((23 lines not shown))
Update apt:
$ sudo apt-get update
-Here is the magic command to get the build dependencies (used to compile the
-version on the PPA).
+Here is the magic command to get the build dependencies, used to compile the version on the PPA.
@Jalle19 Collaborator
Jalle19 added a note

I'd drop the word "magic" here, there's absolutely no magic involved.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
docs/README.linux
((55 lines not shown))
$ make -j2
+
+Note: From v14 with commit 4090a5f a new api for binary audio encoder addons are available, if you need to compile them do:
@Jalle19 Collaborator
Jalle19 added a note

Since we're nitpicking here, "API" is always spelled in all-uppercase.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
docs/README.linux
((38 lines not shown))
5. How to run
------------------------------------------------------------------------------
-How to run xbmc depends on the type of installation you have done. It is
-possible to run XBMC without the requirement to install xbmc anywhere else. In
-this case, type the following from the top source directory.
+-----------------------------------------------------------------------------------------------------------
+
+How to run xbmc depends on the type of installation you have done.
+It is possible to run XBMC without the requirement to install xbmc anywhere else.
@Jalle19 Collaborator
Jalle19 added a note

s/xbmc/XBMC/

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
docs/README.linux
((8 lines not shown))
-To compile and run XBMC's test suite, the configure option '--enable-gtest'
-has to be explicitely set during the configure stage. Once configured, to
-build the testsuite, type the following.
+XBMC has a test suite which uses the Google C++ Testing Framework.
+This framework is provided directly in XBMC's source tree.
+It has very little requirements, in order to build and run.
+See the README file for the framework at 'lib/gtest/README' for specific requirements.
+
+To compile and run XBMC's test suite:
+The configure option '--enable-gtest' has to be explicitly set during the configure stage.
@wsnipex Collaborator
wsnipex added a note

gtest is enabled by default nowadays

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
docs/README.linux
((57 lines not shown))
If you have overridden PREFIX to install XBMC into some non-standard location,
-you will have to run xbmc by directly running 'xbmc.bin'. For example.
+you will have to run XBMC by directly running 'xbmc.bin'.
+
+For example:
$ $HOME/xbmc/usr/share/xbmc.bin
@wsnipex Collaborator
wsnipex added a note

s/share/lib

edit: and you should still run the wrapper via $PREFIX/bin/xbmc

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
docs/README.ubuntu
((16 lines not shown))
[NOTICE] Supported on ubuntu >= 11.10 (oneiric)
You can get all build dependencies used for building the packages on the PPA
Add the unstable and build-depends PPAs:
- $ sudo apt-get install python-software-properties software-properties-common
- $ sudo add-apt-repository ppa:team-xbmc/unstable
- $ sudo add-apt-repository ppa:team-xbmc/xbmc-ppa-build-depends
- $ sudo apt-get update
+.0 $ sudo apt-get install python-software-properties software-properties-common
+.1 $ sudo add-apt-repository ppa:team-xbmc/unstable
@wsnipex Collaborator
wsnipex added a note

please use the nightly ppa, unstable could already be too old.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
docs/README.ubuntu
((85 lines not shown))
For >= 12.10
- $ sudo apt-get install libtag1-dev
+ $ sudo apt-get install libtag1-dev
@wsnipex Collaborator
wsnipex added a note

cosmetics: please move down after 12.04
also doing apt-get build-dep with our ppa added, libtag will already be pulled in with a proper version

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
docs/README.ubuntu
@@ -114,7 +114,6 @@ See README.linux
-----------------------------------------------------------------------------
5. Uninstalling
-----------------------------------------------------------------------------
-$ sudo apt-get remove xbmc*
+ $ sudo apt-get remove xbmc*
@wsnipex Collaborator
wsnipex added a note

this won't uninstall a manually compiled version.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
@uNiversaI

Addressed coments rebased/squashed, would it be worth adding the pvr addons compile too? idk never used pvr but someone mentioned that you dont compile any addons by default.

also if #5024 is going in, it maybe worth it to wait until after, since I can then add the alphabetized dependency lists unless then he handles that for both readmes.

@wsnipex
Collaborator

yes, imho it would be good to add pvr-addons info as well. I'd not worry about 5024 too much, we'll still support gnutls. Actually you can already add "openssl | gnutls" now(if its missing)

docs/README.ubuntu
((62 lines not shown))
For Ubuntu (all versions >= 7.04):
- $ sudo apt-get install automake bison build-essential cmake curl cvs default-jre fp-compiler gawk gdc gettext git-core gperf libasound2-dev libass-dev libboost-dev libboost-thread-dev libbz2-dev libcap-dev libcdio-dev libcurl3 libcurl4-gnutls-dev libdbus-1-dev libenca-dev libflac-dev libfontconfig-dev libfreetype6-dev libfribidi-dev libglew-dev libiso9660-dev libjasper-dev libjpeg-dev liblzo2-dev libmad0-dev libmicrohttpd-dev libmodplug-dev libmpeg2-4-dev libmpeg3-dev libmysqlclient-dev libnfs-dev libogg-dev libogg-dev libpcre3-dev libplist-dev libpng-dev libpulse-dev libsdl-dev libsdl-gfx1.2-dev libsdl-image1.2-dev libsdl-mixer1.2-dev libsmbclient-dev libsqlite3-dev libssh-dev libssl-dev libtiff-dev libtinyxml-dev libtool libudev-dev libusb-dev libvdpau-dev libvorbisenc2 libxml2-dev libxmu-dev libxrandr-dev libxrender-dev libxslt1-dev libxt-dev libyajl-dev mesa-utils nasm pmount python-dev python-imaging python-sqlite swig unzip yasm zip zlib1g-dev
+ $ sudo apt-get install automake bison build-essential cmake curl cvs default-jre fp-compiler gawk gdc gettext git-core gperf libasound2-dev libass-dev libboost-dev libboost-thread-dev libbz2-dev libcap-dev libcdio-dev libcurl3 libcurl4-gnutls-dev libcurl4-openssl-dev libdbus-1-dev libenca-dev libflac-dev libfontconfig-dev libfreetype6-dev libfribidi-dev libglew-dev libiso9660-dev libjasper-dev libjpeg-dev liblzo2-dev libmad0-dev libmicrohttpd-dev libmodplug-dev libmpeg2-4-dev libmpeg3-dev libmysqlclient-dev libnfs-dev libogg-dev libogg-dev libpcre3-dev libplist-dev libpng-dev libpulse-dev libsdl-dev libsdl-gfx1.2-dev libsdl-image1.2-dev libsdl-mixer1.2-dev libsmbclient-dev libsqlite3-dev libssh-dev libssl-dev libtiff-dev libtinyxml-dev libtool libudev-dev libusb-dev libvdpau-dev libvorbisenc2 libxml2-dev libxmu-dev libxrandr-dev libxrender-dev libxslt1-dev libxt-dev libyajl-dev mesa-utils nasm pmount python-dev python-imaging python-sqlite swig unzip yasm zip zlib1g-dev
@wsnipex Collaborator
wsnipex added a note

this won't work as libcurl4-openssl-dev and its gnutls counterpart are mutually exclusive. I guess its best to just put the openssl variant in there

Im only adding that cause 5024 if this isnt needed then never mind, ill revert back.

I will need proper instructions on prv addons compiling along with xbmc, since I never used them I dont really know anything at all about it.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
@MartijnKaijser MartijnKaijser added this to the Pending for inclusion milestone
uNiversaI added some commits
@uNiversaI

libssl-dev then is there already idk what direction 5024 is going but Im not going to worry about that.

I looked at information about compiling pvr-addons, and it looks more complicated than calling a makefile from xbmc tree and since I never have used that and no experience with that, I would require definitive instructions to put in readme, so atm its not there.

@wsnipex
Collaborator

right, the pvr-addons makefile would need a few changes to be able to run "standalone"/without unified deps.

PR is fine for me.

@jmarshallnz jmarshallnz merged commit 7eed7e6 into from
@uNiversaI

@wsnipex

Are the pvr addons built by

make -C tools/depends/target/xbmc-pvr-addons

It looks like it is correctly pulled and bult from examining that Makefile. If so I can then add that to readme.linux

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Commits on Jul 16, 2014
  1. README.linux update

    uNiversaI authored
  2. README.ubuntu update

    uNiversaI authored
This page is out of date. Refresh to see the latest.
Showing with 149 additions and 121 deletions.
  1. +96 −70 docs/README.linux
  2. +53 −51 docs/README.ubuntu
View
166 docs/README.linux
@@ -10,24 +10,28 @@ TOC
1. Introduction
-----------------------------------------------------------------------------
-A gfx-adapter with OpenGL acceleration is highly recommended and 24/32 bitdepth
-is required with OpenGL.
-
-NOTE TO NEW LINUX USERS: All lines that are prefixed with the '$'
-character are commands that need to be typed into a terminal window /
-console (similar to the command prompt for Windows). Note that the '$'
-character itself should NOT be typed as part of the command.
+A graphics-adapter with OpenGL acceleration is highly recommended.
+24/32 bitdepth is required along with OpenGL.
+Note to new Linux users.
+All lines that are prefixed with the '$' character are commands,
+that need to be typed into a terminal window / console. The '$' equals the prompt.
+Note: The '$' character itself should NOT be typed as part of the command.
-----------------------------------------------------------------------------
2. Getting the source code
-----------------------------------------------------------------------------
-You will have to grab the source code of course. First install the git
-package provided by your distribution. Then from a terminal, type:
+You will have to grab the source code of course, here we use git as example.
+First install the git package provided by your distribution.
+Then from a terminal, type:
+
+.0 $ cd $HOME
+.1 $ git clone git://github.com/xbmc/xbmc.git xbmc
+
+Note: You can clone any specific branch.
- $ cd $HOME
- $ git clone git://github.com/xbmc/xbmc.git xbmc
+.1 $ git clone -b <branch> git://github.com/xbmc/xbmc.git xbmc
-----------------------------------------------------------------------------
3. Installing the required libraries and headers
@@ -42,36 +46,40 @@ Build-Depends: autoconf, automake, autopoint, autotools-dev, cmake, curl,
libass-dev (>= 0.9.8), libavahi-client-dev, libavahi-common-dev, libavcodec-dev,
libavfilter-dev, libavformat-dev, libavutil-dev, libbluetooth-dev, libbluray-dev,
libboost-dev, libboost-thread-dev, libbz2-dev, libcap-dev, libcdio-dev, libcec-dev,
- libcrystalhd-dev, libcurl4-gnutls-dev | libcurl-dev, libcwiid-dev, libdbus-1-dev,
- libenca-dev, libflac-dev, libfontconfig-dev, libfreetype6-dev, libfribidi-dev,
- libgl1-mesa-dev | libgl-dev, libglew-dev, libglu1-mesa-dev | libglu-dev, libhal-dev,
- libhal-storage-dev, libiso9660-dev, libjasper-dev, libjpeg-dev, libltdl-dev, liblzo2-dev,
- libmad0-dev, libmicrohttpd-dev, libmodplug-dev, libmpcdec-dev, libmpeg2-4-dev, libmysqlclient-dev,
- libnfs-dev, libogg-dev, libpcre3-dev, libplist-dev, libpng12-dev | libpng-dev, libpostproc-dev,
+ libcrystalhd-dev, libcurl4-gnutls-dev | libcurl4-openssl-dev | libcurl-dev,
+ libcwiid-dev, libdbus-1-dev, libenca-dev, libflac-dev, libfontconfig-dev,
+ libfreetype6-dev, libfribidi-dev, libgl1-mesa-dev | libgl-dev, libglew-dev,
+ libglu1-mesa-dev | libglu-dev, libhal-dev, libhal-storage-dev, libiso9660-dev,
+ libjasper-dev, libjpeg-dev, libltdl-dev, liblzo2-dev, libmad0-dev, libmicrohttpd-dev,
+ libmodplug-dev, libmpcdec-dev, libmpeg2-4-dev, libmysqlclient-dev, libnfs-dev,
+ libogg-dev, libpcre3-dev, libplist-dev, libpng12-dev | libpng-dev, libpostproc-dev,
libpulse-dev, librtmp-dev, libsdl-dev, libsdl-image1.2-dev, libsdl-mixer1.2-dev,
- libshairplay-dev, libsmbclient-dev, libsqlite3-dev, libssh-dev, libssl-dev, libswscale-dev,
- libtag1-dev (>= 1.8), libtiff-dev, libtinyxml-dev, libtool, libudev-dev, libusb-dev, libva-dev,
- libvdpau-dev, libvorbis-dev, libxinerama-dev, libxml2-dev, libxmu-dev, libxrandr-dev, libxslt1-dev,
- libxt-dev, libyajl-dev, lsb-release, nasm [!amd64], python-dev, python-imaging, python-support, swig,
+ libshairplay-dev, libsmbclient-dev, libsqlite3-dev, libssh-dev, libssl-dev,
+ libswscale-dev, libtag1-dev (>= 1.8), libtiff-dev, libtinyxml-dev, libtool,
+ libudev-dev, libusb-dev, libva-dev, libvdpau-dev, libvorbis-dev, libxinerama-dev,
+ libxml2-dev, libxmu-dev, libxrandr-dev, libxslt1-dev, libxt-dev, libyajl-dev,
+ lsb-release, nasm [!amd64], python-dev, python-imaging, python-support, swig,
unzip, yasm, zip, zlib1g-dev
-*** For developers and anyone else who compiles frequently it is recommended to
-use ccache
+Note: For developers and anyone else who compiles frequently it is recommended to use ccache.
---------------------------------------------------------------
+ $ sudo apt-get install ccache
+
+-----------------------------------------------------------------------------
3.1. Using the XBMC PPA to get all build dependencies (Debian/Ubuntu only)
---------------------------------------------------------------
+-----------------------------------------------------------------------------
-For this, you need to specify the PPA in your apt sources. Please find them on
-the forum.
+For this, you need to specify the PPA in your apt sources.
+Please find them on the following wiki link:
+Note: See README.ubuntu as well
-http://forum.xbmc.org/showthread.php?t=33327
+http://wiki.xbmc.org/index.php?title=Team_XBMC_PPA
Update apt:
$ sudo apt-get update
-Here is the magic command to get the build dependencies (used to compile the
-version on the PPA).
+The command to get the build dependencies, used to compile the version on the PPA.
+
$ sudo apt-get build-dep xbmc
-----------------------------------------------------------------------------
@@ -83,24 +91,25 @@ To create the XBMC executable manually perform these steps:
.0 $ ./bootstrap
.1 $ ./configure <option1> <option2> ... (See --help for available options)
-
-A full listing of supported options can be viewed by typing
-'./configure --help'.
+ A full listing of supported options can be viewed by typing './configure --help'.
.2 $ make
-Tip: by adding -j<number> to the make command, you describe how many
- concurrent jobs will be used. So for dualcore the command is:
+Tip: By adding -j<number> to the make command, you describe how many
+ concurrent jobs will be used. So for dualcore the command is:
$ make -j2
+Note: From v14 with commit 4090a5f a new API for binary audio encoder addons is available, if you need to compile them do:
+
+ $ make -C tools/depends/target/xbmc-audioencoder-addons PREFIX=/<system prefix you added on step 4.1
+
.3 $ make install
This will install XBMC in the prefix provided in 4.1 as well as a launcher script.
-NOTE: You may need to run this with sudo (sudo make install) if your user
-doesn't have write permissions to the prefix you have provided (as in the
-default case, /usr/local).
+Note: You may need to run this with sudo (sudo make install) if your user doesn't have write permissions
+to the prefix you have provided (as in the default case, /usr/local).
Tip: To override the location that XBMC is installed, use PREFIX=<path>.
For example.
@@ -110,14 +119,15 @@ For example.
-----------------------------------------------------------------------------
4.1. Test Suite
-----------------------------------------------------------------------------
-XBMC has a test suite which uses the Google C++ Testing Framework. The
-framework is provided directly in XBMC's source tree and has very little
-requirements in order to build and run. See the README file for the framework
-at 'lib/gtest/README' for specific requirements.
-To compile and run XBMC's test suite, the configure option '--enable-gtest'
-has to be explicitely set during the configure stage. Once configured, to
-build the testsuite, type the following.
+XBMC has a test suite which uses the Google C++ Testing Framework.
+This framework is provided directly in XBMC's source tree.
+It has very little requirements, in order to build and run.
+See the README file for the framework at 'lib/gtest/README' for specific requirements.
+
+To compile and run XBMC's test suite:
+The configure option '--enable-gtest' is enabled by default during the configure stage.
+Once configured, to build the testsuite, type the following:
$ make check
@@ -125,43 +135,53 @@ To compile the test suite without running it, type the following.
$ make testsuite
-The test suite program can be run manually as well. The name of the test suite
-program is 'xbmc-test' and will build in the XBMC source tree. To bring up the
-'help' notes for the program, type the following.
+The test suite program can be run manually as well.
+The name of the test suite program is 'xbmc-test' and will build in the XBMC source tree.
+To bring up the 'help' notes for the program, type the following:
$ ./xbmc-test --gtest_help
The most useful options are,
- --gtest_list_tests
- List the names of all tests instead of running them. The name of
- TEST(Foo, Bar) is "Foo.Bar".
- --gtest_filter=POSTIVE_PATTERNS[-NEGATIVE_PATTERNS]
+ --gtest_list_tests
+ List the names of all tests instead of running them.
+ The name of TEST(Foo, Bar) is "Foo.Bar".
+
+ --gtest_filter=POSTIVE_PATTERNS[-NEGATIVE_PATTERNS]
Run only the tests whose name matches one of the positive patterns but
none of the negative patterns. '?' matches any single character; '*'
matches any substring; ':' separates two patterns.
-NOTE: If the '--enable-gtest' option is not set during the configure
-stage, the make targets 'check,' 'testsuite,' and 'testframework' will
-simply show a message saying the framework has not been configured, and then
-silently succeed (i.e. it will not return an error).
+Note: If the '--enable-gtest' option is not set during the configure stage,
+the make targets 'check,' 'testsuite,' and 'testframework' will simply show a message saying
+the framework has not been configured, and then silently succeed (i.e. it will not return an error).
-----------------------------------------------------------------------------
5. How to run
-----------------------------------------------------------------------------
-How to run xbmc depends on the type of installation you have done. It is
-possible to run XBMC without the requirement to install xbmc anywhere else. In
-this case, type the following from the top source directory.
+
+How to run XBMC depends on the type of installation you have done.
+It is possible to run XBMC without the requirement to install XBMC anywhere else.
+In this case, type the following from the top source directory.
$ ./xbmc.bin
-If you chose to install XBMC using '/usr' or '/usr/local' as the PREFIX, you
-can just issue 'xbmc' in a terminal session.
+Or run in 'portable' mode
+
+ $ ./xbmc.bin -p
+
+If you chose to install XBMC using '/usr' or '/usr/local' as the PREFIX,
+you can just issue 'xbmc' in a terminal session.
If you have overridden PREFIX to install XBMC into some non-standard location,
-you will have to run xbmc by directly running 'xbmc.bin'. For example.
+you will have to run XBMC by directly running 'xbmc.bin'.
+
+For example:
+
+ $ $HOME/xbmc/usr/lib/xbmc.bin
- $ $HOME/xbmc/usr/share/xbmc.bin
+You should still run the wrapper via
+ $ $PREFIX/bin/xbmc
If you wish to use VDPAU decoding you will now have to change the Render Method
in Settings->Videos->Player from "Auto Detect" to "VDPAU".
@@ -169,13 +189,19 @@ in Settings->Videos->Player from "Auto Detect" to "VDPAU".
-----------------------------------------------------------------------------
6. Uninstalling
-----------------------------------------------------------------------------
-Issue "make uninstall" from your source tree (or "sudo make uninstall" if your
-user doesn't have write permission to the install directory). If you would like
-to also remove any settings and 3rd party addons (skins, scripts, etc) you
-should also run "rm -rf ~/.xbmc".
-NOTE: If you have rerun configure with a different prefix, you will either need
-to rerun configure with the correct prefix for this step to work correctly.
+Issue the commands prepending "sudo", if your user doesn't have write permission,
+to the install directory.
-EOF
+Note: If you have rerun configure with a different prefix,
+you will either need to rerun configure with the correct prefix for this step to work correctly.
+
+ $ make uninstall
+.0 $ sudo make uninstall
+
+If you would like to also remove any settings and 3rd party addons (skins, scripts, etc)
+you should also run:
+.1 $ rm -rf ~/.xbmc
+
+EOF
View
104 docs/README.ubuntu
@@ -9,22 +9,24 @@ TOC
1. Introduction
-----------------------------------------------------------------------------
-We currently recommend Ubuntu Precise(12.04) or later.
-A gfx-adapter with OpenGL acceleration is highly recommended and 24/32
-bitdepth is required with OpenGL.
+A graphics-adapter with OpenGL acceleration is highly recommended.
+24/32 bitdepth is required along with OpenGL.
-NOTE TO NEW LINUX USERS: All lines that are prefixed with the '$'
-character are commands that need to be typed into a terminal window /
-console (similar to the command prompt for Windows). Note that the '$'
-character itself should NOT be typed as part of the command.
+Note to new Linux users.
+All lines that are prefixed with the '$' character are commands, that need to be typed
+into a terminal window / console (similar to the command prompt for Windows).
+Note that the '$' character itself should NOT be typed as part of the command.
-----------------------------------------------------------------------------
2. Getting the source code
-----------------------------------------------------------------------------
- $ sudo apt-get install git-core
- $ cd $HOME
- $ git clone git://github.com/xbmc/xbmc.git xbmc
+.0 $ cd $HOME
+.1 $ git clone git://github.com/xbmc/xbmc.git xbmc
+
+Note: You can clone any specific branch.
+
+.1 $ git clone -b <branch> git://github.com/xbmc/xbmc.git xbmc
-----------------------------------------------------------------------------
3. Installing the required Ubuntu packages
@@ -32,74 +34,73 @@ character itself should NOT be typed as part of the command.
Two methods exist to install the required Ubuntu packages:
-[NOTICE] For supported old Ubuntu versions, some packages might be outdated.
+[NOTICE] For supported older Ubuntu versions, some packages might be outdated.
For those, you can either compile them manually, or use our backports
available from our official stable PPA:
http://launchpad.net/~team-xbmc/+archive/ppa
---------------------------------------------------------------
+-----------------------------------------------------------------------------
3a. Use a single command to get all build dependencies
---------------------------------------------------------------
-[NOTICE] Supported on ubuntu >= 11.10 (oneiric)
+-----------------------------------------------------------------------------
+[NOTICE] Supported on Ubuntu >= 11.10 (oneiric)
You can get all build dependencies used for building the packages on the PPA
Add the unstable and build-depends PPAs:
- $ sudo apt-get install python-software-properties software-properties-common
- $ sudo add-apt-repository ppa:team-xbmc/unstable
- $ sudo add-apt-repository ppa:team-xbmc/xbmc-ppa-build-depends
- $ sudo apt-get update
+.0 $ sudo apt-get install python-software-properties software-properties-common
+.1 $ sudo add-apt-repository ppa:team-xbmc/xbmc-nightly
+.2 $ sudo add-apt-repository ppa:team-xbmc/xbmc-ppa-build-depends
+.3 $ sudo apt-get update
Here is the magic command to get the build dependencies (used to compile the version on the PPA).
- $ sudo apt-get build-dep xbmc
+ $ sudo apt-get build-dep xbmc
-* Optional: If you do not want xbmc to be installed via PPA, you can removed the PPAs again:
- $ sudo add-apt-repository -r ppa:team-xbmc/unstable
- $ sudo add-apt-repository -r ppa:team-xbmc/xbmc-ppa-build-depends
+Optional: If you do not want XBMC to be installed via PPA, you can removed the PPAs again:
+ $ sudo add-apt-repository -r ppa:team-xbmc/xbmc-nightly
+ $ sudo add-apt-repository -r ppa:team-xbmc/xbmc-ppa-build-depends
-*** Avoid using "aptitude" for the build-dep command. It doesn't resolve everything.
+Note: Do not use "aptitude" for the build-dep command. It doesn't resolve everything properly.
+ For developers and anyone else who compiles frequently it is recommended to use ccache
+ $ sudo apt-get install ccache
-*** For developers and anyone else who compiles frequently it is recommended to use ccache
- $ sudo apt-get install ccache
+Tip: For those with multiple computers at home is to try out distcc
+ (fully unsupported from XBMC of course)
+ $ sudo apt-get install distcc
-*** A tip for those with multiple computers at home is to check out distcc (totally unsupported from xbmc of course)
- $ sudo apt-get install distcc
-
-
---------------------------------------------------------------------
+-----------------------------------------------------------------------------
3b. Alternative: Manual dependency installation
---------------------------------------------------------------------
+-----------------------------------------------------------------------------
For Ubuntu (all versions >= 7.04):
- $ sudo apt-get install automake bison build-essential cmake curl cvs default-jre fp-compiler gawk gdc gettext git-core gperf libasound2-dev libass-dev libboost-dev libboost-thread-dev libbz2-dev libcap-dev libcdio-dev libcurl3 libcurl4-gnutls-dev libdbus-1-dev libenca-dev libflac-dev libfontconfig-dev libfreetype6-dev libfribidi-dev libglew-dev libiso9660-dev libjasper-dev libjpeg-dev liblzo2-dev libmad0-dev libmicrohttpd-dev libmodplug-dev libmpeg2-4-dev libmpeg3-dev libmysqlclient-dev libnfs-dev libogg-dev libogg-dev libpcre3-dev libplist-dev libpng-dev libpulse-dev libsdl-dev libsdl-gfx1.2-dev libsdl-image1.2-dev libsdl-mixer1.2-dev libsmbclient-dev libsqlite3-dev libssh-dev libssl-dev libtiff-dev libtinyxml-dev libtool libudev-dev libusb-dev libvdpau-dev libvorbisenc2 libxml2-dev libxmu-dev libxrandr-dev libxrender-dev libxslt1-dev libxt-dev libyajl-dev mesa-utils nasm pmount python-dev python-imaging python-sqlite swig unzip yasm zip zlib1g-dev
+ $ sudo apt-get install automake bison build-essential cmake curl cvs default-jre fp-compiler gawk gdc gettext git-core gperf libasound2-dev libass-dev libboost-dev libboost-thread-dev libbz2-dev libcap-dev libcdio-dev libcurl3 libcurl4-gnutls-dev libdbus-1-dev libenca-dev libflac-dev libfontconfig-dev libfreetype6-dev libfribidi-dev libglew-dev libiso9660-dev libjasper-dev libjpeg-dev liblzo2-dev libmad0-dev libmicrohttpd-dev libmodplug-dev libmpeg2-4-dev libmpeg3-dev libmysqlclient-dev libnfs-dev libogg-dev libogg-dev libpcre3-dev libplist-dev libpng-dev libpulse-dev libsdl-dev libsdl-gfx1.2-dev libsdl-image1.2-dev libsdl-mixer1.2-dev libsmbclient-dev libsqlite3-dev libssh-dev libssl-dev libtiff-dev libtinyxml-dev libtool libudev-dev libusb-dev libvdpau-dev libvorbisenc2 libxml2-dev libxmu-dev libxrandr-dev libxrender-dev libxslt1-dev libxt-dev libyajl-dev mesa-utils nasm pmount python-dev python-imaging python-sqlite swig unzip yasm zip zlib1g-dev
For >= 10.10:
- $ sudo apt-get install autopoint libltdl-dev
+ $ sudo apt-get install autopoint libltdl-dev
On 8.10 and older versions, libcurl is outdated and thus XBMC will not compile properly.
In this case you will have to manually compile the latest version.
- $ wget http://curl.sourceforge.net/download/curl-7.19.7.tar.gz
- $ tar -xzf curl-7.19.7.tar.gz
- $ cd curl-7.19.7
- $ ./configure --disable-ipv6 --without-libidn --disable-ldap --prefix=/usr
- $ make
- $ sudo make install
-
-For >= 12.10
- $ sudo apt-get install libtag1-dev
+ $ wget http://curl.sourceforge.net/download/curl-7.19.7.tar.gz
+ $ tar -xzf curl-7.19.7.tar.gz
+ $ cd curl-7.19.7
+ $ ./configure --disable-ipv6 --without-libidn --disable-ldap --prefix=/usr
+ $ make
+ $ sudo make install
For <= 12.04
-We need a new version of taglib than what is available. We supply a Makefile in
-lib/taglib to make it easy to install into /usr/local.
- $ sudo apt-get remove libtag1-dev
- $ make -C lib/taglib
- $ sudo make -C lib/taglib install
+XBMC needs a new version of taglib other than what is available at this time.
+We supply a Makefile in lib/taglib to make it easy to install into /usr/local.
+ $ sudo apt-get remove libtag1-dev
+ $ make -C lib/taglib
+ $ sudo make -C lib/taglib install
-Unless you are proficient with how linux libraries and versions work, do not
-try to provide it yourself, as you will likely mess up for other programs.
+or use prepackaged from the XBMC PPA.
+ $ sudo apt-get install libtag1-dev
+
+Unless you are proficient with how Linux libraries and versions work, do not
+try to provide it yourself, as you will likely mess up for other programs.
-----------------------------------------------------------------------------
4. How to compile
@@ -114,7 +115,8 @@ See README.linux
-----------------------------------------------------------------------------
5. Uninstalling
-----------------------------------------------------------------------------
-$ sudo apt-get remove xbmc*
+Remove any PPA installed XBMC.
+ $ sudo apt-get remove xbmc*
+See README.linux/Uninstalling for removing compiled versions of XBMC.
EOF
-
Something went wrong with that request. Please try again.