diff options
Diffstat (limited to 'docs')
| -rw-r--r-- | docs/README.android | 52 | ||||
| -rw-r--r-- | docs/README.armel | 38 | ||||
| -rw-r--r-- | docs/README.ios | 25 | ||||
| -rw-r--r-- | docs/README.linux | 52 | ||||
| -rw-r--r-- | docs/README.osx | 11 | ||||
| -rw-r--r-- | docs/README.raspberrypi | 14 | ||||
| -rw-r--r-- | docs/README.ubuntu | 27 | ||||
| -rw-r--r-- | docs/manpages/kodi-send.1 | 2 |
8 files changed, 116 insertions, 105 deletions
diff --git a/docs/README.android b/docs/README.android index 2f8908c112..dcb9382b29 100644 --- a/docs/README.android +++ b/docs/README.android @@ -4,8 +4,8 @@ TOC 3. Getting the source code 4. Installing the required Ubuntu packages 5. How to compile -6. Installing XBMC in an Android system -7. Running and debugging XBMC in an Android system +6. Installing Kodi in an Android system +7. Running and debugging Kodi in an Android system 8. Architecture 9. Useful Commands @@ -25,7 +25,7 @@ character itself should NOT be typed as part of the command. ----------------------------------------------------------------------------- 2. Installing the required Ubuntu packages ----------------------------------------------------------------------------- -These are the minimum packages necessary for building XBMC. Non-Ubuntu +These are the minimum packages necessary for building Kodi. Non-Ubuntu users will need to get the equivalents. # sudo apt-get install build-essential default-jdk git curl autoconf \ @@ -34,7 +34,7 @@ users will need to get the equivalents. If you run a 64bit operating system you will also need to get ia32-libs ubuntu >= 14.04: - # sudo apt-get install lib32stdc++6 lib32z1 lib32z1-de + # sudo apt-get install lib32stdc++6 lib32z1 lib32z1-dev older versions: # sudo apt-get install ia32-libs @@ -50,7 +50,7 @@ JRE: openjre-6-jre (java version "1.6.0_27") 3. Installing and setting up the Android environment ----------------------------------------------------------------------------- -To develop XBMC for Android the Android SDK and NDK are required. +To develop Kodi for Android the Android SDK and NDK are required. -------------------------------------------------------------------- 3.1. Getting the Android SDK and NDK @@ -60,7 +60,7 @@ To get the Android SDK, go to http://developer.android.com/sdk and download the latest version for your operating system. The NDK can be downloaded from http://developer.android.com/tools/sdk/ndk/ -[NOTICE] Compiling XBMC for Android requires Android NDK +[NOTICE] Compiling Kodi for Android requires Android NDK Revision r9. For the SDK just use the latest available. It will work. @@ -97,7 +97,7 @@ install some android packages using the Android SDK Manager: 3.3. Setup the Android toolchain -------------------------------------------------------------------- -To be able to compile XBMC and the libraries it depends on for the +To be able to compile Kodi and the libraries it depends on for the Android platform you first need to setup an Android toolchain using the Android NDK which you earlier extracted to <android-ndk>. The following commands will create a toolchain suitable for the most @@ -105,7 +105,7 @@ common scenario. The --install-dir option (and therefore the <android-toolchain-arm>/<android-toolchain-x86> value) specifies where the resulting toolchain should be installed (your choice). -[NOTICE] XBMC uses the android API Version 14 and gcc version 4.8! +[NOTICE] Kodi uses the android API Version 14 and gcc version 4.8! Building for arm architecture: @@ -144,15 +144,15 @@ Make sure to pick a toolchain for your desired architecture. ----------------------------------------------------------------------------- # cd $HOME - # git clone git://github.com/xbmc/xbmc.git xbmc-android - # cd xbmc-android + # git clone git://github.com/xbmc/xbmc.git kodi-android + # cd kodi-android # git submodule update --init addons/skin.re-touched ----------------------------------------------------------------------------- 5. How to compile ----------------------------------------------------------------------------- -Compiling XBMC for Android consists of compiling the libraries XBMC depends +Compiling Kodi for Android consists of compiling the libraries Kodi depends on with the Android toolchain and creating an Android Application Package (APK) which can be installed in an Android system. @@ -160,7 +160,7 @@ on with the Android toolchain and creating an Android Application Package 5.1. Building dependencies -------------------------------------------------------------------- - # cd $HOME/xbmc-android/tools/depends + # cd $HOME/kodi-android/tools/depends # ./bootstrap # ./configure --help @@ -182,10 +182,10 @@ on with the Android toolchain and creating an Android Application Package "Dependencies built successfully." appears. -------------------------------------------------------------------- -5.2. Building XBMC +5.2. Building Kodi -------------------------------------------------------------------- - # cd $HOME/xbmc-android + # cd $HOME/kodi-android # make -C tools/depends/target/xbmc # make # make apk @@ -194,15 +194,15 @@ on with the Android toolchain and creating an Android Application Package subsequent builds can be run with a simple 'make' and 'make apk'. ----------------------------------------------------------------------------- -6. Installing XBMC in an Android system +6. Installing Kodi in an Android system ----------------------------------------------------------------------------- -To install XBMC through the previously built APK in an Android system you can +To install Kodi through the previously built APK in an Android system you can either install it on a real device (smartphone/tablet/...) running Android >= 2.3.x. -------------------------------------------------------------------- -6.1. Installing XBMC on the Android device +6.1. Installing Kodi on the Android device -------------------------------------------------------------------- Make sure your Android device is connected to your computer through @@ -212,7 +212,7 @@ device's Android settings: - Applications [X] Unknown sources - # cd $HOME/xbmc-android/tools/android/packaging + # cd $HOME/kodi-android/tools/android/packaging # adb devices # adb -s <device-id> install -r images/xbmcapp-debug.apk @@ -221,17 +221,17 @@ The <device-id> can be retrieved from the list returned by the your device. ----------------------------------------------------------------------------- -7. Running and debugging XBMC in an Android system +7. Running and debugging Kodi in an Android system ----------------------------------------------------------------------------- -After installing XBMC's APK in an Android system you can start it using its +After installing Kodi's APK in an Android system you can start it using its Launcher icon in Android's Application Launcher. -------------------------------------------------------------------- -7.1. Debugging XBMC +7.1. Debugging Kodi -------------------------------------------------------------------- -To be able to see what is happening while running XBMC you first need +To be able to see what is happening while running Kodi you first need to enable USB debugging in your Android settings (this is already done when using the emulator): @@ -257,14 +257,14 @@ to cd to tools/android/packaging/xbmc and execute it from there. # ndk-gdb --start --delay=0 -This will open the installed version of XBMC and break. The warnings can be +This will open the installed version of Kodi and break. The warnings can be ignored as we have setup the appropriate paths already. -------------------------------------------------------------------- 8. Architecture -------------------------------------------------------------------- -During the early days of the android port, xbmc was launched via a stub lib +During the early days of the android port, Kodi was launched via a stub lib that then dlopen'd libkodi. This was done to get around bionic's poor handling of shared libs. We now compile everything into libkodi itself so that it has no runtime dependencies beyond system libs. Done this way, we're able to launch @@ -317,10 +317,10 @@ is 'tools/android/packaging' and that the proper sdk/ndk paths are set. -Install a new build over the existing one # adb -e install -r images/xbmcapp-debug.apk --Launch XBMC on the emulator without the GUI +-Launch Kodi on the emulator without the GUI # adb shell am start -a android.intent.action.MAIN -n org.xbmc.xbmc/android.app.NativeActivity --Kill a misbehaving XBMC +-Kill a misbehaving Kodi # adb shell ps | grep org.xbmc | awk '{print $2}' | xargs adb shell kill -Filter logcat messages by a specific tag (e.g. "XBMC") diff --git a/docs/README.armel b/docs/README.armel index 066cc0887d..1ad32fe908 100644 --- a/docs/README.armel +++ b/docs/README.armel @@ -14,7 +14,7 @@ TOC 7. How to run 7.1 Obtaining the Packages 7.2 Installing the Files - 7.3 Running XBMC + 7.3 Running Kodi 8. Troubleshooting @@ -22,12 +22,12 @@ TOC 1. Introduction ----------------------------------------------------------------------------- -This is a port of XBMC for use on ARM Architecture. -As this is not an official version of XBMC, in-depth testing on various setups has not been done. USE WITH CAUTION! +This is a port of Kodi for use on ARM Architecture. +As this is not an official version of Kodi, in-depth testing on various setups has not been done. USE WITH CAUTION! For the purpose of this port, the following Hardware and Software was used. Software: Scratchbox (cross-compiler) on a Linux (Ubuntu) machine. Hardware: BeagleBoard (ARM Cortex-A8 with IMG POWERVR SGX). -The source code is based on XBMC for Linux - version 9.11 (Camelot). +The source code is based on Kodi for Linux - version 9.11 (Camelot). All lines that are prefixed with the '$' character are commands that need to be typed into a standard linux terminal All lines that are prefixed with the '>' character are commands that need to be typed into scratchbox @@ -162,7 +162,7 @@ In order to continue, you will need the SGX SDK from TI's website. Once you have installed said SDK on a standard Linux machine, copy the neccessary .h and .so files to the appropriate directories in scratchbox: e.g /scratchbox/users/<username>/targets/<target_name>/usr/include/EGL/egl.h These files will also need to be transferred over to the board eventually. -NOTE: XBMC has only been tested with the following versions of the OMAP35x Graphics SDK: +NOTE: Kodi has only been tested with the following versions of the OMAP35x Graphics SDK: 3.00.00.05, 3.00.00.06, 3.00.00.08, 3.00.00.09 @@ -170,7 +170,7 @@ NOTE: XBMC has only been tested with the following versions of the OMAP35x Graph 6. How to compile ----------------------------------------------------------------------------- -To create the XBMC executable manually perform these following steps: +To create the Kodi executable manually perform these following steps: ----------------------------------------------------------------------------- 6.1 Configure & Make: @@ -179,7 +179,7 @@ To create the XBMC executable manually perform these following steps: $ ./bootstrap > ./configure --enable-gles - This will configure XBMC inside scratchbox ready for compilation on ARM. + This will configure Kodi inside scratchbox ready for compilation on ARM. Because the default is to build for OpenGL, we require the --enable-gles flag to be set for OpenGL ES 2.0. (Note: No OpenGL ES 1.x available) Now, build with the following: @@ -191,12 +191,12 @@ To create the XBMC executable manually perform these following steps: ----------------------------------------------------------------------------- There is no need to do 'make install' as we dont want it installed into scratchbox. - There is also the slight problem of the fact that scratchbox's 'find' command is outdated and wont execute xbmc's 'make install' correctly. + There is also the slight problem of the fact that scratchbox's 'find' command is outdated and wont execute Kodi's 'make install' correctly. Instead, use the provided shell script: > cd /tools/arm/arm-scripts/ > ./create-xbmcfile.sh - This will create a tar file tools/arm/arm-scripts/xbmc.tar.bz2 containing the xbmc files, ready for you to transfer to the board. + This will create a tar file tools/arm/arm-scripts/xbmc.tar.bz2 containing the Kodi files, ready for you to transfer to the board. ----------------------------------------------------------------------------- @@ -238,14 +238,14 @@ It is also assumed that you have it setup with either Angstrom or Ubuntu. # tar xjf armel-pkgs.tar.bz2 -C / # tar xjf xbmc.tar.bz2 -C /usr/ - After this initial setup, during development, you should only need to replace /usr/share/xbmc/xbmc.bin with the newly created binary. + After this initial setup, during development, you should only need to replace /usr/share/kodi/kodi.bin with the newly created binary. ----------------------------------------------------------------------------- - 7.3 Running XBMC: + 7.3 Running Kodi: ----------------------------------------------------------------------------- - Now, run XBMC by executing the binary: - # /usr/share/xbmc/xbmc.bin + Now, run Kodi by executing the binary: + # /usr/share/kodi/kodi.bin Run the binary and not the script as the script will fail. @@ -256,7 +256,7 @@ It is also assumed that you have it setup with either Angstrom or Ubuntu. If it fails to run correctly, there are a few things to try out. First, is there any helpful output on the terminal? -Check the log file, usually located ~/.xbmc/temp/xbmc.log +Check the log file, usually located ~/.kodi/temp/kodi.log It may have failed because of a missing package. If so, you will need to download the appropriate armel package from packages.debian.org, Extract the files with the command: dpkg-deb -x packagename.deb /path/to/extract/to @@ -264,10 +264,10 @@ Then tarball the extracted files: tar cjf pkg.tar.bz2 /path/to/extracted/files Then transfer them to the board, and extract: tar xjf pkg.tar.bz2 This is because the .deb files cannot be extracted in Angstrom. -If this is not the case, try various different parameters for xbmc.bin such as: -xbmc.bin --standalone -xbmc.bin -p -xbmc.bin -fs -Or build with debug for a more in-depth xbmc.log file by ommitting the line --disable-debug on configure. +If this is not the case, try various different parameters for kodi.bin such as: +kodi.bin --standalone +kodi.bin -p +kodi.bin -fs +Or build with debug for a more in-depth kodi.log file by ommitting the line --disable-debug on configure. Feel free to contact me on mcgeagh@xbmc.org diff --git a/docs/README.ios b/docs/README.ios index 8cd263c65d..e1d0444612 100644 --- a/docs/README.ios +++ b/docs/README.ios @@ -17,7 +17,7 @@ TOC ----------------------------------------------------------------------------- This is a platform port of Kodi for the Apple iOS operating system. -The current build system supports Xcode 3.2.6 or Xcode 4.3.x with iOS SDK 4.2/4.3/5.1 +The current build system supports Xcode 3.2.6, 4.3.x, 5.x.x, 6.0.1, 6.1.0 with iOS SDK 4.3/5.1/6/7/8/8.1 There are two ways to build Kodi for Mac. 1) command-line or @@ -48,7 +48,7 @@ character itself should NOT be typed as part of the command. ----------------------------------------------------------------------------- See point 3.0a below for an updated list of supported Xcode/osx constellations!!! -Install latest Xcode (5.1.1 as of the writing). You can download it from +Install latest Xcode (6.1.0 as of the writing). You can download it from 1. The MacOSX AppStore (Xcode). @@ -60,10 +60,11 @@ automatically once they are invoked from the cmdline. Xcode 3.2.6 only runs on 10.6.x (Snow Leopard). Xcode 4.3.x only runs on 10.7.x (Lion). Xcode 5.x.x only runs on 10.8.x and later. - +Xcode 6.0.1 only runs on 10.9.4 and later. +Xcode 6.1.0 only runs on 10.9.5 and later. The preferred iOS SDK Version is 4.3 (when using Xcode 3.2.6) or 5.1 (when using -Xcode 4.3.x) or 7.x (when using Xcode 5.x.x) +Xcode 4.3.x) or 7.x (when using Xcode 5.x.x) or 8.x (when using Xcode 6.x.x) ----------------------------------------------------------------------------- 3.0a Supported Xcode and OSX constellations @@ -77,6 +78,8 @@ constellations of Xcode and osx versions (to be updated once we know more): 3.a Building against iOS SDK 6.0 will only allow to run on targets with iOS 5.1 and below. There is no support for devices running iOS 6.0 for now! 4. Xcode 5.1.1 against iOS SDK 7.0 and 7.1 on 10.9.x (Mavericks) +5. Xcode 6.0.1 against iOS SDK 8.0 on 10.9.x (Mavericks) +6. Xcode 6.1.0 against iOS SDK 8.1 on 10.10.x (Yosemite) ----------------------------------------------------------------------------- 3.1 Install Cross libs and runtime environment @@ -137,14 +140,14 @@ of the ATV2 project manually to "default/clang". $ cd $HOME/Kodi $ xcodebuild -project Kodi.xcodeproj -target Kodi-iOS -configuration Release build \ - ONLY_ACTIVE_ARCH=YES ARCHS=armv7 VALID_ARCHS=armv7 IPHONEOS_DEPLOYMENT_TARGET=4.2 \ - SDKROOT=iphoneos4.2 + ONLY_ACTIVE_ARCH=YES ARCHS=armv7 VALID_ARCHS=armv7 IPHONEOS_DEPLOYMENT_TARGET=4.3 \ + SDKROOT=iphoneos4.3 or $ xcodebuild -project Kodi.xcodeproj -target Kodi-ATV2 -configuration Release build \ - ONLY_ACTIVE_ARCH=YES ARCHS=armv7 VALID_ARCHS=armv7 IPHONEOS_DEPLOYMENT_TARGET=4.2 \ - SDKROOT=iphoneos4.2 + ONLY_ACTIVE_ARCH=YES ARCHS=armv7 VALID_ARCHS=armv7 IPHONEOS_DEPLOYMENT_TARGET=4.3 \ + SDKROOT=iphoneos4.3 Make sure to set SDKROOT to the iOS SDK you want to use. This should be the same you used on point 3.1! @@ -202,10 +205,12 @@ distribution. If you are a developer with an official apple code signing identity you can deploy Kodi via xcode to work on it on non-jailbroken devices. For this to happen you just need to alter the -Xcode project by setting your codesign identity. After that the last buildstep in our support script +Xcode project by setting your codesign identity. Be sure to not just select the "iPhone Developer" shortcut +but instead select your full identity "iPhone Developer: your name (your id)" (this is important else our sign +script won't detect a real sign identity). After that the last buildstep in our support script will do a full sign of all binaries and the bundle with the given identity (all *.viz, *.pvr, *.so files Xcode doesn't know anything about). This should allow you to deploy Kodi to all non-jailbroken devices which you can deploy normal apps to. In that case (Kodi will be sandboxed like any other app) - all Kodi files are then located in the sandboxed "Documents" folder and can be easily accessed via iTunes file sharing. -Keep in mind that no hardware acceleration will be possible without jailbreaking! +Keep in mind that no hardware acceleration will be possible without jailbreaking when using iOS < Version 8. diff --git a/docs/README.linux b/docs/README.linux index 5d4c47de28..a64ff227f6 100644 --- a/docs/README.linux +++ b/docs/README.linux @@ -27,18 +27,18 @@ 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 +.1 $ git clone git://github.com/xbmc/xbmc.git kodi Note: You can clone any specific branch. -.1 $ git clone -b <branch> git://github.com/xbmc/xbmc.git xbmc +.1 $ git clone -b <branch> git://github.com/xbmc/xbmc.git kodi ----------------------------------------------------------------------------- 3. Installing the required libraries and headers ----------------------------------------------------------------------------- You will then need the required libraries. The following is the list of packages -that are used to build XBMC packages on Debian/Ubuntu (with all supported +that are used to build Kodi packages on Debian/Ubuntu (with all supported external libraries enabled). Build-Depends: autoconf, automake, autopoint, autotools-dev, cmake, curl, @@ -52,7 +52,7 @@ Build-Depends: autoconf, automake, autopoint, autotools-dev, cmake, curl, 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, + libpulse-dev, librtmp-dev, libsdl-dev, libsdl-image1.2-dev, libsdl-mixer1.2-dev, libsdl2-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, @@ -64,27 +64,27 @@ Note: For developers and anyone else who compiles frequently it is recommended t $ sudo apt-get install ccache ----------------------------------------------------------------------------- -3.1. Using the XBMC PPA to get all build dependencies (Debian/Ubuntu only) +3.1. Using the Kodi 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 following wiki link: Note: See README.ubuntu as well -http://wiki.xbmc.org/index.php?title=Team_XBMC_PPA +http://kodi.wiki/index.php?title=Official_Ubuntu_PPA Update apt: $ sudo apt-get update The 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 kodi ----------------------------------------------------------------------------- 4. How to compile ----------------------------------------------------------------------------- -To create the XBMC executable manually perform these steps: +To create the Kodi executable manually perform these steps: .0 $ ./bootstrap @@ -104,26 +104,26 @@ Note: From v14 with commit 4090a5f a new API for binary audio encoder addons is .3 $ make install -This will install XBMC in the prefix provided in 4.1 as well as a launcher script. +This will install Kodi 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). -Tip: To override the location that XBMC is installed, use PREFIX=<path>. +Tip: To override the location that Kodi is installed, use PREFIX=<path>. For example. - $ make install DESTDIR=$HOME/xbmc + $ make install DESTDIR=$HOME/kodi ----------------------------------------------------------------------------- 4.1. Test Suite ----------------------------------------------------------------------------- -XBMC has a test suite which uses the Google C++ Testing Framework. -This framework is provided directly in XBMC's source tree. +Kodi has a test suite which uses the Google C++ Testing Framework. +This framework is provided directly in Kodi'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: +To compile and run Kodi'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: @@ -134,7 +134,7 @@ 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. +The name of the test suite program is 'xbmc-test' and will build in the Kodi source tree. To bring up the 'help' notes for the program, type the following: $ ./xbmc-test --gtest_help @@ -158,28 +158,28 @@ the framework has not been configured, and then silently succeed (i.e. it will n 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. +How to run Kodi depends on the type of installation you have done. +It is possible to run Kodi without the requirement to install Kodi anywhere else. In this case, type the following from the top source directory. - $ ./xbmc.bin + $ ./kodi.bin Or run in 'portable' mode - $ ./xbmc.bin -p + $ ./kodi.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 chose to install Kodi using '/usr' or '/usr/local' as the PREFIX, +you can just issue 'kodi' 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'. +If you have overridden PREFIX to install Kodi into some non-standard location, +you will have to run Kodi by directly running 'kodi.bin'. For example: - $ $HOME/xbmc/usr/lib/xbmc.bin + $ $HOME/kodi/usr/lib/kodi/kodi.bin You should still run the wrapper via - $ $PREFIX/bin/xbmc + $ $PREFIX/bin/kodi 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". @@ -200,6 +200,6 @@ you will either need to rerun configure with the correct prefix for this step to If you would like to also remove any settings and 3rd party addons (skins, scripts, etc) you should also run: -.1 $ rm -rf ~/.xbmc +.1 $ rm -rf ~/.kodi EOF diff --git a/docs/README.osx b/docs/README.osx index c38f6874ad..9bba999d45 100644 --- a/docs/README.osx +++ b/docs/README.osx @@ -14,7 +14,7 @@ TOC ----------------------------------------------------------------------------- This is a platform port of Kodi for the Apple OSX operating system. 10.6, 10.7 -10.8 and 10.9 Intel development platforms are supported. Xcode 3.2.6 and 4.3 and newer +10.8, 10.9 and 10.10 Intel development platforms are supported. Xcode 3.2.6 and 4.3 and newer are the recommended versions. There are 3 ways to build Kodi for Mac, from command-line with make, from command-line using xcodebuild or from Xcode. @@ -29,13 +29,14 @@ On Snow Leopard (OSX 10.6.x) we recommend using Xcode 3.2.6. On Lion (OSX 10.7.x) we recommend using Xcode 4.3.x. On Mountain Lion (OSX 10.8.1) we recommend using Xcode 4.4. On Mavericks (OSX 10.9.3) we recommend using Xcode 5.1.1 or 6.0.1. +On Yosemite (OSX 10.10) we recommend using Xcode 6.1. NOTE TO NEW OS X USERS: All lines that are prefixed with the '$' character are commands that need to be typed into a Terminal window. Note that the '$' character itself should NOT be typed as part of the command. -ATTENTION: When using Mountain Lion (OSX 10.8.x) or Mavericks (10.9.x) you need to download and install -XQuartz from https://xquartz.macosforge.org/landing/ since its not part of OSX +ATTENTION: When using Mountain Lion (OSX 10.8.x), Mavericks (10.9.x) or Yosemite (10.10.x) you +need to download and install XQuartz from https://xquartz.macosforge.org/landing/ since its not part of OSX anymore. ----------------------------------------------------------------------------- @@ -50,7 +51,7 @@ anymore. ----------------------------------------------------------------------------- See point 3.0a below for an updated list of supported/tested Xcode/osx constellations!!! -Install latest Xcode (6.0.1 or 3.2.6 as of the writing). You can download it from +Install latest Xcode (6.1.0 or 3.2.6 as of the writing). You can download it from 1. Apple's site after registration at http://developer.apple.com/tools/download (Xcode 3.2.6) 2. In the MacOSX AppStore (Xcode 4.3.x and later). @@ -65,6 +66,7 @@ Xcode 4.3.x only runs on 10.7.x (Lion). Xcode 4.4 only runs on 10.8.x (Mountain Lion). Xcode 5.1.1 runs on 10.8.x and 10.9.x (Mavericks). Xcode 6.0.1 runs on 10.9.4 and later (Mavericks). +Xcode 6.1 runs on 10.9.5 and later (Mavericks). ----------------------------------------------------------------------------- 3.0a Supported Xcode and OSX constellations @@ -77,6 +79,7 @@ constellations of Xcode and osx versions (to be updated once we know more): 3. XCode 4.6 against OSX SDK 10.6, 10.7 and 10.8 on 10.7.x (Lion) and 10.8.x (ML) 4. XCode 5.1.1 against OSX SDK 10.8 (ML) and 10.9 (M) 5. XCode 6.0.1 against OSX SDK 10.9 (M) +6. XCode 6.1.0 against OSX SDK 10.10 (Y) ----------------------------------------------------------------------------- 3.1 Install Kodi build depends diff --git a/docs/README.raspberrypi b/docs/README.raspberrypi index aadcc418c7..83cca6cce8 100644 --- a/docs/README.raspberrypi +++ b/docs/README.raspberrypi @@ -14,22 +14,22 @@ crosscompile environment. 2. Installing and setting up the buildroot environment ----------------------------------------------------------------------------- -Create a top level directory where you checkout xbmc and buildroot. +Create a top level directory where you checkout Kodi and buildroot. For example : -mkdir /opt/xbmc-raspberrypi -cd /opt/xbmc-raspberrypi +mkdir /opt/kodi-raspberrypi +cd /opt/kodi-raspberrypi -Checkout xbmc : +Checkout kodi : -git clone https://github.com/xbmc/xbmc.git +git clone https://github.com/xbmc/xbmc.git kodi Checkout buildroot : git clone https://github.com/huceke/buildroot-rbp.git -cd /opt/xbmc-raspberrypi/buildroot-rbp +cd /opt/kodi-raspberrypi/buildroot-rbp -Follow the instructions in README.rbp how to build the system and xbmc. +Follow the instructions in README.rbp how to build the system and Kodi. diff --git a/docs/README.ubuntu b/docs/README.ubuntu index f922ce3a7d..7ae7b21c04 100644 --- a/docs/README.ubuntu +++ b/docs/README.ubuntu @@ -22,11 +22,11 @@ Note that the '$' character itself should NOT be typed as part of the command. ----------------------------------------------------------------------------- .0 $ cd $HOME -.1 $ git clone git://github.com/xbmc/xbmc.git xbmc +.1 $ git clone git://github.com/xbmc/xbmc.git kodi Note: You can clone any specific branch. -.1 $ git clone -b <branch> git://github.com/xbmc/xbmc.git xbmc +.1 $ git clone -b <branch> git://github.com/xbmc/xbmc.git kodi ----------------------------------------------------------------------------- 3. Installing the required Ubuntu packages @@ -54,9 +54,9 @@ Add the unstable and build-depends PPAs: .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 kodi -Optional: If you do not want XBMC to be installed via PPA, you can removed the PPAs again: +Optional: If you do not want Kodi 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 @@ -65,7 +65,7 @@ Note: Do not use "aptitude" for the build-dep command. It doesn't resolve everyt $ sudo apt-get install ccache Tip: For those with multiple computers at home is to try out distcc - (fully unsupported from XBMC of course) + (fully unsupported from Kodi of course) $ sudo apt-get install distcc ----------------------------------------------------------------------------- @@ -74,12 +74,15 @@ Tip: For those with multiple computers at home is to try out distcc 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 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 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 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 libpcre3-dev libplist-dev libpng-dev libpulse-dev libsdl-dev libsdl-gfx1.2-dev libsdl-image1.2-dev libsdl-mixer1.2-dev libsdl2-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 + +For >= 12.10: + $ sudo apt-get install libtag1-dev -On 8.10 and older versions, libcurl is outdated and thus XBMC will not compile properly. +On 8.10 and older versions, libcurl is outdated and thus Kodi 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 @@ -89,13 +92,13 @@ In this case you will have to manually compile the latest version. $ sudo make install For <= 12.04 -XBMC needs a new version of taglib other than what is available at this time. +Kodi 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 -or use prepackaged from the XBMC PPA. +or use prepackaged from the Kodi PPA. $ sudo apt-get install libtag1-dev @@ -115,8 +118,8 @@ See README.linux ----------------------------------------------------------------------------- 5. Uninstalling ----------------------------------------------------------------------------- -Remove any PPA installed XBMC. - $ sudo apt-get remove xbmc* +Remove any PPA installed Kodi. + $ sudo apt-get remove kodi* xbmc* -See README.linux/Uninstalling for removing compiled versions of XBMC. +See README.linux/Uninstalling for removing compiled versions of Kodi. EOF diff --git a/docs/manpages/kodi-send.1 b/docs/manpages/kodi-send.1 index 7e1921235f..03ca685177 100644 --- a/docs/manpages/kodi-send.1 +++ b/docs/manpages/kodi-send.1 @@ -8,7 +8,7 @@ This program is used for sending actions for Kodi. .PP Example .IP -kodi\-send \fB\-\-host\fR=\fI192\fR.168.0.1 \fB\-\-port\fR=\fI9777\fR \fB\-\-action=\fR"XBMC.Quit" +kodi\-send \fB\-\-host\fR=\fI192\fR.168.0.1 \fB\-\-port\fR=\fI9777\fR \fB\-\-action=\fR"Quit" .PP Options .TP |