https://kodi.wiki/api.php?action=feedcontributions&user=UNiversal&feedformat=atomOfficial Kodi Wiki - User contributions [en]2024-03-28T18:39:30ZUser contributionsMediaWiki 1.39.6https://kodi.wiki/index.php?title=Forks&diff=107882Forks2015-12-09T19:08:17Z<p>UNiversal: </p>
<hr />
<div>{{mininav|[[XBMC Foundation]]|[[XBMC]]}}<br />
<section begin=intro />Because of its royalty-free cross-platform nature, with XBMC/Kodi's core code being written in C++ (ANSI standard), possibility for easy rebranding by ODM/OEM with customization of the interface look and feel using skins, and simple addons (plugins) from third-party developers available via Python scripts for content extensions, many systems integrators have created modified versions of Kodi together with a JeOS that are mostly used as a software appliance suite in a variety of devices including smart TVs, set-top boxes, digital signage, hotel television systems, and network connected media players. <section end=intro /><br />
<br />
=== 9x9 Player for 9x9CloudTV ===<br />
9x9 Player (by Santa Clara, CA based 9x9Network) is an open source software media player client for 9x9Network's 9x9CloudTV peer-to-peer TV delivery network over internet. The frontend of this media player client uses XBMC's source code as its application framework platform, and 9x9Network as a company is also an official sponsor of XBMC.<br />
<br />
=== Boxee ===<br />
Boxee, was a freeware and partially open source software cross-platform media center and entertainment hub with social networking features that is a commercial fork of XBMC software. Boxee supported Windows, Linux, and OSX, with the first Alpha made available on 16 June 2008. Later, Boxee released their own set-top-box, the Boxee Box, and shortly after discontinued support for desktop OSes in order to focus on their new hardware. After the Boxee Box, Boxee abandoned their software completely, ending their fork of XBMC, with new hardware known as Boxee TV which used closed source software. In 2013, Boxee was bought by Samsung.<br />
<br />
=== Commodore OS Vision ===<br />
Commodore OS, full name Commodore OS Vision, is a free to download GNU/Linux distribution developed by Commodore USA and intended for its Commodore-branded PCs. The distribution is based on Debian and Linux Mint, available only for x86-64 architectures, and uses the GNOME 2 desktop environment and comes with several preinstalled software including XBMC media center.<br />
<br />
=== Crystalbuntu ===<br />
{{Main|Crystalbuntu}}<br />
{{#lst:Crystalbuntu|intro}}<br />
<br />
=== DVDFab Media Player ===<br />
DVDFab Media Player by Fengtao Software Inc. is a media player software for Windows, based on the XBMC source code. DVDFab Media Player can play encrypted and DRM-protected Blu-ray Discs for 60-days for free before it has to be licensed to enable that feature again. It can however playback unencrypted and Blu-ray ISO-images, folders, and other DRM-free media files without a license.<br />
<br />
=== E2BMC ===<br />
E2BMC is a XBMC-based software platform for DVR/PVR set-top boxes on-top embedded Linux hardware systems, designed as a hybrid integration between XBMC media center software and Dreambox's Enigma2 PVR software scripts, with OpenPLi (OpenEmbedded based Linux operating system for embedded systems) open source set-top box firmware images. "MK-Digital Cube" and "D-Cube R2" were the two first E2BMC based set-to boxes announced, and both was released in Q1 in 2014.<br />
<br />
OpenATV Team, a team of independent developers of long popular community driven firmware images for Enigma2 based set top-boxes like those from Dreambox and Vu+, have also promised that they will develop and release third-party OpenATV (also OpenEmbedded based) firmware images with XBMC for E2BMC compatible set-top boxes.<br />
<br />
=== Element OS ===<br />
Element OS is a free embedded operating system designed for use on a Home Theater PC (HTPC) which is connected to a HDTV. Element OS is a Linux based distribution similar to that of the [[XBMC Live]] distro, however it comes preloaded with dozens of applications for listening to, viewing, and managing music, videos, photos, and internet media. XBMC is the pre-installed default media center, but Boxee and Hulu Desktop are also installable.<br />
<br />
=== GeeXboX ===<br />
{{main|GeeXboX}}<br />
{{#lst:GeeXboX|intro}}<br />
<br />
=== Horizon TV by Liberty Global ===<br />
Horizon TV by Liberty Global, (first-generation Horizon TV only), is a cross-platform media platform and DVB-S2 Dual Tuner high-definition DVR/PVR set-top-box, (with hardware manufactured by Samsung as model "SMT-G7400"), which runs native XBMC as its main media center GUI interface on-top of Linux for embedded systems, together with a hidden proprietary middle-ware framework for video on demand and handling DRM for streaming multimedia.[58] It was first announced in September 2012, and it is also available from Dutch cable operation UPC Netherlands under the brand name "UPC Horizon TV".<br />
<br />
Liberty Global (branded as "UPC" in Europe and worldwide better known as just "Liberty") is since 2013 the worlds largest international cable company, with operations in 14 countries, with Horizon TV being its flagship platform with more than 10 million first-generation Horizon TV devices sold. The second-generation Horizon TV platform is however no longer based on XBMC, it instead is uses ActiveVideo's CloudTV platform.<br />
<br />
=== iConsole ===<br />
iConsole (formerly known under the project codename "''Full Circle''"), produced by startup company MechaWorks, is a freeware and partially open source media center and entertainment hub with video game console features that is initially a fork of XBMC and Boxee software. The first public Alpha release will be as a Linux based distribution, primarily designed to be installed on a computer's empty harddive to make a computer in to a dedicated HTPC, similar to that of the [[XBMC Live]] distro but specifically targeted to a minimum set-top box hardware setup.<br />
<br />
=== MediaPortal ===<br />
MediaPortal is free and open source software media center written for Microsoft Windows that is initially based on forked XBMC source code by Erwin Beckers (a.k.a. Frodo, who was also one of the original founders of XBMC) in February 2004. The reason for this fork to Microsoft Windows was to get away from hardware and software platform limitations of the Xbox game-console platform that XBMC development started on, mainly because of the Xbox inability to support TV-tuner adapters natively as Erwin wanted PVR functionality. Now after several years and innumerable feature changes there has been almost a complete re-design of the source code, however the skinning engine of MediaPortal 1.X.X still remains very similar to that of the original XBMC software making it relatively easy for people to port skins/themes back and forth between the two projects, something that is done quite frequently.<br />
<br />
=== MeeGo TV ===<br />
MeeGo TV was the MeeGo TV stack SDK (Software Development Kit) for Smart TV developing platform, as a specialized branch of the MeeGo (Linux-based) open source mobile operating system. This Meego TV stack provided a GPLv2 compatible "OBS Light" (openSUSE's Open Build Service for clients) based SDK that used a derivative fork of XBMC media center software for embedded systems appliance devices. MeeGo and its Smart TV development platform was founded by the Linux Foundation, Intel, and AMD.<br />
<br />
=== MrMC ===<br />
MrMC is an open source (GPL), multiple platform, software media player for digital media, Based on Kodi.<br />
<br />
<br />
=== ONEvision by at-visions ===<br />
ONEvision by at-visions Informationstechnologie GmbH, (an international system integration and IT soutsourcing firm for hotels), ONEvision is a commercial fork of XBMC for use as hotel television system software in hotel environments and in the hospitality industry for in-room entertainment. It offers a platform for in-room service bookings and an IPTV interface, with custom theme branding. ONEvision is currently used throughout Europe and Asia at hotels such as Hyatt EMEA, Ramada Vienna, RIMC International, DWA Bratanki, Rogner International, EH&A, Heritage Hotel Hallstatt, St. Martins Therme, and Heiltherme Bad Waltersdorf. As of October 2010, at-visions as a company is also an official sponsor of XBMC.<br />
<br />
=== OpenBricks ===<br />
OpenBricks is a free and open source Linux framework, tools, and build system, similar to that of the competing OpenEmbedded and Yocto projects, it provides easy creation of custom embedded Linux operating system distributions for embedded devices. It features a complete embedded development kit for rapid deployment of embedded software on x86, ARM, PowerPC, and MIPS system architectures.[32] Primarily designed to be used to create distributions for DVR/PVR set-top boxes and media player appliance boxes, it does prove complete media center software suites as options, with the choice of pre-configured versions of XBMC, MythTV, and more.[33]<br />
<br />
GeeXboX and OpenPCTV are probably the two best known Linux distro for XBMC that is based on the OpenBricks framework.<br />
<br />
=== OpenELEC ===<br />
{{main|OpenELEC}}<br />
{{#lst:OpenELEC|intro}}<br />
<br />
=== OpenPCTV ===<br />
OpenPCTV is a XBMC-based open source Linux distribution for personal computers and embedded system to be used as DVR/PVR set-top boxes and media player appliance boxes. Just like E2BMC, OpenPCTV is also designed as a hybrid integration between XBMC and Dreambox's Enigma2 PVR software scripts, using VDR (Video Disk Recorder) as the TV tuner backend server and OpenBricks based Linux operating system images for embedded systems.<br />
<br />
=== Plex ===<br />
On 21 May 2008, XBMC developer Elan Feingold forked the source code of XBMC and started a new project called Plex, (previously this Mac OS X port of XBMC was informally known as the "''OSXBMC''" project). Feingold said that he would still try to collaborate with most Team-XBMC members behind the scenes and at least try to keep Plex skinning engine compatible with XBMC skins. While Plex began as a free software hobby project, since 2010 it is commercial software, and today parts of what Plex offers is closed source proprietary software. The Linux, Macintosh, and Windows servers and clients are free, while their Android and iOS clients cost money.<br />
<br />
Feingold was the Team-XBMC member who first initiated the Mac OS X port of XBMC, but soon after he left the original XBMC project due to what was arguably a falling-out with rest of Team-XBMC's developer members over the team's majorities feeling that the XBMC project should aim for strict adherence to the GPL and always keep to an open-source software mindset. This disagreement is claimed to be one of the main factors that led Elan to leave the XBMC project and create the Plex fork.<br />
<br />
=== PrismCube by Marusys ===<br />
PrismCube by Marusys is a DVB-S2 Twin-Tuner high-definition DVR/PVR set-top-box running native XBMC as its main media center GUI interface on-top of Linux for embedded systems. Released in October 2013, this first hardware model is marketed as "PrismCube Ruby" in Europe, North Africa, and Middle East, and it is also sold under different brand names such as "Kasys Prismcube Ruby", "AB IPBox Prismcube Ruby", and "Openbox Prismcube Ruby".<br />
<br />
PrismCube Ruby firmware image is based on OpenEmbedded-Linux, and uses Marusys's own PVR backend software that integrated itself into XBMC's GUI, so currently the PVR front-end GUI functions and features on PrismCube are not part of native XBMC core code, though they use the same skin texture elements to achieve some what similar look and feel interface, a ported fork which Marusys calls "XBMC4STB" (XBMC for Set-Top-Boxes), which is the same name that Vu+ have given to their XBMC port too. Third-party firmware images for PrismCube Ruby is also being developed by the Black Hole Team, a team of independent developers of long popular community driven firmware images for Vu+-based set top-boxes.<br />
<br />
=== Pulse ===<br />
Pulse-Eight Limited sells both custom and off the shelf hardware solutions primarily designed for XBMC, such as remote controls, HTPC systems and accessories, including a custom HTPC PVR set-top-box pre-installed with XBMC that they call "PulseBox" Pulse-Eight also offers free performance tuned embedded versions of XBMC that they call "Pulse" which is based on OpenELEC and a custom PVR-build of XBMC that is meant to on your dedicated HTPC system.<br />
<br />
=== Qt Media Hub ===<br />
Qt Media Hub (also known as QtMediaHub or Qt MediaHub), by Nokia, is a proof of concept port of XBMC to QML and Qt framework on ARM platforms for the MeeGo, Maemo, and Mer projects, to demonstrate the power and flexibility of using Qt/QML, and also to show the best practices when using Qt/QML.<br />
<br />
=== Raspbmc ===<br />
{{main|Raspbmc}}<br />
{{#lst:Raspbmc|intro}}<br />
<br />
=== RasPlex ===<br />
RasPlex is an Linux-based OS distribution designed and optimized for the Raspberry Pi, and comes with a forked version of XBMC. RasPlex's XBMC has been modified to look and feel like Plex Home Theater. It is primarily designed to be a third-party client for Plex Media Server, but it can be used as a stand-alone media player as well. RasPlex uses software firmware image which is fork of OpenELEC.<br />
<br />
=== Rippl-TV ===<br />
Rippl-TV by Rippl-TV Electronics is a development framework and software platform centered around XBMC for Android, (similar to TOFU Media Platform by Pivos). It is designed for both first-party (ei. media player devices from Rippl-TV Electronics themselves) and also licensed to third-parties (OEM/ODM) and other commercial partners for branding. Marketed as a "entertainment ecosystem" derived from XBMC Media Center, that build on top of underlying custom Android operating system. Rippl-TV platform itself consists of "XBMC Rippl-TV Edition" which is a fork of XBMC, and the current version of "UtilOS" is a fork of Android 4.4 (KitKat) firmware<br />
<br />
=== Sabayon Linux ===<br />
Sabayon Linux is a full Linux distribution that among other applications comes with a pre-installed and preconfigured "ready-to-use" version of XBMC Media Center.<br />
<br />
=== SPMC ===<br />
{{main|SPMC}}<br />
{{#lst:SPMC|intro}}<br />
<br />
=== The One from DitIsTV ===<br />
DitIsTV is a Dutch company which uses the Raspberry Pi as the HTPC hardware. They include OpenELEC as operating system with XBMC and provide it with a custom skin and several add-ons included by default.<br />
<br />
=== TOFU Media Center by Pivos ===<br />
TOFU Media Platform by Pivos Technology Group, Inc. is a development framework and software platform centered around XBMC for Android, designed for both first-parties (ei. media player devices from Pivos themselves) and licensed to third parties (OEM) and other commercial partners. Marked as a "entertainment ecosystem" derived from XBMC Media Center, that build on top of underlying embedded operating system such as Android or Linux variants.<br />
<br />
TOFU Media Platform itself consists of "TOFU Media Center" which is a fork of XBMC, and the current version of "TOFU Media OS" is a fork of Android 4.2 (Jellybean). The first commercial third-party device to have official ToFu Media Center (Android version) application support was the GameStick video game console developed by PlayJam. Pivos's own first device that comes with the complete TOFU Media Platform (TOFU Media OS and TOFU Media Center) preloaded is their Pivos XIOS XS media player.<br />
<br />
=== VidOn Media Center by VidOn.me ===<br />
VidOn.me (or VidOnMe) is a company that maintain a commercial fork and derivative of XBMC media center software, named VidOn Media Center (formerly "VidOn XBMC") and other than offering non-XBMC based media player software for iOS and Android, they also sell set-top boxes and Mini PCs with Android 4.x that comes with XBMC pre-installed re-branded under the VidOn.me name. They in addition offer iOS and Android remote control apps for their VidOn.me media player software, both which the company claim to be fully cross-compatible with remote control apps designed for XBMC and vice versa.<br />
<br />
=== Voddler ===<br />
Voddler is a commercial video-on-demand service and client software streaming movies and television programming, similar to Spotify and Grooveshark but for video. From its first release at 1 July 2009 up until 24 February 2010, Voddler's media player software was initially based on a fork of the XBMC open source code. Voddler violated the license for XBMC's source code by neglecting to release all of their modifications that they used in their application as required per the GPL, and they have been publicly criticized for this.<br />
<br />
Voddler's newer media player software is since 8 March 2010 now instead based on the Adobe Air closed-source application platform.<br />
<br />
=== XBian ===<br />
XBian is an another Linux distribution based on Raspbian which comes with a pre-configured version of XBMC and is optimized for Raspberry Pi.<br />
<br />
=== XBMC4STB project by Vu+ ===<br />
'''Vu+''' (or VUplus), is produced by a Korean multimedia vendor, which is a manufacturer of Linux-powered DVB, satellite, terrestrial digital television receivers) that all currently uses Enigma2 for Dreambox based software as firmware.<br />
<br />
In September 2011 Vu+ Day in Amsterdam it was announced that the next-generation Vu+ DVB satellite receivers to be released publicly in the end of 2012 will be using XBMC Media Center software for its GUI, a development project that they call "''XBMC4STB''" (''XBMC for Set-Top-Boxes''), with beta releases of both the software and hardware said to be made available to XBMC developers before then.<br />
<br />
=== XBMC4Xbox ===<br />
{{main|XBMC4Xbox}}<br />
{{#lst:XBMC4Xbox|intro}}<br />
<br />
=== XBMC for BSD ===<br />
XBMC for BSD, which is a full port of XBMC to BSD UNIX operating-systems. Compatible with FreeBSD and other similar derivatives like PC-BSD, for IA-32/x86, x86-64, PowerPC (G4 or later), and ARM-based computers, including hardware accelerated video decoding via VDPAU API on Nvidia's GPUs and VAAPI API for AMD/ATI Radeon<br />
<br />
=== yaVDR ===<br />
yaVDR (which name originated from the abbreviation "''yet another VDR''") is an Ubuntu-based Linux (i386) distribution designed for HTPCs with a TV tuner card for DVR (Digital Video Recorder) capabilities. yaVDR comes preinstalled and preconfigured "''ready-to-use''" version of XBMC Media Center from the "''PVR''" Subversion development branch as its primary front-end media player interface, with VDR (Video Disk Recorder) integrated as its PVR back-end server. It also features Xine as an alternative front-end media player interface to XBMC.<br />
<br />
[[Category:Kodi]]</div>UNiversalhttps://kodi.wiki/index.php?title=Forks&diff=107881Forks2015-12-09T19:07:28Z<p>UNiversal: </p>
<hr />
<div>{{mininav|[[XBMC Foundation]]|[[XBMC]]}}<br />
<section begin=intro />Because of its royalty-free cross-platform nature, with XBMC/Kodi's core code being written in C++ (ANSI standard), possibility for easy rebranding by ODM/OEM with customization of the interface look and feel using skins, and simple addons (plugins) from third-party developers available via Python scripts for content extensions, many systems integrators have created modified versions of Kodi together with a JeOS that are mostly used as a software appliance suite in a variety of devices including smart TVs, set-top boxes, digital signage, hotel television systems, and network connected media players. <section end=intro /><br />
<br />
=== 9x9 Player for 9x9CloudTV ===<br />
9x9 Player (by Santa Clara, CA based 9x9Network) is an open source software media player client for 9x9Network's 9x9CloudTV peer-to-peer TV delivery network over internet. The frontend of this media player client uses XBMC's source code as its application framework platform, and 9x9Network as a company is also an official sponsor of XBMC.<br />
<br />
=== Boxee ===<br />
Boxee, was a freeware and partially open source software cross-platform media center and entertainment hub with social networking features that is a commercial fork of XBMC software. Boxee supported Windows, Linux, and OSX, with the first Alpha made available on 16 June 2008. Later, Boxee released their own set-top-box, the Boxee Box, and shortly after discontinued support for desktop OSes in order to focus on their new hardware. After the Boxee Box, Boxee abandoned their software completely, ending their fork of XBMC, with new hardware known as Boxee TV which used closed source software. In 2013, Boxee was bought by Samsung.<br />
<br />
=== Commodore OS Vision ===<br />
Commodore OS, full name Commodore OS Vision, is a free to download GNU/Linux distribution developed by Commodore USA and intended for its Commodore-branded PCs. The distribution is based on Debian and Linux Mint, available only for x86-64 architectures, and uses the GNOME 2 desktop environment and comes with several preinstalled software including XBMC media center.<br />
<br />
=== Crystalbuntu ===<br />
{{Main|Crystalbuntu}}<br />
{{#lst:Crystalbuntu|intro}}<br />
<br />
=== DVDFab Media Player ===<br />
DVDFab Media Player by Fengtao Software Inc. is a media player software for Windows, based on the XBMC source code. DVDFab Media Player can play encrypted and DRM-protected Blu-ray Discs for 60-days for free before it has to be licensed to enable that feature again. It can however playback unencrypted and Blu-ray ISO-images, folders, and other DRM-free media files without a license.<br />
<br />
=== E2BMC ===<br />
E2BMC is a XBMC-based software platform for DVR/PVR set-top boxes on-top embedded Linux hardware systems, designed as a hybrid integration between XBMC media center software and Dreambox's Enigma2 PVR software scripts, with OpenPLi (OpenEmbedded based Linux operating system for embedded systems) open source set-top box firmware images. "MK-Digital Cube" and "D-Cube R2" were the two first E2BMC based set-to boxes announced, and both was released in Q1 in 2014.<br />
<br />
OpenATV Team, a team of independent developers of long popular community driven firmware images for Enigma2 based set top-boxes like those from Dreambox and Vu+, have also promised that they will develop and release third-party OpenATV (also OpenEmbedded based) firmware images with XBMC for E2BMC compatible set-top boxes.<br />
<br />
=== Element OS ===<br />
Element OS is a free embedded operating system designed for use on a Home Theater PC (HTPC) which is connected to a HDTV. Element OS is a Linux based distribution similar to that of the [[XBMC Live]] distro, however it comes preloaded with dozens of applications for listening to, viewing, and managing music, videos, photos, and internet media. XBMC is the pre-installed default media center, but Boxee and Hulu Desktop are also installable.<br />
<br />
=== GeeXboX ===<br />
{{main|GeeXboX}}<br />
{{#lst:GeeXboX|intro}}<br />
<br />
=== Horizon TV by Liberty Global ===<br />
Horizon TV by Liberty Global, (first-generation Horizon TV only), is a cross-platform media platform and DVB-S2 Dual Tuner high-definition DVR/PVR set-top-box, (with hardware manufactured by Samsung as model "SMT-G7400"), which runs native XBMC as its main media center GUI interface on-top of Linux for embedded systems, together with a hidden proprietary middle-ware framework for video on demand and handling DRM for streaming multimedia.[58] It was first announced in September 2012, and it is also available from Dutch cable operation UPC Netherlands under the brand name "UPC Horizon TV".<br />
<br />
Liberty Global (branded as "UPC" in Europe and worldwide better known as just "Liberty") is since 2013 the worlds largest international cable company, with operations in 14 countries, with Horizon TV being its flagship platform with more than 10 million first-generation Horizon TV devices sold. The second-generation Horizon TV platform is however no longer based on XBMC, it instead is uses ActiveVideo's CloudTV platform.<br />
<br />
=== iConsole ===<br />
iConsole (formerly known under the project codename "''Full Circle''"), produced by startup company MechaWorks, is a freeware and partially open source media center and entertainment hub with video game console features that is initially a fork of XBMC and Boxee software. The first public Alpha release will be as a Linux based distribution, primarily designed to be installed on a computer's empty harddive to make a computer in to a dedicated HTPC, similar to that of the [[XBMC Live]] distro but specifically targeted to a minimum set-top box hardware setup.<br />
<br />
=== MediaPortal ===<br />
MediaPortal is free and open source software media center written for Microsoft Windows that is initially based on forked XBMC source code by Erwin Beckers (a.k.a. Frodo, who was also one of the original founders of XBMC) in February 2004. The reason for this fork to Microsoft Windows was to get away from hardware and software platform limitations of the Xbox game-console platform that XBMC development started on, mainly because of the Xbox inability to support TV-tuner adapters natively as Erwin wanted PVR functionality. Now after several years and innumerable feature changes there has been almost a complete re-design of the source code, however the skinning engine of MediaPortal 1.X.X still remains very similar to that of the original XBMC software making it relatively easy for people to port skins/themes back and forth between the two projects, something that is done quite frequently.<br />
<br />
=== MeeGo TV ===<br />
MeeGo TV was the MeeGo TV stack SDK (Software Development Kit) for Smart TV developing platform, as a specialized branch of the MeeGo (Linux-based) open source mobile operating system. This Meego TV stack provided a GPLv2 compatible "OBS Light" (openSUSE's Open Build Service for clients) based SDK that used a derivative fork of XBMC media center software for embedded systems appliance devices. MeeGo and its Smart TV development platform was founded by the Linux Foundation, Intel, and AMD.<br />
<br />
== MrMC ==<br />
MrMC is an open source (GPL), multiple platform, software media player for digital media, Based on Kodi.<br />
<br />
<br />
=== ONEvision by at-visions ===<br />
ONEvision by at-visions Informationstechnologie GmbH, (an international system integration and IT soutsourcing firm for hotels), ONEvision is a commercial fork of XBMC for use as hotel television system software in hotel environments and in the hospitality industry for in-room entertainment. It offers a platform for in-room service bookings and an IPTV interface, with custom theme branding. ONEvision is currently used throughout Europe and Asia at hotels such as Hyatt EMEA, Ramada Vienna, RIMC International, DWA Bratanki, Rogner International, EH&A, Heritage Hotel Hallstatt, St. Martins Therme, and Heiltherme Bad Waltersdorf. As of October 2010, at-visions as a company is also an official sponsor of XBMC.<br />
<br />
=== OpenBricks ===<br />
OpenBricks is a free and open source Linux framework, tools, and build system, similar to that of the competing OpenEmbedded and Yocto projects, it provides easy creation of custom embedded Linux operating system distributions for embedded devices. It features a complete embedded development kit for rapid deployment of embedded software on x86, ARM, PowerPC, and MIPS system architectures.[32] Primarily designed to be used to create distributions for DVR/PVR set-top boxes and media player appliance boxes, it does prove complete media center software suites as options, with the choice of pre-configured versions of XBMC, MythTV, and more.[33]<br />
<br />
GeeXboX and OpenPCTV are probably the two best known Linux distro for XBMC that is based on the OpenBricks framework.<br />
<br />
=== OpenELEC ===<br />
{{main|OpenELEC}}<br />
{{#lst:OpenELEC|intro}}<br />
<br />
=== OpenPCTV ===<br />
OpenPCTV is a XBMC-based open source Linux distribution for personal computers and embedded system to be used as DVR/PVR set-top boxes and media player appliance boxes. Just like E2BMC, OpenPCTV is also designed as a hybrid integration between XBMC and Dreambox's Enigma2 PVR software scripts, using VDR (Video Disk Recorder) as the TV tuner backend server and OpenBricks based Linux operating system images for embedded systems.<br />
<br />
=== Plex ===<br />
On 21 May 2008, XBMC developer Elan Feingold forked the source code of XBMC and started a new project called Plex, (previously this Mac OS X port of XBMC was informally known as the "''OSXBMC''" project). Feingold said that he would still try to collaborate with most Team-XBMC members behind the scenes and at least try to keep Plex skinning engine compatible with XBMC skins. While Plex began as a free software hobby project, since 2010 it is commercial software, and today parts of what Plex offers is closed source proprietary software. The Linux, Macintosh, and Windows servers and clients are free, while their Android and iOS clients cost money.<br />
<br />
Feingold was the Team-XBMC member who first initiated the Mac OS X port of XBMC, but soon after he left the original XBMC project due to what was arguably a falling-out with rest of Team-XBMC's developer members over the team's majorities feeling that the XBMC project should aim for strict adherence to the GPL and always keep to an open-source software mindset. This disagreement is claimed to be one of the main factors that led Elan to leave the XBMC project and create the Plex fork.<br />
<br />
=== PrismCube by Marusys ===<br />
PrismCube by Marusys is a DVB-S2 Twin-Tuner high-definition DVR/PVR set-top-box running native XBMC as its main media center GUI interface on-top of Linux for embedded systems. Released in October 2013, this first hardware model is marketed as "PrismCube Ruby" in Europe, North Africa, and Middle East, and it is also sold under different brand names such as "Kasys Prismcube Ruby", "AB IPBox Prismcube Ruby", and "Openbox Prismcube Ruby".<br />
<br />
PrismCube Ruby firmware image is based on OpenEmbedded-Linux, and uses Marusys's own PVR backend software that integrated itself into XBMC's GUI, so currently the PVR front-end GUI functions and features on PrismCube are not part of native XBMC core code, though they use the same skin texture elements to achieve some what similar look and feel interface, a ported fork which Marusys calls "XBMC4STB" (XBMC for Set-Top-Boxes), which is the same name that Vu+ have given to their XBMC port too. Third-party firmware images for PrismCube Ruby is also being developed by the Black Hole Team, a team of independent developers of long popular community driven firmware images for Vu+-based set top-boxes.<br />
<br />
=== Pulse ===<br />
Pulse-Eight Limited sells both custom and off the shelf hardware solutions primarily designed for XBMC, such as remote controls, HTPC systems and accessories, including a custom HTPC PVR set-top-box pre-installed with XBMC that they call "PulseBox" Pulse-Eight also offers free performance tuned embedded versions of XBMC that they call "Pulse" which is based on OpenELEC and a custom PVR-build of XBMC that is meant to on your dedicated HTPC system.<br />
<br />
=== Qt Media Hub ===<br />
Qt Media Hub (also known as QtMediaHub or Qt MediaHub), by Nokia, is a proof of concept port of XBMC to QML and Qt framework on ARM platforms for the MeeGo, Maemo, and Mer projects, to demonstrate the power and flexibility of using Qt/QML, and also to show the best practices when using Qt/QML.<br />
<br />
=== Raspbmc ===<br />
{{main|Raspbmc}}<br />
{{#lst:Raspbmc|intro}}<br />
<br />
=== RasPlex ===<br />
RasPlex is an Linux-based OS distribution designed and optimized for the Raspberry Pi, and comes with a forked version of XBMC. RasPlex's XBMC has been modified to look and feel like Plex Home Theater. It is primarily designed to be a third-party client for Plex Media Server, but it can be used as a stand-alone media player as well. RasPlex uses software firmware image which is fork of OpenELEC.<br />
<br />
=== Rippl-TV ===<br />
Rippl-TV by Rippl-TV Electronics is a development framework and software platform centered around XBMC for Android, (similar to TOFU Media Platform by Pivos). It is designed for both first-party (ei. media player devices from Rippl-TV Electronics themselves) and also licensed to third-parties (OEM/ODM) and other commercial partners for branding. Marketed as a "entertainment ecosystem" derived from XBMC Media Center, that build on top of underlying custom Android operating system. Rippl-TV platform itself consists of "XBMC Rippl-TV Edition" which is a fork of XBMC, and the current version of "UtilOS" is a fork of Android 4.4 (KitKat) firmware<br />
<br />
=== Sabayon Linux ===<br />
Sabayon Linux is a full Linux distribution that among other applications comes with a pre-installed and preconfigured "ready-to-use" version of XBMC Media Center.<br />
<br />
=== SPMC ===<br />
{{main|SPMC}}<br />
{{#lst:SPMC|intro}}<br />
<br />
=== The One from DitIsTV ===<br />
DitIsTV is a Dutch company which uses the Raspberry Pi as the HTPC hardware. They include OpenELEC as operating system with XBMC and provide it with a custom skin and several add-ons included by default.<br />
<br />
=== TOFU Media Center by Pivos ===<br />
TOFU Media Platform by Pivos Technology Group, Inc. is a development framework and software platform centered around XBMC for Android, designed for both first-parties (ei. media player devices from Pivos themselves) and licensed to third parties (OEM) and other commercial partners. Marked as a "entertainment ecosystem" derived from XBMC Media Center, that build on top of underlying embedded operating system such as Android or Linux variants.<br />
<br />
TOFU Media Platform itself consists of "TOFU Media Center" which is a fork of XBMC, and the current version of "TOFU Media OS" is a fork of Android 4.2 (Jellybean). The first commercial third-party device to have official ToFu Media Center (Android version) application support was the GameStick video game console developed by PlayJam. Pivos's own first device that comes with the complete TOFU Media Platform (TOFU Media OS and TOFU Media Center) preloaded is their Pivos XIOS XS media player.<br />
<br />
=== VidOn Media Center by VidOn.me ===<br />
VidOn.me (or VidOnMe) is a company that maintain a commercial fork and derivative of XBMC media center software, named VidOn Media Center (formerly "VidOn XBMC") and other than offering non-XBMC based media player software for iOS and Android, they also sell set-top boxes and Mini PCs with Android 4.x that comes with XBMC pre-installed re-branded under the VidOn.me name. They in addition offer iOS and Android remote control apps for their VidOn.me media player software, both which the company claim to be fully cross-compatible with remote control apps designed for XBMC and vice versa.<br />
<br />
=== Voddler ===<br />
Voddler is a commercial video-on-demand service and client software streaming movies and television programming, similar to Spotify and Grooveshark but for video. From its first release at 1 July 2009 up until 24 February 2010, Voddler's media player software was initially based on a fork of the XBMC open source code. Voddler violated the license for XBMC's source code by neglecting to release all of their modifications that they used in their application as required per the GPL, and they have been publicly criticized for this.<br />
<br />
Voddler's newer media player software is since 8 March 2010 now instead based on the Adobe Air closed-source application platform.<br />
<br />
=== XBian ===<br />
XBian is an another Linux distribution based on Raspbian which comes with a pre-configured version of XBMC and is optimized for Raspberry Pi.<br />
<br />
=== XBMC4STB project by Vu+ ===<br />
'''Vu+''' (or VUplus), is produced by a Korean multimedia vendor, which is a manufacturer of Linux-powered DVB, satellite, terrestrial digital television receivers) that all currently uses Enigma2 for Dreambox based software as firmware.<br />
<br />
In September 2011 Vu+ Day in Amsterdam it was announced that the next-generation Vu+ DVB satellite receivers to be released publicly in the end of 2012 will be using XBMC Media Center software for its GUI, a development project that they call "''XBMC4STB''" (''XBMC for Set-Top-Boxes''), with beta releases of both the software and hardware said to be made available to XBMC developers before then.<br />
<br />
=== XBMC4Xbox ===<br />
{{main|XBMC4Xbox}}<br />
{{#lst:XBMC4Xbox|intro}}<br />
<br />
=== XBMC for BSD ===<br />
XBMC for BSD, which is a full port of XBMC to BSD UNIX operating-systems. Compatible with FreeBSD and other similar derivatives like PC-BSD, for IA-32/x86, x86-64, PowerPC (G4 or later), and ARM-based computers, including hardware accelerated video decoding via VDPAU API on Nvidia's GPUs and VAAPI API for AMD/ATI Radeon<br />
<br />
=== yaVDR ===<br />
yaVDR (which name originated from the abbreviation "''yet another VDR''") is an Ubuntu-based Linux (i386) distribution designed for HTPCs with a TV tuner card for DVR (Digital Video Recorder) capabilities. yaVDR comes preinstalled and preconfigured "''ready-to-use''" version of XBMC Media Center from the "''PVR''" Subversion development branch as its primary front-end media player interface, with VDR (Video Disk Recorder) integrated as its PVR back-end server. It also features Xine as an alternative front-end media player interface to XBMC.<br />
<br />
[[Category:Kodi]]</div>UNiversalhttps://kodi.wiki/index.php?title=Add-on:OpenSubtitles.org&diff=102691Add-on:OpenSubtitles.org2015-10-28T12:20:21Z<p>UNiversal: add notice that opensubtitles was ripped from repo and add reason</p>
<hr />
<div><big>{{redv|Notice:| '''This addon was removed from the Kodi repo in [https://github.com/xbmc/repo-scripts/commit/3253bc3a27c6b007baeed37f6eff9a47145f8475 this commit] due to containing adverts'''}}</big><br />
<br />
{{Addon <br />
|Name=OpenSubtitles.org<br />
|provider-name=amet<br />
|ID=service.subtitles.opensubtitles<br />
|latest-version=5.0.14<br />
|extension point=xbmc.subtitle.module<br />
|provides=<br />
|Summary=OpenSubtitles<br />
|Description=Search and download subtitles from opensubtitles.org<br />
|Platform=all<br />
|Language=<br />
|License=GNU GENERAL PUBLIC LICENSE. Version 2, June 1991<br />
|Forum=http://forum.xbmc.org/showthread.php?tid=183114<br />
|Website=<br />
|Source=https://github.com/amet/service.subtitles.opensubtitles<br />
|Email=<br />
|broken=<br />
|icon url=http://mirrors.kodi.tv/addons/gotham/service.subtitles.opensubtitles/icon.png}}<br />
<br />
[[Category:Gotham add-on repository]]</div>UNiversalhttps://kodi.wiki/index.php?title=TexturePacker&diff=100700TexturePacker2015-09-08T23:12:40Z<p>UNiversal: 1.0.4 update</p>
<hr />
<div>{{mininav|[[Development]]|[[Add-on development]]|[[Skinning]]}}<br />
<section begin="intro" />Kodi uses a tool named TexturePacker to compile all images used in a skin into a single file. The benefit of it is that images inside the Textures.xbt will load faster in the skin. This is done by converting all images into a format that take less processing by Kodi when they need to be rendered onto the screen.<br />
<br />
A common misconception is that TexturPacker will just compress the images into a single file, this if far from the truth, so don't be surprised if the Textures.xbt file is much larger than to total size of all the individual images.<br />
<section end="intro" /><br />
== How To Get It ==<br />
If you are using Windows, you can simply download a zipfile with an up-to-date version of TexturePacker from the Kodi mirrors.<br />
<br /><big>'''It is available here:''' [http://mirrors.kodi.tv/build-deps//win32/texturepacker-1.0.4-win32.7z '''Download TexturePacker 1.0.4''']</big><br />
{{note| This is a dll free self contained texturepacker executable for windows.}}<br />
<br />
On other platforms, you will have to compile TexturePacker yourself. This is done by compiling Kodi and when the compile is finished, you can find TexturePacker inside the ../tools/depends/native/TexturePacker directory.<br />
<br />
== Usage ==<br />
Since TexturePacker is a command-line tool, you will need to open a dos box/terminal/console in order to run it. The general usage is:<br />
<pre>TexturePacker -input skin.name\media -output skin.name\media\Textures.xbt</pre><br />
<br />
Optionally, you can run TexturePacker with the ''-dupecheck'' option. This is useful if you have included the same image multiple times in your media folder. For example, if your skin includes a lot of studio logos, most likely a lot of them are included multiple times but with a slightly different filename. The '-dupecheck' option will make sure each unique image is included only once in the Textures.xbt file and thus keeping the size of it as small as possible.<br />
<br />
If your skins includes [[Skin_development_introduction#Skin_Themes]] you should also run TexturePacker on your theme folders:<br />
<pre>TexturePacker -input skin.name\themes\Blue -output skin.name\media\Blue.xbt</pre><br />
<br />
{{Note| When using an XBT file in your skin, your file paths will '''not''' be case sensitive, even if your skin resides on a case sensitive file system!}}<br />
<br />
=== Texturepacker build bat ===<br />
Create a Texturepacker.bat with the contents below, inside the skin.name directory along with all the texturepacker.exe, a double click on the bat file does all the work for you.<br />
<pre><br />
@ECHO OFF<br />
<br />
COLOR A<br />
<br />
ECHO -------------------------------------------------------------------------<br />
ECHO ^> ** Creating excludes... **<br />
<br />
ECHO .svn>exclude.txt<br />
ECHO .git>>exclude.txt<br />
ECHO Thumbs.db>>exclude.txt<br />
ECHO Desktop.ini>>exclude.txt<br />
ECHO dsstdfx.bin>>exclude.txt<br />
ECHO build.bat>>exclude.txt<br />
ECHO \skin.confluence\media\>>exclude.txt<br />
ECHO \skin.confluence\backgrounds\>>exclude.txt<br />
ECHO exclude.txt>>exclude.txt<br />
<br />
ECHO -------------------------------------------------------------------------<br />
ECHO.<br />
<br />
ECHO -------------------------------------------------------------------------<br />
ECHO ** Creating Textures XBT File... **<br />
ECHO -------------------------------------------------------------------------<br />
<br />
ECHO.<br />
PING -n 2 -w 1000 127.0.0.1 > NUL<br />
START /B /WAIT TexturePacker -dupecheck -input media\ -output media\Texture.xbt<br />
PING -n 2 -w 20000 127.0.0.1 > NUL<br />
ECHO.<br />
ECHO.<br />
ECHO -------------------------------------------------------------------------<br />
ECHO ^> Deleting excludes...<br />
DEL exclude.txt<br />
ECHO ^> Done<br />
ECHO -------------------------------------------------------------------------<br />
ECHO.<br />
ECHO.<br />
<br />
ECHO -------------------------------------------------------------------------<br />
ECHO ** XBT build complete - scroll up to check for errors. **<br />
ECHO -------------------------------------------------------------------------<br />
<br />
PING -n 50 -w 5000 127.0.0.1 > NUL<br />
</pre><br />
<br />
[[Category:Add-on development]]<br />
[[Category:Skin development]]<br />
[[Category:Development]]</div>UNiversalhttps://kodi.wiki/index.php?title=Archive:Kodibuntu&diff=100596Archive:Kodibuntu2015-09-06T07:33:35Z<p>UNiversal: </p>
<hr />
<div>{{mininav|[[Linux]] {{l2| [[Devices]] }} }}<br />
{{to do}}<br />
<section begin="intro" />[[Kodibuntu]] is a combination Kodi/operating system for use on PCs that are mainly just running Kodi. It is an alternative to installing Windows or a larger (and sometimes more complicated) Linux-based OS.<section end="intro" /><br />
<br />
== Hardware requirements ==<br />
{{see also|Supported hardware}}<br />
<br />
Kodibuntu should work with the general hardware requirements for Linux:<br />
{{Collapse top|Click to show hardware requirements -->}}<br />
{{#lst:Supported hardware|Linux}}<br />
{{Collapse bottom}}<br />
<br />
== Installing ==<br />
{{main|HOW-TO:Install KodiBuntu from a USB drive}}<br />
Kodibuntu comes in an ISO form that can be written to a USB drive or burned to an optical disc.<br />
<br />
Download the current stable Kodibuntu image from: '''<code>http://kodi.tv/download/</code>'''<br />
<br />
{{note|<br />
* Kodibuntu has only one iso image file for all x86 computers, regardless of GPU.<br />
* Currently, only a '''64-bit''' version is available, but this should cover the vast majority of users.<br />
* A pre release 32bit exists in mirrors with unstable ppa and RC candidate Kodi, which can be upgraded to stable kodi<br />
* There will be no separate Kodibuntu release for Kodi 15.x as it's based on the same OS. To get Kodi 15.x on Kodibuntu, just upgrade the software as suggested below}}<br />
<br />
== Upgrading Kodi Media Center ==<br />
{{main|HOW-TO:Install Kodi for Linux#Upgrading}}<br />
{{#lst:HOW-TO:Install Kodi for Linux|Ubuntu upgrade}}<br />
<br />
=== Upgrading the OS ===<br />
<br />
Current Kodibuntu is based on a LTS release (long term release) which is supported for 5 years, this means that it won't require to upgrade the OS base in order to obtain updated or upgrade application packages.<br />
<br />
See [https://wiki.ubuntu.com/Releases Current Ubuntu releases] if your current distro is listed under End of life table, you will need to upgrade your OS to a supported release.<br />
<br />
However should you need to upgrade the OS base a quick how-to follows.<br />
<br />
{{#lst:Kodibuntu FAQ|upgradeOS}}<br />
<br />
== Basic use ==<br />
<br />
=== Desktop mode ===<br />
<br />
Kodibuntu can boot directly into Kodi or it can also boot into a desktop mode for using applications such as a web browser.<br />
<br />
In order to enter desktop mode, follow those steps below:<br />
<gallery widths=500px heights=313px><br />
File:kodi-exit.png|'''Step 1:''' ''Exit'' Kodi.<br />
File:kodi-session.png|'''Step 2:''' Select ''Lubuntu'' and enter your ''username'' and ''password''.<br />
</gallery><br />
<br />
The username may differ from the one you supplied during installation. So please be aware, that "xbmc" (as shown in the screenshot) might not be the username you will see and/or have to use. <br />
<br />
{{note|If you last booted directly or switched to desktop and shutdown the HTPC while in desktop, on next reboot you will get the last used session by default.}} <br />
<br />
To return to Kodi, '''logout''', select '''Kodi''' as session in the top-right pulldown menu and enter your ''username'' and ''password'' again.<br />
<br />
=== Login ===<br />
To login to the command line interface press {{keypress|Ctrl|Alt|F1 - F6 }} or connect over [[SSH]] by using usernamne and password supplied during installation.<br />
<br />
{{note|For the use of {{keypress|Ctrl|Alt|F1 - F6 }} no username and password is required. You are logged in directly to the command line.}} <br />
<br />
<br />
=== Media center ===<br />
Kodibuntu contains [[Linux|Kodi for Linux]] compiled with the 'standalone' mode, this enabled certain functions that are not available in normal Kodi installations (Windows, Mac Linux), these functions include Power Management, and Network Management.<br />
<br />
=== Using desktop mode ===<br />
Chromium is included for web browsing and can be found in the start menu.<br />
<br />
In Systems / Package Manager tools - you can install other applications for your specific needs.<br />
<br />
==Other Uses==<br />
<br />
<br />
===KodiBuntu VNC Server===<br />
<br />
https://help.ubuntu.com/community/VNC/Servers<br />
<br />
*Install x11vnc <br />
*Set password<br />
**x11vnc -storepasswd<br />
*Test connection by running manual start command.<br />
x11vnc -auth guess -forever -loop -noxdamage -repeat -rfbauth /home/USERNAME/.vnc/passwd -rfbport 5900 -shared<br />
<br />
<br />
Have x11vnc start automatically via upstart in any environment (<=Utopic)<br />
sudo nano /etc/init/x11vnc.conf<br />
<br />
# description "Start x11vnc at boot"<br />
description "x11vnc"<br />
start on runlevel [2345]<br />
stop on runlevel [^2345]<br />
console log<br />
respawn<br />
respawn limit 20 5<br />
exec /usr/bin/x11vnc -auth guess -forever -loop -noxdamage -repeat -rfbauth /home/USERNAME/.vnc/passwd -rfbport 5900 -shared<br />
<br />
<br />
<br />
== KodiBuntu FAQ ==<br />
{{See|KodiBuntu FAQ}}<br />
<br />
== See also ==<br />
* [[Linux]]<br />
* [[HOW-TO:Install Kodi for Linux]]<br />
* [[JeOS implementations for Kodi]]<br />
* [[OpenELEC]]<br />
<br />
{{Helix updated}}<br />
<br />
[[Category:Installation]]<br />
[[Category:Linux]]<br />
[[Category:Kodibuntu|*]]<br />
[[Category:Manual]]</div>UNiversalhttps://kodi.wiki/index.php?title=Archive:Kodibuntu&diff=100595Archive:Kodibuntu2015-09-06T07:31:37Z<p>UNiversal: </p>
<hr />
<div>{{mininav|[[Linux]] {{l2| [[Devices]] }} }}<br />
{{to do}}<br />
<section begin="intro" />[[Kodibuntu]] is a combination Kodi/operating system for use on PCs that are mainly just running Kodi. It is an alternative to installing Windows or a larger (and sometimes more complicated) Linux-based OS.<section end="intro" /><br />
<br />
== Hardware requirements ==<br />
{{see also|Supported hardware}}<br />
<br />
Kodibuntu should work with the general hardware requirements for Linux:<br />
{{Collapse top|Click to show hardware requirements -->}}<br />
{{#lst:Supported hardware|Linux}}<br />
{{Collapse bottom}}<br />
<br />
== Installing ==<br />
{{main|HOW-TO:Install KodiBuntu from a USB drive}}<br />
Kodibuntu comes in an ISO form that can be written to a USB drive or burned to an optical disc.<br />
<br />
Download the current stable Kodibuntu image from: '''<code>http://kodi.tv/download/</code>'''<br />
<br />
{{note|<br />
* Kodibuntu has only one iso image file for all x86 computers, regardless of GPU.<br />
* Currently, only a '''64-bit''' version is available, but this should cover the vast majority of users.<br />
* A pre release 32bit exists in mirrors with unstable ppa and RC candidate Kodi, which can be upgraded to stable kodi<br />
* There will be no seperate Kodibuntu release for Kodi 15.x as it's based on the same OS. To get Kodi 15.x on Kodibuntu, just upgrade the software as suggested below}}<br />
<br />
== Upgrading Kodi Media Center ==<br />
{{main|HOW-TO:Install Kodi for Linux#Upgrading}}<br />
{{#lst:HOW-TO:Install Kodi for Linux|Ubuntu upgrade}}<br />
<br />
=== Upgrading the OS ===<br />
<br />
Current Kodibuntu is based on a LTS release (long term release) which is supported for 5 years, this means that it won't require to upgrade the OS base in order to obtain updated or upgrade application packages.<br />
<br />
See [https://wiki.ubuntu.com/Releases Current Ubuntu releases] if your current distro is listed under End of life table, you will need to upgrade your OS to a supported release.<br />
<br />
However should you need to upgrade the OS base a quick how-to follows.<br />
<br />
{{#lst:Kodibuntu FAQ|upgradeOS}}<br />
<br />
== Basic use ==<br />
<br />
=== Desktop mode ===<br />
<br />
Kodibuntu can boot directly into Kodi or it can also boot into a desktop mode for using applications such as a web browser.<br />
<br />
In order to enter desktop mode, follow those steps below:<br />
<gallery widths=500px heights=313px><br />
File:kodi-exit.png|'''Step 1:''' ''Exit'' Kodi.<br />
File:kodi-session.png|'''Step 2:''' Select ''Lubuntu'' and enter your ''username'' and ''password''.<br />
</gallery><br />
<br />
The username may differ from the one you supplied during installation. So please be aware, that "xbmc" (as shown in the screenshot) might not be the username you will see and/or have to use. <br />
<br />
{{note|If you last booted directly or switched to desktop and shutdown the HTPC while in desktop, on next reboot you will get the last used session by default.}} <br />
<br />
To return to Kodi, '''logout''', select '''Kodi''' as session in the top-right pulldown menu and enter your ''username'' and ''password'' again.<br />
<br />
=== Login ===<br />
To login to the command line interface press {{keypress|Ctrl|Alt|F1 - F6 }} or connect over [[SSH]] by using usernamne and password supplied during installation.<br />
<br />
{{note|For the use of {{keypress|Ctrl|Alt|F1 - F6 }} no username and password is required. You are logged in directly to the command line.}} <br />
<br />
<br />
=== Media center ===<br />
Kodibuntu contains [[Linux|Kodi for Linux]] compiled with the 'standalone' mode, this enabled certain functions that are not available in normal Kodi installations (Windows, Mac Linux), these functions include Power Management, and Network Management.<br />
<br />
=== Using desktop mode ===<br />
Chromium is included for web browsing and can be found in the start menu.<br />
<br />
In Systems / Package Manager tools - you can install other applications for your specific needs.<br />
<br />
==Other Uses==<br />
<br />
<br />
===KodiBuntu VNC Server===<br />
<br />
https://help.ubuntu.com/community/VNC/Servers<br />
<br />
*Install x11vnc <br />
*Set password<br />
**x11vnc -storepasswd<br />
*Test connection by running manual start command.<br />
x11vnc -auth guess -forever -loop -noxdamage -repeat -rfbauth /home/USERNAME/.vnc/passwd -rfbport 5900 -shared<br />
<br />
<br />
Have x11vnc start automatically via upstart in any environment (<=Utopic)<br />
sudo nano /etc/init/x11vnc.conf<br />
<br />
# description "Start x11vnc at boot"<br />
description "x11vnc"<br />
start on runlevel [2345]<br />
stop on runlevel [^2345]<br />
console log<br />
respawn<br />
respawn limit 20 5<br />
exec /usr/bin/x11vnc -auth guess -forever -loop -noxdamage -repeat -rfbauth /home/USERNAME/.vnc/passwd -rfbport 5900 -shared<br />
<br />
<br />
<br />
== KodiBuntu FAQ ==<br />
{{See|KodiBuntu FAQ}}<br />
<br />
== See also ==<br />
* [[Linux]]<br />
* [[HOW-TO:Install Kodi for Linux]]<br />
* [[JeOS implementations for Kodi]]<br />
* [[OpenELEC]]<br />
<br />
{{Helix updated}}<br />
<br />
[[Category:Installation]]<br />
[[Category:Linux]]<br />
[[Category:Kodibuntu|*]]<br />
[[Category:Manual]]</div>UNiversalhttps://kodi.wiki/index.php?title=HOW-TO:Install_Kodi_for_Linux&diff=100327HOW-TO:Install Kodi for Linux2015-08-30T20:55:12Z<p>UNiversal: </p>
<hr />
<div>{{Kodi migration note}}<br />
<br />
<br />
= Official Team Kodi repositories =<br />
<br />
The installation instructions within this section reference repositories that are officially sanctioned by Team Kodi. For third party and unofficial build support, please see the section below.<br />
<br />
== Installing Kodi on Ubuntu-based distributions ==<br />
See [[SSH]] or [http://help.ubuntu.com/community/UsingTheTerminal Click here to find out how to use the terminal.]<br />
<br />
Use the command line terminal and enter the following commands. Follow the prompts as you would any other software installation.<br />
<br />
<syntaxhighlight lang="bash"><br />
sudo apt-get install software-properties-common<br />
sudo add-apt-repository ppa:team-xbmc/ppa<br />
sudo apt-get update<br />
sudo apt-get install kodi <br />
</syntaxhighlight><br />
<br />
{{#lst:Team XBMC PPA|repos}}<br />
<br />
=== Installing PVR Addons ===<br />
The Linux release of Kodi doesn't include any PVR addons by default. To install a PVR addon, run the following command and replace the XXXXXX with the PVR addon of your choice:<br />
<br />
<syntaxhighlight lang="bash"><br />
sudo apt-get install kodi-pvr-XXXXXXX<br />
</syntaxhighlight><br />
<br />
{| class="wikitable"<br />
|-<br />
! PVR Addon !! Description<br />
|-<br />
| kodi-pvr-dev || Kodi Media Center (PVR Add-on Dev package)<br />
|-<br />
| kodi-pvr-argustv || Kodi PVR Addon Argustv<br />
|-<br />
| kodi-pvr-demo || Kodi PVR Demo Addon<br />
|-<br />
| kodi-pvr-dvbviewer || Kodi PVR Addon Dvbviewer<br />
|-<br />
| kodi-pvr-iptvsimple || Kodi PVR Iptv Addon<br />
|-<br />
| kodi-pvr-mediaportal-tvserver || Kodi PVR Addon Mediaportal Tvserver<br />
|-<br />
| kodi-pvr-mythtv || Kodi PVR Addon MythTv - Cmyth<br />
|-<br />
| kodi-pvr-nextpvr || Kodi PVR Addon NextPvr<br />
|-<br />
| kodi-pvr-njoy || Kodi PVR Addon Njoy<br />
|-<br />
| kodi-pvr-hts || Kodi PVR Addon TvHeadend Hts<br />
|-<br />
| kodi-pvr-vdr-vnsi || Kodi PVR Addon VDR Vnsi<br />
|-<br />
| kodi-pvr-vuplus || Kodi PVR Addon Vuplus<br />
|}<br />
<br />
=== Installing a development build ===<br />
{{see also|Development builds}}<br />
To install a beta/unstable version of {{kodi}} you must first add the unstable repository, then install XBMC. Use <code>ppa:team-xbmc/xbmc-nightly</code> for nightly builds and <code>ppa:team-xbmc/unstable</code> for [[beta]] builds.<br />
<br />
<syntaxhighlight lang="bash"><br />
sudo add-apt-repository ppa:team-xbmc/xbmc-nightly<br />
sudo apt-get update<br />
sudo apt-get install kodi<br />
</syntaxhighlight><br />
<br />
<br />
=== Upgrading ===<br />
<section begin="Ubuntu upgrade" /><br />
To update Kodi when a new version is released, just do a general system/package or use the following commands in the terminal (or via [[SSH]]):<br />
<br />
<syntaxhighlight lang="bash"><br />
sudo apt-get update<br />
sudo apt-get upgrade<br />
</syntaxhighlight><br />
<br />
<br />
{{note|In some cases where additional packages are required, Kodi will fail to upgrade when using the upgrade commands as above. To install additional packages use the command below:<br />
<br />
<syntaxhighlight lang="bash"><br />
sudo apt-get dist-upgrade<br />
</syntaxhighlight>}}<br />
<section end="Ubuntu upgrade" /><br />
<br />
<br />
=== Downgrading to a stable version from a development version ===<br />
If you install a nightly build or an unstable release and want to return to a stable release, follow these instructions:<br />
<br />
Find the current PPA you are using:<br />
<syntaxhighlight lang="bash"><br />
sudo apt-cache policy | grep team-xbmc<br />
</syntaxhighlight><br />
<br />
Remove the unstable or nightly PPA where it says '''PPAHERE''':<br />
<syntaxhighlight lang="bash"><br />
sudo add-apt-repository -r ppa:PPAHERE<br />
</syntaxhighlight><br />
<br />
Then restore the stable version with the following commands:<br />
<syntaxhighlight lang="bash"><br />
sudo add-apt-repository ppa:team-xbmc/ppa<br />
sudo apt-get update<br />
sudo apt-get remove kodi<br />
sudo apt-get install kodi<br />
</syntaxhighlight><br />
<br />
=== Downgrading between stable versions ===<br />
{{incomplete}}<br />
<br />
=== Uninstalling ===<br />
If you need to remove and purge an application and finally removing/purging also the application configurations files, do so by using the following commands:<br />
<br />
<syntaxhighlight lang="bash" enclose="div"><br />
sudo apt-get update<br />
sudo apt-get remove kodi*<br />
sudo apt-get purge kodi*<br />
</syntaxhighlight><br />
<br />
Then remove the settings folder to remove all settings and library data. This will not delete any videos or music, but just the settings and library data itself:<br />
<syntaxhighlight lang="bash"><br />
rm ~/.kodi/ <br />
</syntaxhighlight><br />
or<br />
<syntaxhighlight lang="bash" enclose="div"><br />
rm ~/.xbmc/ # for older versions before 14.0<br />
</syntaxhighlight><br />
<br />
= Third Party Repositories =<br />
<!-- Please only list repos that use an internal ffmpeg library --><br />
<br />
The instructions in this section are for unofficial Linux binaries that are un/semi supported by Team Kodi. Most of those binaries use system ffmpeg or even worse totally untested libav, which is not recommended for {{kodi}} as we support ffmpeg only.<br />
<br />
== Debian ==<br />
<br />
The installation if you are using Debian, it's very simple You will need custom repos, availables on [http://people.debian.org/~rbalint/ppa/xbmc-ffmpeg/ custom repos here].<br />
<br />
Add the following lines to your /etc/apt/sources.list file, as superuser (sudo)<br />
<br />
<syntaxhighlight lang="bash"><br />
# XBMC repos<br />
deb https://people.debian.org/~rbalint/ppa/xbmc-ffmpeg xbmc-ffmpeg-unstable/<br />
deb http://http.debian.net/debian unstable main<br />
</syntaxhighlight><br />
<br />
And then, update APT and install Kodi.<br />
<br />
<syntaxhighlight lang="bash"><br />
sudo apt-get update<br />
sudo apt-get install kodi<br />
</syntaxhighlight><br />
<br />
Enjoy your new Kodi.<br />
<br />
== Fedora ==<br />
Refer to [[HOW-TO:Install Kodi on Fedora 21 using RPMFusion packages]] for a guide showing how to install Fedora 21 and Kodi to create a quick-booting, standalone style of media player.<br />
<br />
FedoraProject also has [http://fedoraproject.org/wiki/HTPC this page] discussing how to build a dedicated home theatre.<br />
<br />
== OpenELEC ==<br />
{{main|OpenELEC}}<br />
{{#lst:OpenELEC|intro}}<br />
<br />
== KodiBuntu ==<br />
The installation instructions on this page are intended for people who already have a Linux-based OS setup, or wish to do their own installation of Linux. Alternatively you can try out [[KodiBuntu]], which will install both an OS and {{kodi}} with an easy installer.<br />
<br />
{{main|KodiBuntu}}<br />
{{#lst:KodiBuntu|intro}}<br />
<br />
= Installation from source =<br />
If distribution packages are not available, or you need a newer version, or specific features enabled, then you will most likely need to compile from source. While compiling from source does not differ very much between distributions (except for installation of build dependencies), a few different guides are available in this wiki.<br />
<br />
* [[HOW-TO compile XBMC for Linux from source code]]<br />
* [[HOW-TO compile XBMC for Linux on Debian/Ubuntu]] - This is a tutorial on how to compile and install {{kodi}} on Debian and Ubuntu.<br />
<br />
= See also =<br />
* [[Linux]]<br />
* [[HOW-TO:Autostart XBMC for Linux]]<br />
*[[JeOS implementations for Kodi]]<br />
<!--{{mininav| [[Installing]] {{l2| [[Linux]] }} }}--><br />
* [[Linux FAQ]]<br />
<br />
{{Helix updated}}<br />
<br />
[[Category:Linux]]<br />
[[Category:How-to]]<br />
[[Category:Installation|Linux]]<br />
[[Category:Manual]]</div>UNiversalhttps://kodi.wiki/index.php?title=Path_substitution&diff=99938Path substitution2015-08-19T21:01:59Z<p>UNiversal: bigger yet maybe the fools will read it now.</p>
<hr />
<div>{{mininav| [[advancedsettings.xml]] }}<br />
<br />
<section begin="intro" />[[Path substitution]]s are settings in [[advancedsettings.xml#<pathsubstitution>|advancedsettings.xml]] to force Kodi to use different file paths. These are processed in order, and are useful for substituting an absolute path on a PC with a path suitable for Kodi to handle. Path subs work for most file and folder paths. Path subs work across local and network paths, across different network protocols, and can even be used with some of the [[special protocol]].<section end="intro" /><br />
<br />
== Special notes about path substitution for userdata files ==<br />
<big>{{divbox|orange||<big>'''Note:''' This is considered an advanced (complicated) and experimental feature.</big><br /><br />Path substitution is not officially supported for settings files with the exception of playlists. It probably won't hurt anything, but some things might not always work right depending on what you are substituting.<br /><br /><br />
;<big>Thumbnails</big><br />
Sharing the Thumbnails folder with Path Substitution is prone to problems, primarily because the Texture Cache consists of two interlinked data stores - the Thumbnails folder and the SQLite database Textures13.db. Sharing the SQLite Textures13.db between multiple clients is <strong>not</strong> supported under any circumstances due to the liklehood of database corruption.<br /><br /><br />
Since sharing of the database is not realistically possible, attempts at sharing only the Thumbnails folder will either fail completely, or result in some artwork items never being displayed, or you may experience artwork being displayed but with higher or lower than expected image quality or even image corruption (a result of different clients overwriting previously cached artwork, as not all clients cache artwork at the same resolutions, or even use the same image formats).<br/><br/><br />
If you must use Path Substitution to relocate (rather than share) your Thumbnails folder, by all means do so but only for individual clients and their associated Thumbnails folder. Do <strong>not</strong> share a single Thumbnails folder between multiple clients, as the Texture Cache is simply not designed to support this and you will experience problems.}}</big><br />
<br />
== Examples ==<br />
Save as "advancedsettings.xml" in your [[userdata folder]]:<br />
<br />
;Example 1 - changing the path of music files<br />
<syntaxhighlight lang="XML" enclose="div"><br />
<advancedsettings><br />
<pathsubstitution><br />
<substitute><br />
<from>SMB://192.168.1.19/Music/</from><br />
<to>G:\Music\</to><br />
</substitute><br />
</pathsubstitution><br />
</advancedsettings><br />
</syntaxhighlight ><br />
<br />
<br />
;Example 2 - changing where thumbnails are stored<br />
{{note|This will slowdown thumbnail loading, but might be worth it for low-memory devices. See also '''[[HOW-TO:Reduce disk space usage]]'''.}}<br />
<syntaxhighlight lang="XML" enclose="div"><br />
<advancedsettings><br />
<pathsubstitution><br />
<substitute><br />
<from>special://profile/Thumbnails/</from><br />
<to>PROTOCOL://YOUR_NETWORK_SHARE/Kodi/userdata/Thumbnails/</to><br />
</substitute><br />
</pathsubstitution><br />
</advancedsettings><br />
</syntaxhighlight ><br />
<br />
<br />
{{Note|Not all special paths can be substituted. In particular, special://musicplaylists/ and special://videoplaylists/ should not be substituted, as internally these are multipaths that cannot be written to (thus saving of playlists will go elsewhere). Instead, one should use the advanced setting <system><playlistpath> to change this.}}<br />
<br />
== See also ==<br />
* [[advancedsettings.xml#<pathsubstitution>]]<br />
* [[MySQL/Sync other parts of Kodi]]<br />
* [[Special protocol]]<br />
<br />
<br />
{{Isengard updated}}<br />
<br />
[[Category:Settings]]<br />
[[Category:Manual]]<br />
[[Category:Advanced topics]]</div>UNiversalhttps://kodi.wiki/index.php?title=TexturePacker&diff=99876TexturePacker2015-08-15T14:09:55Z<p>UNiversal: texturepacker 1.0.3</p>
<hr />
<div>{{mininav|[[Development]]|[[Add-on development]]|[[Skinning]]}}<br />
<section begin="intro" />Kodi uses a tool named TexturePacker to compile all images used in a skin into a single file. The benefit of it is that images inside the Textures.xbt will load faster in the skin. This is done by converting all images into a format that take less processing by Kodi when they need to be rendered onto the screen.<br />
<br />
A common misconception is that TexturPacker will just compress the images into a single file, this if far from the truth, so don't be surprised if the Textures.xbt file is much larger than to total size of all the individual images.<br />
<section end="intro" /><br />
== How To Get It ==<br />
If you are using Windows, you can simply download a zipfile with an up-to-date version of TexturePacker from the Kodi mirrors.<br />
<br /><big>'''It is available here:''' [http://mirrors.kodi.tv/build-deps//win32/texturepacker-1.0.3-win32.7z '''Download TexturePacker 1.0.3''']</big><br />
{{note| This is a dll free self contained texturepacker executable for windows.}}<br />
<br />
On other platforms, you will have to compile TexturePacker yourself. This is done by compiling Kodi and when the compile is finished, you can find TexturePacker inside the ../tools/depends/native/TexturePacker directory.<br />
<br />
== Usage ==<br />
Since TexturePacker is a command-line tool, you will need to open a dos box/terminal/console in order to run it. The general usage is:<br />
<pre>TexturePacker -input skin.name\media -output skin.name\media\Textures.xbt</pre><br />
<br />
Optionally, you can run TexturePacker with the ''-dupecheck'' option. This is useful if you have included the same image multiple times in your media folder. For example, if your skin includes a lot of studio logos, most likely a lot of them are included multiple times but with a slightly different filename. The '-dupecheck' option will make sure each unique image is included only once in the Textures.xbt file and thus keeping the size of it as small as possible.<br />
<br />
If your skins includes [[Skin_development_introduction#Skin_Themes]] you should also run TexturePacker on your theme folders:<br />
<pre>TexturePacker -input skin.name\themes\Blue -output skin.name\media\Blue.xbt</pre><br />
<br />
{{Note| When using an XBT file in your skin, your file paths will '''not''' be case sensitive, even if your skin resides on a case sensitive file system!}}<br />
<br />
=== Texturepacker build bat ===<br />
Create a Texturepacker.bat with the contents below, inside the skin.name directory along with all the texturepacker.exe, a double click on the bat file does all the work for you.<br />
<pre><br />
@ECHO OFF<br />
<br />
COLOR A<br />
<br />
ECHO -------------------------------------------------------------------------<br />
ECHO ^> ** Creating excludes... **<br />
<br />
ECHO .svn>exclude.txt<br />
ECHO .git>>exclude.txt<br />
ECHO Thumbs.db>>exclude.txt<br />
ECHO Desktop.ini>>exclude.txt<br />
ECHO dsstdfx.bin>>exclude.txt<br />
ECHO build.bat>>exclude.txt<br />
ECHO \skin.confluence\media\>>exclude.txt<br />
ECHO \skin.confluence\backgrounds\>>exclude.txt<br />
ECHO exclude.txt>>exclude.txt<br />
<br />
ECHO -------------------------------------------------------------------------<br />
ECHO.<br />
<br />
ECHO -------------------------------------------------------------------------<br />
ECHO ** Creating Textures XBT File... **<br />
ECHO -------------------------------------------------------------------------<br />
<br />
ECHO.<br />
PING -n 2 -w 1000 127.0.0.1 > NUL<br />
START /B /WAIT TexturePacker -dupecheck -input media\ -output media\Texture.xbt<br />
PING -n 2 -w 20000 127.0.0.1 > NUL<br />
ECHO.<br />
ECHO.<br />
ECHO -------------------------------------------------------------------------<br />
ECHO ^> Deleting excludes...<br />
DEL exclude.txt<br />
ECHO ^> Done<br />
ECHO -------------------------------------------------------------------------<br />
ECHO.<br />
ECHO.<br />
<br />
ECHO -------------------------------------------------------------------------<br />
ECHO ** XBT build complete - scroll up to check for errors. **<br />
ECHO -------------------------------------------------------------------------<br />
<br />
PING -n 50 -w 5000 127.0.0.1 > NUL<br />
</pre><br />
<br />
[[Category:Add-on development]]<br />
[[Category:Skin development]]<br />
[[Category:Development]]</div>UNiversalhttps://kodi.wiki/index.php?title=Archive:Codecinfo&diff=99121Archive:Codecinfo2015-07-27T08:37:59Z<p>UNiversal: fps is gone from windowing in v15</p>
<hr />
<div>{{mininav|[[Video library]]|[[Video playback|Playback]]}}<br />
<section begin="intro" />Whilst Kodi is playing media on screen you can activate the '''codecinfo''' overlay {{keypress|o}} key on a keyboard. This normally appears as white text on a black background bar located near the top of the screen (dependent on the skin being used). The codecinfo overlay displays a number of real time variables describing detailed information on the codecs currently in use.<section end="intro" /><br />
<br />
{{note|The codecinfo screen is not entirely accurate for some of the reported data, due to the fact that the codecinfo screen itself will reduce performance on low powered devices (i.e., Raspberry Pi, some Android/ARM boxes). }}<br />
<br />
{{-}}<br />
== Current stable builds ==<br />
[[File:Helix codecinfo.png|700px|Helix|right]]<br />
;Video codecinfo window as seen in stable Kodi v14.x and newer builds.<br />
<br />
Information is split into 6 lines of text:<br />
* Audio information - '''D'''emuxer<br />
* Audio information - '''P'''layer<br />
* Video information - '''D'''emuxer<br />
* Video information - '''P'''layer<br />
* General playback information '''C'''<br />
* '''W'''indowing and System CPU information<br />
{{-}}<br />
<br />
=== Breakdown ===<br />
Samples from the screen(s) above:<br />
{| class="prettytable"<br />
! Audio information <br />
! Breakdown<br />
|-<br />
| aac || Audio codec<br />
|-<br />
| mp4a / 0x6134706D || Codec ID - Format profile <ref>http://matroska.org/technical/specs/index.html#CodecID</ref><br />
|-<br />
| 48000 Hz || Sampling rate<br />
|-<br />
| 5.1 || Audio channels<br />
|-<br />
| s16 || Sample size (s16 = signed 16-bit value)<br />
|-<br />
| fltp || float, planar <br />
|-<br />
| 437 kb/s || Average audio bitrate (reported by demuxer)<br />
|-<br />
| aq:99% || Audio queue saturation<br />
|-<br />
| Kb/s:437.41 || Current audio bitrate (reported by player)<br />
|-<br />
| att:0.0db || Attenuation / gain added by player<br />
|-<br />
! style="background: #DBDBDB;" | '''Video information''' <br />
! style="background: #DBDBDB;" | '''Breakdown'''<br />
|-<br />
| h264 (Main) (avc1 / 0x31637661) || Video codec<br />
|-<br />
| yuv420p || Color space / Chroma subsampling<br />
|-<br />
| 1920x1080 || Resolution<br />
|-<br />
| SAR 1:1 DAR 16x9 || '''S'''ource '''A'''spect '''R'''atio - '''D'''isplay '''A'''spect '''R'''atio<br />
|-<br />
| 9282 kb/s || Average audio bitrate (reported by demuxer)<br />
|-<br />
| fr:24.000 || Source framerate<br />
|-<br />
| vq:88% || Video queue saturation<br />
|-<br />
| dc:ff-h264-dxva2 || Video library performing decode<br />
|-<br />
| Mb/s:7.79 || Current video bitrate (reported by player)<br />
|-<br />
| drop:12 || Number of dropped frames<br />
|-<br />
| skip:13 || Number of skipped frames<br />
|-<br />
| pc:1 || Pullup correction pattern length<br />
|-<br />
! style="background: #DBDBDB;" | '''General playback information''' <br />
! style="background: #DBDBDB;" | '''Breakdown'''<br />
|-<br />
| ad:0.000 || Audio delay (configured)<br />
|-<br />
| a/v:0.030 || Audio/video sync difference (real time)<br />
|-<br />
| edl:- || [[Edit decision list]]<br />
|-<br />
| dcpu: 0% || Relative CPU Usage of the player thread<br />
|-<br />
| acpu: 0% || Relative CPU usage of the audio decode thread<br />
|-<br />
| vcpu: 0% || Relative CPU Usage of the video decode thread<br />
|-<br />
| cache:0 B 100% || Size of cached data and % of cache utilized<br />
|-<br />
! style="background: #DBDBDB;" | '''Windowing information'''<br />
! style="background: #DBDBDB;" | '''Breakdown'''<br />
|-<br />
| CPU 4 core(s) || System processor information (this display is OS-dependent)<br />
|-<br />
| average: 4.7% || Average CPU load across all cores<br />
|-<br />
! style="background: #DBDBDB;" | '''Sync to screen information'''<br />
! style="background: #DBDBDB;" | '''Breakdown'''<br />
|-<br />
| refresh || Actual refresh-rate being displayed<br />
|-<br />
| missed || Number of missed frames<br />
|-<br />
| speed || Audio speed correction to sync<br />
|-<br />
| sync || Video speed to enable sync<br />
|-<br />
| avg || Avg amount of correction<br />
|-<br />
| error || Percentage of errors syncing<br />
|}<br />
<br />
== References ==<br />
<references/><br />
<br />
== Further information/discussion ==<br />
* See the [[forum:70743|Video Diagnostic Screen]] forum topic for discussion and more information.<br />
<br />
{{isengard updated}}<br />
<br />
[[Category:Manual]]<br />
[[Category:Troubleshooting]]<br />
[[Category:Video library]]</div>UNiversalhttps://kodi.wiki/index.php?title=Advancedsettings.xml&diff=98775Advancedsettings.xml2015-07-25T10:30:04Z<p>UNiversal: /* seeksteps */ future nonsense - future is now</p>
<hr />
<div>{{TOC right}}{{mininav|[[Settings]]|page=advancedsettings.xml}}<br />
{{bigger|{{note|'''The advancedsettings.xml file does not exist by default. You have to create it first!'''}} }}<br />
<br />
<section begin="intro" />The [[advancedsettings.xml]] file, which does not exist by default, can be created by a user in their '''[[userdata folder]]'''.<br />
<br />
This file is used for advanced settings and options that do not have GUI controls inside of {{kodi}}. Some settings are experimental or very rarely set, so they can only be used via the advancedsettings.xml file. The file is simply a plain text file and can be edited by various text editors, so long as the name is "advancedsettings.xml". These advanced settings can be used to tweak various things such as episode naming patterns, special network ports, special behaviors, and more.<section end="intro" /><br />
<br />
The following page will describe the structure of the advancedsettings.xml file and the various individual settings.<br />
<br />
{{note|<br />
# All XML tags must be lowercase. The start and end of the advancedsettings.xml file must have the <advancedsettings> and </advancedsettings> tags.<br />
# Kodi will only read the advancedsettings.xml file when it starts up. If you make changes while it is running then you must restart Kodi.<br />
# For some Windows versions, Kodi has two <code>\userdata\</code> folders. The correct one to put the advancedsettings.xml file in is not the one in Program Files, but in <code>%appdata%\Kodi\userdata\.</code>}}<br />
<br />
== Layout ==<br />
<br />
The layout of <code>advancedsettings.xml</code> is as follows:<br />
<br />
<syntaxhighlight lang="xml" enclose="div"><br />
<advancedsettings><br />
<setting>value</setting><br />
...<br />
<setting>value</setting><br />
</advancedsettings><br />
</syntaxhighlight><br />
<br />
where "setting" gives the name of the setting, and "value" gives it's value.<br />
<br />
A list of the available "setting" strings and their values is given below.<br />
<br />
= List of available settings =<br />
<br />
== Troubleshooting settings ==<br />
<br />
=== loglevel ===<br />
{{Anchor|.3Cloglevel.3E}}<br />
{{see also|debug log}}<br />
<section begin="loglevel" /><br />
{{xml setting<br />
| tag name = loglevel<br />
| tag attribute = hide<br />
| tag attribute values = <br />
{{option values<br />
| value1= true | value1 description= Hides "enable debugging" guisetting.<br />
| value2= false | value2 description= "enable debugging" guisetting will switch between min(loglevel, 0) and max(loglevel, 2) for off and on respectively. '''(Default)'''<br />
}}<br />
| tag attribute default values = true<br />
| option values = <br />
{{option values<br />
| value1= -1 | value1 description= No logging, suppresses all log output<br />
| value2= 0 | value2 description= Normal logging, only logging errors '''(Default)'''<br />
| value3= 1 | value3 description= Debug logging ''(without showing text on screen)''<br />
| value4= 2 | value4 description= Debug logging with freemem, fps and cpu usage shown on screen<br />
| value5= 3 | value5 description= Debug logging with freemem, fps and cpu usage and full smb logging<br />
}}<br />
| default values = 0<br />
| description = <br />
The logging level that Kodi will use to log errors and information. The "hide" attribute is optional.<br />
| example =<br />
Example:<br />
<syntaxhighlight lang="xml" enclose="div"><br />
<loglevel hide="false">1</loglevel><br />
</syntaxhighlight><br />
<br />
<br /><br />
<br />
{{Note| If debugging is switched on in the GUI, loglevel will be set to 2 (''log to both file and on-screen information''); this will over-ride any <code>advancedsettings.xml</code> setting.}}<br /><br />
<br />
{{Note| If debugging is switched on in the GUI when Kodi is shut down, then it will be automatically be re-enabled at level 2 when it is re-started. This is true even if 'hide' is subsequently set to 'true' - in other words, if you enable it in the GUI and then hide the GUI toggle, it will stay on level 2 irrespective of what you subsequently set in <code>advancedsettings.xml</code>.}}<br /><br />
}}<br />
<section end="loglevel" /><br />
<br />
=== jsonrpc ===<br />
{{Anchor|.3Cjsonrpc.3E}}<br />
To make it easier for developers using the [[JSON RPC]] API in their (third party) applications to debug during development the json output of Kodi can be prettified by setting '''compactoutput''' to '''false'''. Default json output mode is a compact print which does not contain any unnecessary whitespaces and therefore is difficult to read for humans.<br />
Furthermore using the '''tcpport''' setting it is possible to change the default TCP port used by Kodi for JSON RPC (which is 9090) to any other valid port.<br />
<br />
Example:<br />
<syntaxhighlight lang="xml" enclose="div"><br />
<jsonrpc><br />
<compactoutput>false</compactoutput><br />
<tcpport>9999</tcpport><br />
</jsonrpc><br />
</syntaxhighlight><br />
<br />
=== other - enableairtunesdebuglog ===<br />
{{see|#enableairtunesdebuglog}}<br />
<br />
== Audio/video playback settings ==<br />
<br />
=== skiploopfilter ===<br />
{{anchor|.3Cskiploopfilter.3E}}<br />
The amount of the loop filter to skip on h264 decoding. This can help the performance of slower machines when decoding h264 content. Values, in decreasing CPU usage (and decreasing quality)<br />
* -16 None<br />
* 0 Skip only empty frames (default)<br />
* 8 Skip non-reference frames (default on ATV)<br />
* 16 Skip bi-dir frames<br />
* 32 Skip all non-key frames<br />
* 48 Skip all frames<br />
Example:<br />
<syntaxhighlight lang="xml" enclose="div"><br />
<skiploopfilter>8</skiploopfilter><br />
</syntaxhighlight><br />
<br />
=== video ===<br />
{{anchor|.3Cvideo.3E}}<br />
{{see also|HOW-TO:Modify automatic watch and resume points|HOW-TO:Modify time seeking}}<br />
<syntaxhighlight lang="xml" enclose="div"><br />
<video><br />
<subsdelayrange>10</subsdelayrange> <!-- Delay range for subtitles, in seconds. --><br />
<audiodelayrange>10</audiodelayrange> <!-- Delay range for audio/video sync, in seconds. --><br />
<br />
<smallstepbackseconds>7</smallstepbackseconds> <!-- Length of the small skip back when playing a video --> <!-- Will be replaced by a GUI option in v15 --><br />
<usetimeseeking>true</usetimeseeking> <!-- Whether to use time based or percentage based seeking. --><br />
<timeseekforward>30</timeseekforward> <!-- Time to seek forward in seconds when doing a short seek. Defaults to 30. --> <!-- Deprecated. Will be replaced by a GUI option in v15. Note: Need to double check if it will actually be removed? --><br />
<timeseekbackward>-30</timeseekbackward> <!-- Time to seek backward in seconds when doing a short seek. Defaults to -30. --> <!-- Deprecated. Will be replaced by a GUI option in v15. Note: Need to double check if it will actually be removed? --><br />
<timeseekforwardbig>600</timeseekforwardbig> <!-- Time to seek forward in seconds when doing a long seek. Defaults to 600 (10 minutes). --><br />
<timeseekbackwardbig>-600</timeseekbackwardbig> <!-- Time to seek forward in seconds when doing a long seek. Defaults to -600 (10 minutes). --><br />
<percentseekforward>2</percentseekforward> <!-- Amount to seek forward as a percentage, when doing a short seek. Defaults to 2. --><br />
<percentseekbackward>-2</percentseekbackward> <!-- Amount to seek backward as a percentage, when doing a short seek. Defaults to -2. --><br />
<percentseekforwardbig>10</percentseekforwardbig> <!-- Amount to seek forward as a percentage, when doing a long seek. Defaults to 10. --><br />
<percentseekbackwardbig>-10</percentseekbackwardbig> <!-- Amount to seek forward as a percentage, when doing a long seek. Defaults to -10. --><br />
<br />
<blackbarcolour>1</blackbarcolour> <!-- colour of the black bars (0->255), (black->white) on videos. --><br />
<br />
<fullscreenonmoviestart>true</fullscreenonmoviestart> <!-- Whether to go to fullscreen or not when starting a movie. Defaults to true. --><br />
<br />
<defaultplayer>dvdplayer</defaultplayer> <!-- Set the default video player: dvdplayer or extplayer. --><br />
<br />
<excludefromscan> <!-- Regular expressions that if evaluated to true won't be added to library. --><br />
<regexp>[-\._ ](sample|trailer)[-\._ ]</regexp><br />
</excludefromscan><br />
<excludefromlisting> <!-- Regular expressions that if evaluated to true won't be displayed in Files View --><br />
<regexp>[-\._ ](sample|trailer)[-\._ ]</regexp><br />
</excludefromlisting><br />
<br />
<playcountminimumpercent>90</playcountminimumpercent> <!--Minimum percentage that has to be played before it is marked as watched. Set to 101 to never auto-mark items as watched --><br />
<ignoresecondsatstart>180</ignoresecondsatstart> <!-- Number of seconds to ignore at video start after which a resume point is created --><br />
<ignorepercentatend>8</ignorepercentatend> <!-- percentage of video to ignore at the end. If you stop watching the video here no resume point is created. Set to 101 to never save a resume point. The video is already marked as watched at 90%, see above. --><br />
<br />
<forcevaapienabled>true</forcevaapienabled> <!-- VAAPI is only tested on intel hardware. This flag helps wrapper developers and fglrx users to easily test current VAAPI state on their hardware. Default is false. Please report crashes directly to your driver vendor --><br />
<br />
<vdpauscaling>true</vdpauscaling> <!-- scales with vdpau instead of opengl and turns on its HQ scaler when available, enabling this might slow down rendering and cause framedrops especially on ION systems, this setting requires a vdpau feature set C gpu--><br />
<br />
<enablehighqualityhwscalers>true</enablehighqualityhwscalers> <!-- allow turning on the spline36 and lanczos3 shader (for GL builds) --><br />
<br />
<dxvaallowhqscaling>false</dxvaallowhqscaling> <!-- enables high quality video upscaling for Windows --><br />
<br />
<ppffmpegdeinterlacing>linblenddeint</ppffmpegdeinterlacing> <!-- override the deinterlacing options passed to libpostproc --><br />
<br />
<ppffmpegpostprocessing>ha:128:7,va,dr</ppffmpegpostprocessing> <!-- override the post processing options passed to libpostproc when 'Video post-processing' is activated in GUI Videos-Settings-Playback --><br />
<autoscalemaxfps>30</autoscalemaxfps> <!-- when scaling method is set to auto, bilinear is chosen when the fps is higher than this limit, the default is 30 --><br />
<br />
<br />
<!-- Settings for when "Adjust refreshrate to match video fps" is enabled, available since r33806. --><br />
<adjustrefreshrate> <br />
<br />
<!-- "Adjust refreshrate to match video fps" will try to select the best refreshrate for the video fps but it doesn't always get it right, for example it might switch to an unsupported refreshrate. You can add overrides here to switch to a certain refreshrate based on video fps. It's possible to add as many overrides as you need. Overrides are processed in order, if the first one doesn't match the fps or no refreshrates match that override, it will try the next one until no overrides are left --><br />
<br />
<override><br />
<fps>23.976</fps> <!-- if the fps is between 23.966 and 23.986 --><br />
<refresh>60.0</refresh> <!-- switch to the first found refreshrate that is between 59.99 and 60.01 --><br />
</override><br />
<br />
<override><br />
<fpsmin>29.96</fpsmin> <!-- You can also specify the fps range yourself --><br />
<fpsmax>30.01</fpsmax><br />
<refreshmin>59.0</refreshmin> <!-- Same for the refreshrate --><br />
<refreshmax>61.0</refreshmax><br />
</override><br />
<br />
<!-- It none of the overrides match, or none of the refreshrates match any of the fps matching overrides, it will choose a fallback refreshrate. Fallbacks are process in order, if the first fallback doesn't match any refreshrate, it will try the next one until no fallbacks are left --><br />
<fallback><br />
<refresh>50.0</refresh> <!-- switch to the first found refreshrate that is between 49.99 and 50.01. --><br />
</fallback><br />
<br />
<!-- You can also specify the range for the fallback yourself --><br />
<fallback><br />
<refreshmin>49.0</refreshmin><br />
<refreshmax>51.0</refreshmax><br />
</fallback><br />
<br />
<!-- If none of the overrides match the video fps, or no refreshrates match any of the fps matching overrides, and no fallbacks are specified or no refreshrates match any fallbacks, it will automatically choose the best refreshrate (same as having no overrides and fallbacks). --><br />
</adjustrefreshrate><br />
<br />
<checkdxvacompatibility>value</checkdxvacompatibility> <!-- Advanced setting not present: let Kodi autodetect cards that support H264 profile > L4.1. Set value to false to enable DXVA no matter what. Set value to true if Kodi doesn't autodetect that the graphics card doesn't support > L4.1 --><br />
<br />
<useocclusionquery>-1</useocclusionquery> <!--Use an occlusion query when capturing videoframes, -1 means auto detect, 0 means disabled, 1 means enabled, the default is -1.--><br />
<fpsdetect>1</fpsdetect> <!-- fps detection for video playback, 0 = trust codec fps, 1 = recalculate from video timestamps with uniform spacing, 2 = recalculate from video timestamps always --><br />
<br />
<br />
<latency> <!-- Compensate display latency (video lag). Latency is given in msecs. --><br />
<br />
<delay>0</delay> <!-- Global default display latency --><br />
<br />
<!-- Override latency for given display (not video) refresh rates. When Kodi is in windowed mode, override is ignored. Multiple overrides are allowed.<br />
<br />
Syntax of an override entry:<br />
<refresh><br />
<min>, <max> refresh rate range, OR<br />
<rate> exact refresh rate<br />
<delay> display latency for the given refresh rate<br />
</refresh><br />
--><br />
<br />
<!-- Example: display has 125 msec latency at 23-24 Hz --><br />
<refresh><br />
<min>23</min><br />
<max>24</max><br />
<delay>125</delay><br />
</refresh><br />
<br />
<!-- Example: display has 50 msec latency at 50 (+/-0.01) Hz --><br />
<refresh><br />
<rate>50</rate><br />
<delay>50</delay><br />
</refresh><br />
<br />
</latency><br />
<br />
<stereoscopicregex3d>[-. _]3d[-. _]</stereoscopicregex3d> <!-- Filename triggers for 3D (stereoscopic) mode. --><br />
<stereoscopicregexsbs>[-. _]h?sbs[-. _]</stereoscopicregexsbs><br />
<stereoscopicregextab>[-. _]h?tab[-. _]</stereoscopicregextab><br />
<br />
<stagefright> <!-- Previously this page also listed <mediacodec> tags as well as stagefright tags, but this was in error. There are only stagefright options for official Kodi builds. SPMC has mediacodec options for codec tweaking, though. -1 is default, 0 is never used this codec, 1 is always use this codec, bypassing blacklist --><br />
<useavccodec>-1</useavccodec><br />
<usehevccodec>-1</usehevccodec> <!-- Added in v15 --><br />
<usevc1codec>-1</usevc1codec><br />
<usevpxcodec>-1</usevpxcodec><br />
<usemp4codec>-1</usemp4codec><br />
<usempeg2codec>-1</usempeg2codec><br />
<useswrenderer>false</useswrenderer><br />
</stagefright><br />
<br />
<disableswmultithreading>false</disableswmultithreading> <!-- Replaces disablehi10pmultithreading. Set this to true if you want software decoding to use only one CPU thread. --><br />
<br />
<useffmpegvda>false</useffmpegvda> <!-- Experimental hardware video decoding mode for OS X. Option is available for development/testing purposes. --><br />
<br />
</syntaxhighlight><br />
{{isengard box|1=<br />
<syntaxhighlight lang="xml" enclose="div"><br />
<assfixedworks>false</assfixedworks> <!-- position behavior of ass subtitiles when setting "subtitle position on screen" set to "fixed". True to show at the fixed position set in video calibration. False to show at the bottom of video (default). --><br />
</syntaxhighlight><br />
}}<br />
<syntaxhighlight lang="xml" enclose="div"><br />
<br />
</video><br />
</syntaxhighlight><br />
<br />
=== audio ===<br />
{{anchor|.3Caudio.3E}}<br />
<syntaxhighlight lang="xml" enclose="div"><br />
<audio><br />
<!-- Amount of headroom Kodi should use above the maximum volume level, in decibels. Defaults to 0, valid values 0, 6, 12. --><br />
<headroom>0</headroom><br />
<!-- Default audio player: paplayer or dvdplayer --><br />
<defaultplayer>paplayer</defaultplayer><br />
<!-- Regular expressions that if evaluated to true won't be added to library. --><br />
<excludefromscan> <br />
<regexp>[-\._ ](podcast)[-\._ ]</regexp><br />
</excludefromscan><br />
<!-- Regular expressions that if evaluated to true won't be displayed in Files View --><br />
<excludefromlisting> <br />
<regexp>[-\._ ](podcast)[-\._ ]</regexp><br />
</excludefromlisting><br />
<!-- Amount of gain (dB) to be applied to AC3 streams that have been mixed-down to 2 channels. Default is 12.0. Valid values are: -96.0 to 96.0. --><br />
<ac3downmixgain>12.0</ac3downmixgain><br />
<!-- Minimum percentage that has to be played before it is considered for incrementing in the Top 100 database view, or for last.fm submittal --><br />
<playcountminimumpercent>99</playcountminimumpercent> <br />
<!-- Whether to use Dynamic Range Compression (DRC) on AC3 streams. 1.0 is "full" compression, as defined by the audio track's metadata, which is recommended for "basic" sound systems such as the internal speakers on a TV. 0.0 is no compression at all, which is recommended for people with nice multi-speaker sound systems. -1.0 (default) defaults to whatever ffmpeg uses, which is currently the same as 1.0. This has no effect if passthrough is enabled for AC3. --><br />
<applydrc>-1.0</applydrc> <br />
<!-- set to true to skip decoding of DTS in wav files when using dvdplayer (10.10 only) --><br />
<dvdplayerignoredtsinwav>false</dvdplayerignoredtsinwav> <br />
<!-- default values for limiter/compressor --><br />
<limiterhold>0.025</limiterhold> <br />
<!-- default values for limiter/compressor --><br />
<limiterrelease>0.1</limiterrelease> <br />
</audio><br />
</syntaxhighlight><br />
<br />
For more information on the configuration of audio under Frodo see [[AudioEngine/HOW-TO: Configure audio]]<br />
<br />
=== measurerefreshrate ===<br />
{{anchor|.3Cmeasurerefreshrate.3E}}<br />
When using "Sync playback to display" on Windows, the detected refreshrate might be wrong.<br />
When enabling measurerefreshrate, the refreshrate is measured instead, which makes it more accurate.<br />
<br />
<syntaxhighlight lang="xml" enclose="div"><br />
<measurerefreshrate>true</measurerefreshrate><br />
</syntaxhighlight><br />
<br />
=== edl ===<br />
{{anchor|.3Cedl.3E}}<br />
{{main|EDL}}<br />
Commercial break detection not as good you think it could be? Are some commercial breaks in a series of adverts not being skipped? Are some parts being skipped that are clearly not commercials? Does the end of the previous recording still show? The following advanced settings can be used to better identify full commercial break sequences, remove incorrectly flagged commercial breaks, and have playback start at the actual beginning of the recording.<br />
<br />
<syntaxhighlight lang="xml" enclose="div"><br />
<edl><br />
<!-- if true, commercial breaks will be merged according to the remaining options. --><br />
<mergeshortcommbreaks>false</mergeshortcommbreaks><br />
<!-- Commercial breaks won't be merged if the total length of the commercial break would be greater than this (seconds) --><br />
<maxcommbreaklength>250</maxcommbreaklength><br />
<!-- After merging, commercial breaks shorter than this will be removed (seconds) --><br />
<mincommbreaklength>90</mincommbreaklength><br />
<!-- Commercial breaks that are further apart than this won't be merged (seconds) --><br />
<maxcommbreakgap>120</maxcommbreakgap><br />
<!-- How long to wait before automatically skipping when the start of a commercial break reached (seconds) --><br />
<commbreakautowait>0</commbreakautowait><br />
<!-- How long to rewind after automatically skipping to the end of the commercial break (seconds) --><br />
<commbreakautowind>0</commbreakautowind><br />
</edl><br />
</syntaxhighlight><br />
<br />
=== pvr ===<br />
{{anchor|.3Cpvr.3E}}<br />
<syntaxhighlight lang="xml" enclose="div"><br />
<pvr><br />
<timecorrection>0</timecorrection> <!-- Correct all times (epg tags, timer tags, recording tags) by this amount of minutes. --><br />
<infotoggleinterval>3000</infotoggleinterval> <!-- If there is more than one pvr gui info item available (e.g. multiple recordings active at the same time), use this toggle delay in milliseconds. --><br />
<minvideocachelevel>5</minvideocachelevel> <!-- Cache up to this level in the video buffer buffer before resuming playback if the buffers run dry. --><br />
<minaudiocachelevel>10</minaudiocachelevel> <!-- Cache up to this level in the audio buffer before resuming playback if the buffers run dry. --><br />
<cacheindvdplayer>true</cacheindvdplayer> <!-- Cache PVR stream in DVDPlayer. --><br />
<channeliconsautoscan>true</channeliconsautoscan> <!-- Automatically scan user defined folder for channel icons when loading internal channel groups. --><br />
<autoscaniconsuserset>false</autoscaniconsuserset> <!-- Mark channel icons populated by auto scan as "user set". --><br />
<numericchannelswitchtimeout>1000</numericchannelswitchtimeout> <!-- Time in ms before the numeric dialog auto closes when confirmchannelswitch is disabled. --><br />
</pvr><br />
</syntaxhighlight><br />
<br />
=== epg ===<br />
{{anchor|.3Cpvr.3E}}<br />
<syntaxhighlight lang="xml" enclose="div"><br />
<epg><br />
<lingertime>1440</lingertime> <!-- keep X minutes of past epg data (default: 24h) --><br />
<updatecheckinterval>300</updatecheckinterval> <!-- check if tables need to be updated every X minutes --><br />
<lingercleanupintervaltime>900</cleanupinterval> <!-- remove old entries from the EPG every X minutes --><br />
<activetagcheckinterval>60</activetagcheckinterval> <!-- check for updated active tags every X minute --><br />
<retryinterruptedupdateinterval>30</retryinterruptedupdateinterval> <!-- retry an interrupted epg update after X seconds --><br />
<updateemptytagsinterval>60</updateemptytagsinterval> <!-- override user selectable EPG update interval (minutes) for empty EPG tags --><br />
<displayupdatepopup>true</displayupdatepopup> <!-- display a progress popup while updating EPG data from clients --><br />
<displayincrementalupdatepopup>false</displayincrementalupdatepopup> <!-- also display a progress popup while doing incremental EPG updates --><br />
</epg><br />
</syntaxhighlight><br />
<br />
=== forcedswaptime ===<br />
{{anchor|.3Cforcedswaptime.3E}}<br />
Use to force a backbuffer->frontbuffer swap while vsync is enabled. Set to the time (in ms) to allow for the swap (e.g. <forcedswaptime>1</forcedswaptime> is typical). <br />
<br />
Default: Off<br />
<br />
<!--<br />
=== omxdecodestartwithvalidframe ===<br />
{{note|This tag is only in some Raspberry Pi specific distributions, such as [[OpenELEC]]. As of March 2015, this tag has not been merged into "vanilla" Kodi builds.}}<br />
<br />
<syntaxhighlight lang="xml" enclose="div"><br />
<omxdecodestartwithvalidframe></omxdecodestartwithvalidframe><br />
</syntaxhighlight> --><br />
<br />
== Video library settings ==<br />
<br />
=== videoextensions ===<br />
{{anchor|.3Cvideoextensions.3E}}<section begin="videoextensions" /><br />
A list of additional file-extensions to allow ('''add''') or exclude ('''remove''') in the My Video windows.<br />
<br />
Default extensions for VIDEOS:<br />
<pre><br />
.m4v .3gp .nsv .ts .ty .strm .rm .rmvb .m3u .ifo .mov .qt .divx .xvid .bivx .vob .nrg .img<br />
.iso .pva .wmv .asf .asx .ogm .m2v .avi .bin .dat .dvr-ms .mpg .mpeg .mp4 .mkv .avc .vp3 <br />
.svq3 .nuv .viv .dv .fli .flv .rar .001 .wpl .zip<br />
</pre><br />
Examples:<br />
<syntaxhighlight lang="xml" enclose="div"><br />
<videoextensions><br />
<add>.ex1|.ex2</add><br />
<remove>.ex3|.ex4</remove><br />
</videoextensions><br />
</syntaxhighlight><br />
<section end="videoextensions" /><br />
<br />
=== discstubextensions ===<br />
{{anchor|.3Cdiscstubextensions.3E}}<br />
A list of additional file-extensions that will (<tt><add></tt>) or will not (<tt><remove></tt>) be treated as disc stubs.<br />
<br />
Default extensions for DISC STUBS:<br />
<pre><br />
.disc<br />
</pre><br />
<br />
Examples:<br />
<syntaxhighlight lang="xml" enclose="div"><br />
<discstubextensions><br />
<add>.dvd|.blu</add><br />
<remove>.cd|.vhs</remove><br />
</discstubextensions><br />
</syntaxhighlight><br />
<br />
=== languagecodes ===<br />
{{anchor|.3Clanguagecodes.3E}}<br />
Translation table for subtitle and audio names. Contains entries of the form<br />
<br />
<syntaxhighlight lang="xml" enclose="div"><br />
<languagecodes><br />
<code><br />
<short>alt</short><br />
<long>Alternate</long><br />
</code><br />
</languagecodes><br />
</syntaxhighlight><br />
<br />
=== sorttokens ===<br />
{{anchor|.3Csorttokens.3E}}<br />
Allows you to specify additional tokens that will be ignored at the start of lines during sorting.<br />
{{note|Sort tokens are case sensitive.}}<br />
<syntaxhighlight lang="xml" enclose="div"><br />
<sorttokens><br />
<token>the</token><br />
</sorttokens><br />
</syntaxhighlight><br />
<br />
=== moviestacking ===<br />
{{anchor|.3Cmoviestacking.3E}}<section begin="moviestacking" /><br />
{{main|File stacking}}<br />
This is used by the [[file stacking]] algorithm to combine multi-part files and contains a list of "''[[Regular Expression (RegEx) Tutorial|regular expressions]]''". For stacking videos that are contained in folders, such as VIDEO_TS folders, see '''[[advancedsettings.xml#folderstacking|<folderstacking>]]'''<br />
<br />
As of v9.11, video stacking regular expressions '''must''' contain exactly four (4) capture expressions. <br />
<br />
Default:<br />
<syntaxhighlight lang="xml" enclose="div"><br />
<moviestacking><br />
<!-- <cd/dvd/part/pt/disk/disc> <0-N> --><br />
<regexp>(.*?)([ _.-]*(?:cd|dvd|p(?:ar)?t|dis[ck])[ _.-]*[0-9]+)(.*?)(\.[^.]+)$</regexp><br />
<!-- <cd/dvd/part/pt/disk/disc> <a-d> --><br />
<regexp>(.*?)([ _.-]*(?:cd|dvd|p(?:ar)?t|dis[ck])[ _.-]*[a-d])(.*?)(\.[^.]+)$</regexp><br />
<!-- movienamea-xvid.avi, movienameb-xvid.avi --><br />
<regexp>(.*?)([ ._-]*[a-d])(.*?)(\.[^.]+)$</regexp><br />
</moviestacking><br />
</syntaxhighlight><br />
<br />
If the argument <tt>action="append"</tt> or <tt>append="yes"</tt> is supplied, the default moviestacking regular expressions will remain intact and the user specified ones will be added to the end. <br />
<br />
Example:<br />
<syntaxhighlight lang="xml" enclose="div"><br />
<moviestacking action="append"><br />
<!-- This expression will match movename1-xvid.avi, moviename2-xvid.avi.<br />
Be warned that it will likely stack sequels in a flat directory layout,<br />
so it is only recommend in a dir-per-video layout. --><br />
<regexp>(.*?)([ ._-]*[0-9])(.*?)(\.[^.]+)$</regexp><br />
</moviestacking><br />
</syntaxhighlight><br />
<br />
<br />
If the argument <tt>action="prepend"</tt> is supplied, the default moviestacking regular expressions will remain intact and the user specified ones will be added to the beginning. <br />
<br />
Example:<br />
<syntaxhighlight lang="xml" enclose="div"><br />
<moviestacking action="prepend"><br />
<regexp>(Title)(Volume)(Ignore)(Extension)</regexp><br />
</moviestacking><br />
</syntaxhighlight><br />
<br />
If no argument is supplied, or the argument <tt>append="no"</tt> is supplied, the default moviestacking regular expressions are overwritten by the user specified ones.<br />
<section end="moviestacking" /><br />
<br />
=== folderstacking ===<br />
{{main|File stacking}}<br />
This is similar to '''[[advancedsettings.xml#moviestacking|<moviestacking>]]''', but is used for videos that are contained in folders that use the folder names to stack, such as VIDEO_TS folders (DVD rips that are not in ISO format).<br />
<br />
Default:<br />
<syntaxhighlight lang="xml" enclose="div"><br />
<folderstacking><br />
<!-- <cd/dvd/disk/disc> <0-N> --><br />
<regexp>((cd|dvd|dis[ck])[0-9]+)$</regexp><br />
</folderstacking><br />
</syntaxhighlight><br />
<br />
=== cleandatetime ===<br />
{{anchor|.3Ccleandatetime.3E}}<br />
Matches a year number in a string using a ''[[Regular Expression (RegEx) Tutorial|Regular Expression]]'' <br />
<br />
Default expression:<br />
<syntaxhighlight lang="xml" enclose="div"><br />
<video><br />
<cleandatetime>(.+[^ _\,\.\(\)\[\]\-])[ _\.\(\)\[\]\-]+(19[0-9][0-9]|20[0-1][0-9])([ _\,\.\(\)\[\]\-][^0-9]|$)</cleandatetime><br />
</video><br />
</syntaxhighlight><br />
:* The string found before will be used as basis string getting cleaned by the cleanstrings expressions. <br />
:* By default date formats like MM:YY are ignored.<br />
<br />
=== cleanstrings ===<br />
{{anchor|.3Ccleanstrings.3E}}<br />
Clean unwanted characters from filenames or folders by using a list of ''[[Regular Expression (RegEx) Tutorial|Regular Expressions]]''. Please note that everything right of the match (at the end of the file name) is removed, so if you would have a file named ''Super movie.mp4'' and would add <tt><regexp> </regexp></tt> (only a space), the only thing that would be left is ''Super'', which is probably not what you want.<br />
<br />
Default expressions:<br />
<syntaxhighlight lang="xml" enclose="div"><br />
<video><br />
<cleanstrings><br />
<regexp>[ _\,\.\(\)\[\]\-](ac3|dts|custom|dc|divx|divx5|dsr|dsrip|dutch|dvd|dvdrip|dvdscr|dvdscreener|screener|dvdivx|cam|fragment|fs|hdtv|hdrip|hdtvrip|internal|limited|multisubs|ntsc|ogg|ogm|pal|pdtv|proper|repack|rerip|retail|cd[1-9]|r3|r5|bd5|se|svcd|swedish|german|read.nfo|nfofix|unrated|ws|telesync|ts|telecine|tc|brrip|bdrip|480p|480i|576p|576i|720p|720i|1080p|1080i|hrhd|hrhdtv|hddvd|bluray|x264|h264|xvid|xvidvd|xxx|www.www|\[.*\])([ _\,\.\(\)\[\]\-]|$)</regexp><br />
<regexp>(\[.*\])</regexp><br />
</cleanstrings><br />
</video><br />
</syntaxhighlight><br />
<br />
:* Arguments <tt>action="append"</tt> or <tt>action="prepend"</tt> will insert user specified expressions after, or before, the defaults above. (Further details in [[Advancedsettings.xml#.3Cmoviestacking.3E|moviestacking]] section)<br />
<br />
=== tvshowmatching ===<br />
{{anchor|.3Ctvshowmatching.3E}}<br />
Matches the season and episode numbers in file paths by using a list of ''[[Regular Expression (RegEx) Tutorial|Regular Expressions]]''<br />
<br />
Defaults:<br />
<syntaxhighlight lang="xml" enclose="div"><br />
<tvshowmatching><br />
<regexp>[Ss]([0-9]+)[][ ._-]*[Ee]([0-9]+)([^\\/]*)$</regexp> <!-- foo.s01.e01, foo.s01_e01, S01E02 foo, S01 - E02 --><br />
<regexp>[\._ -]()[Ee][Pp]_?([0-9]+)([^\\/]*)$</regexp> <!-- foo.ep01, foo.EP_01 --><br />
<regexp>([0-9]{4})[\.-]([0-9]{2})[\.-]([0-9]{2})</regexp> <!-- foo.yyyy.mm.dd.* (byDate=true) --><br />
<regexp>([0-9]{2})[\.-]([0-9]{2})[\.-]([0-9]{4})</regexp> <!-- foo.mm.dd.yyyy.* (byDate=true) --><br />
<regexp>[\\/\._ \[\(-]([0-9]+)x([0-9]+)([^\\/]*)$</regexp> <!-- foo.1x09* or just /1x09* --><br />
<regexp>[\\/\._ -]([0-9]+)([0-9][0-9])([\._ -][^\\/]*)$</regexp> <!-- foo.103*, 103 foo --><br />
<regexp>[\/._ -]p(?:ar)?t[_. -]()([ivx]+)([._ -][^\/]*)$</regexp> <!-- Part I, Pt.VI --><br />
</tvshowmatching><br />
</syntaxhighlight><br />
<br />
:* Arguments <tt>action="append"</tt> or <tt>action="prepend"</tt> will insert user specified expressions after, or before, the defaults above. (Further details in [[Advancedsettings.xml#.3Cmoviestacking.3E|moviestacking]] section)<br />
:* Paths are converted to lower case before matching.<br />
:* Examples of matching regexps for certain filenames can be found on the [[TV Shows (Video Library)|TV shows]] page.<br />
<br />
:* For multi-episode matching to work, there needs to be a third set of parentheses '()' at the end, this part is fed back into the regexp engine.<br />
<br />
:* A [http://forum.kodi.tv/showthread.php?t=51614 forum thread] has a discussion of pre-made regex lists to match common names. These might improve Kodi's ability to match TV show names in some situations, at the risk of additional false positives.<br />
<br />
==== Filenames without Season ====<br />
There are two methods to add episodes without a season in their file path. Both ways will force the season to '1' by default, so that you can use<br />
the 'Use Absolute Ordering (Single Season)' setting from the TheTvDb.com scraper.<br />
<br />
; Simple Method ''(XBMC v9.11 onwards and Kodi)''<br />
: Use only one pair of parentheses<br />
<syntaxhighlight lang="xml" enclose="div"><regexp>[/\._ \-]([0-9]+)</regexp></syntaxhighlight><br />
; Advanced Method ''(XBMC v10.05 onwards and Kodi)''<br />
: Supports multi-episode files without season<br />
: Use an empty pair of parentheses for the season<br />
<syntaxhighlight lang="xml" enclose="div"><regexp>[/\._ \-]()([0-9]+)(-[0-9]+)?</regexp></syntaxhighlight><br />
<br />
; Specifying Default Season ''(XBMC v12.0 onwards and Kodi)''<br />
It is possible to set the default season for specific regular expressions by setting the 'defaultseason' attribute.<br />
: Works with both the simple method and advanced method<br />
: If not used, the season will be set to '1'<br />
: Useful for setting specials to season '0'<br />
<syntaxhighlight lang="xml" enclose="div"><regexp defaultseason="0">[/\._ \-]X()([0-9]+)(-[0-9]+)?</regexp><br />
<regexp defaultseason="1">[/\._ \-]E()([0-9]+)(-[0-9]+)?</regexp></syntaxhighlight><br />
<br />
=== tvmultipartmatching ===<br />
{{anchor|.3Ctvmultipartmatching.3E}}<br />
Matches a multipart episode number based on a previously identified episode file, using a list of ''[[Regular Expression (RegEx) Tutorial|Regular Expressions]]''.<br />
<br />
Default:<br />
<syntaxhighlight lang="xml" enclose="div"><br />
<tvmultipartmatching>^[-_ex]+([0-9]+(?:(?:[a-i]|\\.[1-9])(?![0-9]))?)</tvmultipartmatching><br />
</syntaxhighlight><br />
:* Text matching is compared case-insensitive.<br />
:* Specifying this option '''replaces''' the default value<br />
<br />
=== excludefromscan ===<br />
{{anchor|.3Cexcludefromscan.3E}}<br />
Matches filenames or folders which should be excluded from a library scan (except tvshows) using a list of ''[[Regular Expression (RegEx) Tutorial|Regular Expressions]]''. This can be for both Video or Audio sections of <tt>advancedsettings.xml</tt>.<br />
<br />
Defaults:<br />
<syntaxhighlight lang="xml" enclose="div"><br />
<video><br />
<excludefromscan><br />
<regexp>-trailer</regexp><br />
<regexp>[!-._ \\/]sample[-._ \\/]</regexp><br />
</excludefromscan><br />
</video><br />
</syntaxhighlight><br />
<br />
:* Arguments <tt>action="append"</tt> or <tt>action="prepend"</tt> will insert user specified expressions after, or before, the defaults above. (Further details in [[Advancedsettings.xml#.3Cmoviestacking.3E|moviestacking]] section)<br />
<br />
=== excludefromlisting ===<br />
{{anchor|.3Cexcludefromlisting.3E}}<br />
<syntaxhighlight lang="xml" enclose="div"><br />
<video> <br />
<excludefromlisting> <!-- Regular expressions that if evaluated to true won't be displayed in Files View --><br />
<regexp>[-\._ ](sample|trailer)[-\._ ]</regexp><br />
</excludefromlisting><br />
</video><br />
</syntaxhighlight><br />
<br />
=== excludetvshowsfromscan ===<br />
{{anchor|.3Cexcludetvshowsfromscan.3E}}<br />
Matches filenames or folders which should be excluded from a tvshow library scan using a list of ''[[Regular Expression (RegEx) Tutorial|Regular Expressions]]''<br />
<br />
Defaults:<br />
<syntaxhighlight lang="xml" enclose="div"><br />
<video><br />
<excludetvshowsfromscan><br />
<regexp>[!-._ \\/]sample[-._ \\/]</regexp><br />
</excludetvshowsfromscan><br />
</video><br />
</syntaxhighlight><br />
<br />
:* Arguments <tt>action="append"</tt> or <tt>action="prepend"</tt> will insert user specified expressions after, or before, the defaults above. (Further details in [[Advancedsettings.xml#.3Cmoviestacking.3E|moviestacking]] section)<br />
<br />
=== trailermatching ===<br />
{{anchor|.3Ctrailermatching.3E}}<br />
Contains "''[[Regular Expression (RegEx) Tutorial|Regular Expression]]''" syntax (commonly referred to as "''[[Regular Expression (RegEx) Tutorial|RegEx]]''" or "''[[Regular Expression (RegEx) Tutorial|RegExp]]''") to match the locally stored trailers to movies in the library.<br />
<br />
<syntaxhighlight lang="xml" enclose="div"><br />
<trailermatching><br />
<!-- This regexp will match moviename_Trailer.avi --><br />
<regexp>(.*?)(_Trailer)(\.[^.]+)$</regexp><br />
</trailermatching><br />
</syntaxhighlight><br />
<br />
=== videolibrary ===<br />
{{anchor|.3Cvideolibrary.3E}}<br />
Options specific to the Video Library<br />
<br />
<syntaxhighlight lang="xml" enclose="div"><br />
<videolibrary><br />
<allitemsonbottom>false</allitemsonbottom> <!-- sorts the "*All" items at the bottom of the list when in Ascending order --><br />
<backgroundupdate>false</backgroundupdate> <!-- set to "true" to hide the video scanner dialog from the GUI --><br />
<!-- NOTE: To get this working properly, you have to do a 'Clean Library' in settings the first time after you enable the setting. --><br />
<cleanonupdate>false</cleanonupdate> <!-- default set to false to prevent Kodi from removing items from the database while updating. --><br />
<usefasthash>true</usefasthash> <!-- defaults to true. Set to false in order to skip hashing based on the folders modification time. --><br />
<hideallitems>false</hideallitems> <!-- removes the "*All" items from the video library --> <!-- This will be replaced in v15 with a GUI option. --><br />
<hideemptyseries>false</hideemptyseries> <!-- set to "true" to hide empty series in the video library and prevent empty series from being removed during a library cleanup. --><br />
<recentlyaddeditems>35</recentlyaddeditems> <!-- number of recently added items. Defaults to 25 --><br />
<itemseparator> / </itemseparator> <!-- separator used for multiple artists/genres in tags. Note, this is *space* *slash* *space* --><br />
<exportautothumbs>false</exportautothumbs> <!-- export auto-generated thumbs. Defaults to false --><br />
<importwatchedstate>false</importwatchedstate> <!-- import previously exported playdate and playcount from .nfo files. Defaults to false --><br />
<importresumepoint>false</importresumepoint> <!-- import previously exported resume point from .nfo files. Defaults to false --><br />
<mymovies> <!-- Options specific to MyMovies XML file parsing --><br />
<categoriestogenres>false</categoriestogenres> <!-- Add MyMovies Custom Categories to Genres (boolean, default is false) --><br />
</mymovies><br />
<dateadded>1</dateadded> <!-- 0 results in using the current datetime when adding a video;<br />
1 (default) results in prefering to use the files mtime (if it's valid) and only using the file's ctime if the mtime isn't valid;<br />
2 results in using the newer datetime of the file's mtime and ctime --><br />
</videolibrary><br />
</syntaxhighlight><br />
<br />
=== videoscanner ===<br />
{{anchor|.3Cvideoscanner.3E}}<br />
Options specific to the Video scanner<br />
<syntaxhighlight lang="xml" enclose="div"><br />
<videoscanner><br />
<ignoreerrors>true</ignoreerrors> <!-- Set to true to silently ignore errors while scanning videos. This prevents the error dialogue box, so you don't have to keep hitting "yes" to keep scanning.--><br />
</videoscanner><br />
</syntaxhighlight><br />
<br />
=== myth ===<br />
{{anchor|.3Cmyth.3E}}<br />
Not seeing all the recordings you expected in the Movies folder? If so, it's very likely that the electronic program guide (EPG) used by MythTV doesn't accurately distinguish between TV Shows and Movies all the time. The following setting allows the length of the recording to also be used to determine if a recording is a Movie.<br />
<br />
<syntaxhighlight lang="xml" enclose="div"><br />
<myth><br />
<!-- Recordings longer than this will be added to the Movies folder (minutes). 0 = off --><br />
<movielength>0</movielength><br />
</myth><br />
</syntaxhighlight><br />
<br />
== Library artwork ==<br />
<br />
=== imageres ===<br />
{{anchor|.3Cimageres.3E}}<br />
This tag is new for v12 (Frodo), replacing <thumbsize>.<br />
<br />
<section begin="imageres description" />Specify the maximal resolution that art should be resized to in pixels. The width is automatically calculated as being 16/9*height. The image will be resized to fit within this size. e.g. an image that is 2000x500 will be cached at size 1280x320. An image that is 500x800 will be cached at size 450x720 using the default value of 720.<section end="imageres description" /><br />
<br />
<syntaxhighlight lang="xml" enclose="div"><br />
<imageres>720</imageres><br />
</syntaxhighlight><br />
<br />
=== fanartres ===<br />
{{anchor|.3Cfanartres.3E}}<br />
This tag is new for v12 (Frodo), replacing <fanartheight>.<br />
<br />
<section begin="fanartres description" />Specify the resolution that cached fanart should be resized to in pixels. The width is automatically calculated as being 16/9*height. Only images that are exactly 16x9 and equal to or greater than this resolution will be cached at this size - all other images will be cached using <imageres>. The default value is 1080.<section end="fanartres description" /><br />
<br />
<syntaxhighlight lang="xml" enclose="div"><br />
<fanartres>1080</fanartres><br />
</syntaxhighlight><br />
<br />
=== fanart ===<br />
{{anchor|.3Cfanart.3E}}<br />
As of v12 (Frodo), this tag is only used for music and not video.<br />
<br />
A list of additional files to try when searching for fanart images. (The defaults are fanart.jpg and fanart.png which can be removed.)<br />
<br />
Example:<br />
<syntaxhighlight lang="xml" enclose="div"><br />
<fanart><br />
<remove>fanart.jpg</remove><br />
<add>backdrop.jpg</add><br />
</fanart><br />
</syntaxhighlight><br />
<br />
=== musicthumbs ===<br />
{{anchor|.3Cmusicthumbs.3E}}<br />
A list of additional files to try when searching for music thumbnail images. (The default is folder.jpg which can be removed.)<br />
<br />
Example:<br />
<syntaxhighlight lang="xml" enclose="div"><br />
<musicthumbs><br />
<remove>folder.jpg</remove><br />
<add>thumb.jpg|cover.jpg</add><br />
</musicthumbs><br />
</syntaxhighlight><br />
<br />
=== useddsfanart ===<br />
{{anchor|.3Cuseddsfanart.3E}}<br />
This settings allows Kodi to use your GPU rendering fanart and some other images. This will make loading images considerably faster, especially on systems with slower processors (e.g. atom based systems). Do not use this option on ARM based systems (Apple TV2/iOS/RPi/many Android systems) as it is likely to degrade performance because DDS images are not supported.<br />
<br />
<syntaxhighlight lang="xml" enclose="div"><br />
<useddsfanart>true</useddsfanart><br />
</syntaxhighlight><br />
<br />
=== imagescalingalgorithm ===<br />
{| width="100%" style="background-color: #EBE6FF; border: 1px solid #808000; font-size: 95%; clear: both" |<br />
| width="57px" | [[File:Future.png|50px|link=]]<br />
| align="left" | <big>{{{raw|'''{{{2|Current Kodi v16 development version feature}}}:'''<br />{{{1|This page or section describes a feature that is only available in Kodi v16 currently in development.}}}</big> }}}<br />
|}<br />
<br />
Specify the image scaling algorithm for image resizing/caching i.e. posters, fanart, etc.<br />
<br /><br />
<syntaxhighlight lang="xml" enclose="div"><br />
<imagescalingalgorithm>bicubic</imagescalingalgorithm><br />
</syntaxhighlight><br />
<br />
[https://github.com/xbmc/xbmc/blob/1a8753d5cd93890dc6a9f9d4b2ce8848066ea5d0/xbmc/pictures/PictureScalingAlgorithm.cpp#L32-L43 Available image scaling algorithms]<br />
<br />
<syntaxhighlight lang="text" enclose="div"><br />
fast_bilinear<br />
bilinear<br />
bicubic<br />
experimental<br />
nearest_neighbor<br />
averaging_area<br />
bicublin<br />
gaussian<br />
sinc<br />
lanczos<br />
bicubic_spline<br />
</syntaxhighlight><br />
<br />
== Video and music library settings ==<br />
<br />
=== playlistasfolders ===<br />
{{anchor|.3Cplaylistasfolders.3E}}<br />
In the recent releases, playlists are treated as folders. Selecting a playlist no longer plays it, but opens it, as if it were a folder.<br />
<br />
Set to false to revert to the previous behaviour. When you select a playlist, its content is added to the list of elements to be played.<br />
<br />
:{{note|This setting will not affect smart playlists, they will always show as folders.}}<br />
<br />
;Example<br />
<syntaxhighlight lang="xml" enclose="div"><br />
<playlistasfolders>true</playlistasfolders><br />
</syntaxhighlight><br />
<br />
=== playlistretries ===<br />
{{anchor|.3Cplaylistretries.3E}}<br />
The number of retries attempted if a source is offline. With this control you can alter the number of consecutive failed items before a playlist fails.<br />
<br />
Default:<br />
<syntaxhighlight lang="xml" enclose="div"><br />
<playlistretries>100</playlistretries><br />
</syntaxhighlight><br />
<br />
=== playlisttimeout ===<br />
{{anchor|.3Cplaylisttimeout.3E}}<br />
The timeout, in seconds, before item failure.<br />
<br />
Default:<br />
<syntaxhighlight lang="xml" enclose="div"><br />
<playlisttimeout>20</playlisttimeout> <br />
</syntaxhighlight><br />
<br />
=== musicdatabase/videodatabase ===<br />
{{anchor|.3Cmusicdatabase.3E/.3Cvideodatabase.3E}}<br />
{{main|MySQL}}<br />
<section begin="videodatabase" /><br />
Allows advanced customization of the default database settings for both music and video.<br />
<br />
:{{note| '''It is HIGHLY recommended that you not attempt to place an sqlite3 database outside of kodi's path. sqlite3 contains no filesystem abstraction, so this will plain break on any non-local (as far as Kodi is concerned) paths. Use this for mysql only.'''}}<br />
<br />
'''type'''<br />
: Can be either "sqlite3" or "mysql" (default: sqlite3)<br />
<br />
<br />
;host<br />
* sqlite3: defines the relative path to the database file (eg. /usr/local/kodi/databases).<br />
* mysql: defines the host of the mysql socket (eg. localhost, 192.168.0.1, etc)<br />
<br />
<br />
;port<br />
* sqlite3: silently ignored<br />
* mysql: defines the port of the mysql socket (default: 3306)<br />
<br />
<br />
;name<br />
:by default "MyVideos"+DB number will be used.<br />
* sqlite3: defines the name of the database file to read from, excluding the ".db" extension.<br />
* mysql: defines the name of the database to use<br />
<br />
<br />
;user<br />
* sqlite3: silently ignored<br />
* mysql: defines the user with privileged access to the database<br />
<br />
<br />
;pass<br />
* sqlite3: silently ignored<br />
* mysql: defines the password for the user with privileged access to the database<br />
<br />
<br />
;key<br />
: Optional SSL setting for MySQL [https://github.com/xbmc/xbmc/pull/2566]<br />
<br />
<br />
;cert<br />
: Optional SSL setting for MySQL [https://github.com/xbmc/xbmc/pull/2566]<br />
<br />
<br />
;ca<br />
: Optional SSL setting for MySQL [https://github.com/xbmc/xbmc/pull/2566]<br />
<br />
<br />
;capath<br />
: Optional SSL setting for MySQL [https://github.com/xbmc/xbmc/pull/2566]<br />
<br />
<br />
;ciphers<br />
: Optional SSL setting for MySQL [https://github.com/xbmc/xbmc/pull/2566]<br />
<br />
<br />
{{future box|1=<br />
;compression<br />
: Defaults to false. Set to "true" to enable MySQL compression protocol. Performance benefit is going to be largely dependent on the network bandwidth, latency between database and clients and on the size of the result sets. [https://github.com/xbmc/xbmc/pull/6484]<br />
: {{Note|Slower clients (such as the RPi and others) won't benefit from it as the zlib de-compression overhead is higher than the actual compression savings}}<br />
}}<br />
<br />
<br />
'''Examples:'''<br />
<br />
1) Configure a database for MySQL.<br />
:{{note| ''The videodatabase and musicdatabase tags are interchangeable here.''}}<br />
<syntaxhighlight lang="xml" enclose="div"><br />
<videodatabase><br />
<type>mysql</type><br />
<host>192.168.0.10</host><br />
<name>kodi_video</name><br />
<user>kodi</user><br />
<pass>kodi</pass><br />
</videodatabase><br />
</syntaxhighlight><br />
<br />
2) Configure a database for an sqlite database.<br />
:{{note|''The videodatabase and musicdatabase tags are interchangeable here.''}}<br />
<syntaxhighlight lang="xml" enclose="div"><br />
<musicdatabase><br />
<type>sqlite3</type><br />
<host>/usr/local/share/kodi/databases</host><br />
<name>kodi_music</name><br />
</musicdatabase><br />
</syntaxhighlight><br />
<br />
<section end="videodatabase" /><br />
<br />
=== externalplayer ===<br />
{{anchor|.3Cexternalplayer.3E}}<br />
{{see|External players}}<br />
<br />
== Music settings ==<br />
<br />
=== musicextensions ===<br />
{{anchor|.3Cmusicextensions.3E}}<br />
A list of additional file-extensions to allow ('''add''') or exclude ('''remove''') in the My Music windows.<br />
<br />
Default extensions for MUSIC:<br />
<pre><br />
.nsv .m4a .flac .aac .strm .pls .rm .mpa .wav .wma .ogg .mp3 .mp2 .m3u .mod .amf .669 .dmf .dsm .far .gdm <br />
.imf .it .m15 .med .okt .s3m .stm .sfx .ult .uni .xm .sid .ac3 .dts .cue .aif .aiff .wpl .ape .mac .mpc <br />
.mp+ .mpp .shn .zip .rar .wv .nsf .spc .gym .adplug .adx .dsp .adp .ymf .ast .afc .hps .xsp<br />
</pre><br />
<br />
Examples:<br />
<syntaxhighlight lang="xml" enclose="div"><br />
<musicextensions><br />
<add>.ex1|.ex2</add><br />
<remove>.ex3|.ex4</remove><br />
</musicextensions><br />
</syntaxhighlight><br />
<br />
=== cddbaddress ===<br />
{{anchor|.3Ccddbaddress.3E}}<br />
The address of the online CDDb database. You may set this to another freedb mirror if there is a more suitable one. <br />
<br />
Default: <br />
<syntaxhighlight lang="XML" enclose="div><br />
<cddbaddress>freedb.freedb.org</cddbaddress><br />
</syntaxhighlight><br />
<br />
=== songinfoduration ===<br />
{{anchor|.3Csonginfoduration.3E}}<br />
This controls how long the song information will remain onscreen when the song changes during visualisations. The valid range is "1" to "Indefinite (0)", in seconds. This does not include the duration of any transition effects. <br />
<br />
Default:<br />
<syntaxhighlight lang="xml" enclose="div"><br />
<songinfoduration>10</songinfoduration><br />
</syntaxhighlight><br />
<br />
=== musicfilenamefilters ===<br />
{{anchor|.3Cmusicfilenamefilters.3E}}<br />
Contains filters to match music information (artist, title etc.) from a tag-less music filename. The first <filter> to match completely is used. Matched items include:<br />
<br />
<pre><br />
%A - Artist<br />
%T - Title<br />
%B - Album<br />
%N - Track number<br />
%S - Part of set (disk number)<br />
%D - Duration<br />
%G - Genre<br />
%Y - Year<br />
%R - Rating<br />
</pre><br />
<br />
Example:<br />
<syntaxhighlight lang="xml" enclose="div"><br />
<musicfilenamefilters><br />
<filter>%A - %T</filter><br />
</musicfilenamefilters><br />
</syntaxhighlight><br />
<br />
=== musiclibrary ===<br />
{{anchor|.3Cmusiclibrary.3E}}<br />
Options specific to the Music Library<br />
<br />
<syntaxhighlight lang="xml" enclose="div"><br />
<musiclibrary><br />
<hideallitems>true</hideallitems> <!-- removes the "*All" items from the music library --> <!-- This will be replaced in v15 with a GUI option. --><br />
<allitemsonbottom>true</allitemsonbottom> <!-- sorts the "*All" items at the bottom of the list when in Ascending order --><br />
<backgroundupdate>true</backgroundupdate> <!-- set to hide the music scanner dialog from the gui --><br />
<recentlyaddeditems>35</recentlyaddeditems> <!-- number of recently added items. Defaults to 25 --><br />
<albumssortbyartistthenyear>true</albumssortbyartistthenyear> <!-- at an albums listing, when you sort by artist, secondary sort will be year. --><br />
<albumformat>%B - %Y</albumformat> <!-- album label template, default is "%B" --><br />
<albumformatright>%A</albumformatright> <!-- album label template for right column, default is "%A" --><br />
<prioritiseapetags>true</prioritiseapetags> <!-- prioritise APEv2 tags over ID3v1/2 tags, default is false. --><br />
<itemseparator> / </itemseparator> <!-- separator used for multiple artists/genres in tags. Note, this is *space* *slash* *space* --><br />
</musiclibrary><br />
</syntaxhighlight><br />
<br />
=== karaoke ===<br />
{{anchor|.3Ckaraoke.3E}}<br />
{{Main|Karaoke}}<section begin="karaoke" /><br />
<syntaxhighlight lang="xml" enclose="div"><br />
<karaoke><br />
<!-- Music-lyrics delay for CDG format lyrics in SECONDS. Floating number, may be negative. --><br />
<syncdelaycdg>0.0</syncdelaycdg><br />
<!-- Music-lyrics delay for LRC format lyrics in 1/10 seconds. Floating number, may be negative. --><br />
<syncdelaylrc>0.0</syncdelaylrc><br />
<!-- If set to true, when the songs are added to the library, Kodi will automatically replace the song genre by "Karaoke"<br />
if the song has associated lyrics. Default is false. --><br />
<alwaysreplacegenre>false</alwaysreplacegenre><br />
<!-- If set to true, when the music-lyrics delay was modified while playing using subtitle delay buttons, the delay value<br />
for this song will be stored, and restored when the song is played next time. Default is true. --><br />
<storedelay>true</storedelay><br />
<!-- When karaoke songs are added to the library during scans, an autoincrement number is automatically assigned<br />
to each song, starting from the value specified below. Default starts from 1. --><br />
<autoassignstartfrom>1</autoassignstartfrom><br />
<!-- If set to true (default), the background for CDG songs is always empty (plain color) no matter what setting is set in <br />
defaultbackground below. When setting this to false, then one can see through the background and see the video or<br />
visualization.--><br />
<nocdgbackground>true</nocdgbackground><br />
<!-- Sets default background mode. Type could be "none", "vis" for visualisation, "image" or "video".<br />
For image/video types the "path" parameter should specify the image or video file to play. --><br />
<defaultbackground type="video" path="special://masterprofile/karaokevideobg.avi"/><br />
<!-- If non-zero, specifies the time in seconds left before the end of the current song when a window will pop up informing you<br />
about the next played song. The window does not pop up if there is no next song, or it is not a karaoke song --><br />
<nextsongpopuptime>0.0</nextsongpopuptime><br />
</karaoke><br />
</syntaxhighlight><br />
<section end="karaoke" /><br />
<br />
== Photos settings ==<br />
<br />
=== pictureextensions ===<br />
{{anchor|.3Cpictureextensions.3E}}<br />
A list of additional file-extensions to allow ('''add''') or exclude ('''remove''') in the My Pictures window.<br />
<br />
Default extensions for PICTURES:<br />
<pre><br />
.png .jpg .jpeg .bmp .gif .ico .tif .tiff .tga .pcx .cbz .zip .cbr .rar .m3u<br />
</pre><br />
<br />
Examples:<br />
<syntaxhighlight lang="xml" enclose="div"><br />
<pictureextensions><br />
<add>.ex1|.ex2</add><br />
<remove>.ex3|.ex4</remove><br />
</pictureextensions><br />
</syntaxhighlight><br />
<br />
=== pictureexcludes ===<br />
{{anchor|.3Cpictureexcludes.3E}}<br />
Matches filenames or folders which should be excluded from being displayed in My Pictures using a list of ''[[Regular Expression (RegEx) Tutorial|Regular Expressions]]''<br />
<br />
<syntaxhighlight lang="xml" enclose="div"><br />
<pictureexcludes> <!-- Regular expressions that if evaluated to true won't be displayed in My Pictures --><br />
<regexp>small</regexp><br />
<regexp>[-\._ ](sample|trailer)[-\._ ]</regexp><br />
</pictureexcludes><br />
</syntaxhighlight><br />
<br />
=== slideshow ===<br />
{{anchor|.3Cslideshow.3E}}<br />
<syntaxhighlight lang="xml" enclose="div"><br />
<slideshow><br />
<!-- Amount to pan images as a percentage of the screen --><br />
<panamount>2.5</panamount><br />
<!-- Amount to zoom images as a percentage of the screen --><br />
<zoomamount>5.0</zoomamount><br />
<!-- Amount to compensate (zoom) images to attempt to reduce black bars. --><br />
<!-- Results in cropping of the longer length of the image in order to reduce the black bars on the shorter length of the image. --><br />
<!-- Defaults to 20. --><br />
<blackbarcompensation>20</blackbarcompensation> <br />
</slideshow><br />
</syntaxhighlight><br />
<br />
== Network settings ==<br />
<br />
=== samba ===<br />
{{anchor|.3Csamba.3E}}<br />
<syntaxhighlight lang="xml" enclose="div"><br />
<samba><br />
<doscodepage></doscodepage> <!-- code page to use for filenames --><br />
<clienttimeout>10</clienttimeout> <!-- timeout (in seconds) --><br />
<statfiles>true</statfiles> <!-- Set to false to disable smb stat() on files to speed up listings of large directories (over slow links) --><br />
</samba><br />
</syntaxhighlight><br />
<br />
=== hosts ===<br />
{{anchor|.3Cfhosts.3E}}<br />
Static dns entries which take precedence over your dns server.<br />
<syntaxhighlight lang="xml" enclose="div"><br />
<hosts><br />
<entry name="HOSTNAME">IPADDRESS</entry><br />
</hosts><br />
</syntaxhighlight><br />
<br />
=== network ===<br />
{{anchor|.3Cnetwork.3E}}<br />
{{see also|HOW-TO:Modify the cache}}<br />
<syntaxhighlight lang="xml" enclose="div"><br />
<network><br />
<curlclienttimeout>10</curlclienttimeout> <!-- Timeout in seconds for libcurl (http/ftp) connections --><br />
<curllowspeedtime>5</curllowspeedtime> <!-- Time in seconds for libcurl to consider a connection lowspeed --><br />
<httpproxyusername></httpproxyusername> <!-- username for Basic Proxy Authentication --><br />
<httpproxypassword></httpproxypassword> <!-- password for Basic Proxy Authentication --><br />
<cachemembuffersize>20971520</cachemembuffersize> <!-- number of bytes used for buffering streams ahead in memory <br />
Kodi will not buffer ahead more than this. WARNING: for the bytes set here, Kodi will consume 3x the amount of RAM<br />
When set to 0 the cache will be written to disk instead of RAM, as of v12 Frodo --><br />
<buffermode>0</buffermode> <!-- Choose what to buffer:<br />
0) Buffer all internet filesystems (like "2" but additionally also ftp, webdav, etc.) (default)<br />
1) Buffer all filesystems (including local)<br />
2) Only buffer true internet filesystems (streams) (http, etc.)<br />
3) No buffer --><br />
<readbufferfactor>1.0</readbufferfactor> <!-- this factor determines the max readrate in terms of readbufferfactor * avg bitrate of a video file. <br />
This can help on bad connections to keep the cache filled. It will also greatly speed up buffering. Default value 1.0. --><br />
</network><br />
</syntaxhighlight><br />
<br />
=== tuxbox ===<br />
{{anchor|.3Ctuxbox.3E}}<br />
<syntaxhighlight lang="xml" enclose="div"><br />
<tuxbox><br />
<!-- "audiochannelselection"; default is 'false', 'true' will popup the audio channel selection if<br />
there is more then one audio stream !--><br />
<audiochannelselection>false</audiochannelselection><br />
<!-- "submenuselection"; default is 'false', 'true' will popup the Submenu selection !--><br />
<submenuselection>false</submenuselection><br />
<!-- "defaultrootmenu"; MODE: 0 = TV (Default), 1 = Radio, 2 = Data, 3 = Movies, 4 = Root !--><br />
<defaultrootmenu>0</defaultrootmenu><br />
<!-- "defaultsubmenu"; 1=Services 2=Satellites 3=Providers 4=Bouquets (default) !--><br />
<defaultsubmenu>4</defaultsubmenu><br />
<!-- "pictureicon"; default is 'true', will use the Picture Icons from folder /UserData/PictureIcon/ !--><br />
<pictureicon>true</pictureicon><br />
<!-- "epgrequesttime"; default is '10', 0-3600, defines the time in seconds between epg queries, some tuxbox<br />
devices need longer to response (Minimum: 1, Maximum: 3600) !--><br />
<epgrequesttime>10</epgrequesttime><br />
<!-- "zapwaittime"; default is '0' (0 = OFF), defines the time in seconds to wait for a valid PMT after the<br />
zaping was send (Minimum: 0, Maximum: 120) !--><br />
<zapwaittime>0</zapwaittime> <br />
</tuxbox><br />
</syntaxhighlight><br />
<br />
=== airtunesport ===<br />
{{anchor|.3Cairtunesport.3E}}<section begin="airtunesport" /><br />
This overwrites the defalt listening port of the AirTunes server (announced via zeroconf).<br />
<section end="airtunesport" /><br />
<br />
=== airplayport ===<br />
{{anchor|.3Cairplayport.3E}}<section begin="airplayport" /><br />
This overwrites the default listening port of the AirPlay server (announced via zeroconf).<br />
<section end="airplayport" /><br />
<br />
== File system settings ==<br />
<br />
=== packagefoldersize ===<br />
<section begin="packagefoldersize" /><br />
{{anchor|.3Cpackagefoldersize.3E}}<br />
{{xml setting<br />
| tag name = packagefoldersize<br />
| option type = numerical<br />
| option values = <br />
| default values = 200<br />
| platform = all<br />
| XBMC version = 12<br />
| description = The amount (in megabytes) of add-on zip packages saved from previous add-on installs. These packages are mainly used for the [[add-on]] rollback feature. Increasing the size should increase the amount of past versions saved.<br />
| example = Example: <syntaxhighlight lang="xml" enclose="div"><packagefoldersize>200</packagefoldersize> <!-- this example would keep up to 200MB of add-on packages. --></syntaxhighlight><br />
}}<br />
<section end="packagefoldersize" /><br />
=== detectasudf ===<br />
{{anchor|.3Cdetectasudf.3E}}<br />
Set to true if you wish to detect joint ISO9660/UDF disks as UDF. <br />
<br />
Default: False<br />
<br />
=== pathsubstitution ===<br />
{{anchor|.3Cpathsubstitution.3E}}<br />
{{main|Path substitution}}<br />
Path substitutions are for use for redirecting file paths. These are processed in order, and are useful for substituting an absolute path on a PC with a path suitable for Kodi to handle. <br />
<br />
Default: No path substitutions defined. <br />
<br />
Example:<br />
<syntaxhighlight lang="xml" enclose="div"><br />
<pathsubstitution><br />
<substitute><br />
<from>G:\dvds\</from><br />
<to>smb://somecomputer/g-share/dvds/</to> <!-- Note the difference between the usage of forward and backslashes --><br />
</substitute><br />
</pathsubstitution><br />
</syntaxhighlight><br />
<br />
== Input control settings ==<br />
<br />
=== remotedelay ===<br />
{{anchor|.3Cremotedelay.3E}}<br />
The repeat delay for a LIRC remote control. A delay value between 1 and 20 before a remote button starts repeating on a long keypress (i.e. continuously sending button pushes while it's held down). <br />
<br />
Default: 3<br />
<syntaxhighlight lang="xml" enclose="div"><br />
<remotedelay>10</remotedelay><br />
</syntaxhighlight><br />
<br />
=== remoterepeat ===<br />
{{anchor|.3Cremoterepeat.3E}}<br />
This used to adjust the amount of time in milliseconds between repeated keystrokes. Used to prevent key-bounce, in other words prevents Kodi (lirc?) seeing one key press as multiple key presses with certain remotes.<br />
<br />
<syntaxhighlight lang="xml" enclose="div"><br />
<remoterepeat>800</remoterepeat><br />
</syntaxhighlight><br />
<br />
=== controllerdeadzone ===<br />
{{anchor|.3Ccontrollerdeadzone.3E}}<br />
The controller deadzone is the region of movement around the center which is not recognized by the device. Because joysticks can have noise (report motion when still) and bias (report an offset when centered), spurious events can be reported even though the controller isn't being touched. If you notice these kinds of events, you most likely need to increase your controller's deadzone (both axes recommended). The values range from 0.0 (no deadzone, Kodi will see all input your controller is capable of registering) to 1.0 (it will ignore all input inside of the device's physical limits).<br />
<br />
<syntaxhighlight lang="xml" enclose="div"><br />
<controllerdeadzone>0.2</controllerdeadzone><br />
</syntaxhighlight><br />
<br />
=== enablemultimediakeys ===<br />
{{anchor|.3Cenablemultimediakeys.3E}}<br />
This setting only has any effect on Windows versions of Kodi, and only applies to builds from 28th May 2011 onwards.<br />
In Windows the multimedia keys generate a WM_APPCOMMAND message in addition the keypress. Kodi processes both keypresses and the WM_APPCOMMAND messages, and the end result would be that the command is executed twice. To avoid this, by default multimedia keypresses are disabled. Although it should rarely be necessary, the enablemultimediakeys setting allows you to enable the multimedia keys.<br />
<br />
Example:<br />
<syntaxhighlight lang="xml" enclose="div"><br />
<enablemultimediakeys>true</enablemultimediakeys><br />
</syntaxhighlight><br />
<br />
<br />
=== seeksteps ===<br />
{{Main|Skip steps}}<br />
<br />
This setting changes which increments are available in the settings GUI for additive seeking. Note that <code><seeksteps></code> is not used to actually choose which seek steps are enabled.<br />
<br />
'''Default:'''<br />
<syntaxhighlight lang="xml" enclose="div"><br />
<seeksteps>7, 15, 30, 60, 180, 300, 600, 900, 1800</seeksteps><br />
</syntaxhighlight><br />
<br />
{{editor note|the defaults need to be updated for seeksteps.}}<br />
<br />
== Other interface settings ==<br />
<br />
=== window ===<br />
{{anchor|.3Cwindow.3E}}<br />
This allows you to manually set the default size of Kodi's windowed mode. If you resize the window, it will return to the set size when restarting.<br />
<br />
WIDTH and HEIGHT are the values for each dimension, in pixels.<br />
<br />
<syntaxhighlight lang="xml" enclose="div"><br />
<window><width>WIDTH</width><height>HEIGHT</height></window><br />
</syntaxhighlight><br />
<br />
=== allowd3d9ex ===<br />
{{anchor|.3Callowd3d9ex.3E}}<br />
Applies only to Windows Vista and up. Values: true/false. Allows Kodi to use Direct3D 9Ex, which is a bit more stable and robust than Direct3D 9.<br />
<br />
Default:<br />
<syntaxhighlight lang="xml" enclose="div"><br />
<allowd3d9ex>true</allowd3d9ex><br />
</syntaxhighlight><br />
<br />
=== restrictcapsmask ===<br />
{{anchor|.3Crestrictcapsmask.3E}}<br />
Windows only. A bitmask to prevent Kodi from using detected texture capabilities of the GPU. This helps work around buggy hardware/drivers.<br />
<br />
1: prevent the use of compressed textures (DXT1, DXT3, DXT5)<br />
2: prevent the use of non-power-of-two dimensions for textures<br />
4: prevent the use of compressed textures with non-power-of-two dimensions.<br />
<br />
<syntaxhighlight lang="xml" enclose="div"><br />
<restrictcapsmask>0</restrictcapsmask><br />
</syntaxhighlight><br />
<br />
=== forced3d9ex ===<br />
{{anchor|.3Cforced3d9ex.3E}}<br />
Windows only: Kodi attempts to detect drivers released for a version earlier than Vista, to avoid using advanced features which are often not emulated correctly. The detection may be incorrect and this setting allows forcing the using of D3D9Ex.<br />
<br />
<syntaxhighlight lang="xml" enclose="div"><br />
<forced3d9ex>false</forced3d9ex><br />
</syntaxhighlight><br />
<br />
=== algorithmdirtyregions ===<br />
{{anchor|.3Calgorithmdirtyregions.3E}}<br />
{{see also|HOW-TO:Modify dirty regions}}<br />
<section begin="algorithmdirtyregions" /> {{note|Some GPU/hardware configurations will have some minor issues (such as a visual "flicker"). For those situations try mode 2 or use the default (mode 3, which requires no advancedsetting). Almost all ARM-based devices (such as [[Android]]) willl likely have flickering issues.}}<br />
<br />
Enable dirty-region processing. Dirty regions are any parts of the screen that have changed since the last frame. By not re-rendering what hasn't changed the GUI can be sped up. Because all GPUs work differently, only Mode 3, combined with nofliptimeout=0, is guaranteed to work for everyone without flickering issues. This mode will reduce CPU/GPU usage, but will not increase GUI speed.<br />
<br />
{| class="prettytable"<br />
! value !! result !! description<br />
|-<br />
! 0<br />
| Off<br />
| The entire viewport is always rendered.<br />
|-<br />
! 1<br />
|Union<br />
|All dirty regions are grouped into the smallest possible rectangle. This is typically the fastest mode for slower GPUs due to only making one pass.<br />
|-<br />
! 2<br />
| {{nowrap|Cost reduction}}<br />
| Each dirty region is presented separately, in as many passes as there are regions.<br />
|-<br />
! 3<br />
| {{nowrap|Whole Screen}}<br />
| The entire screen is rendered if there are any dirty regions. This, combined with nofliptimeout is a safe default for drivers that clear buffer contents (manifests as blinking or vibrating images). '''Default'''<br />
|}<section end="algorithmdirtyregions" /><br />
<br />
Example:<br />
<syntaxhighlight lang="xml" enclose="div"><br />
<gui> <br />
<algorithmdirtyregions>1</algorithmdirtyregions><br />
</gui><br />
</syntaxhighlight><br />
<br />
=== nofliptimeout ===<br />
{{anchor|.3Cnofliptimeout.3E}}<br />
{{see also|HOW-TO:Modify dirty regions}}<br />
<section begin="nofliptimeout" />Specifies the timeout in milliseconds after which Kodi will not flip the graphics buffers anymore when nothing has been rendered, this lowers both CPU and GPU usage. Sometimes adjusting this value can help prevent flickering.<br />
<br />
* -1: disabled <br />
* 0 or higher: timeout in milliseconds '''(0 is default)'''<br />
<section end="nofliptimeout" /><br />
Example: <br />
<syntaxhighlight lang="xml" enclose="div"><br />
<gui> <br />
<nofliptimeout>1000</nofliptimeout><br />
</gui><br />
</syntaxhighlight><br />
<br />
=== visualizedirtyregions ===<br />
{{anchor|.3Cvisualizedirtyregions.3E}}<br />
{{see also|HOW-TO:Modify dirty regions}}<br />
<section begin="visualizedirtyregions" />Enable dirty-region visualization. Paints a rectangle over marked controls.<br />
<br />
* true: on<br />
* false: off '''(Default)'''<br />
<br />
{{note|This is only a development mode and isn't of use to normal users.}}<br />
<section end="visualizedirtyregions" /><br />
Example: <br />
<syntaxhighlight lang="xml" enclose="div"><br />
<gui> <br />
<visualizedirtyregions>true</visualizedirtyregions><br />
</gui><br />
</syntaxhighlight><br />
<br />
=== showexitbutton ===<br />
{{anchor|.3Cshowexitbutton.3E}}<br />
Setting to hide the exit button, useful for people running appliance based setup's where exit would only confuse/complicate the user. Modifiable via the advancedsettings.xml by setting showexitbutton to false, default is true (show)<br />
<br />
Example:<br />
<syntaxhighlight lang="xml" enclose="div"><br />
<showexitbutton>true</showexitbutton><br />
</syntaxhighlight><br />
<br />
=== fullscreen ===<br />
{{anchor|.3Cfullscreen.3E}}<br />
Starts Kodi in full screen (check resolutions!).<br />
<br />
<syntaxhighlight lang="xml" enclose="div"><br />
<fullscreen>false</fullscreen><br />
</syntaxhighlight><br />
<br />
=== splash ===<br />
{{anchor|.3Csplash.3E}}<br />
Set to false if you wish to disable the startup splash image. Defaults to true.<br />
<br />
<syntaxhighlight lang="xml" enclose="div"><br />
<splash>true</splash><br />
</syntaxhighlight><br />
<br />
=== cputempcommand ===<br />
{{anchor|.3Ccputempcommand.3E}}<br />
Provide a shell command Kodi will use to get CPU temperature. It should print out only "[temp as integer] [scale as one of "CcFf"]".<br /><br />
;<u>For Nvidia and Raspberry Pi</u><br />
<syntaxhighlight lang="xml" enclose="div"><br />
<cputempcommand>sed -e 's/\([0-9]*\)[0-9]\{3\}.*/\1 C/' /sys/class/thermal/thermal_zone0/temp</cputempcommand><br />
</syntaxhighlight><br />
or<br />
<syntaxhighlight lang="xml" enclose="div"><br />
<cputempcommand>echo "$(sensors -u | tail -n64 | grep temp1_input | awk '{print $2 }' |awk '{printf("%d\n",$1 + 0.5);}') C"</cputempcommand><br />
</syntaxhighlight><br />
;<u>For ATI/AMD</u><br />
<syntaxhighlight lang="xml" enclose="div"><br />
<cputempcommand>sensors|sed -ne "s/temp1: \+[-+]\([0-9]\+\).*/\1 C/p"</cputempcommand><br />
</syntaxhighlight><br />
<br />
=== gputempcommand ===<br />
{{anchor|.3Cgputempcommand.3E}}<br />
Provide a shell command Kodi will use to get GPU temperature. It should print out only "[temp as integer] [scale as one of "CcFf"]".<br /><br />
;<u>For Nvidia</u><br />
<syntaxhighlight lang="xml" enclose="div"><br />
<gputempcommand>echo "$(nvidia-settings -tq gpuCoreTemp) C"</gputempcommand><br />
</syntaxhighlight><br />
or<br />
<syntaxhighlight lang="xml" enclose="div"><br />
<gputempcommand>echo "$(nvidia-smi -q -d TEMPERATURE | grep Gpu | cut -c35-36) C"</gputempcommand><br />
</syntaxhighlight><br />
;<u>For ATI/AMD</u><br />
<syntaxhighlight lang="xml" enclose="div"><br />
<gputempcommand>/usr/bin/aticonfig --od-gettemperature | grep Temperature | cut -f 2 -d "-" | cut -f 1 -d "." | sed -e "s, ,," | sed 's/$/ C/'</gputempcommand><br />
</syntaxhighlight><br />
<br />
;<u>For Raspberry Pi</u><br />
<syntaxhighlight lang="xml" enclose="div"><br />
<gputempcommand>/opt/vc/bin/vcgencmd measure_temp | sed -e "s/temp=//" -e "s/\..*'/ /"</gputempcommand><br />
</syntaxhighlight><br />
<br />
=== glrectanglehack ===<br />
{{anchor|.3Cglrectanglehack.3E}}<br />
Problems with ghosting or videos which are only played back in the left upper quarter? The following ATI hack may solve it.<br />
<syntaxhighlight lang="xml" enclose="div"><br />
<glrectanglehack>yes</glrectanglehack><br />
</syntaxhighlight><br />
<br />
=== alwaysontop ===<br />
{{anchor|.3Calwaysontop.3E}}<br />
Added in XBMC v9.11 (Windows OS only). Keeps Kodi always on top when windowed.<br />
<syntaxhighlight lang="xml" enclose="div"><br />
<alwaysontop>yes</alwaysontop><br />
</syntaxhighlight><br />
<br />
Alternate code.<br />
<syntaxhighlight lang="xml" enclose="div"><br />
<videoscreen><br />
<fakefullscreen>false</fakefullscreen><br />
</videoscreen><br />
</syntaxhighlight><br />
<br />
== Recently removed tags ==<br />
* {{anchor|.3Cthumbsize.3E}}'''<thumbsize>''' - replaced by <[[#imageres|imageres]]> in v12 Frodo<br />
* {{anchor|.3Cfanartheight.3E}}'''<fanartheight>''' - replaced by <[[#fanartres|fanartres]]> in v12 Frodo<br />
* {{anchor|.3Cdvdthumbs.3E}}'''<dvdthumbs>''' - removed in v12 Frodo<br />
* {{anchor|.3Cbusydialogdelayms.3E}}'''<busydialogdelayms>''' - removed in v12 Frodo<br />
* {{anchor|.3Cbginfoloadermaxthreads.3E}}'''<bginfoloadermaxthreads>''' - removed in v13 Gotham<br />
* '''<showepginfoonselect>''' - replaced by a GUI setting in v13 Gotham<br />
* '''<resample>''', '''<forceDirectSound>''', '''<audiophile>''', '''<audiosinkbufferdurationmsec>''', '''<allowtranscode44100>''', and '''<streamsilence>''' - These were various sub-tags for <audio> that were removed in v13 Gotham and either replaced by GUI settings or were no longer needed.<br />
* {{anchor|.3Cenableairtunesdebuglog.3E}}'''<enableairtunesdebuglog>''' - replaced by a GUI option in v14 Helix<br />
* '''<videoDisableHi10pMultithreading>''' - renamed to <disableswmultithreading> in v14 Helix<br />
* '''<hideallitems>''' - For both the <code><videolibrary></code> and <code><musiclibrary></code> sections, this is replaced by a GUI option in v15 Isengard<br />
* '''<SmallStepBackSeconds>''' - In v15 the <code>SmallStepBack</code> [[action ID]] has been replaced by <code>seek(-7)</code> in default keymaps. See '''[[skip steps]]''' for details. When the original <code>SmallStepBack</code> action ID is used it defaults to the first backwards [[skip steps|additive seeking value]].<br />
* '''<timeseekforward>/<timeseekbackward>''' - In v15 these tags are replaced by GUI options via [[skip steps|additive seeking]], which is configured in the GUI. See '''[[skip steps]]''' for details.<br />
<br />
== guisettings.xml settings ==<br />
You can also define the settings normally defined in the GUI (and stored in guisettings.xml) in advancedsettings.xml. Most guisettings.xml settings defined in advancedsettings.xml will override the guisettings.xml values, and the settings will be removed completely from the interface.<br />
<br />
The easiest way to include a guisettings.xml setting is to first change the setting in the interface to the value that you want, and then open the '''[[userdata]]/guisettings.xml''' file and find the XML entry that corresponds to that setting.<br />
<br />
Then just add that entry to the advancedsettings.xml file.<br />
<br />
For instance, to set the Font Character Set (found in the appearance setting, in the Look and Feel section), you'd open up guisettings.xml and find:<br />
<br />
<syntaxhighlight lang="xml" enclose="div"><br />
<lookandfeel><br />
<charset>Hebrew (Windows)</charset><br />
</lookandfeel><br />
</syntaxhighlight><br />
<br />
Simply take that entry and place it in advancedsettings.xml. The option in Kodi's interface for the character set will then no longer be visible, and Kodi will always use the Hebrew (Windows) character set.<br />
<br />
{{Helix updated}}<br />
{{DISPLAYTITLE:advancedsettings.xml}}<br />
<br />
[[Category:Settings]]<br />
[[Category:Manual]]<br />
[[Category:Advanced topics]]</div>UNiversalhttps://kodi.wiki/index.php?title=Skip_steps&diff=98774Skip steps2015-07-25T10:28:11Z<p>UNiversal: </p>
<hr />
<div>{{mininav| [[Video library]] | [[Video playback]] }}<br />
<br />
<br />
{{note|This page applies to ''both'' video & music playback.}}<br />
<br />
<br />
<section begin="intro" />Skip steps is a new seeking function that has been implemented into Kodi as of v15, and is a method of additive skipping (also known as additive seeking) that applies to both videos and music. This allows the user to skip backwards and forwards with the left and right cursor keys (this is the default '''[[Keymap|keyboard and remote]]''' mapping), and by pressing these keys multiple times they can skip with increasingly larger steps.<section end="intro"/><br />
<br />
<br />
== New action ID behavior ==<br />
The following '''[[Action IDs|Action ID's]]''' are now forwarded to the new seeking function:<br />
<br />
* StepForward<br />
* StepBack<br />
* SmallStepBack - note this action is going to be removed as it is now replaced with the new <code>seek(##)</code> built-in command.<br />
<br />
<br />
==Configuration==<br />
The settings can be found in the '''''Videos -> Playback''''' section and '''''Music -> Playback'''''<br />
<br /><br />
<br />
[[File:skip steps.jpg|800px]]<br />
<br />
<br /><br />
<br /><br />
'''Skip steps -''' This allows you to set the number of skip steps and the value for each step, the default values available here are '''-30 min, -10 min, -5 min, -3 min, -60 sec, -30 sec, -10 sec, 10 sec, 30 sec, 60 sec, 3 min, 5 min, 10 min, 30 min.'''<br />
<br /><br />
{{greenv|'''Note:'''|These values can be customised, for details see '''[[Skip_steps#Changing_GUI_skip_step_values|Changing GUI skip step values]]''' }}<br />
<br /><br />
'''Skip delay:''' This is the amount of time Kodi waits for you to press the left or right key again (if using the default '''[[Keymap|keyboard and remote]]''' mapping) , before actually performing the forward or backwards skip, can be set to '''None''' and from there in '''250ms''' steps until '''3000ms'''.<br />
<br /><br />
<br />
==Additive skipping==<br />
<br />
Additive skipping (additive seeking) is a method of having increasingly larger skip steps the more times you press either the left key {{key press|Left}} or right key {{key press|Right}}, you need at least one skip step configured for either the positive or negative direction together with having a skip delay set. <br />
{{greenv|'''Note:'''| If you press either the {{key press|Left}} or {{key press|Right}} more times than there are configured steps for that direction, then the last configured skip size value will be summed up for each subsequent key press.}}<br />
<br /><br />
<u><big>'''Example 1'''</big></u><br />
<br /><br />
<br /><br />
'''Skip Steps:''' -30 sec, -15sec, -7 sec, 15 sec, 30 sec, 60 sec<br /><br />
'''Skip Delay:''' 750ms<br />
<br /><br />
<br /><br />
This table shows what happens with multiple presses of either the {{key press|Left}} key or the {{key press|Right}} key:<br />
<br />
{| class="wikitable"<br />
|- style="text-align: center"<br />
| '''Key Presses''' || {{key press|Left}} x 5 || {{key press|Left}} x 4 || {{key press|Left}} x 3 || {{key press|Left}} x 2 || {{key press|Left}} || {{key press|Right}} || {{key press|Right}} x 2 || {{key press|Right}} x 3 || {{key press|Right}} x 4 || {{key press|Right}} x 5<br />
|- style="text-align: center"<br />
| '''Time to be skipped''' || 90 seconds backwards || 60 seconds backwards || 30 seconds backwards || 15 seconds backwards || 7 seconds backwards || 15 seconds forwards || 30 seconds forwards || 60 seconds forwards || 120 seconds forwards || 180 seconds forwards<br />
|}<br />
<br />
{{greenv|'''IMPORTANT:'''|As there are 3 skip values in the positive direction with 60 sec being the last value, therefore a 4th right key press will take 60 sec (value for 3 key presses) and add a further 60 sec thus the skip size will be 120 sec forwards, a 5th right key press will be 180 sec, and so on. The same behaviour also applies for the negative direction.}}<br />
<br />
<br /><br />
<u><big>'''Example 2'''</big></u><br />
<br /><br />
<br /><br />
'''Skip Steps:''' -7 sec, 30 sec<br /><br />
'''Skip Delay:''' 750ms<br />
<br /><br />
<br /><br />
This table shows what happens with multiple presses of either the left key or the right key:<br />
<br />
{| class="wikitable"<br />
|- style="text-align: center"<br />
| '''Key Presses''' || {{key press|Left}} x 3 || {{key press|Left}} x 2 || {{key press|Left}} || {{key press|Right}} || {{key press|Right}} x 2 || {{key press|Right}} x 3<br />
|- style="text-align: center"<br />
| '''Time to be skipped''' || 21 seconds backwards || 14 seconds backwards || 7 seconds backwards || 30 seconds forwards || 60 seconds forwards || 90 seconds forwards<br />
|}<br />
<br />
{{greenv|'''IMPORTANT:'''|As there is only 1 skip value of 30 sec in the positive direction therefore a 2nd right key press will take 30 sec (value for 1 key press) and add a further 30 sec thus the skip size will be 60 sec forwards, a 3rd right key press will be 90 sec, and so on. The same behaviour also applies for the negative direction.}}<br />
<br />
<br /><br />
It is worth experimenting with Skip Delay to find the optimal setting for your hardware and the type of response you wish, for 250ms allows use of the additive function while retaining an almost instant response however this needs very quick presses for multiple presses to be registered.<br />
<br /><br />
<br />
==Instant skipping==<br />
<br />
With no more than a single negative or positive step configured, together with Skip Delay set to none, then Kodi will instantly skip without a delay.<br />
<br /><br />
<br /><br />
<u><big>'''Example'''</big></u><br />
<br /><br />
<br /><br />
'''Skip Steps:''' -7 sec, 30 sec<br /><br />
'''Skip Delay:''' None<br />
<br /><br />
<br />
{| class="wikitable"<br />
|- style="text-align: center"<br />
| '''Key Presses''' || {{key press|Left}} || {{key press|Right}}<br />
|-<br />
| '''Time to be skipped''' || 7 seconds backwards || 30 seconds forwards<br />
|}<br />
<br />
==Custom skip step values==<br />
The available '''skip step''' values can be further customised via the '''[[advancedsettings.xml]]''' file with the '''<seeksteps>''' entry. This is an optional step for users who want more granular control over what options are available. <br />
<br /><br />
{{greenv|'''IMPORTANT:'''|This advanced setting only overrides the values to be listed in the GUI '''Skip steps''' setting , in order to activate them for use you need to select them in the GUI using the '''Skip step''' setting, otherwise Kodi will carry on using the previously selected values. The values you enter are integers, so they apply for both the negative and positive directions e.g. a value of 10 will result in '''-10 sec''' and '''10 sec''' appearing in the '''Skip step''' list.}}<br />
<br /><br />
<u><big>'''Example:'''</big></u><br />
<br /><br />
<syntaxhighlight lang="xml" enclose="div"><br />
<advancedsettings><br />
<seeksteps>10, 20, 30, 40, 50, 60</seeksteps><br />
</advancedsettings><br />
</syntaxhighlight><br />
<br /><br />
This will result in the '''Skip step''' list in the GUI of '''-60 sec, -50 sec, -40 sec, -30 sec, -20 sec, -10 sec, 10 sec, 20 sec, 30 sec, 40 sec, 50 sec, 60 sec'''<br />
<br /><br />
<br />
=Adding seek built-in function to keymap=<br />
'''''Applies to Video & Music playback'''''<br />
<br /><br />
<br />
The built-in function <code>Seek(seconds)</code> is used to add custom seek (skip) values the keymap, so that when a particular key is pressed an instant seek (skip) of the specified value is performed. You are able to specify a relative amount of seconds to seek (skip) within the current playing media, where a negative value will seek (skip) backwards and a positive value will seek (skip) forwards. For details on how to modify your keymap see '''[[Keymap|How to customize my keymap]]'''.<br />
<br /><br />
<br /><br />
<u><big>'''Example'''</big></u><br />
<br /><br />
This maps a -7 sec seek to the key {{key press|b}} and a +15 sec seek to the key {{key press|n}}<br />
<pre><br />
<keymap><br />
<FullscreenVideo><br />
<keyboard><br />
<b>Seek(-7)</b><br />
<n>Seek(15)</n><br />
</keyboard><br />
</FullscreenVideo><br />
</keymap><br />
</pre><br />
<br />
=Time skipping=<br />
'''''Applies to Video playback only'''''<br />
<br />
These methods allow for the input a specific value during the course of video playback to either<br />
<br />
* Skip the specified amount<br />
* Skip to a certain point in time<br />
<br />
When using these methods the time values are enter in the form '''hh:mm:ss''' where '''h''' is hours, '''m''' is minutes, '''s''' is seconds<br />
<br />
<u><big>'''Examples:'''</big></u><br />
* Time value to enter is 45sec you would input '''45'''<br />
* Time value to enter is 1min 45sec you would input '''145'''<br />
* Time value to enter is 1hr 1min 45sec you would input '''10145'''<br />
<br/><br />
==Skip the specified amount==<br />
Using you remote or keyboard enter the skip value followed by either {{key press|Left}} or {{key press|Right}}<br />
key, depending on which direction you wish to skip in.<br />
<br />
<u><big>'''Examples:'''</big></u><br />
<br />
To skip 2 minute 30sec forward in the video then carry out:<br />
<br />
'''230''' then {{key press|Right}}<br />
<br />
To skip 1 minute 45sec back in the video then carry out:<br />
<br />
'''145''' then {{key press|left}}<br />
<br/><br />
==Skip to a specific time mark==<br />
Using you remote or keyboard enter '''time mark value''' followed by {{keypress|Enter}} key. <br />
<br />
<u><big>'''Example:'''</big></u><br />
<br />
To skip to the 25 minute mark in the video carry out:<br />
<br />
'''2500''' then {{keypress|Enter}}<br />
<br/><br />
=See also=<br />
* [[Video playback]]<br />
* [[HOW-TO:Modify time seeking]]<br />
* [[Keyboard controls]]<br />
* [[Keymap]]<br />
* [[Action IDs]]<br />
<br />
<br />
{{Isengard updated}}<br />
<br />
[[Category:Manual]]<br />
[[Category:Video library]]</div>UNiversalhttps://kodi.wiki/index.php?title=Action_IDs&diff=98665Action IDs2015-07-21T10:21:43Z<p>UNiversal: IncreaseRating and DecreaseRating is indeed used https://github.com/xbmc/xbmc/pull/6744</p>
<hr />
<div><section begin="Action IDs" /><br />
;Main actions<br />
{| class="prettytable" <br />
|-<br />
! Action<br />
! Description<br />
|- <br />
| <code>Left</code> || Move left off a control.<br />
|- <br />
| <code>Right</code> || Move right off a control. <br />
|- <br />
| <code>Up</code> || Move up off a control.<br />
|- <br />
| <code>Down</code> || Move down off a control.<br />
|- <br />
| <code>Select</code> || Select a button, or an item from a list of thumb view.<br />
|-<br />
| <code>enter</code> || '''?''' (ACTION_ENTER) Not sure about all areas, but on some windows this will be the same as the "done" on screen button.<br />
|- <br />
| <code>PageUp</code> || Scroll up on page in a list, thumb, or text view.<br />
|- <br />
| <code>PageDown</code> || Scroll down on page in a list, thumb, or text view.<br />
|- <br />
| <code>Highlight</code> || Highlight an item in a list or thumb view.<br />
|- <br />
| <code>ParentDir</code> || Go up a folder to the parent folder.<br />
|- <br />
| <code>PreviousMenu</code> || Go back to the previous menu screen.<br />
|- <br />
| <code>back</code> || Go back in navigation.<br />
|- <br />
| <code>Info</code> || Show the information about the currently highlighted item, or currently playing item.<br />
|- <br />
| <code>Pause</code> || Pause the currently playing item.<br />
|- <br />
| <code>Stop</code> || Stop the currently playing item.<br />
|- <br />
| <code>SkipNext</code> || Skip to next video in playlist. If no playlist, then skip to next chapter in video.<br />
|- <br />
| <code>SkipPrevious</code> || Skip to previous video in playlist. If no playlist, then skip to previous chapter in video.<br />
|- <br />
| <code>FullScreen</code> || Toggles full-screen content playback (either visualisation or video playback)<br />
|- <br />
| <code>togglefullscreen</code> || Changes whether the app is displayed full-screen or windowed (on windowing OSs)<br />
|- <br />
| <code>AspectRatio</code> || Toggle through the various aspect ratio modes (Normal is the preferred option).<br />
|- <br />
| <code>StepForward</code> || Step forward 30 seconds in a video.<br />
|- <br />
| <code>StepBack</code> || Step back 30 seconds in a video.<br />
|- <br />
| <code>BigStepForward</code> || Step forward 10 minutes in video.<br />
|- <br />
| <code>BigStepBack</code> || Step back 10 minutes in video.<br />
|- <br />
| <code>SmallStepBack</code> || Step back 7 seconds in the current video.<br />
|-<br />
| <code>Seek(''##'')</code> || A definable seek action, where <code>''##''</code> is a number of seconds. For example, to make a seek action that goes forward 25 seconds use <code>Seek(25)</code>, and to make a seek action that goes back 36 seconds use <code>Seek(-36)</code>. '''(v15 Isengard addition)'''<br />
|- {{Gotham row}}<br />
| <code>ChapterOrBigStepForward</code> || Go to to next chapter in video. If no chapters, then step forward 10 minutes in video. '''(v13 Gotham addition)'''<br />
|- {{Gotham row}}<br />
| <code>ChapterOrBigStepBack</code> || Go to previous chapter in video, If no chapters, then step back 10 minutes in video. '''(v13 Gotham addition)'''<br />
|- <br />
| <code>NextScene</code> || Go to next scene that is marked in an [[EDL]] file.<br />
|- <br />
| <code>PreviousScene</code> || Go to previous scene that is marked in an [[EDL]] file.<br />
|- <br />
| <code>OSD</code> || Toggles the OSD while playing an item.<br />
|- <br />
| <code>osdleft</code> || '''?''' (ACTION_OSD_SHOW_LEFT)<br />
|- <br />
| <code>osdright</code> || '''?''' (ACTION_OSD_SHOW_RIGHT)<br />
|- <br />
| <code>osdup</code> || '''?''' (ACTION_OSD_SHOW_UP)<br />
|- <br />
| <code>osddown</code> || '''?''' (ACTION_OSD_SHOW_DOWN)<br />
|- <br />
| <code>osdselect</code> || '''?''' (ACTION_OSD_SHOW_SELECT)<br />
|- <br />
| <code>osdvalueplus</code> || '''?''' (ACTION_OSD_SHOW_VALUE_PLUS)<br />
|- <br />
| <code>osdvalueminus</code> || '''?''' (ACTION_OSD_SHOW_VALUE_MIN)<br />
|- <br />
| <code>PlayDVD</code> || Start playing a DVD (goes to the DVD menu)<br />
|- <br />
| <code>ShowVideoMenu</code> || Go to the DVD Video menu when playing a DVD.<br />
|- <br />
| <code>ShowSubtitles</code> || Toggles whether subtitles are shown or not.<br />
|- <br />
| <code>NextSubtitle</code> || Change to the next subtitle language, if there is more than one.<br />
|- <br />
| <code>subtitleshiftup</code> || '''?''' (ACTION_SUBTITLE_VSHIFT_UP)<br />
|- <br />
| <code>subtitleshiftdown</code> || '''?''' (ACTION_SUBTITLE_VSHIFT_DOWN)<br />
|- <br />
| <code>subtitlealign</code> || '''?''' (ACTION_SUBTITLE_ALIGN)<br />
|- <br />
| <code>CodecInfo</code> || Show codec information about the currently playing item (during video or visualisation playback)<br />
|- <br />
| <code>NextPicture</code> || Move to the next picture in a slideshow.<br />
|- <br />
| <code>PreviousPicture</code> || Move to the previous picture in a slideshow.<br />
|- <br />
| <code>ZoomOut</code> || Used in picture, slideshow or video fullscreen to zoom out of the current image/video.<br />
|- <br />
| <code>ZoomIn</code> || Used in picture, slideshow or video fullscreen to zoom in to the current image/video.<br />
|- <br />
| <code>IncreasePAR</code> || Used in video fullscreen to increase the pixel aspect ratio (stretch).<br />
|- <br />
| <code>DecreasePAR</code> || Used in video fullscreen to decrease the pixel aspect ratio (stretch).<br />
|- <br />
| <code>Queue</code> || Queue the item to the current playlist<br />
|- <br />
| <code>Filter</code> || Opens the mediafilter dialog in the video and musiclibrary. {{editor note|seems to only use the [[advanced filter]] for the video library?}}<br />
|- <br />
| <code>Playlist</code> || Toggle to playlist view from My Music or My Videos<br />
|- <br />
| <code>ZoomNormal</code> || Normal (fullscreen) viewing in My Pictures<br />
|- <br />
| <code>ZoomLevel1</code> || Zoom to 120% in My Pictures<br />
|- <br />
| <code>ZoomLevel2</code> || Zoom to 150% in My Pictures<br />
|- <br />
| <code>ZoomLevel3</code> || Zoom to 200% in My Pictures<br />
|- <br />
| <code>ZoomLevel4</code> || Zoom to 280% in My Pictures<br />
|- <br />
| <code>ZoomLevel5</code> || Zoom to 400% in My Pictures<br />
|- <br />
| <code>ZoomLevel6</code> || Zoom to 600% in My Pictures<br />
|- <br />
| <code>ZoomLevel7</code> || Zoom to 900% in My Pictures<br />
|- <br />
| <code>ZoomLevel8</code> || Zoom to 1350% in My Pictures<br />
|- <br />
| <code>ZoomLevel9</code> || Zoom to 2000% in My Pictures<br />
|- <br />
| <code>NextCalibration</code> || Used in Video + GUI calibration<br />
|- <br />
| <code>ResetCalibration</code> || Used in Video + GUI calibration<br />
|- <br />
| <code>AnalogMove</code> || Move in the calibration screens, and while zoomed in My Pictures.<br />
|- <br />
| <code>Rotate</code> || Rotate a picture in My Pictures<br />
|- <br />
| <code>rotateccw</code> || '''?''' (ACTION_ROTATE_PICTURE_CCW)<br />
|- <br />
| <code>Close</code> || Used to close a dialog<br />
|- <br />
| <code>subtitledelay</code> || '''?''' (ACTION_SUBTITLE_DELAY)<br />
|- <br />
| <code>SubtitleDelayMinus</code> || Decrease the delay amount of subtitles (use if subtitles are displaying too late)<br />
|- <br />
| <code>SubtitleDelayPlus</code> || Increase the delay amount of subtitles (use if subtitles are displaying too early)<br />
|- <br />
| <code>audiodelay</code> || '''?''' (ACTION_AUDIO_DELAY)<br />
|- <br />
| <code>AudioDelayMinus</code> || Decrease the delay amount of audio (use if audio is being heard too early) <br />
|- <br />
| <code>AudioDelayPlus</code> || Increase the delay amount of audio (use if audio is being heard too late) <br />
|- <br />
| <code>AudioNextLanguage</code> || Change to the next audio track in a video with multiple audio tracks.<br />
|- <br />
| <code>NextResolution</code> || Used in Video calibration<br />
|- <br />
| <code>Number''(0-9)''</code> || Used to input the number 0 through 9<br />
|- <br />
| <code>FastForward</code> || Toggle the fastforward speed between normal play, 2x, 4x, 8x, 16x, and 32x.<br />
|- <br />
| <code>Rewind</code> || Toggle the rewind speed between normal play, 2x, 4x, 8x, 16x, and 32x.<br />
|- <br />
| <code>Play</code> || Play the selected item (or folder of items). {{note|You may want to use <code>playpause</code> instead of just "play", since it will no longer pause media already being played.}}<br />
|- <br />
| <code>PlayPause</code> || Play the selected item (or folder of items). Will also pause media when something is already playing.<br />
|- <br />
| <code>Delete</code> || Used in My Files to delete a file.<br />
|- <br />
| <code>Copy</code> || Used in My Files to copy a file.<br />
|- <br />
| <code>Move</code> || Used in My Files to move a file.<br />
|- <br />
| <code>Rename</code> || Used in My Files to rename a file.<br />
|- <br />
| <code>HideSubmenu</code> || <depreciated><br />
|- <br />
| <code>Screenshot</code> || Take a screenshot of the current screen.<br />
|- <br />
| <code>ShutDown()</code> || Shutdown and power off<br />
|- <br />
| <code>VolumeUp</code> || Increase the volume of playback.<br />
|- <br />
| <code>VolumeDown</code> || Decrease the volume of playback.<br />
|- <br />
| <code>Mute</code> || Mute the volume.<br />
|- <br />
| <code>volampup</code> || '''?''' (ACTION_VOLAMP_UP)<br />
|- <br />
| <code>volampdown</code> || '''?''' (ACTION_VOLAMP_DOWN)<br />
|- <br />
| <code>audiotoggledigital</code> || '''?''' (ACTION_TOGGLE_DIGITAL_ANALOG)<br />
|- <br />
| <code>BackSpace</code> || Used in the virtual keyboards to delete one letter.<br />
|- <br />
| <code>ScrollUp</code> || Variable speed scroll up for analog keys (stick or triggers)<br />
|- <br />
| <code>ScrollDown</code> || Variable speed scroll down for analog keys (stick or triggers)<br />
|- <br />
| <code>AnalogFastForward</code> || Variable speed fast forward for analog keys (stick or triggers)<br />
|- <br />
| <code>AnalogRewind</code> || Variable speed rewind for analog keys (stick or triggers)<br />
|- <br />
| <code>AnalogSeekForward</code> || Variable speed seeking for analog keys (stick or triggers)<br />
|- <br />
| <code>AnalogSeekBack</code> || Variable speed seeking for analog keys (stick or triggers)<br />
|- <br />
| <code>MoveItemUp</code> || Used to rearrange playlists<br />
|- <br />
| <code>MoveItemDown</code> || Used to rearrange playlists<br />
|- <br />
| <code>ContextMenu</code> || Pops up a contextual menu<br />
|- <br />
| <code>Shift</code> || Used in Virtual Keyboard to switch to upper or lower case letters<br />
|- <br />
| <code>Symbols</code> || Used in Virtual Keyboard to switch to or from symbols mode<br />
|- <br />
| <code>CursorLeft</code> || Used in Virtual Keyboard to move the current cursor point to the left<br />
|- <br />
| <code>CursorRight</code> || Used in Virtual Keyboard to move the current cursor point to the right<br />
|- <br />
| <code>ShowTime</code> || Used to show the current play time in music + video playback<br />
|-<br />
| <code>visualisationpresetlist</code> || Shows the visualisation preset list<br />
|- <br />
| <code>ShowPreset</code> || Shows the current visualisation preset (milkdrop/spectrum)<br />
|- <br />
| <code>NextPreset</code> || Next visualisation preset<br />
|- <br />
| <code>PreviousPreset</code> || Previous visualisation preset<br />
|- <br />
| <code>LockPreset</code> || Lock the current visualisation preset<br />
|- <br />
| <code>RandomPreset</code> || Switch to a new random preset<br />
|- <br />
| <code>IncreaseRating</code> || Used to increase track rating in full screen playback (press info on track and use pageplus on keyboard/remote<br />
|- <br />
| <code>DecreaseRating</code> || Used to decrease track rating in full screen playback (press info on track and use pageminus on keyboard/remote<br />
|- <br />
| <code>ToggleWatched</code> || Toggles watched/unwatched status for Videos<br />
|- <br />
| <code>NextLetter</code> || Move to the next letter in a list or thumb panel. Note that SHIFT-B on the keyboard will take you to the B's.<br />
|- <br />
| <code>PrevLetter</code> || Move to the previous letter in a list or thumb panel. Note that SHIFT-Z on the keyboard will take you to the Z's.<br />
|- <br />
| <code>JumpSMS''(2-9)''</code> || Jump through a list using SMS-style input (eg press 2 twice to jump to the B's.)<br />
|- <br />
| <code>FilterSMS''(2-9)''</code> || Filter a list in music or videos using SMS-style input.<br />
|- <br />
| <code>verticalshiftup</code> || '''?''' (ACTION_VSHIFT_UP)<br />
|- <br />
| <code>verticalshiftdown</code> || '''?''' (ACTION_VSHIFT_DOWN)<br />
|- <br />
| <code>scanitem</code> || '''?''' (ACTION_SCAN_ITEM)<br />
|- <br />
| <code>reloadkeymaps</code> || Reload keymap, loading any changes made to the keymap since started up.<br />
|- <br />
| <code>increasevisrating</code> || '''?''' (ACTION_VIS_RATE_PRESET_PLUS)<br />
|- <br />
| <code>decreasevisrating</code> || '''?''' (ACTION_VIS_RATE_PRESET_MINUS)<br />
|- <br />
| <code>firstpage</code> || '''?''' (ACTION_FIRST_PAGE)<br />
|- <br />
| <code>lastpage</code> || '''?''' (ACTION_LAST_PAGE)<br />
|- <br />
| <code>guiprofile</code> || '''?''' (ACTION_GUIPROFILE_BEGIN)<br />
|- <br />
| <code>red</code> || '''?''' (ACTION_TELETEXT_RED<br />
|- <br />
| <code>green</code> || '''?''' (ACTION_TELETEXT_GREEN)<br />
|- <br />
| <code>yellow</code> || '''?''' (ACTION_TELETEXT_YELLOW)<br />
|- <br />
| <code>blue</code> || '''?''' (ACTION_TELETEXT_BLUE)<br />
|- <br />
| <code>toggledebug</code> || toggle debugging mode for the [[log file]]<br />
|- <br />
| <code>ActivateWindow(MyVideos)</code> || Go to My Videos.<br />
|- <br />
| <code>ActivateWindow(MyMusic)</code> || Go to My Music.<br />
|- <br />
| <code>ActivateWindow(MyPictures)</code> || Go to My Pictures.<br />
|- <br />
| <code>ActivateWindow(Home)</code> || Go to Home window. Go back from within a context in the UI. <br />
|- <br />
| <code>ActivateWindow(type,path to playlist)</code> || Opens the window for the desired playlist.<br />
|- <br />
| <code>ActivateWindow('''''[[Window IDs|windowid]]''''')</code> || Go a window specified by ''''windowid''. See the [[Window IDs|list of window IDs]] for the list of valid values. Not all ids will work on all themes.<br />
|- {{gotham row}}<br />
| <code>createbookmark</code> || Creates a bookmark of the currently playing Video '''(v13 Gotham addition)'''<br />
|- {{gotham row}}<br />
| <code>createepisodebookmark</code> || Creates an episode bookmark of the currently playing multi-episode file (e.g. S01E01E02). An episode bookmark specifies the end of the one and the begin of the other episode '''(v13 Gotham addition)'''<br />
|- {{gotham row}}<br />
| <code>NextChannelGroup</code> || Goes to the next channel group when using [[PVR]]/live TV. Works only within the "PVROSDChannels" window. '''(v13 Gotham addition)'''<br />
|- {{gotham row}}<br />
| <code>PreviousChannelGroup</code> || Goes to the previous channel group when using [[PVR]]/live TV. Works only within the "PVROSDChannels" window. '''(v13 Gotham addition)'''<br />
|- {{gotham row}}<br />
| <code>PlayPvr</code> || [[PVR]] something ? '''(v13 Gotham addition)'''<br />
|- {{gotham row}}<br />
| <code>PlayPvrTV</code> || [[PVR]] something ? '''(v13 Gotham addition)'''<br />
|- {{gotham row}}<br />
| <code>PlayPvrRadio</code> || [[PVR]] something ? '''(v13 Gotham addition)'''<br />
|- {{gotham row}}<br />
| <code>Record</code> || [[PVR]] record current playing channel or selected item in windows like EPG '''(v13 Gotham addition)'''<br />
|- {{gotham row}}<br />
| <code>StereoMode</code> || Toggle 3D/Stereoscopic mode '''(v13 Gotham addition)'''<br />
|- {{gotham row}}<br />
| <code>ToggleStereoMode</code> || Toggle 3D/Stereoscopic mode '''(v13 Gotham addition)'''<br />
|- {{gotham row}}<br />
| <code>SwitchPlayer</code> || Select player to use, such as internal (DVDPlayer/PAPlayer), UPnP "play using" targets, external players (defined in [[playercorefactory.xml]]). '''(v13 Gotham addition)'''<br />
|- <br />
| <code>UpdateLibrary(video)</code> || Update Movie/TV-Show library (only tested with v13 Gotham addition).<br />
|- <br />
|}<br />
<br />
;Other<br />
{| class="prettytable"<br />
! Action<br />
! Description<br />
|-<br />
| <code>noop</code> || No action. Used to specifically disable a key.<br />
|}<br />
<section end="Action IDs" /><br />
<br />
== Removed action IDs ==<br />
* <code>PresetList</code> - replaced with <code>visualisationpresetlist</code> in a previous version (unknown?)<br />
<br />
== See also ==<br />
* [[Keymaps]]<br />
* [[Window IDs]]<br />
* [[Built-in scripting]]<br />
<br />
{{Helix updated}}<br />
<br />
[[Category:Remotes]]<br />
[[Category:Skin development]]</div>UNiversalhttps://kodi.wiki/index.php?title=Advancedsettings.xml&diff=98587Advancedsettings.xml2015-07-14T07:34:53Z<p>UNiversal: /* imagescalingalgorithm */ Add some explanation</p>
<hr />
<div>{{TOC right}}{{mininav|[[Settings]]|page=advancedsettings.xml}}<br />
{{bigger|{{note|'''The advancedsettings.xml file does not exist by default. You have to create it first!'''}} }}<br />
<br />
<section begin="intro" />The [[advancedsettings.xml]] file, which does not exist by default, can be created by a user in their '''[[userdata folder]]'''.<br />
<br />
This file is used for advanced settings and options that do not have GUI controls inside of {{kodi}}. Some settings are experimental or very rarely set, so they can only be used via the advancedsettings.xml file. The file is simply a plain text file and can be edited by various text editors, so long as the name is "advancedsettings.xml". These advanced settings can be used to tweak various things such as episode naming patterns, special network ports, special behaviors, and more.<section end="intro" /><br />
<br />
The following page will describe the structure of the advancedsettings.xml file and the various individual settings.<br />
<br />
{{note|<br />
# All XML tags must be lowercase. The start and end of the advancedsettings.xml file must have the <advancedsettings> and </advancedsettings> tags.<br />
# Kodi will only read the advancedsettings.xml file when it starts up. If you make changes while it is running then you must restart Kodi.<br />
# For some Windows versions, Kodi has two <code>\userdata\</code> folders. The correct one to put the advancedsettings.xml file in is not the one in Program Files, but in <code>%appdata%\Kodi\userdata\.</code>}}<br />
<br />
== Layout ==<br />
<br />
The layout of <code>advancedsettings.xml</code> is as follows:<br />
<br />
<syntaxhighlight lang="xml" enclose="div"><br />
<advancedsettings><br />
<setting>value</setting><br />
...<br />
<setting>value</setting><br />
</advancedsettings><br />
</syntaxhighlight><br />
<br />
where "setting" gives the name of the setting, and "value" gives it's value.<br />
<br />
A list of the available "setting" strings and their values is given below.<br />
<br />
= List of available settings =<br />
<br />
== Troubleshooting settings ==<br />
<br />
=== loglevel ===<br />
{{Anchor|.3Cloglevel.3E}}<br />
{{see also|debug log}}<br />
<section begin="loglevel" /><br />
{{xml setting<br />
| tag name = loglevel<br />
| tag attribute = hide<br />
| tag attribute values = <br />
{{option values<br />
| value1= true | value1 description= Hides "enable debugging" guisetting.<br />
| value2= false | value2 description= "enable debugging" guisetting will switch between min(loglevel, 0) and max(loglevel, 2) for off and on respectively. '''(Default)'''<br />
}}<br />
| tag attribute default values = true<br />
| option values = <br />
{{option values<br />
| value1= -1 | value1 description= No logging, suppresses all log output<br />
| value2= 0 | value2 description= Normal logging, only logging errors '''(Default)'''<br />
| value3= 1 | value3 description= Debug logging ''(without showing text on screen)''<br />
| value4= 2 | value4 description= Debug logging with freemem, fps and cpu usage shown on screen<br />
| value5= 3 | value5 description= Debug logging with freemem, fps and cpu usage and full smb logging<br />
}}<br />
| default values = 0<br />
| description = <br />
The logging level that Kodi will use to log errors and information. The "hide" attribute is optional.<br />
| example =<br />
Example:<br />
<syntaxhighlight lang="xml" enclose="div"><br />
<loglevel hide="false">1</loglevel><br />
</syntaxhighlight><br />
<br />
<br /><br />
<br />
{{Note| If debugging is switched on in the GUI, loglevel will be set to 2 (''log to both file and on-screen information''); this will over-ride any <code>advancedsettings.xml</code> setting.}}<br /><br />
<br />
{{Note| If debugging is switched on in the GUI when Kodi is shut down, then it will be automatically be re-enabled at level 2 when it is re-started. This is true even if 'hide' is subsequently set to 'true' - in other words, if you enable it in the GUI and then hide the GUI toggle, it will stay on level 2 irrespective of what you subsequently set in <code>advancedsettings.xml</code>.}}<br /><br />
}}<br />
<section end="loglevel" /><br />
<br />
=== jsonrpc ===<br />
{{Anchor|.3Cjsonrpc.3E}}<br />
To make it easier for developers using the [[JSON RPC]] API in their (third party) applications to debug during development the json output of Kodi can be prettified by setting '''compactoutput''' to '''false'''. Default json output mode is a compact print which does not contain any unnecessary whitespaces and therefore is difficult to read for humans.<br />
Furthermore using the '''tcpport''' setting it is possible to change the default TCP port used by Kodi for JSON RPC (which is 9090) to any other valid port.<br />
<br />
Example:<br />
<syntaxhighlight lang="xml" enclose="div"><br />
<jsonrpc><br />
<compactoutput>false</compactoutput><br />
<tcpport>9999</tcpport><br />
</jsonrpc><br />
</syntaxhighlight><br />
<br />
=== other - enableairtunesdebuglog ===<br />
{{see|#enableairtunesdebuglog}}<br />
<br />
== Audio/video playback settings ==<br />
<br />
=== skiploopfilter ===<br />
{{anchor|.3Cskiploopfilter.3E}}<br />
The amount of the loop filter to skip on h264 decoding. This can help the performance of slower machines when decoding h264 content. Values, in decreasing CPU usage (and decreasing quality)<br />
* -16 None<br />
* 0 Skip only empty frames (default)<br />
* 8 Skip non-reference frames (default on ATV)<br />
* 16 Skip bi-dir frames<br />
* 32 Skip all non-key frames<br />
* 48 Skip all frames<br />
Example:<br />
<syntaxhighlight lang="xml" enclose="div"><br />
<skiploopfilter>8</skiploopfilter><br />
</syntaxhighlight><br />
<br />
=== video ===<br />
{{anchor|.3Cvideo.3E}}<br />
{{see also|HOW-TO:Modify automatic watch and resume points|HOW-TO:Modify time seeking}}<br />
<syntaxhighlight lang="xml" enclose="div"><br />
<video><br />
<subsdelayrange>10</subsdelayrange> <!-- Delay range for subtitles, in seconds. --><br />
<audiodelayrange>10</audiodelayrange> <!-- Delay range for audio/video sync, in seconds. --><br />
<br />
<smallstepbackseconds>7</smallstepbackseconds> <!-- Length of the small skip back when playing a video --> <!-- Will be replaced by a GUI option in v15 --><br />
<usetimeseeking>true</usetimeseeking> <!-- Whether to use time based or percentage based seeking. --><br />
<timeseekforward>30</timeseekforward> <!-- Time to seek forward in seconds when doing a short seek. Defaults to 30. --> <!-- Deprecated. Will be replaced by a GUI option in v15. Note: Need to double check if it will actually be removed? --><br />
<timeseekbackward>-30</timeseekbackward> <!-- Time to seek backward in seconds when doing a short seek. Defaults to -30. --> <!-- Deprecated. Will be replaced by a GUI option in v15. Note: Need to double check if it will actually be removed? --><br />
<timeseekforwardbig>600</timeseekforwardbig> <!-- Time to seek forward in seconds when doing a long seek. Defaults to 600 (10 minutes). --><br />
<timeseekbackwardbig>-600</timeseekbackwardbig> <!-- Time to seek forward in seconds when doing a long seek. Defaults to -600 (10 minutes). --><br />
<percentseekforward>2</percentseekforward> <!-- Amount to seek forward as a percentage, when doing a short seek. Defaults to 2. --><br />
<percentseekbackward>-2</percentseekbackward> <!-- Amount to seek backward as a percentage, when doing a short seek. Defaults to -2. --><br />
<percentseekforwardbig>10</percentseekforwardbig> <!-- Amount to seek forward as a percentage, when doing a long seek. Defaults to 10. --><br />
<percentseekbackwardbig>-10</percentseekbackwardbig> <!-- Amount to seek forward as a percentage, when doing a long seek. Defaults to -10. --><br />
<br />
<blackbarcolour>1</blackbarcolour> <!-- colour of the black bars (0->255), (black->white) on videos. --><br />
<br />
<fullscreenonmoviestart>true</fullscreenonmoviestart> <!-- Whether to go to fullscreen or not when starting a movie. Defaults to true. --><br />
<br />
<defaultplayer>dvdplayer</defaultplayer> <!-- Set the default video player: dvdplayer or extplayer. --><br />
<br />
<excludefromscan> <!-- Regular expressions that if evaluated to true won't be added to library. --><br />
<regexp>[-\._ ](sample|trailer)[-\._ ]</regexp><br />
</excludefromscan><br />
<excludefromlisting> <!-- Regular expressions that if evaluated to true won't be displayed in Files View --><br />
<regexp>[-\._ ](sample|trailer)[-\._ ]</regexp><br />
</excludefromlisting><br />
<br />
<playcountminimumpercent>90</playcountminimumpercent> <!--Minimum percentage that has to be played before it is marked as watched. Set to 101 to never auto-mark items as watched --><br />
<ignoresecondsatstart>180</ignoresecondsatstart> <!-- Number of seconds to ignore at video start after which a resume point is created --><br />
<ignorepercentatend>8</ignorepercentatend> <!-- percentage of video to ignore at the end. If you stop watching the video here no resume point is created. Set to 101 to never save a resume point. The video is already marked as watched at 90%, see above. --><br />
<br />
<forcevaapienabled>true</forcevaapienabled> <!-- VAAPI is only tested on intel hardware. This flag helps wrapper developers and fglrx users to easily test current VAAPI state on their hardware. Default is false. Please report crashes directly to your driver vendor --><br />
<br />
<vdpauscaling>true</vdpauscaling> <!-- scales with vdpau instead of opengl and turns on its HQ scaler when available, enabling this might slow down rendering and cause framedrops especially on ION systems, this setting requires a vdpau feature set C gpu--><br />
<br />
<enablehighqualityhwscalers>true</enablehighqualityhwscalers> <!-- allow turning on the spline36 and lanczos3 shader (for GL builds) --><br />
<br />
<dxvaallowhqscaling>false</dxvaallowhqscaling> <!-- enables high quality video upscaling for Windows --><br />
<br />
<ppffmpegdeinterlacing>linblenddeint</ppffmpegdeinterlacing> <!-- override the deinterlacing options passed to libpostproc --><br />
<br />
<ppffmpegpostprocessing>ha:128:7,va,dr</ppffmpegpostprocessing> <!-- override the post processing options passed to libpostproc when 'Video post-processing' is activated in GUI Videos-Settings-Playback --><br />
<autoscalemaxfps>30</autoscalemaxfps> <!-- when scaling method is set to auto, bilinear is chosen when the fps is higher than this limit, the default is 30 --><br />
<br />
<br />
<!-- Settings for when "Adjust refreshrate to match video fps" is enabled, available since r33806. --><br />
<adjustrefreshrate> <br />
<br />
<!-- "Adjust refreshrate to match video fps" will try to select the best refreshrate for the video fps but it doesn't always get it right, for example it might switch to an unsupported refreshrate. You can add overrides here to switch to a certain refreshrate based on video fps. It's possible to add as many overrides as you need. Overrides are processed in order, if the first one doesn't match the fps or no refreshrates match that override, it will try the next one until no overrides are left --><br />
<br />
<override><br />
<fps>23.976</fps> <!-- if the fps is between 23.966 and 23.986 --><br />
<refresh>60.0</refresh> <!-- switch to the first found refreshrate that is between 59.99 and 60.01 --><br />
</override><br />
<br />
<override><br />
<fpsmin>29.96</fpsmin> <!-- You can also specify the fps range yourself --><br />
<fpsmax>30.01</fpsmax><br />
<refreshmin>59.0</refreshmin> <!-- Same for the refreshrate --><br />
<refreshmax>61.0</refreshmax><br />
</override><br />
<br />
<!-- It none of the overrides match, or none of the refreshrates match any of the fps matching overrides, it will choose a fallback refreshrate. Fallbacks are process in order, if the first fallback doesn't match any refreshrate, it will try the next one until no fallbacks are left --><br />
<fallback><br />
<refresh>50.0</refresh> <!-- switch to the first found refreshrate that is between 49.99 and 50.01. --><br />
</fallback><br />
<br />
<!-- You can also specify the range for the fallback yourself --><br />
<fallback><br />
<refreshmin>49.0</refreshmin><br />
<refreshmax>51.0</refreshmax><br />
</fallback><br />
<br />
<!-- If none of the overrides match the video fps, or no refreshrates match any of the fps matching overrides, and no fallbacks are specified or no refreshrates match any fallbacks, it will automatically choose the best refreshrate (same as having no overrides and fallbacks). --><br />
</adjustrefreshrate><br />
<br />
<checkdxvacompatibility>value</checkdxvacompatibility> <!-- Advanced setting not present: let Kodi autodetect cards that support H264 profile > L4.1. Set value to false to enable DXVA no matter what. Set value to true if Kodi doesn't autodetect that the graphics card doesn't support > L4.1 --><br />
<br />
<useocclusionquery>-1</useocclusionquery> <!--Use an occlusion query when capturing videoframes, -1 means auto detect, 0 means disabled, 1 means enabled, the default is -1.--><br />
<fpsdetect>1</fpsdetect> <!-- fps detection for video playback, 0 = trust codec fps, 1 = recalculate from video timestamps with uniform spacing, 2 = recalculate from video timestamps always --><br />
<br />
<br />
<latency> <!-- Compensate display latency (video lag). Latency is given in msecs. --><br />
<br />
<delay>0</delay> <!-- Global default display latency --><br />
<br />
<!-- Override latency for given display (not video) refresh rates. When Kodi is in windowed mode, override is ignored. Multiple overrides are allowed.<br />
<br />
Syntax of an override entry:<br />
<refresh><br />
<min>, <max> refresh rate range, OR<br />
<rate> exact refresh rate<br />
<delay> display latency for the given refresh rate<br />
</refresh><br />
--><br />
<br />
<!-- Example: display has 125 msec latency at 23-24 Hz --><br />
<refresh><br />
<min>23</min><br />
<max>24</max><br />
<delay>125</delay><br />
</refresh><br />
<br />
<!-- Example: display has 50 msec latency at 50 (+/-0.01) Hz --><br />
<refresh><br />
<rate>50</rate><br />
<delay>50</delay><br />
</refresh><br />
<br />
</latency><br />
<br />
<stereoscopicregex3d>[-. _]3d[-. _]</stereoscopicregex3d> <!-- Filename triggers for 3D (stereoscopic) mode. --><br />
<stereoscopicregexsbs>[-. _]h?sbs[-. _]</stereoscopicregexsbs><br />
<stereoscopicregextab>[-. _]h?tab[-. _]</stereoscopicregextab><br />
<br />
<stagefright> <!-- Previously this page also listed <mediacodec> tags as well as stagefright tags, but this was in error. There are only stagefright options for official Kodi builds. SPMC has mediacodec options for codec tweaking, though. -1 is default, 0 is never used this codec, 1 is always use this codec, bypassing blacklist --><br />
<useavccodec>-1</useavccodec><br />
<usehevccodec>-1</usehevccodec> <!-- Added in v15 --><br />
<usevc1codec>-1</usevc1codec><br />
<usevpxcodec>-1</usevpxcodec><br />
<usemp4codec>-1</usemp4codec><br />
<usempeg2codec>-1</usempeg2codec><br />
<useswrenderer>false</useswrenderer><br />
</stagefright><br />
<br />
<disableswmultithreading>false</disableswmultithreading> <!-- Replaces disablehi10pmultithreading. Set this to true if you want software decoding to use only one CPU thread. --><br />
<br />
<useffmpegvda>false</useffmpegvda> <!-- Experimental hardware video decoding mode for OS X. Option is available for development/testing purposes. --><br />
<br />
</syntaxhighlight><br />
{{isengard box|1=<br />
<syntaxhighlight lang="xml" enclose="div"><br />
<assfixedworks>false</assfixedworks> <!-- position behavior of ass subtitiles when setting "subtitle position on screen" set to "fixed". True to show at the fixed position set in video calibration. False to show at the bottom of video (default). --><br />
</syntaxhighlight><br />
}}<br />
<syntaxhighlight lang="xml" enclose="div"><br />
<br />
</video><br />
</syntaxhighlight><br />
<br />
=== audio ===<br />
{{anchor|.3Caudio.3E}}<br />
<syntaxhighlight lang="xml" enclose="div"><br />
<audio><br />
<!-- Amount of headroom Kodi should use above the maximum volume level, in decibels. Defaults to 0, valid values 0, 6, 12. --><br />
<headroom>0</headroom><br />
<!-- Default audio player: paplayer or dvdplayer --><br />
<defaultplayer>paplayer</defaultplayer><br />
<!-- Regular expressions that if evaluated to true won't be added to library. --><br />
<excludefromscan> <br />
<regexp>[-\._ ](podcast)[-\._ ]</regexp><br />
</excludefromscan><br />
<!-- Regular expressions that if evaluated to true won't be displayed in Files View --><br />
<excludefromlisting> <br />
<regexp>[-\._ ](podcast)[-\._ ]</regexp><br />
</excludefromlisting><br />
<!-- Amount of gain (dB) to be applied to AC3 streams that have been mixed-down to 2 channels. Default is 12.0. Valid values are: -96.0 to 96.0. --><br />
<ac3downmixgain>12.0</ac3downmixgain><br />
<!-- Minimum percentage that has to be played before it is considered for incrementing in the Top 100 database view, or for last.fm submittal --><br />
<playcountminimumpercent>99</playcountminimumpercent> <br />
<!-- Whether to use Dynamic Range Compression (DRC) on AC3 streams. 1.0 is "full" compression, as defined by the audio track's metadata, which is recommended for "basic" sound systems such as the internal speakers on a TV. 0.0 is no compression at all, which is recommended for people with nice multi-speaker sound systems. -1.0 (default) defaults to whatever ffmpeg uses, which is currently the same as 1.0. This has no effect if passthrough is enabled for AC3. --><br />
<applydrc>-1.0</applydrc> <br />
<!-- set to true to skip decoding of DTS in wav files when using dvdplayer (10.10 only) --><br />
<dvdplayerignoredtsinwav>false</dvdplayerignoredtsinwav> <br />
<!-- default values for limiter/compressor --><br />
<limiterhold>0.025</limiterhold> <br />
<!-- default values for limiter/compressor --><br />
<limiterrelease>0.1</limiterrelease> <br />
</audio><br />
</syntaxhighlight><br />
<br />
For more information on the configuration of audio under Frodo see [[AudioEngine/HOW-TO: Configure audio]]<br />
<br />
=== measurerefreshrate ===<br />
{{anchor|.3Cmeasurerefreshrate.3E}}<br />
When using "Sync playback to display" on Windows, the detected refreshrate might be wrong.<br />
When enabling measurerefreshrate, the refreshrate is measured instead, which makes it more accurate.<br />
<br />
<syntaxhighlight lang="xml" enclose="div"><br />
<measurerefreshrate>true</measurerefreshrate><br />
</syntaxhighlight><br />
<br />
=== edl ===<br />
{{anchor|.3Cedl.3E}}<br />
{{main|EDL}}<br />
Commercial break detection not as good you think it could be? Are some commercial breaks in a series of adverts not being skipped? Are some parts being skipped that are clearly not commercials? Does the end of the previous recording still show? The following advanced settings can be used to better identify full commercial break sequences, remove incorrectly flagged commercial breaks, and have playback start at the actual beginning of the recording.<br />
<br />
<syntaxhighlight lang="xml" enclose="div"><br />
<edl><br />
<!-- if true, commercial breaks will be merged according to the remaining options. --><br />
<mergeshortcommbreaks>false</mergeshortcommbreaks><br />
<!-- Commercial breaks won't be merged if the total length of the commercial break would be greater than this (seconds) --><br />
<maxcommbreaklength>250</maxcommbreaklength><br />
<!-- After merging, commercial breaks shorter than this will be removed (seconds) --><br />
<mincommbreaklength>90</mincommbreaklength><br />
<!-- Commercial breaks that are further apart than this won't be merged (seconds) --><br />
<maxcommbreakgap>120</maxcommbreakgap><br />
<!-- How long to wait before automatically skipping when the start of a commercial break reached (seconds) --><br />
<commbreakautowait>0</commbreakautowait><br />
<!-- How long to rewind after automatically skipping to the end of the commercial break (seconds) --><br />
<commbreakautowind>0</commbreakautowind><br />
</edl><br />
</syntaxhighlight><br />
<br />
=== pvr ===<br />
{{anchor|.3Cpvr.3E}}<br />
<syntaxhighlight lang="xml" enclose="div"><br />
<pvr><br />
<timecorrection>0</timecorrection> <!-- Correct all times (epg tags, timer tags, recording tags) by this amount of minutes. --><br />
<infotoggleinterval>3000</infotoggleinterval> <!-- If there is more than one pvr gui info item available (e.g. multiple recordings active at the same time), use this toggle delay in milliseconds. --><br />
<minvideocachelevel>5</minvideocachelevel> <!-- Cache up to this level in the video buffer buffer before resuming playback if the buffers run dry. --><br />
<minaudiocachelevel>10</minaudiocachelevel> <!-- Cache up to this level in the audio buffer before resuming playback if the buffers run dry. --><br />
<cacheindvdplayer>true</cacheindvdplayer> <!-- Cache PVR stream in DVDPlayer. --><br />
<channeliconsautoscan>true</channeliconsautoscan> <!-- Automatically scan user defined folder for channel icons when loading internal channel groups. --><br />
<autoscaniconsuserset>false</autoscaniconsuserset> <!-- Mark channel icons populated by auto scan as "user set". --><br />
<numericchannelswitchtimeout>1000</numericchannelswitchtimeout> <!-- Time in ms before the numeric dialog auto closes when confirmchannelswitch is disabled. --><br />
</pvr><br />
</syntaxhighlight><br />
<br />
=== epg ===<br />
{{anchor|.3Cpvr.3E}}<br />
<syntaxhighlight lang="xml" enclose="div"><br />
<epg><br />
<lingertime>1440</lingertime> <!-- keep X minutes of past epg data (default: 24h) --><br />
<updatecheckinterval>300</updatecheckinterval> <!-- check if tables need to be updated every X minutes --><br />
<lingercleanupintervaltime>900</cleanupinterval> <!-- remove old entries from the EPG every X minutes --><br />
<activetagcheckinterval>60</activetagcheckinterval> <!-- check for updated active tags every X minute --><br />
<retryinterruptedupdateinterval>30</retryinterruptedupdateinterval> <!-- retry an interrupted epg update after X seconds --><br />
<updateemptytagsinterval>60</updateemptytagsinterval> <!-- override user selectable EPG update interval (minutes) for empty EPG tags --><br />
<displayupdatepopup>true</displayupdatepopup> <!-- display a progress popup while updating EPG data from clients --><br />
<displayincrementalupdatepopup>false</displayincrementalupdatepopup> <!-- also display a progress popup while doing incremental EPG updates --><br />
</epg><br />
</syntaxhighlight><br />
<br />
=== forcedswaptime ===<br />
{{anchor|.3Cforcedswaptime.3E}}<br />
Use to force a backbuffer->frontbuffer swap while vsync is enabled. Set to the time (in ms) to allow for the swap (e.g. <forcedswaptime>1</forcedswaptime> is typical). <br />
<br />
Default: Off<br />
<br />
<!--<br />
=== omxdecodestartwithvalidframe ===<br />
{{note|This tag is only in some Raspberry Pi specific distributions, such as [[OpenELEC]]. As of March 2015, this tag has not been merged into "vanilla" Kodi builds.}}<br />
<br />
<syntaxhighlight lang="xml" enclose="div"><br />
<omxdecodestartwithvalidframe></omxdecodestartwithvalidframe><br />
</syntaxhighlight> --><br />
<br />
== Video library settings ==<br />
<br />
=== videoextensions ===<br />
{{anchor|.3Cvideoextensions.3E}}<section begin="videoextensions" /><br />
A list of additional file-extensions to allow ('''add''') or exclude ('''remove''') in the My Video windows.<br />
<br />
Default extensions for VIDEOS:<br />
<pre><br />
.m4v .3gp .nsv .ts .ty .strm .rm .rmvb .m3u .ifo .mov .qt .divx .xvid .bivx .vob .nrg .img<br />
.iso .pva .wmv .asf .asx .ogm .m2v .avi .bin .dat .dvr-ms .mpg .mpeg .mp4 .mkv .avc .vp3 <br />
.svq3 .nuv .viv .dv .fli .flv .rar .001 .wpl .zip<br />
</pre><br />
Examples:<br />
<syntaxhighlight lang="xml" enclose="div"><br />
<videoextensions><br />
<add>.ex1|.ex2</add><br />
<remove>.ex3|.ex4</remove><br />
</videoextensions><br />
</syntaxhighlight><br />
<section end="videoextensions" /><br />
<br />
=== discstubextensions ===<br />
{{anchor|.3Cdiscstubextensions.3E}}<br />
A list of additional file-extensions that will (<tt><add></tt>) or will not (<tt><remove></tt>) be treated as disc stubs.<br />
<br />
Default extensions for DISC STUBS:<br />
<pre><br />
.disc<br />
</pre><br />
<br />
Examples:<br />
<syntaxhighlight lang="xml" enclose="div"><br />
<discstubextensions><br />
<add>.dvd|.blu</add><br />
<remove>.cd|.vhs</remove><br />
</discstubextensions><br />
</syntaxhighlight><br />
<br />
=== languagecodes ===<br />
{{anchor|.3Clanguagecodes.3E}}<br />
Translation table for subtitle and audio names. Contains entries of the form<br />
<br />
<syntaxhighlight lang="xml" enclose="div"><br />
<languagecodes><br />
<code><br />
<short>alt</short><br />
<long>Alternate</long><br />
</code><br />
</languagecodes><br />
</syntaxhighlight><br />
<br />
=== sorttokens ===<br />
{{anchor|.3Csorttokens.3E}}<br />
Allows you to specify additional tokens that will be ignored at the start of lines during sorting.<br />
<syntaxhighlight lang="xml" enclose="div"><br />
<sorttokens><br />
<token>the</token><br />
</sorttokens><br />
</syntaxhighlight><br />
<br />
=== moviestacking ===<br />
{{anchor|.3Cmoviestacking.3E}}<section begin="moviestacking" /><br />
{{main|File stacking}}<br />
This is used by the [[file stacking]] algorithm to combine multi-part files and contains a list of "''[[Regular Expression (RegEx) Tutorial|regular expressions]]''". For stacking videos that are contained in folders, such as VIDEO_TS folders, see '''[[advancedsettings.xml#folderstacking|<folderstacking>]]'''<br />
<br />
As of v9.11, video stacking regular expressions '''must''' contain exactly four (4) capture expressions. <br />
<br />
Default:<br />
<syntaxhighlight lang="xml" enclose="div"><br />
<moviestacking><br />
<!-- <cd/dvd/part/pt/disk/disc> <0-N> --><br />
<regexp>(.*?)([ _.-]*(?:cd|dvd|p(?:ar)?t|dis[ck])[ _.-]*[0-9]+)(.*?)(\.[^.]+)$</regexp><br />
<!-- <cd/dvd/part/pt/disk/disc> <a-d> --><br />
<regexp>(.*?)([ _.-]*(?:cd|dvd|p(?:ar)?t|dis[ck])[ _.-]*[a-d])(.*?)(\.[^.]+)$</regexp><br />
<!-- movienamea-xvid.avi, movienameb-xvid.avi --><br />
<regexp>(.*?)([ ._-]*[a-d])(.*?)(\.[^.]+)$</regexp><br />
</moviestacking><br />
</syntaxhighlight><br />
<br />
If the argument <tt>action="append"</tt> or <tt>append="yes"</tt> is supplied, the default moviestacking regular expressions will remain intact and the user specified ones will be added to the end. <br />
<br />
Example:<br />
<syntaxhighlight lang="xml" enclose="div"><br />
<moviestacking action="append"><br />
<!-- This expression will match movename1-xvid.avi, moviename2-xvid.avi.<br />
Be warned that it will likely stack sequels in a flat directory layout,<br />
so it is only recommend in a dir-per-video layout. --><br />
<regexp>(.*?)([ ._-]*[0-9])(.*?)(\.[^.]+)$</regexp><br />
</moviestacking><br />
</syntaxhighlight><br />
<br />
<br />
If the argument <tt>action="prepend"</tt> is supplied, the default moviestacking regular expressions will remain intact and the user specified ones will be added to the beginning. <br />
<br />
Example:<br />
<syntaxhighlight lang="xml" enclose="div"><br />
<moviestacking action="prepend"><br />
<regexp>(Title)(Volume)(Ignore)(Extension)</regexp><br />
</moviestacking><br />
</syntaxhighlight><br />
<br />
If no argument is supplied, or the argument <tt>append="no"</tt> is supplied, the default moviestacking regular expressions are overwritten by the user specified ones.<br />
<section end="moviestacking" /><br />
<br />
=== folderstacking ===<br />
{{main|File stacking}}<br />
This is similar to '''[[advancedsettings.xml#moviestacking|<moviestacking>]]''', but is used for videos that are contained in folders that use the folder names to stack, such as VIDEO_TS folders (DVD rips that are not in ISO format).<br />
<br />
Default:<br />
<syntaxhighlight lang="xml" enclose="div"><br />
<folderstacking><br />
<!-- <cd/dvd/disk/disc> <0-N> --><br />
<regexp>((cd|dvd|dis[ck])[0-9]+)$</regexp><br />
</folderstacking><br />
</syntaxhighlight><br />
<br />
=== cleandatetime ===<br />
{{anchor|.3Ccleandatetime.3E}}<br />
Matches a year number in a string using a ''[[Regular Expression (RegEx) Tutorial|Regular Expression]]'' <br />
<br />
Default expression:<br />
<syntaxhighlight lang="xml" enclose="div"><br />
<video><br />
<cleandatetime>(.+[^ _\,\.\(\)\[\]\-])[ _\.\(\)\[\]\-]+(19[0-9][0-9]|20[0-1][0-9])([ _\,\.\(\)\[\]\-][^0-9]|$)</cleandatetime><br />
</video><br />
</syntaxhighlight><br />
:* The string found before will be used as basis string getting cleaned by the cleanstrings expressions. <br />
:* By default date formats like MM:YY are ignored.<br />
<br />
=== cleanstrings ===<br />
{{anchor|.3Ccleanstrings.3E}}<br />
Clean unwanted characters from filenames or folders by using a list of ''[[Regular Expression (RegEx) Tutorial|Regular Expressions]]''. Please note that everything right of the match (at the end of the file name) is removed, so if you would have a file named ''Super movie.mp4'' and would add <tt><regexp> </regexp></tt> (only a space), the only thing that would be left is ''Super'', which is probably not what you want.<br />
<br />
Default expressions:<br />
<syntaxhighlight lang="xml" enclose="div"><br />
<video><br />
<cleanstrings><br />
<regexp>[ _\,\.\(\)\[\]\-](ac3|dts|custom|dc|divx|divx5|dsr|dsrip|dutch|dvd|dvdrip|dvdscr|dvdscreener|screener|dvdivx|cam|fragment|fs|hdtv|hdrip|hdtvrip|internal|limited|multisubs|ntsc|ogg|ogm|pal|pdtv|proper|repack|rerip|retail|cd[1-9]|r3|r5|bd5|se|svcd|swedish|german|read.nfo|nfofix|unrated|ws|telesync|ts|telecine|tc|brrip|bdrip|480p|480i|576p|576i|720p|720i|1080p|1080i|hrhd|hrhdtv|hddvd|bluray|x264|h264|xvid|xvidvd|xxx|www.www|\[.*\])([ _\,\.\(\)\[\]\-]|$)</regexp><br />
<regexp>(\[.*\])</regexp><br />
</cleanstrings><br />
</video><br />
</syntaxhighlight><br />
<br />
:* Arguments <tt>action="append"</tt> or <tt>action="prepend"</tt> will insert user specified expressions after, or before, the defaults above. (Further details in [[Advancedsettings.xml#.3Cmoviestacking.3E|moviestacking]] section)<br />
<br />
=== tvshowmatching ===<br />
{{anchor|.3Ctvshowmatching.3E}}<br />
Matches the season and episode numbers in file paths by using a list of ''[[Regular Expression (RegEx) Tutorial|Regular Expressions]]''<br />
<br />
Defaults:<br />
<syntaxhighlight lang="xml" enclose="div"><br />
<tvshowmatching><br />
<regexp>[Ss]([0-9]+)[][ ._-]*[Ee]([0-9]+)([^\\/]*)$</regexp> <!-- foo.s01.e01, foo.s01_e01, S01E02 foo, S01 - E02 --><br />
<regexp>[\._ -]()[Ee][Pp]_?([0-9]+)([^\\/]*)$</regexp> <!-- foo.ep01, foo.EP_01 --><br />
<regexp>([0-9]{4})[\.-]([0-9]{2})[\.-]([0-9]{2})</regexp> <!-- foo.yyyy.mm.dd.* (byDate=true) --><br />
<regexp>([0-9]{2})[\.-]([0-9]{2})[\.-]([0-9]{4})</regexp> <!-- foo.mm.dd.yyyy.* (byDate=true) --><br />
<regexp>[\\/\._ \[\(-]([0-9]+)x([0-9]+)([^\\/]*)$</regexp> <!-- foo.1x09* or just /1x09* --><br />
<regexp>[\\/\._ -]([0-9]+)([0-9][0-9])([\._ -][^\\/]*)$</regexp> <!-- foo.103*, 103 foo --><br />
<regexp>[\/._ -]p(?:ar)?t[_. -]()([ivx]+)([._ -][^\/]*)$</regexp> <!-- Part I, Pt.VI --><br />
</tvshowmatching><br />
</syntaxhighlight><br />
<br />
:* Arguments <tt>action="append"</tt> or <tt>action="prepend"</tt> will insert user specified expressions after, or before, the defaults above. (Further details in [[Advancedsettings.xml#.3Cmoviestacking.3E|moviestacking]] section)<br />
:* Paths are converted to lower case before matching.<br />
:* Examples of matching regexps for certain filenames can be found on the [[TV Shows (Video Library)|TV shows]] page.<br />
<br />
:* For multi-episode matching to work, there needs to be a third set of parentheses '()' at the end, this part is fed back into the regexp engine.<br />
<br />
:* A [http://forum.kodi.tv/showthread.php?t=51614 forum thread] has a discussion of pre-made regex lists to match common names. These might improve Kodi's ability to match TV show names in some situations, at the risk of additional false positives.<br />
<br />
==== Filenames without Season ====<br />
There are two methods to add episodes without a season in their file path. Both ways will force the season to '1' by default, so that you can use<br />
the 'Use Absolute Ordering (Single Season)' setting from the TheTvDb.com scraper.<br />
<br />
; Simple Method ''(XBMC v9.11 onwards and Kodi)''<br />
: Use only one pair of parentheses<br />
<syntaxhighlight lang="xml" enclose="div"><regexp>[/\._ \-]([0-9]+)</regexp></syntaxhighlight><br />
; Advanced Method ''(XBMC v10.05 onwards and Kodi)''<br />
: Supports multi-episode files without season<br />
: Use an empty pair of parentheses for the season<br />
<syntaxhighlight lang="xml" enclose="div"><regexp>[/\._ \-]()([0-9]+)(-[0-9]+)?</regexp></syntaxhighlight><br />
<br />
; Specifying Default Season ''(XBMC v12.0 onwards and Kodi)''<br />
It is possible to set the default season for specific regular expressions by setting the 'defaultseason' attribute.<br />
: Works with both the simple method and advanced method<br />
: If not used, the season will be set to '1'<br />
: Useful for setting specials to season '0'<br />
<syntaxhighlight lang="xml" enclose="div"><regexp defaultseason="0">[/\._ \-]X()([0-9]+)(-[0-9]+)?</regexp><br />
<regexp defaultseason="1">[/\._ \-]E()([0-9]+)(-[0-9]+)?</regexp></syntaxhighlight><br />
<br />
=== tvmultipartmatching ===<br />
{{anchor|.3Ctvmultipartmatching.3E}}<br />
Matches a multipart episode number based on a previously identified episode file, using a list of ''[[Regular Expression (RegEx) Tutorial|Regular Expressions]]''.<br />
<br />
Default:<br />
<syntaxhighlight lang="xml" enclose="div"><br />
<tvmultipartmatching>^[-_ex]+([0-9]+(?:(?:[a-i]|\\.[1-9])(?![0-9]))?)</tvmultipartmatching><br />
</syntaxhighlight><br />
:* Text matching is compared case-insensitive.<br />
:* Specifying this option '''replaces''' the default value<br />
<br />
=== excludefromscan ===<br />
{{anchor|.3Cexcludefromscan.3E}}<br />
Matches filenames or folders which should be excluded from a library scan (except tvshows) using a list of ''[[Regular Expression (RegEx) Tutorial|Regular Expressions]]''. This can be for both Video or Audio sections of <tt>advancedsettings.xml</tt>.<br />
<br />
Defaults:<br />
<syntaxhighlight lang="xml" enclose="div"><br />
<video><br />
<excludefromscan><br />
<regexp>-trailer</regexp><br />
<regexp>[!-._ \\/]sample[-._ \\/]</regexp><br />
</excludefromscan><br />
</video><br />
</syntaxhighlight><br />
<br />
:* Arguments <tt>action="append"</tt> or <tt>action="prepend"</tt> will insert user specified expressions after, or before, the defaults above. (Further details in [[Advancedsettings.xml#.3Cmoviestacking.3E|moviestacking]] section)<br />
<br />
=== excludefromlisting ===<br />
{{anchor|.3Cexcludefromlisting.3E}}<br />
<syntaxhighlight lang="xml" enclose="div"><br />
<video> <br />
<excludefromlisting> <!-- Regular expressions that if evaluated to true won't be displayed in Files View --><br />
<regexp>[-\._ ](sample|trailer)[-\._ ]</regexp><br />
</excludefromlisting><br />
</video><br />
</syntaxhighlight><br />
<br />
=== excludetvshowsfromscan ===<br />
{{anchor|.3Cexcludetvshowsfromscan.3E}}<br />
Matches filenames or folders which should be excluded from a tvshow library scan using a list of ''[[Regular Expression (RegEx) Tutorial|Regular Expressions]]''<br />
<br />
Defaults:<br />
<syntaxhighlight lang="xml" enclose="div"><br />
<video><br />
<excludetvshowsfromscan><br />
<regexp>[!-._ \\/]sample[-._ \\/]</regexp><br />
</excludetvshowsfromscan><br />
</video><br />
</syntaxhighlight><br />
<br />
:* Arguments <tt>action="append"</tt> or <tt>action="prepend"</tt> will insert user specified expressions after, or before, the defaults above. (Further details in [[Advancedsettings.xml#.3Cmoviestacking.3E|moviestacking]] section)<br />
<br />
=== trailermatching ===<br />
{{anchor|.3Ctrailermatching.3E}}<br />
Contains "''[[Regular Expression (RegEx) Tutorial|Regular Expression]]''" syntax (commonly referred to as "''[[Regular Expression (RegEx) Tutorial|RegEx]]''" or "''[[Regular Expression (RegEx) Tutorial|RegExp]]''") to match the locally stored trailers to movies in the library.<br />
<br />
<syntaxhighlight lang="xml" enclose="div"><br />
<trailermatching><br />
<!-- This regexp will match moviename_Trailer.avi --><br />
<regexp>(.*?)(_Trailer)(\.[^.]+)$</regexp><br />
</trailermatching><br />
</syntaxhighlight><br />
<br />
=== videolibrary ===<br />
{{anchor|.3Cvideolibrary.3E}}<br />
Options specific to the Video Library<br />
<br />
<syntaxhighlight lang="xml" enclose="div"><br />
<videolibrary><br />
<allitemsonbottom>false</allitemsonbottom> <!-- sorts the "*All" items at the bottom of the list when in Ascending order --><br />
<backgroundupdate>false</backgroundupdate> <!-- set to "true" to hide the video scanner dialog from the GUI --><br />
<!-- NOTE: To get this working properly, you have to do a 'Clean Library' in settings the first time after you enable the setting. --><br />
<cleanonupdate>false</cleanonupdate> <!-- default set to false to prevent Kodi from removing items from the database while updating. --><br />
<usefasthash>true</usefasthash> <!-- defaults to true. Set to false in order to skip hashing based on the folders modification time. --><br />
<hideallitems>false</hideallitems> <!-- removes the "*All" items from the video library --> <!-- This will be replaced in v15 with a GUI option. --><br />
<hideemptyseries>false</hideemptyseries> <!-- set to "true" to hide empty series in the video library and prevent empty series from being removed during a library cleanup. --><br />
<recentlyaddeditems>35</recentlyaddeditems> <!-- number of recently added items. Defaults to 25 --><br />
<itemseparator> / </itemseparator> <!-- separator used for multiple artists/genres in tags. Note, this is *space* *slash* *space* --><br />
<exportautothumbs>false</exportautothumbs> <!-- export auto-generated thumbs. Defaults to false --><br />
<importwatchedstate>false</importwatchedstate> <!-- import previously exported playdate and playcount from .nfo files. Defaults to false --><br />
<importresumepoint>false</importresumepoint> <!-- import previously exported resume point from .nfo files. Defaults to false --><br />
<mymovies> <!-- Options specific to MyMovies XML file parsing --><br />
<categoriestogenres>false</categoriestogenres> <!-- Add MyMovies Custom Categories to Genres (boolean, default is false) --><br />
</mymovies><br />
<dateadded>1</dateadded> <!-- 0 results in using the current datetime when adding a video;<br />
1 (default) results in prefering to use the files mtime (if it's valid) and only using the file's ctime if the mtime isn't valid;<br />
2 results in using the newer datetime of the file's mtime and ctime --><br />
</videolibrary><br />
</syntaxhighlight><br />
<br />
=== videoscanner ===<br />
{{anchor|.3Cvideoscanner.3E}}<br />
Options specific to the Video scanner<br />
<syntaxhighlight lang="xml" enclose="div"><br />
<videoscanner><br />
<ignoreerrors>true</ignoreerrors> <!-- Set to true to silently ignore errors while scanning videos. This prevents the error dialogue box, so you don't have to keep hitting "yes" to keep scanning.--><br />
</videoscanner><br />
</syntaxhighlight><br />
<br />
=== myth ===<br />
{{anchor|.3Cmyth.3E}}<br />
Not seeing all the recordings you expected in the Movies folder? If so, it's very likely that the electronic program guide (EPG) used by MythTV doesn't accurately distinguish between TV Shows and Movies all the time. The following setting allows the length of the recording to also be used to determine if a recording is a Movie.<br />
<br />
<syntaxhighlight lang="xml" enclose="div"><br />
<myth><br />
<!-- Recordings longer than this will be added to the Movies folder (minutes). 0 = off --><br />
<movielength>0</movielength><br />
</myth><br />
</syntaxhighlight><br />
<br />
== Library artwork ==<br />
<br />
=== imageres ===<br />
{{anchor|.3Cimageres.3E}}<br />
This tag is new for v12 (Frodo), replacing <thumbsize>.<br />
<br />
<section begin="imageres description" />Specify the maximal resolution that art should be resized to in pixels. The width is automatically calculated as being 16/9*height. The image will be resized to fit within this size. e.g. an image that is 2000x500 will be cached at size 1280x320. An image that is 500x800 will be cached at size 450x720 using the default value of 720.<section end="imageres description" /><br />
<br />
<syntaxhighlight lang="xml" enclose="div"><br />
<imageres>720</imageres><br />
</syntaxhighlight><br />
<br />
=== fanartres ===<br />
{{anchor|.3Cfanartres.3E}}<br />
This tag is new for v12 (Frodo), replacing <fanartheight>.<br />
<br />
<section begin="fanartres description" />Specify the resolution that cached fanart should be resized to in pixels. The width is automatically calculated as being 16/9*height. Only images that are exactly 16x9 and equal to or greater than this resolution will be cached at this size - all other images will be cached using <imageres>. The default value is 1080.<section end="fanartres description" /><br />
<br />
<syntaxhighlight lang="xml" enclose="div"><br />
<fanartres>1080</fanartres><br />
</syntaxhighlight><br />
<br />
=== fanart ===<br />
{{anchor|.3Cfanart.3E}}<br />
As of v12 (Frodo), this tag is only used for music and not video.<br />
<br />
A list of additional files to try when searching for fanart images. (The defaults are fanart.jpg and fanart.png which can be removed.)<br />
<br />
Example:<br />
<syntaxhighlight lang="xml" enclose="div"><br />
<fanart><br />
<remove>fanart.jpg</remove><br />
<add>backdrop.jpg</add><br />
</fanart><br />
</syntaxhighlight><br />
<br />
=== musicthumbs ===<br />
{{anchor|.3Cmusicthumbs.3E}}<br />
A list of additional files to try when searching for music thumbnail images. (The default is folder.jpg which can be removed.)<br />
<br />
Example:<br />
<syntaxhighlight lang="xml" enclose="div"><br />
<musicthumbs><br />
<remove>folder.jpg</remove><br />
<add>thumb.jpg|cover.jpg</add><br />
</musicthumbs><br />
</syntaxhighlight><br />
<br />
=== useddsfanart ===<br />
{{anchor|.3Cuseddsfanart.3E}}<br />
This settings allows Kodi to use your GPU rendering fanart and some other images. This will make loading images considerably faster, especially on systems with slower processors (e.g. atom based systems). Do not use this option on ARM based systems (Apple TV2/iOS/RPi/many Android systems) as it is likely to degrade performance because DDS images are not supported.<br />
<br />
<syntaxhighlight lang="xml" enclose="div"><br />
<useddsfanart>true</useddsfanart><br />
</syntaxhighlight><br />
<br />
=== imagescalingalgorithm ===<br />
{| width="100%" style="background-color: #EBE6FF; border: 1px solid #808000; font-size: 95%; clear: both" |<br />
| width="57px" | [[File:Future.png|50px|link=]]<br />
| align="left" | <big>{{{raw|'''{{{2|Current Kodi v16 development version feature}}}:'''<br />{{{1|This page or section describes a feature that is only available in Kodi v16 currently in development.}}}</big> }}}<br />
|}<br />
<br />
Specify the image scaling algorithm for image resizing/caching i.e. posters, fanart, etc.<br />
<br /><br />
<syntaxhighlight lang="xml" enclose="div"><br />
<imagescalingalgorithm>bicubic</imagescalingalgorithm><br />
</syntaxhighlight><br />
<br />
[https://github.com/xbmc/xbmc/blob/1a8753d5cd93890dc6a9f9d4b2ce8848066ea5d0/xbmc/pictures/PictureScalingAlgorithm.cpp#L32-L43 Available image scaling algorithms]<br />
<br />
<syntaxhighlight lang="text" enclose="div"><br />
fast_bilinear<br />
bilinear<br />
bicubic<br />
experimental<br />
nearest_neighbor<br />
averaging_area<br />
bicublin<br />
gaussian<br />
sinc<br />
lanczos<br />
bicubic_spline<br />
</syntaxhighlight><br />
<br />
== Video and music library settings ==<br />
<br />
=== playlistasfolders ===<br />
{{anchor|.3Cplaylistasfolders.3E}}<br />
In the recent releases, playlists are treated as folders. Selecting a playlist no longer plays it, but opens it, as if it were a folder.<br />
<br />
Set to false to revert to the previous behaviour. When you select a playlist, its content is added to the list of elements to be played.<br />
<br />
:{{note|This setting will not affect smart playlists, they will always show as folders.}}<br />
<br />
;Example<br />
<syntaxhighlight lang="xml" enclose="div"><br />
<playlistasfolders>true</playlistasfolders><br />
</syntaxhighlight><br />
<br />
=== playlistretries ===<br />
{{anchor|.3Cplaylistretries.3E}}<br />
The number of retries attempted if a source is offline. With this control you can alter the number of consecutive failed items before a playlist fails.<br />
<br />
Default:<br />
<syntaxhighlight lang="xml" enclose="div"><br />
<playlistretries>100</playlistretries><br />
</syntaxhighlight><br />
<br />
=== playlisttimeout ===<br />
{{anchor|.3Cplaylisttimeout.3E}}<br />
The timeout, in seconds, before item failure.<br />
<br />
Default:<br />
<syntaxhighlight lang="xml" enclose="div"><br />
<playlisttimeout>20</playlisttimeout> <br />
</syntaxhighlight><br />
<br />
=== musicdatabase/videodatabase ===<br />
{{anchor|.3Cmusicdatabase.3E/.3Cvideodatabase.3E}}<br />
{{main|MySQL}}<br />
<section begin="videodatabase" /><br />
Allows advanced customization of the default database settings for both music and video.<br />
<br />
:{{note| '''It is HIGHLY recommended that you not attempt to place an sqlite3 database outside of kodi's path. sqlite3 contains no filesystem abstraction, so this will plain break on any non-local (as far as Kodi is concerned) paths. Use this for mysql only.'''}}<br />
<br />
'''type'''<br />
: Can be either "sqlite3" or "mysql" (default: sqlite3)<br />
<br />
<br />
;host<br />
* sqlite3: defines the relative path to the database file (eg. /usr/local/kodi/databases).<br />
* mysql: defines the host of the mysql socket (eg. localhost, 192.168.0.1, etc)<br />
<br />
<br />
;port<br />
* sqlite3: silently ignored<br />
* mysql: defines the port of the mysql socket (default: 3306)<br />
<br />
<br />
;name<br />
:by default "MyVideos"+DB number will be used.<br />
* sqlite3: defines the name of the database file to read from, excluding the ".db" extension.<br />
* mysql: defines the name of the database to use<br />
<br />
<br />
;user<br />
* sqlite3: silently ignored<br />
* mysql: defines the user with privileged access to the database<br />
<br />
<br />
;pass<br />
* sqlite3: silently ignored<br />
* mysql: defines the password for the user with privileged access to the database<br />
<br />
<br />
;key<br />
: Optional SSL setting for MySQL [https://github.com/xbmc/xbmc/pull/2566]<br />
<br />
<br />
;cert<br />
: Optional SSL setting for MySQL [https://github.com/xbmc/xbmc/pull/2566]<br />
<br />
<br />
;ca<br />
: Optional SSL setting for MySQL [https://github.com/xbmc/xbmc/pull/2566]<br />
<br />
<br />
;capath<br />
: Optional SSL setting for MySQL [https://github.com/xbmc/xbmc/pull/2566]<br />
<br />
<br />
;ciphers<br />
: Optional SSL setting for MySQL [https://github.com/xbmc/xbmc/pull/2566]<br />
<br />
<br />
{{future box|1=<br />
;compression<br />
: Defaults to false. Set to "true" to enable MySQL compression protocol. Performance benefit is going to be largely dependent on the network bandwidth, latency between database and clients and on the size of the result sets. [https://github.com/xbmc/xbmc/pull/6484]<br />
: {{Note|Slower clients (such as the RPi and others) won't benefit from it as the zlib de-compression overhead is higher than the actual compression savings}}<br />
}}<br />
<br />
<br />
'''Examples:'''<br />
<br />
1) Configure a database for MySQL.<br />
:{{note| ''The videodatabase and musicdatabase tags are interchangeable here.''}}<br />
<syntaxhighlight lang="xml" enclose="div"><br />
<videodatabase><br />
<type>mysql</type><br />
<host>192.168.0.10</host><br />
<name>kodi_video</name><br />
<user>kodi</user><br />
<pass>kodi</pass><br />
</videodatabase><br />
</syntaxhighlight><br />
<br />
2) Configure a database for an sqlite database.<br />
:{{note|''The videodatabase and musicdatabase tags are interchangeable here.''}}<br />
<syntaxhighlight lang="xml" enclose="div"><br />
<musicdatabase><br />
<type>sqlite3</type><br />
<host>/usr/local/share/kodi/databases</host><br />
<name>kodi_music</name><br />
</musicdatabase><br />
</syntaxhighlight><br />
<br />
<section end="videodatabase" /><br />
<br />
=== externalplayer ===<br />
{{anchor|.3Cexternalplayer.3E}}<br />
{{see|External players}}<br />
<br />
== Music settings ==<br />
<br />
=== musicextensions ===<br />
{{anchor|.3Cmusicextensions.3E}}<br />
A list of additional file-extensions to allow ('''add''') or exclude ('''remove''') in the My Music windows.<br />
<br />
Default extensions for MUSIC:<br />
<pre><br />
.nsv .m4a .flac .aac .strm .pls .rm .mpa .wav .wma .ogg .mp3 .mp2 .m3u .mod .amf .669 .dmf .dsm .far .gdm <br />
.imf .it .m15 .med .okt .s3m .stm .sfx .ult .uni .xm .sid .ac3 .dts .cue .aif .aiff .wpl .ape .mac .mpc <br />
.mp+ .mpp .shn .zip .rar .wv .nsf .spc .gym .adplug .adx .dsp .adp .ymf .ast .afc .hps .xsp<br />
</pre><br />
<br />
Examples:<br />
<syntaxhighlight lang="xml" enclose="div"><br />
<musicextensions><br />
<add>.ex1|.ex2</add><br />
<remove>.ex3|.ex4</remove><br />
</musicextensions><br />
</syntaxhighlight><br />
<br />
=== cddbaddress ===<br />
{{anchor|.3Ccddbaddress.3E}}<br />
The address of the online CDDb database. You may set this to another freedb mirror if there is a more suitable one. <br />
<br />
Default: <br />
<syntaxhighlight lang="XML" enclose="div><br />
<cddbaddress>freedb.freedb.org</cddbaddress><br />
</syntaxhighlight><br />
<br />
=== songinfoduration ===<br />
{{anchor|.3Csonginfoduration.3E}}<br />
This controls how long the song information will remain onscreen when the song changes during visualisations. The valid range is "1" to "Indefinite (0)", in seconds. This does not include the duration of any transition effects. <br />
<br />
Default:<br />
<syntaxhighlight lang="xml" enclose="div"><br />
<songinfoduration>10</songinfoduration><br />
</syntaxhighlight><br />
<br />
=== musicfilenamefilters ===<br />
{{anchor|.3Cmusicfilenamefilters.3E}}<br />
Contains filters to match music information (artist, title etc.) from a tag-less music filename. The first <filter> to match completely is used. Matched items include:<br />
<br />
<pre><br />
%A - Artist<br />
%T - Title<br />
%B - Album<br />
%N - Track number<br />
%S - Part of set (disk number)<br />
%D - Duration<br />
%G - Genre<br />
%Y - Year<br />
%R - Rating<br />
</pre><br />
<br />
Example:<br />
<syntaxhighlight lang="xml" enclose="div"><br />
<musicfilenamefilters><br />
<filter>%A - %T</filter><br />
</musicfilenamefilters><br />
</syntaxhighlight><br />
<br />
=== musiclibrary ===<br />
{{anchor|.3Cmusiclibrary.3E}}<br />
Options specific to the Music Library<br />
<br />
<syntaxhighlight lang="xml" enclose="div"><br />
<musiclibrary><br />
<hideallitems>true</hideallitems> <!-- removes the "*All" items from the music library --> <!-- This will be replaced in v15 with a GUI option. --><br />
<allitemsonbottom>true</allitemsonbottom> <!-- sorts the "*All" items at the bottom of the list when in Ascending order --><br />
<backgroundupdate>true</backgroundupdate> <!-- set to hide the music scanner dialog from the gui --><br />
<recentlyaddeditems>35</recentlyaddeditems> <!-- number of recently added items. Defaults to 25 --><br />
<albumssortbyartistthenyear>true</albumssortbyartistthenyear> <!-- at an albums listing, when you sort by artist, secondary sort will be year. --><br />
<albumformat>%B - %Y</albumformat> <!-- album label template, default is "%B" --><br />
<albumformatright>%A</albumformatright> <!-- album label template for right column, default is "%A" --><br />
<prioritiseapetags>true</prioritiseapetags> <!-- prioritise APEv2 tags over ID3v1/2 tags, default is false. --><br />
<itemseparator> / </itemseparator> <!-- separator used for multiple artists/genres in tags. Note, this is *space* *slash* *space* --><br />
</musiclibrary><br />
</syntaxhighlight><br />
<br />
=== karaoke ===<br />
{{anchor|.3Ckaraoke.3E}}<br />
{{Main|Karaoke}}<section begin="karaoke" /><br />
<syntaxhighlight lang="xml" enclose="div"><br />
<karaoke><br />
<!-- Music-lyrics delay for CDG format lyrics in SECONDS. Floating number, may be negative. --><br />
<syncdelaycdg>0.0</syncdelaycdg><br />
<!-- Music-lyrics delay for LRC format lyrics in 1/10 seconds. Floating number, may be negative. --><br />
<syncdelaylrc>0.0</syncdelaylrc><br />
<!-- If set to true, when the songs are added to the library, Kodi will automatically replace the song genre by "Karaoke"<br />
if the song has associated lyrics. Default is false. --><br />
<alwaysreplacegenre>false</alwaysreplacegenre><br />
<!-- If set to true, when the music-lyrics delay was modified while playing using subtitle delay buttons, the delay value<br />
for this song will be stored, and restored when the song is played next time. Default is true. --><br />
<storedelay>true</storedelay><br />
<!-- When karaoke songs are added to the library during scans, an autoincrement number is automatically assigned<br />
to each song, starting from the value specified below. Default starts from 1. --><br />
<autoassignstartfrom>1</autoassignstartfrom><br />
<!-- If set to true (default), the background for CDG songs is always empty (plain color) no matter what setting is set in <br />
defaultbackground below. When setting this to false, then one can see through the background and see the video or<br />
visualization.--><br />
<nocdgbackground>true</nocdgbackground><br />
<!-- Sets default background mode. Type could be "none", "vis" for visualisation, "image" or "video".<br />
For image/video types the "path" parameter should specify the image or video file to play. --><br />
<defaultbackground type="video" path="special://masterprofile/karaokevideobg.avi"/><br />
<!-- If non-zero, specifies the time in seconds left before the end of the current song when a window will pop up informing you<br />
about the next played song. The window does not pop up if there is no next song, or it is not a karaoke song --><br />
<nextsongpopuptime>0.0</nextsongpopuptime><br />
</karaoke><br />
</syntaxhighlight><br />
<section end="karaoke" /><br />
<br />
== Photos settings ==<br />
<br />
=== pictureextensions ===<br />
{{anchor|.3Cpictureextensions.3E}}<br />
A list of additional file-extensions to allow ('''add''') or exclude ('''remove''') in the My Pictures window.<br />
<br />
Default extensions for PICTURES:<br />
<pre><br />
.png .jpg .jpeg .bmp .gif .ico .tif .tiff .tga .pcx .cbz .zip .cbr .rar .m3u<br />
</pre><br />
<br />
Examples:<br />
<syntaxhighlight lang="xml" enclose="div"><br />
<pictureextensions><br />
<add>.ex1|.ex2</add><br />
<remove>.ex3|.ex4</remove><br />
</pictureextensions><br />
</syntaxhighlight><br />
<br />
=== pictureexcludes ===<br />
{{anchor|.3Cpictureexcludes.3E}}<br />
Matches filenames or folders which should be excluded from being displayed in My Pictures using a list of ''[[Regular Expression (RegEx) Tutorial|Regular Expressions]]''<br />
<br />
<syntaxhighlight lang="xml" enclose="div"><br />
<pictureexcludes> <!-- Regular expressions that if evaluated to true won't be displayed in My Pictures --><br />
<regexp>small</regexp><br />
<regexp>[-\._ ](sample|trailer)[-\._ ]</regexp><br />
</pictureexcludes><br />
</syntaxhighlight><br />
<br />
=== slideshow ===<br />
{{anchor|.3Cslideshow.3E}}<br />
<syntaxhighlight lang="xml" enclose="div"><br />
<slideshow><br />
<!-- Amount to pan images as a percentage of the screen --><br />
<panamount>2.5</panamount><br />
<!-- Amount to zoom images as a percentage of the screen --><br />
<zoomamount>5.0</zoomamount><br />
<!-- Amount to compensate (zoom) images to attempt to reduce black bars. --><br />
<!-- Results in cropping of the longer length of the image in order to reduce the black bars on the shorter length of the image. --><br />
<!-- Defaults to 20. --><br />
<blackbarcompensation>20</blackbarcompensation> <br />
</slideshow><br />
</syntaxhighlight><br />
<br />
== Network settings ==<br />
<br />
=== samba ===<br />
{{anchor|.3Csamba.3E}}<br />
<syntaxhighlight lang="xml" enclose="div"><br />
<samba><br />
<doscodepage></doscodepage> <!-- code page to use for filenames --><br />
<clienttimeout>10</clienttimeout> <!-- timeout (in seconds) --><br />
<statfiles>true</statfiles> <!-- Set to false to disable smb stat() on files to speed up listings of large directories (over slow links) --><br />
</samba><br />
</syntaxhighlight><br />
<br />
=== hosts ===<br />
{{anchor|.3Cfhosts.3E}}<br />
Static dns entries which take precedence over your dns server.<br />
<syntaxhighlight lang="xml" enclose="div"><br />
<hosts><br />
<entry name="HOSTNAME">IPADDRESS</entry><br />
</hosts><br />
</syntaxhighlight><br />
<br />
=== network ===<br />
{{anchor|.3Cnetwork.3E}}<br />
{{see also|HOW-TO:Modify the cache}}<br />
<syntaxhighlight lang="xml" enclose="div"><br />
<network><br />
<curlclienttimeout>10</curlclienttimeout> <!-- Timeout in seconds for libcurl (http/ftp) connections --><br />
<curllowspeedtime>5</curllowspeedtime> <!-- Time in seconds for libcurl to consider a connection lowspeed --><br />
<httpproxyusername></httpproxyusername> <!-- username for Basic Proxy Authentication --><br />
<httpproxypassword></httpproxypassword> <!-- password for Basic Proxy Authentication --><br />
<cachemembuffersize>20971520</cachemembuffersize> <!-- number of bytes used for buffering streams ahead in memory <br />
Kodi will not buffer ahead more than this. WARNING: for the bytes set here, Kodi will consume 3x the amount of RAM<br />
When set to 0 the cache will be written to disk instead of RAM, as of v12 Frodo --><br />
<buffermode>0</buffermode> <!-- Choose what to buffer:<br />
0) Buffer all internet filesystems (like "2" but additionally also ftp, webdav, etc.) (default)<br />
1) Buffer all filesystems (including local)<br />
2) Only buffer true internet filesystems (streams) (http, etc.)<br />
3) No buffer --><br />
<readbufferfactor>1.0</readbufferfactor> <!-- this factor determines the max readrate in terms of readbufferfactor * avg bitrate of a video file. <br />
This can help on bad connections to keep the cache filled. It will also greatly speed up buffering. Default value 1.0. --><br />
</network><br />
</syntaxhighlight><br />
<br />
=== tuxbox ===<br />
{{anchor|.3Ctuxbox.3E}}<br />
<syntaxhighlight lang="xml" enclose="div"><br />
<tuxbox><br />
<!-- "audiochannelselection"; default is 'false', 'true' will popup the audio channel selection if<br />
there is more then one audio stream !--><br />
<audiochannelselection>false</audiochannelselection><br />
<!-- "submenuselection"; default is 'false', 'true' will popup the Submenu selection !--><br />
<submenuselection>false</submenuselection><br />
<!-- "defaultrootmenu"; MODE: 0 = TV (Default), 1 = Radio, 2 = Data, 3 = Movies, 4 = Root !--><br />
<defaultrootmenu>0</defaultrootmenu><br />
<!-- "defaultsubmenu"; 1=Services 2=Satellites 3=Providers 4=Bouquets (default) !--><br />
<defaultsubmenu>4</defaultsubmenu><br />
<!-- "pictureicon"; default is 'true', will use the Picture Icons from folder /UserData/PictureIcon/ !--><br />
<pictureicon>true</pictureicon><br />
<!-- "epgrequesttime"; default is '10', 0-3600, defines the time in seconds between epg queries, some tuxbox<br />
devices need longer to response (Minimum: 1, Maximum: 3600) !--><br />
<epgrequesttime>10</epgrequesttime><br />
<!-- "zapwaittime"; default is '0' (0 = OFF), defines the time in seconds to wait for a valid PMT after the<br />
zaping was send (Minimum: 0, Maximum: 120) !--><br />
<zapwaittime>0</zapwaittime> <br />
</tuxbox><br />
</syntaxhighlight><br />
<br />
=== airtunesport ===<br />
{{anchor|.3Cairtunesport.3E}}<section begin="airtunesport" /><br />
This overwrites the defalt listening port of the AirTunes server (announced via zeroconf).<br />
<section end="airtunesport" /><br />
<br />
=== airplayport ===<br />
{{anchor|.3Cairplayport.3E}}<section begin="airplayport" /><br />
This overwrites the default listening port of the AirPlay server (announced via zeroconf).<br />
<section end="airplayport" /><br />
<br />
== File system settings ==<br />
<br />
=== packagefoldersize ===<br />
<section begin="packagefoldersize" /><br />
{{anchor|.3Cpackagefoldersize.3E}}<br />
{{xml setting<br />
| tag name = packagefoldersize<br />
| option type = numerical<br />
| option values = <br />
| default values = 200<br />
| platform = all<br />
| XBMC version = 12<br />
| description = The amount (in megabytes) of add-on zip packages saved from previous add-on installs. These packages are mainly used for the [[add-on]] rollback feature. Increasing the size should increase the amount of past versions saved.<br />
| example = Example: <syntaxhighlight lang="xml" enclose="div"><packagefoldersize>200</packagefoldersize> <!-- this example would keep up to 200MB of add-on packages. --></syntaxhighlight><br />
}}<br />
<section end="packagefoldersize" /><br />
=== detectasudf ===<br />
{{anchor|.3Cdetectasudf.3E}}<br />
Set to true if you wish to detect joint ISO9660/UDF disks as UDF. <br />
<br />
Default: False<br />
<br />
=== pathsubstitution ===<br />
{{anchor|.3Cpathsubstitution.3E}}<br />
{{main|Path substitution}}<br />
Path substitutions are for use for redirecting file paths. These are processed in order, and are useful for substituting an absolute path on a PC with a path suitable for Kodi to handle. <br />
<br />
Default: No path substitutions defined. <br />
<br />
Example:<br />
<syntaxhighlight lang="xml" enclose="div"><br />
<pathsubstitution><br />
<substitute><br />
<from>G:\dvds\</from><br />
<to>smb://somecomputer/g-share/dvds/</to> <!-- Note the difference between the usage of forward and backslashes --><br />
</substitute><br />
</pathsubstitution><br />
</syntaxhighlight><br />
<br />
== Input control settings ==<br />
<br />
=== remotedelay ===<br />
{{anchor|.3Cremotedelay.3E}}<br />
The repeat delay for a LIRC remote control. A delay value between 1 and 20 before a remote button starts repeating on a long keypress (i.e. continuously sending button pushes while it's held down). <br />
<br />
Default: 3<br />
<syntaxhighlight lang="xml" enclose="div"><br />
<remotedelay>10</remotedelay><br />
</syntaxhighlight><br />
<br />
=== remoterepeat ===<br />
{{anchor|.3Cremoterepeat.3E}}<br />
This used to adjust the amount of time in milliseconds between repeated keystrokes. Used to prevent key-bounce, in other words prevents Kodi (lirc?) seeing one key press as multiple key presses with certain remotes.<br />
<br />
<syntaxhighlight lang="xml" enclose="div"><br />
<remoterepeat>800</remoterepeat><br />
</syntaxhighlight><br />
<br />
=== controllerdeadzone ===<br />
{{anchor|.3Ccontrollerdeadzone.3E}}<br />
The controller deadzone is the region of movement around the center which is not recognized by the device. Because joysticks can have noise (report motion when still) and bias (report an offset when centered), spurious events can be reported even though the controller isn't being touched. If you notice these kinds of events, you most likely need to increase your controller's deadzone (both axes recommended). The values range from 0.0 (no deadzone, Kodi will see all input your controller is capable of registering) to 1.0 (it will ignore all input inside of the device's physical limits).<br />
<br />
<syntaxhighlight lang="xml" enclose="div"><br />
<controllerdeadzone>0.2</controllerdeadzone><br />
</syntaxhighlight><br />
<br />
=== enablemultimediakeys ===<br />
{{anchor|.3Cenablemultimediakeys.3E}}<br />
This setting only has any effect on Windows versions of Kodi, and only applies to builds from 28th May 2011 onwards.<br />
In Windows the multimedia keys generate a WM_APPCOMMAND message in addition the keypress. Kodi processes both keypresses and the WM_APPCOMMAND messages, and the end result would be that the command is executed twice. To avoid this, by default multimedia keypresses are disabled. Although it should rarely be necessary, the enablemultimediakeys setting allows you to enable the multimedia keys.<br />
<br />
Example:<br />
<syntaxhighlight lang="xml" enclose="div"><br />
<enablemultimediakeys>true</enablemultimediakeys><br />
</syntaxhighlight><br />
<br />
<br />
=== seeksteps ===<br />
{{Main|Skip steps}}<br />
{{future box|1=<br />
This setting changes which increments are available in the settings GUI for additive seeking. Note that <code><seeksteps></code> is not used to actually choose which seek steps are enabled.<br />
<br />
'''Default:'''<br />
<syntaxhighlight lang="xml" enclose="div"><br />
<seeksteps>7, 15, 30, 60, 180, 300, 600, 900, 1800</seeksteps><br />
</syntaxhighlight><br />
}}<br />
<br />
{{editor note|the defaults need to be updated for seeksteps.}}<br />
<br />
== Other interface settings ==<br />
<br />
=== window ===<br />
{{anchor|.3Cwindow.3E}}<br />
This allows you to manually set the default size of Kodi's windowed mode. If you resize the window, it will return to the set size when restarting.<br />
<br />
WIDTH and HEIGHT are the values for each dimension, in pixels.<br />
<br />
<syntaxhighlight lang="xml" enclose="div"><br />
<window><width>WIDTH</width><height>HEIGHT</height></window><br />
</syntaxhighlight><br />
<br />
=== allowd3d9ex ===<br />
{{anchor|.3Callowd3d9ex.3E}}<br />
Applies only to Windows Vista and up. Values: true/false. Allows Kodi to use Direct3D 9Ex, which is a bit more stable and robust than Direct3D 9.<br />
<br />
Default:<br />
<syntaxhighlight lang="xml" enclose="div"><br />
<allowd3d9ex>true</allowd3d9ex><br />
</syntaxhighlight><br />
<br />
=== restrictcapsmask ===<br />
{{anchor|.3Crestrictcapsmask.3E}}<br />
Windows only. A bitmask to prevent Kodi from using detected texture capabilities of the GPU. This helps work around buggy hardware/drivers.<br />
<br />
1: prevent the use of compressed textures (DXT1, DXT3, DXT5)<br />
2: prevent the use of non-power-of-two dimensions for textures<br />
4: prevent the use of compressed textures with non-power-of-two dimensions.<br />
<br />
<syntaxhighlight lang="xml" enclose="div"><br />
<restrictcapsmask>0</restrictcapsmask><br />
</syntaxhighlight><br />
<br />
=== forced3d9ex ===<br />
{{anchor|.3Cforced3d9ex.3E}}<br />
Windows only: Kodi attempts to detect drivers released for a version earlier than Vista, to avoid using advanced features which are often not emulated correctly. The detection may be incorrect and this setting allows forcing the using of D3D9Ex.<br />
<br />
<syntaxhighlight lang="xml" enclose="div"><br />
<forced3d9ex>false</forced3d9ex><br />
</syntaxhighlight><br />
<br />
=== algorithmdirtyregions ===<br />
{{anchor|.3Calgorithmdirtyregions.3E}}<br />
{{see also|HOW-TO:Modify dirty regions}}<br />
<section begin="algorithmdirtyregions" /> {{note|Some GPU/hardware configurations will have some minor issues (such as a visual "flicker"). For those situations try mode 2 or use the default (mode 3, which requires no advancedsetting). Almost all ARM-based devices (such as [[Android]]) willl likely have flickering issues.}}<br />
<br />
Enable dirty-region processing. Dirty regions are any parts of the screen that have changed since the last frame. By not re-rendering what hasn't changed the GUI can be sped up. Because all GPUs work differently, only Mode 3, combined with nofliptimeout=0, is guaranteed to work for everyone without flickering issues. This mode will reduce CPU/GPU usage, but will not increase GUI speed.<br />
<br />
{| class="prettytable"<br />
! value !! result !! description<br />
|-<br />
! 0<br />
| Off<br />
| The entire viewport is always rendered.<br />
|-<br />
! 1<br />
|Union<br />
|All dirty regions are grouped into the smallest possible rectangle. This is typically the fastest mode for slower GPUs due to only making one pass.<br />
|-<br />
! 2<br />
| {{nowrap|Cost reduction}}<br />
| Each dirty region is presented separately, in as many passes as there are regions.<br />
|-<br />
! 3<br />
| {{nowrap|Whole Screen}}<br />
| The entire screen is rendered if there are any dirty regions. This, combined with nofliptimeout is a safe default for drivers that clear buffer contents (manifests as blinking or vibrating images). '''Default'''<br />
|}<section end="algorithmdirtyregions" /><br />
<br />
Example:<br />
<syntaxhighlight lang="xml" enclose="div"><br />
<gui> <br />
<algorithmdirtyregions>1</algorithmdirtyregions><br />
</gui><br />
</syntaxhighlight><br />
<br />
=== nofliptimeout ===<br />
{{anchor|.3Cnofliptimeout.3E}}<br />
{{see also|HOW-TO:Modify dirty regions}}<br />
<section begin="nofliptimeout" />Specifies the timeout in milliseconds after which Kodi will not flip the graphics buffers anymore when nothing has been rendered, this lowers both CPU and GPU usage. Sometimes adjusting this value can help prevent flickering.<br />
<br />
* -1: disabled <br />
* 0 or higher: timeout in milliseconds '''(0 is default)'''<br />
<section end="nofliptimeout" /><br />
Example: <br />
<syntaxhighlight lang="xml" enclose="div"><br />
<gui> <br />
<nofliptimeout>1000</nofliptimeout><br />
</gui><br />
</syntaxhighlight><br />
<br />
=== visualizedirtyregions ===<br />
{{anchor|.3Cvisualizedirtyregions.3E}}<br />
{{see also|HOW-TO:Modify dirty regions}}<br />
<section begin="visualizedirtyregions" />Enable dirty-region visualization. Paints a rectangle over marked controls.<br />
<br />
* true: on<br />
* false: off '''(Default)'''<br />
<br />
{{note|This is only a development mode and isn't of use to normal users.}}<br />
<section end="visualizedirtyregions" /><br />
Example: <br />
<syntaxhighlight lang="xml" enclose="div"><br />
<gui> <br />
<visualizedirtyregions>true</visualizedirtyregions><br />
</gui><br />
</syntaxhighlight><br />
<br />
=== showexitbutton ===<br />
{{anchor|.3Cshowexitbutton.3E}}<br />
Setting to hide the exit button, useful for people running appliance based setup's where exit would only confuse/complicate the user. Modifiable via the advancedsettings.xml by setting showexitbutton to false, default is true (show)<br />
<br />
Example:<br />
<syntaxhighlight lang="xml" enclose="div"><br />
<showexitbutton>true</showexitbutton><br />
</syntaxhighlight><br />
<br />
=== fullscreen ===<br />
{{anchor|.3Cfullscreen.3E}}<br />
Starts Kodi in full screen (check resolutions!).<br />
<br />
<syntaxhighlight lang="xml" enclose="div"><br />
<fullscreen>false</fullscreen><br />
</syntaxhighlight><br />
<br />
=== splash ===<br />
{{anchor|.3Csplash.3E}}<br />
Set to false if you wish to disable the startup splash image. Defaults to true.<br />
<br />
<syntaxhighlight lang="xml" enclose="div"><br />
<splash>true</splash><br />
</syntaxhighlight><br />
<br />
=== cputempcommand ===<br />
{{anchor|.3Ccputempcommand.3E}}<br />
Provide a shell command Kodi will use to get CPU temperature. It should print out only "[temp as integer] [scale as one of "CcFf"]".<br /><br />
;<u>For Nvidia and Raspberry Pi</u><br />
<syntaxhighlight lang="xml" enclose="div"><br />
<cputempcommand>sed -e 's/\([0-9]*\)[0-9]\{3\}.*/\1 C/' /sys/class/thermal/thermal_zone0/temp</cputempcommand><br />
</syntaxhighlight><br />
or<br />
<syntaxhighlight lang="xml" enclose="div"><br />
<cputempcommand>echo "$(sensors -u | tail -n64 | grep temp1_input | awk '{print $2 }' |awk '{printf("%d\n",$1 + 0.5);}') C"</cputempcommand><br />
</syntaxhighlight><br />
;<u>For ATI/AMD</u><br />
<syntaxhighlight lang="xml" enclose="div"><br />
<cputempcommand>sensors|sed -ne "s/temp1: \+[-+]\([0-9]\+\).*/\1 C/p"</cputempcommand><br />
</syntaxhighlight><br />
<br />
=== gputempcommand ===<br />
{{anchor|.3Cgputempcommand.3E}}<br />
Provide a shell command Kodi will use to get GPU temperature. It should print out only "[temp as integer] [scale as one of "CcFf"]".<br /><br />
;<u>For Nvidia</u><br />
<syntaxhighlight lang="xml" enclose="div"><br />
<gputempcommand>echo "$(nvidia-settings -tq gpuCoreTemp) C"</gputempcommand><br />
</syntaxhighlight><br />
or<br />
<syntaxhighlight lang="xml" enclose="div"><br />
<gputempcommand>echo "$(nvidia-smi -q -d TEMPERATURE | grep Gpu | cut -c35-36) C"</gputempcommand><br />
</syntaxhighlight><br />
;<u>For ATI/AMD</u><br />
<syntaxhighlight lang="xml" enclose="div"><br />
<gputempcommand>/usr/bin/aticonfig --od-gettemperature | grep Temperature | cut -f 2 -d "-" | cut -f 1 -d "." | sed -e "s, ,," | sed 's/$/ C/'</gputempcommand><br />
</syntaxhighlight><br />
<br />
;<u>For Raspberry Pi</u><br />
<syntaxhighlight lang="xml" enclose="div"><br />
<gputempcommand>/opt/vc/bin/vcgencmd measure_temp | sed -e "s/temp=//" -e "s/\..*'/ /"</gputempcommand><br />
</syntaxhighlight><br />
<br />
=== glrectanglehack ===<br />
{{anchor|.3Cglrectanglehack.3E}}<br />
Problems with ghosting or videos which are only played back in the left upper quarter? The following ATI hack may solve it.<br />
<syntaxhighlight lang="xml" enclose="div"><br />
<glrectanglehack>yes</glrectanglehack><br />
</syntaxhighlight><br />
<br />
=== alwaysontop ===<br />
{{anchor|.3Calwaysontop.3E}}<br />
Added in XBMC v9.11 (Windows OS only). Keeps Kodi always on top when windowed.<br />
<syntaxhighlight lang="xml" enclose="div"><br />
<alwaysontop>yes</alwaysontop><br />
</syntaxhighlight><br />
<br />
Alternate code.<br />
<syntaxhighlight lang="xml" enclose="div"><br />
<videoscreen><br />
<fakefullscreen>false</fakefullscreen><br />
</videoscreen><br />
</syntaxhighlight><br />
<br />
== Recently removed tags ==<br />
* {{anchor|.3Cthumbsize.3E}}'''<thumbsize>''' - replaced by <[[#imageres|imageres]]> in v12 Frodo<br />
* {{anchor|.3Cfanartheight.3E}}'''<fanartheight>''' - replaced by <[[#fanartres|fanartres]]> in v12 Frodo<br />
* {{anchor|.3Cdvdthumbs.3E}}'''<dvdthumbs>''' - removed in v12 Frodo<br />
* {{anchor|.3Cbusydialogdelayms.3E}}'''<busydialogdelayms>''' - removed in v12 Frodo<br />
* {{anchor|.3Cbginfoloadermaxthreads.3E}}'''<bginfoloadermaxthreads>''' - removed in v13 Gotham<br />
* '''<showepginfoonselect>''' - replaced by a GUI setting in v13 Gotham<br />
* '''<resample>''', '''<forceDirectSound>''', '''<audiophile>''', '''<audiosinkbufferdurationmsec>''', '''<allowtranscode44100>''', and '''<streamsilence>''' - These were various sub-tags for <audio> that were removed in v13 Gotham and either replaced by GUI settings or were no longer needed.<br />
* {{anchor|.3Cenableairtunesdebuglog.3E}}'''<enableairtunesdebuglog>''' - replaced by a GUI option in v14 Helix<br />
* '''<videoDisableHi10pMultithreading>''' - renamed to <disableswmultithreading> in v14 Helix<br />
* '''<hideallitems>''' - For both the <code><videolibrary></code> and <code><musiclibrary></code> sections, this is replaced by a GUI option in v15 Isengard<br />
* '''<SmallStepBackSeconds>''' - In v15 the <code>SmallStepBack</code> [[action ID]] has been replaced by <code>seek(-7)</code> in default keymaps. See '''[[skip steps]]''' for details. When the original <code>SmallStepBack</code> action ID is used it defaults to the first backwards [[skip steps|additive seeking value]].<br />
* '''<timeseekforward>/<timeseekbackward>''' - In v15 these tags are replaced by GUI options via [[skip steps|additive seeking]], which is configured in the GUI. See '''[[skip steps]]''' for details.<br />
<br />
== guisettings.xml settings ==<br />
You can also define the settings normally defined in the GUI (and stored in guisettings.xml) in advancedsettings.xml. Most guisettings.xml settings defined in advancedsettings.xml will override the guisettings.xml values, and the settings will be removed completely from the interface.<br />
<br />
The easiest way to include a guisettings.xml setting is to first change the setting in the interface to the value that you want, and then open the '''[[userdata]]/guisettings.xml''' file and find the XML entry that corresponds to that setting.<br />
<br />
Then just add that entry to the advancedsettings.xml file.<br />
<br />
For instance, to set the Font Character Set (found in the appearance setting, in the Look and Feel section), you'd open up guisettings.xml and find:<br />
<br />
<syntaxhighlight lang="xml" enclose="div"><br />
<lookandfeel><br />
<charset>Hebrew (Windows)</charset><br />
</lookandfeel><br />
</syntaxhighlight><br />
<br />
Simply take that entry and place it in advancedsettings.xml. The option in Kodi's interface for the character set will then no longer be visible, and Kodi will always use the Hebrew (Windows) character set.<br />
<br />
{{Helix updated}}<br />
{{DISPLAYTITLE:advancedsettings.xml}}<br />
<br />
[[Category:Settings]]<br />
[[Category:Manual]]<br />
[[Category:Advanced topics]]</div>UNiversalhttps://kodi.wiki/index.php?title=Advancedsettings.xml&diff=98585Advancedsettings.xml2015-07-14T07:31:04Z<p>UNiversal: /* useddsfanart */ <imagescalingalgorithm></p>
<hr />
<div>{{TOC right}}{{mininav|[[Settings]]|page=advancedsettings.xml}}<br />
{{bigger|{{note|'''The advancedsettings.xml file does not exist by default. You have to create it first!'''}} }}<br />
<br />
<section begin="intro" />The [[advancedsettings.xml]] file, which does not exist by default, can be created by a user in their '''[[userdata folder]]'''.<br />
<br />
This file is used for advanced settings and options that do not have GUI controls inside of {{kodi}}. Some settings are experimental or very rarely set, so they can only be used via the advancedsettings.xml file. The file is simply a plain text file and can be edited by various text editors, so long as the name is "advancedsettings.xml". These advanced settings can be used to tweak various things such as episode naming patterns, special network ports, special behaviors, and more.<section end="intro" /><br />
<br />
The following page will describe the structure of the advancedsettings.xml file and the various individual settings.<br />
<br />
{{note|<br />
# All XML tags must be lowercase. The start and end of the advancedsettings.xml file must have the <advancedsettings> and </advancedsettings> tags.<br />
# Kodi will only read the advancedsettings.xml file when it starts up. If you make changes while it is running then you must restart Kodi.<br />
# For some Windows versions, Kodi has two <code>\userdata\</code> folders. The correct one to put the advancedsettings.xml file in is not the one in Program Files, but in <code>%appdata%\Kodi\userdata\.</code>}}<br />
<br />
== Layout ==<br />
<br />
The layout of <code>advancedsettings.xml</code> is as follows:<br />
<br />
<syntaxhighlight lang="xml" enclose="div"><br />
<advancedsettings><br />
<setting>value</setting><br />
...<br />
<setting>value</setting><br />
</advancedsettings><br />
</syntaxhighlight><br />
<br />
where "setting" gives the name of the setting, and "value" gives it's value.<br />
<br />
A list of the available "setting" strings and their values is given below.<br />
<br />
= List of available settings =<br />
<br />
== Troubleshooting settings ==<br />
<br />
=== loglevel ===<br />
{{Anchor|.3Cloglevel.3E}}<br />
{{see also|debug log}}<br />
<section begin="loglevel" /><br />
{{xml setting<br />
| tag name = loglevel<br />
| tag attribute = hide<br />
| tag attribute values = <br />
{{option values<br />
| value1= true | value1 description= Hides "enable debugging" guisetting.<br />
| value2= false | value2 description= "enable debugging" guisetting will switch between min(loglevel, 0) and max(loglevel, 2) for off and on respectively. '''(Default)'''<br />
}}<br />
| tag attribute default values = true<br />
| option values = <br />
{{option values<br />
| value1= -1 | value1 description= No logging, suppresses all log output<br />
| value2= 0 | value2 description= Normal logging, only logging errors '''(Default)'''<br />
| value3= 1 | value3 description= Debug logging ''(without showing text on screen)''<br />
| value4= 2 | value4 description= Debug logging with freemem, fps and cpu usage shown on screen<br />
| value5= 3 | value5 description= Debug logging with freemem, fps and cpu usage and full smb logging<br />
}}<br />
| default values = 0<br />
| description = <br />
The logging level that Kodi will use to log errors and information. The "hide" attribute is optional.<br />
| example =<br />
Example:<br />
<syntaxhighlight lang="xml" enclose="div"><br />
<loglevel hide="false">1</loglevel><br />
</syntaxhighlight><br />
<br />
<br /><br />
<br />
{{Note| If debugging is switched on in the GUI, loglevel will be set to 2 (''log to both file and on-screen information''); this will over-ride any <code>advancedsettings.xml</code> setting.}}<br /><br />
<br />
{{Note| If debugging is switched on in the GUI when Kodi is shut down, then it will be automatically be re-enabled at level 2 when it is re-started. This is true even if 'hide' is subsequently set to 'true' - in other words, if you enable it in the GUI and then hide the GUI toggle, it will stay on level 2 irrespective of what you subsequently set in <code>advancedsettings.xml</code>.}}<br /><br />
}}<br />
<section end="loglevel" /><br />
<br />
=== jsonrpc ===<br />
{{Anchor|.3Cjsonrpc.3E}}<br />
To make it easier for developers using the [[JSON RPC]] API in their (third party) applications to debug during development the json output of Kodi can be prettified by setting '''compactoutput''' to '''false'''. Default json output mode is a compact print which does not contain any unnecessary whitespaces and therefore is difficult to read for humans.<br />
Furthermore using the '''tcpport''' setting it is possible to change the default TCP port used by Kodi for JSON RPC (which is 9090) to any other valid port.<br />
<br />
Example:<br />
<syntaxhighlight lang="xml" enclose="div"><br />
<jsonrpc><br />
<compactoutput>false</compactoutput><br />
<tcpport>9999</tcpport><br />
</jsonrpc><br />
</syntaxhighlight><br />
<br />
=== other - enableairtunesdebuglog ===<br />
{{see|#enableairtunesdebuglog}}<br />
<br />
== Audio/video playback settings ==<br />
<br />
=== skiploopfilter ===<br />
{{anchor|.3Cskiploopfilter.3E}}<br />
The amount of the loop filter to skip on h264 decoding. This can help the performance of slower machines when decoding h264 content. Values, in decreasing CPU usage (and decreasing quality)<br />
* -16 None<br />
* 0 Skip only empty frames (default)<br />
* 8 Skip non-reference frames (default on ATV)<br />
* 16 Skip bi-dir frames<br />
* 32 Skip all non-key frames<br />
* 48 Skip all frames<br />
Example:<br />
<syntaxhighlight lang="xml" enclose="div"><br />
<skiploopfilter>8</skiploopfilter><br />
</syntaxhighlight><br />
<br />
=== video ===<br />
{{anchor|.3Cvideo.3E}}<br />
{{see also|HOW-TO:Modify automatic watch and resume points|HOW-TO:Modify time seeking}}<br />
<syntaxhighlight lang="xml" enclose="div"><br />
<video><br />
<subsdelayrange>10</subsdelayrange> <!-- Delay range for subtitles, in seconds. --><br />
<audiodelayrange>10</audiodelayrange> <!-- Delay range for audio/video sync, in seconds. --><br />
<br />
<smallstepbackseconds>7</smallstepbackseconds> <!-- Length of the small skip back when playing a video --> <!-- Will be replaced by a GUI option in v15 --><br />
<usetimeseeking>true</usetimeseeking> <!-- Whether to use time based or percentage based seeking. --><br />
<timeseekforward>30</timeseekforward> <!-- Time to seek forward in seconds when doing a short seek. Defaults to 30. --> <!-- Deprecated. Will be replaced by a GUI option in v15. Note: Need to double check if it will actually be removed? --><br />
<timeseekbackward>-30</timeseekbackward> <!-- Time to seek backward in seconds when doing a short seek. Defaults to -30. --> <!-- Deprecated. Will be replaced by a GUI option in v15. Note: Need to double check if it will actually be removed? --><br />
<timeseekforwardbig>600</timeseekforwardbig> <!-- Time to seek forward in seconds when doing a long seek. Defaults to 600 (10 minutes). --><br />
<timeseekbackwardbig>-600</timeseekbackwardbig> <!-- Time to seek forward in seconds when doing a long seek. Defaults to -600 (10 minutes). --><br />
<percentseekforward>2</percentseekforward> <!-- Amount to seek forward as a percentage, when doing a short seek. Defaults to 2. --><br />
<percentseekbackward>-2</percentseekbackward> <!-- Amount to seek backward as a percentage, when doing a short seek. Defaults to -2. --><br />
<percentseekforwardbig>10</percentseekforwardbig> <!-- Amount to seek forward as a percentage, when doing a long seek. Defaults to 10. --><br />
<percentseekbackwardbig>-10</percentseekbackwardbig> <!-- Amount to seek forward as a percentage, when doing a long seek. Defaults to -10. --><br />
<br />
<blackbarcolour>1</blackbarcolour> <!-- colour of the black bars (0->255), (black->white) on videos. --><br />
<br />
<fullscreenonmoviestart>true</fullscreenonmoviestart> <!-- Whether to go to fullscreen or not when starting a movie. Defaults to true. --><br />
<br />
<defaultplayer>dvdplayer</defaultplayer> <!-- Set the default video player: dvdplayer or extplayer. --><br />
<br />
<excludefromscan> <!-- Regular expressions that if evaluated to true won't be added to library. --><br />
<regexp>[-\._ ](sample|trailer)[-\._ ]</regexp><br />
</excludefromscan><br />
<excludefromlisting> <!-- Regular expressions that if evaluated to true won't be displayed in Files View --><br />
<regexp>[-\._ ](sample|trailer)[-\._ ]</regexp><br />
</excludefromlisting><br />
<br />
<playcountminimumpercent>90</playcountminimumpercent> <!--Minimum percentage that has to be played before it is marked as watched. Set to 101 to never auto-mark items as watched --><br />
<ignoresecondsatstart>180</ignoresecondsatstart> <!-- Number of seconds to ignore at video start after which a resume point is created --><br />
<ignorepercentatend>8</ignorepercentatend> <!-- percentage of video to ignore at the end. If you stop watching the video here no resume point is created. Set to 101 to never save a resume point. The video is already marked as watched at 90%, see above. --><br />
<br />
<forcevaapienabled>true</forcevaapienabled> <!-- VAAPI is only tested on intel hardware. This flag helps wrapper developers and fglrx users to easily test current VAAPI state on their hardware. Default is false. Please report crashes directly to your driver vendor --><br />
<br />
<vdpauscaling>true</vdpauscaling> <!-- scales with vdpau instead of opengl and turns on its HQ scaler when available, enabling this might slow down rendering and cause framedrops especially on ION systems, this setting requires a vdpau feature set C gpu--><br />
<br />
<enablehighqualityhwscalers>true</enablehighqualityhwscalers> <!-- allow turning on the spline36 and lanczos3 shader (for GL builds) --><br />
<br />
<dxvaallowhqscaling>false</dxvaallowhqscaling> <!-- enables high quality video upscaling for Windows --><br />
<br />
<ppffmpegdeinterlacing>linblenddeint</ppffmpegdeinterlacing> <!-- override the deinterlacing options passed to libpostproc --><br />
<br />
<ppffmpegpostprocessing>ha:128:7,va,dr</ppffmpegpostprocessing> <!-- override the post processing options passed to libpostproc when 'Video post-processing' is activated in GUI Videos-Settings-Playback --><br />
<autoscalemaxfps>30</autoscalemaxfps> <!-- when scaling method is set to auto, bilinear is chosen when the fps is higher than this limit, the default is 30 --><br />
<br />
<br />
<!-- Settings for when "Adjust refreshrate to match video fps" is enabled, available since r33806. --><br />
<adjustrefreshrate> <br />
<br />
<!-- "Adjust refreshrate to match video fps" will try to select the best refreshrate for the video fps but it doesn't always get it right, for example it might switch to an unsupported refreshrate. You can add overrides here to switch to a certain refreshrate based on video fps. It's possible to add as many overrides as you need. Overrides are processed in order, if the first one doesn't match the fps or no refreshrates match that override, it will try the next one until no overrides are left --><br />
<br />
<override><br />
<fps>23.976</fps> <!-- if the fps is between 23.966 and 23.986 --><br />
<refresh>60.0</refresh> <!-- switch to the first found refreshrate that is between 59.99 and 60.01 --><br />
</override><br />
<br />
<override><br />
<fpsmin>29.96</fpsmin> <!-- You can also specify the fps range yourself --><br />
<fpsmax>30.01</fpsmax><br />
<refreshmin>59.0</refreshmin> <!-- Same for the refreshrate --><br />
<refreshmax>61.0</refreshmax><br />
</override><br />
<br />
<!-- It none of the overrides match, or none of the refreshrates match any of the fps matching overrides, it will choose a fallback refreshrate. Fallbacks are process in order, if the first fallback doesn't match any refreshrate, it will try the next one until no fallbacks are left --><br />
<fallback><br />
<refresh>50.0</refresh> <!-- switch to the first found refreshrate that is between 49.99 and 50.01. --><br />
</fallback><br />
<br />
<!-- You can also specify the range for the fallback yourself --><br />
<fallback><br />
<refreshmin>49.0</refreshmin><br />
<refreshmax>51.0</refreshmax><br />
</fallback><br />
<br />
<!-- If none of the overrides match the video fps, or no refreshrates match any of the fps matching overrides, and no fallbacks are specified or no refreshrates match any fallbacks, it will automatically choose the best refreshrate (same as having no overrides and fallbacks). --><br />
</adjustrefreshrate><br />
<br />
<checkdxvacompatibility>value</checkdxvacompatibility> <!-- Advanced setting not present: let Kodi autodetect cards that support H264 profile > L4.1. Set value to false to enable DXVA no matter what. Set value to true if Kodi doesn't autodetect that the graphics card doesn't support > L4.1 --><br />
<br />
<useocclusionquery>-1</useocclusionquery> <!--Use an occlusion query when capturing videoframes, -1 means auto detect, 0 means disabled, 1 means enabled, the default is -1.--><br />
<fpsdetect>1</fpsdetect> <!-- fps detection for video playback, 0 = trust codec fps, 1 = recalculate from video timestamps with uniform spacing, 2 = recalculate from video timestamps always --><br />
<br />
<br />
<latency> <!-- Compensate display latency (video lag). Latency is given in msecs. --><br />
<br />
<delay>0</delay> <!-- Global default display latency --><br />
<br />
<!-- Override latency for given display (not video) refresh rates. When Kodi is in windowed mode, override is ignored. Multiple overrides are allowed.<br />
<br />
Syntax of an override entry:<br />
<refresh><br />
<min>, <max> refresh rate range, OR<br />
<rate> exact refresh rate<br />
<delay> display latency for the given refresh rate<br />
</refresh><br />
--><br />
<br />
<!-- Example: display has 125 msec latency at 23-24 Hz --><br />
<refresh><br />
<min>23</min><br />
<max>24</max><br />
<delay>125</delay><br />
</refresh><br />
<br />
<!-- Example: display has 50 msec latency at 50 (+/-0.01) Hz --><br />
<refresh><br />
<rate>50</rate><br />
<delay>50</delay><br />
</refresh><br />
<br />
</latency><br />
<br />
<stereoscopicregex3d>[-. _]3d[-. _]</stereoscopicregex3d> <!-- Filename triggers for 3D (stereoscopic) mode. --><br />
<stereoscopicregexsbs>[-. _]h?sbs[-. _]</stereoscopicregexsbs><br />
<stereoscopicregextab>[-. _]h?tab[-. _]</stereoscopicregextab><br />
<br />
<stagefright> <!-- Previously this page also listed <mediacodec> tags as well as stagefright tags, but this was in error. There are only stagefright options for official Kodi builds. SPMC has mediacodec options for codec tweaking, though. -1 is default, 0 is never used this codec, 1 is always use this codec, bypassing blacklist --><br />
<useavccodec>-1</useavccodec><br />
<usehevccodec>-1</usehevccodec> <!-- Added in v15 --><br />
<usevc1codec>-1</usevc1codec><br />
<usevpxcodec>-1</usevpxcodec><br />
<usemp4codec>-1</usemp4codec><br />
<usempeg2codec>-1</usempeg2codec><br />
<useswrenderer>false</useswrenderer><br />
</stagefright><br />
<br />
<disableswmultithreading>false</disableswmultithreading> <!-- Replaces disablehi10pmultithreading. Set this to true if you want software decoding to use only one CPU thread. --><br />
<br />
<useffmpegvda>false</useffmpegvda> <!-- Experimental hardware video decoding mode for OS X. Option is available for development/testing purposes. --><br />
<br />
</syntaxhighlight><br />
{{isengard box|1=<br />
<syntaxhighlight lang="xml" enclose="div"><br />
<assfixedworks>false</assfixedworks> <!-- position behavior of ass subtitiles when setting "subtitle position on screen" set to "fixed". True to show at the fixed position set in video calibration. False to show at the bottom of video (default). --><br />
</syntaxhighlight><br />
}}<br />
<syntaxhighlight lang="xml" enclose="div"><br />
<br />
</video><br />
</syntaxhighlight><br />
<br />
=== audio ===<br />
{{anchor|.3Caudio.3E}}<br />
<syntaxhighlight lang="xml" enclose="div"><br />
<audio><br />
<!-- Amount of headroom Kodi should use above the maximum volume level, in decibels. Defaults to 0, valid values 0, 6, 12. --><br />
<headroom>0</headroom><br />
<!-- Default audio player: paplayer or dvdplayer --><br />
<defaultplayer>paplayer</defaultplayer><br />
<!-- Regular expressions that if evaluated to true won't be added to library. --><br />
<excludefromscan> <br />
<regexp>[-\._ ](podcast)[-\._ ]</regexp><br />
</excludefromscan><br />
<!-- Regular expressions that if evaluated to true won't be displayed in Files View --><br />
<excludefromlisting> <br />
<regexp>[-\._ ](podcast)[-\._ ]</regexp><br />
</excludefromlisting><br />
<!-- Amount of gain (dB) to be applied to AC3 streams that have been mixed-down to 2 channels. Default is 12.0. Valid values are: -96.0 to 96.0. --><br />
<ac3downmixgain>12.0</ac3downmixgain><br />
<!-- Minimum percentage that has to be played before it is considered for incrementing in the Top 100 database view, or for last.fm submittal --><br />
<playcountminimumpercent>99</playcountminimumpercent> <br />
<!-- Whether to use Dynamic Range Compression (DRC) on AC3 streams. 1.0 is "full" compression, as defined by the audio track's metadata, which is recommended for "basic" sound systems such as the internal speakers on a TV. 0.0 is no compression at all, which is recommended for people with nice multi-speaker sound systems. -1.0 (default) defaults to whatever ffmpeg uses, which is currently the same as 1.0. This has no effect if passthrough is enabled for AC3. --><br />
<applydrc>-1.0</applydrc> <br />
<!-- set to true to skip decoding of DTS in wav files when using dvdplayer (10.10 only) --><br />
<dvdplayerignoredtsinwav>false</dvdplayerignoredtsinwav> <br />
<!-- default values for limiter/compressor --><br />
<limiterhold>0.025</limiterhold> <br />
<!-- default values for limiter/compressor --><br />
<limiterrelease>0.1</limiterrelease> <br />
</audio><br />
</syntaxhighlight><br />
<br />
For more information on the configuration of audio under Frodo see [[AudioEngine/HOW-TO: Configure audio]]<br />
<br />
=== measurerefreshrate ===<br />
{{anchor|.3Cmeasurerefreshrate.3E}}<br />
When using "Sync playback to display" on Windows, the detected refreshrate might be wrong.<br />
When enabling measurerefreshrate, the refreshrate is measured instead, which makes it more accurate.<br />
<br />
<syntaxhighlight lang="xml" enclose="div"><br />
<measurerefreshrate>true</measurerefreshrate><br />
</syntaxhighlight><br />
<br />
=== edl ===<br />
{{anchor|.3Cedl.3E}}<br />
{{main|EDL}}<br />
Commercial break detection not as good you think it could be? Are some commercial breaks in a series of adverts not being skipped? Are some parts being skipped that are clearly not commercials? Does the end of the previous recording still show? The following advanced settings can be used to better identify full commercial break sequences, remove incorrectly flagged commercial breaks, and have playback start at the actual beginning of the recording.<br />
<br />
<syntaxhighlight lang="xml" enclose="div"><br />
<edl><br />
<!-- if true, commercial breaks will be merged according to the remaining options. --><br />
<mergeshortcommbreaks>false</mergeshortcommbreaks><br />
<!-- Commercial breaks won't be merged if the total length of the commercial break would be greater than this (seconds) --><br />
<maxcommbreaklength>250</maxcommbreaklength><br />
<!-- After merging, commercial breaks shorter than this will be removed (seconds) --><br />
<mincommbreaklength>90</mincommbreaklength><br />
<!-- Commercial breaks that are further apart than this won't be merged (seconds) --><br />
<maxcommbreakgap>120</maxcommbreakgap><br />
<!-- How long to wait before automatically skipping when the start of a commercial break reached (seconds) --><br />
<commbreakautowait>0</commbreakautowait><br />
<!-- How long to rewind after automatically skipping to the end of the commercial break (seconds) --><br />
<commbreakautowind>0</commbreakautowind><br />
</edl><br />
</syntaxhighlight><br />
<br />
=== pvr ===<br />
{{anchor|.3Cpvr.3E}}<br />
<syntaxhighlight lang="xml" enclose="div"><br />
<pvr><br />
<timecorrection>0</timecorrection> <!-- Correct all times (epg tags, timer tags, recording tags) by this amount of minutes. --><br />
<infotoggleinterval>3000</infotoggleinterval> <!-- If there is more than one pvr gui info item available (e.g. multiple recordings active at the same time), use this toggle delay in milliseconds. --><br />
<minvideocachelevel>5</minvideocachelevel> <!-- Cache up to this level in the video buffer buffer before resuming playback if the buffers run dry. --><br />
<minaudiocachelevel>10</minaudiocachelevel> <!-- Cache up to this level in the audio buffer before resuming playback if the buffers run dry. --><br />
<cacheindvdplayer>true</cacheindvdplayer> <!-- Cache PVR stream in DVDPlayer. --><br />
<channeliconsautoscan>true</channeliconsautoscan> <!-- Automatically scan user defined folder for channel icons when loading internal channel groups. --><br />
<autoscaniconsuserset>false</autoscaniconsuserset> <!-- Mark channel icons populated by auto scan as "user set". --><br />
<numericchannelswitchtimeout>1000</numericchannelswitchtimeout> <!-- Time in ms before the numeric dialog auto closes when confirmchannelswitch is disabled. --><br />
</pvr><br />
</syntaxhighlight><br />
<br />
=== epg ===<br />
{{anchor|.3Cpvr.3E}}<br />
<syntaxhighlight lang="xml" enclose="div"><br />
<epg><br />
<lingertime>1440</lingertime> <!-- keep X minutes of past epg data (default: 24h) --><br />
<updatecheckinterval>300</updatecheckinterval> <!-- check if tables need to be updated every X minutes --><br />
<lingercleanupintervaltime>900</cleanupinterval> <!-- remove old entries from the EPG every X minutes --><br />
<activetagcheckinterval>60</activetagcheckinterval> <!-- check for updated active tags every X minute --><br />
<retryinterruptedupdateinterval>30</retryinterruptedupdateinterval> <!-- retry an interrupted epg update after X seconds --><br />
<updateemptytagsinterval>60</updateemptytagsinterval> <!-- override user selectable EPG update interval (minutes) for empty EPG tags --><br />
<displayupdatepopup>true</displayupdatepopup> <!-- display a progress popup while updating EPG data from clients --><br />
<displayincrementalupdatepopup>false</displayincrementalupdatepopup> <!-- also display a progress popup while doing incremental EPG updates --><br />
</epg><br />
</syntaxhighlight><br />
<br />
=== forcedswaptime ===<br />
{{anchor|.3Cforcedswaptime.3E}}<br />
Use to force a backbuffer->frontbuffer swap while vsync is enabled. Set to the time (in ms) to allow for the swap (e.g. <forcedswaptime>1</forcedswaptime> is typical). <br />
<br />
Default: Off<br />
<br />
<!--<br />
=== omxdecodestartwithvalidframe ===<br />
{{note|This tag is only in some Raspberry Pi specific distributions, such as [[OpenELEC]]. As of March 2015, this tag has not been merged into "vanilla" Kodi builds.}}<br />
<br />
<syntaxhighlight lang="xml" enclose="div"><br />
<omxdecodestartwithvalidframe></omxdecodestartwithvalidframe><br />
</syntaxhighlight> --><br />
<br />
== Video library settings ==<br />
<br />
=== videoextensions ===<br />
{{anchor|.3Cvideoextensions.3E}}<section begin="videoextensions" /><br />
A list of additional file-extensions to allow ('''add''') or exclude ('''remove''') in the My Video windows.<br />
<br />
Default extensions for VIDEOS:<br />
<pre><br />
.m4v .3gp .nsv .ts .ty .strm .rm .rmvb .m3u .ifo .mov .qt .divx .xvid .bivx .vob .nrg .img<br />
.iso .pva .wmv .asf .asx .ogm .m2v .avi .bin .dat .dvr-ms .mpg .mpeg .mp4 .mkv .avc .vp3 <br />
.svq3 .nuv .viv .dv .fli .flv .rar .001 .wpl .zip<br />
</pre><br />
Examples:<br />
<syntaxhighlight lang="xml" enclose="div"><br />
<videoextensions><br />
<add>.ex1|.ex2</add><br />
<remove>.ex3|.ex4</remove><br />
</videoextensions><br />
</syntaxhighlight><br />
<section end="videoextensions" /><br />
<br />
=== discstubextensions ===<br />
{{anchor|.3Cdiscstubextensions.3E}}<br />
A list of additional file-extensions that will (<tt><add></tt>) or will not (<tt><remove></tt>) be treated as disc stubs.<br />
<br />
Default extensions for DISC STUBS:<br />
<pre><br />
.disc<br />
</pre><br />
<br />
Examples:<br />
<syntaxhighlight lang="xml" enclose="div"><br />
<discstubextensions><br />
<add>.dvd|.blu</add><br />
<remove>.cd|.vhs</remove><br />
</discstubextensions><br />
</syntaxhighlight><br />
<br />
=== languagecodes ===<br />
{{anchor|.3Clanguagecodes.3E}}<br />
Translation table for subtitle and audio names. Contains entries of the form<br />
<br />
<syntaxhighlight lang="xml" enclose="div"><br />
<languagecodes><br />
<code><br />
<short>alt</short><br />
<long>Alternate</long><br />
</code><br />
</languagecodes><br />
</syntaxhighlight><br />
<br />
=== sorttokens ===<br />
{{anchor|.3Csorttokens.3E}}<br />
Allows you to specify additional tokens that will be ignored at the start of lines during sorting.<br />
<syntaxhighlight lang="xml" enclose="div"><br />
<sorttokens><br />
<token>the</token><br />
</sorttokens><br />
</syntaxhighlight><br />
<br />
=== moviestacking ===<br />
{{anchor|.3Cmoviestacking.3E}}<section begin="moviestacking" /><br />
{{main|File stacking}}<br />
This is used by the [[file stacking]] algorithm to combine multi-part files and contains a list of "''[[Regular Expression (RegEx) Tutorial|regular expressions]]''". For stacking videos that are contained in folders, such as VIDEO_TS folders, see '''[[advancedsettings.xml#folderstacking|<folderstacking>]]'''<br />
<br />
As of v9.11, video stacking regular expressions '''must''' contain exactly four (4) capture expressions. <br />
<br />
Default:<br />
<syntaxhighlight lang="xml" enclose="div"><br />
<moviestacking><br />
<!-- <cd/dvd/part/pt/disk/disc> <0-N> --><br />
<regexp>(.*?)([ _.-]*(?:cd|dvd|p(?:ar)?t|dis[ck])[ _.-]*[0-9]+)(.*?)(\.[^.]+)$</regexp><br />
<!-- <cd/dvd/part/pt/disk/disc> <a-d> --><br />
<regexp>(.*?)([ _.-]*(?:cd|dvd|p(?:ar)?t|dis[ck])[ _.-]*[a-d])(.*?)(\.[^.]+)$</regexp><br />
<!-- movienamea-xvid.avi, movienameb-xvid.avi --><br />
<regexp>(.*?)([ ._-]*[a-d])(.*?)(\.[^.]+)$</regexp><br />
</moviestacking><br />
</syntaxhighlight><br />
<br />
If the argument <tt>action="append"</tt> or <tt>append="yes"</tt> is supplied, the default moviestacking regular expressions will remain intact and the user specified ones will be added to the end. <br />
<br />
Example:<br />
<syntaxhighlight lang="xml" enclose="div"><br />
<moviestacking action="append"><br />
<!-- This expression will match movename1-xvid.avi, moviename2-xvid.avi.<br />
Be warned that it will likely stack sequels in a flat directory layout,<br />
so it is only recommend in a dir-per-video layout. --><br />
<regexp>(.*?)([ ._-]*[0-9])(.*?)(\.[^.]+)$</regexp><br />
</moviestacking><br />
</syntaxhighlight><br />
<br />
<br />
If the argument <tt>action="prepend"</tt> is supplied, the default moviestacking regular expressions will remain intact and the user specified ones will be added to the beginning. <br />
<br />
Example:<br />
<syntaxhighlight lang="xml" enclose="div"><br />
<moviestacking action="prepend"><br />
<regexp>(Title)(Volume)(Ignore)(Extension)</regexp><br />
</moviestacking><br />
</syntaxhighlight><br />
<br />
If no argument is supplied, or the argument <tt>append="no"</tt> is supplied, the default moviestacking regular expressions are overwritten by the user specified ones.<br />
<section end="moviestacking" /><br />
<br />
=== folderstacking ===<br />
{{main|File stacking}}<br />
This is similar to '''[[advancedsettings.xml#moviestacking|<moviestacking>]]''', but is used for videos that are contained in folders that use the folder names to stack, such as VIDEO_TS folders (DVD rips that are not in ISO format).<br />
<br />
Default:<br />
<syntaxhighlight lang="xml" enclose="div"><br />
<folderstacking><br />
<!-- <cd/dvd/disk/disc> <0-N> --><br />
<regexp>((cd|dvd|dis[ck])[0-9]+)$</regexp><br />
</folderstacking><br />
</syntaxhighlight><br />
<br />
=== cleandatetime ===<br />
{{anchor|.3Ccleandatetime.3E}}<br />
Matches a year number in a string using a ''[[Regular Expression (RegEx) Tutorial|Regular Expression]]'' <br />
<br />
Default expression:<br />
<syntaxhighlight lang="xml" enclose="div"><br />
<video><br />
<cleandatetime>(.+[^ _\,\.\(\)\[\]\-])[ _\.\(\)\[\]\-]+(19[0-9][0-9]|20[0-1][0-9])([ _\,\.\(\)\[\]\-][^0-9]|$)</cleandatetime><br />
</video><br />
</syntaxhighlight><br />
:* The string found before will be used as basis string getting cleaned by the cleanstrings expressions. <br />
:* By default date formats like MM:YY are ignored.<br />
<br />
=== cleanstrings ===<br />
{{anchor|.3Ccleanstrings.3E}}<br />
Clean unwanted characters from filenames or folders by using a list of ''[[Regular Expression (RegEx) Tutorial|Regular Expressions]]''. Please note that everything right of the match (at the end of the file name) is removed, so if you would have a file named ''Super movie.mp4'' and would add <tt><regexp> </regexp></tt> (only a space), the only thing that would be left is ''Super'', which is probably not what you want.<br />
<br />
Default expressions:<br />
<syntaxhighlight lang="xml" enclose="div"><br />
<video><br />
<cleanstrings><br />
<regexp>[ _\,\.\(\)\[\]\-](ac3|dts|custom|dc|divx|divx5|dsr|dsrip|dutch|dvd|dvdrip|dvdscr|dvdscreener|screener|dvdivx|cam|fragment|fs|hdtv|hdrip|hdtvrip|internal|limited|multisubs|ntsc|ogg|ogm|pal|pdtv|proper|repack|rerip|retail|cd[1-9]|r3|r5|bd5|se|svcd|swedish|german|read.nfo|nfofix|unrated|ws|telesync|ts|telecine|tc|brrip|bdrip|480p|480i|576p|576i|720p|720i|1080p|1080i|hrhd|hrhdtv|hddvd|bluray|x264|h264|xvid|xvidvd|xxx|www.www|\[.*\])([ _\,\.\(\)\[\]\-]|$)</regexp><br />
<regexp>(\[.*\])</regexp><br />
</cleanstrings><br />
</video><br />
</syntaxhighlight><br />
<br />
:* Arguments <tt>action="append"</tt> or <tt>action="prepend"</tt> will insert user specified expressions after, or before, the defaults above. (Further details in [[Advancedsettings.xml#.3Cmoviestacking.3E|moviestacking]] section)<br />
<br />
=== tvshowmatching ===<br />
{{anchor|.3Ctvshowmatching.3E}}<br />
Matches the season and episode numbers in file paths by using a list of ''[[Regular Expression (RegEx) Tutorial|Regular Expressions]]''<br />
<br />
Defaults:<br />
<syntaxhighlight lang="xml" enclose="div"><br />
<tvshowmatching><br />
<regexp>[Ss]([0-9]+)[][ ._-]*[Ee]([0-9]+)([^\\/]*)$</regexp> <!-- foo.s01.e01, foo.s01_e01, S01E02 foo, S01 - E02 --><br />
<regexp>[\._ -]()[Ee][Pp]_?([0-9]+)([^\\/]*)$</regexp> <!-- foo.ep01, foo.EP_01 --><br />
<regexp>([0-9]{4})[\.-]([0-9]{2})[\.-]([0-9]{2})</regexp> <!-- foo.yyyy.mm.dd.* (byDate=true) --><br />
<regexp>([0-9]{2})[\.-]([0-9]{2})[\.-]([0-9]{4})</regexp> <!-- foo.mm.dd.yyyy.* (byDate=true) --><br />
<regexp>[\\/\._ \[\(-]([0-9]+)x([0-9]+)([^\\/]*)$</regexp> <!-- foo.1x09* or just /1x09* --><br />
<regexp>[\\/\._ -]([0-9]+)([0-9][0-9])([\._ -][^\\/]*)$</regexp> <!-- foo.103*, 103 foo --><br />
<regexp>[\/._ -]p(?:ar)?t[_. -]()([ivx]+)([._ -][^\/]*)$</regexp> <!-- Part I, Pt.VI --><br />
</tvshowmatching><br />
</syntaxhighlight><br />
<br />
:* Arguments <tt>action="append"</tt> or <tt>action="prepend"</tt> will insert user specified expressions after, or before, the defaults above. (Further details in [[Advancedsettings.xml#.3Cmoviestacking.3E|moviestacking]] section)<br />
:* Paths are converted to lower case before matching.<br />
:* Examples of matching regexps for certain filenames can be found on the [[TV Shows (Video Library)|TV shows]] page.<br />
<br />
:* For multi-episode matching to work, there needs to be a third set of parentheses '()' at the end, this part is fed back into the regexp engine.<br />
<br />
:* A [http://forum.kodi.tv/showthread.php?t=51614 forum thread] has a discussion of pre-made regex lists to match common names. These might improve Kodi's ability to match TV show names in some situations, at the risk of additional false positives.<br />
<br />
==== Filenames without Season ====<br />
There are two methods to add episodes without a season in their file path. Both ways will force the season to '1' by default, so that you can use<br />
the 'Use Absolute Ordering (Single Season)' setting from the TheTvDb.com scraper.<br />
<br />
; Simple Method ''(XBMC v9.11 onwards and Kodi)''<br />
: Use only one pair of parentheses<br />
<syntaxhighlight lang="xml" enclose="div"><regexp>[/\._ \-]([0-9]+)</regexp></syntaxhighlight><br />
; Advanced Method ''(XBMC v10.05 onwards and Kodi)''<br />
: Supports multi-episode files without season<br />
: Use an empty pair of parentheses for the season<br />
<syntaxhighlight lang="xml" enclose="div"><regexp>[/\._ \-]()([0-9]+)(-[0-9]+)?</regexp></syntaxhighlight><br />
<br />
; Specifying Default Season ''(XBMC v12.0 onwards and Kodi)''<br />
It is possible to set the default season for specific regular expressions by setting the 'defaultseason' attribute.<br />
: Works with both the simple method and advanced method<br />
: If not used, the season will be set to '1'<br />
: Useful for setting specials to season '0'<br />
<syntaxhighlight lang="xml" enclose="div"><regexp defaultseason="0">[/\._ \-]X()([0-9]+)(-[0-9]+)?</regexp><br />
<regexp defaultseason="1">[/\._ \-]E()([0-9]+)(-[0-9]+)?</regexp></syntaxhighlight><br />
<br />
=== tvmultipartmatching ===<br />
{{anchor|.3Ctvmultipartmatching.3E}}<br />
Matches a multipart episode number based on a previously identified episode file, using a list of ''[[Regular Expression (RegEx) Tutorial|Regular Expressions]]''.<br />
<br />
Default:<br />
<syntaxhighlight lang="xml" enclose="div"><br />
<tvmultipartmatching>^[-_ex]+([0-9]+(?:(?:[a-i]|\\.[1-9])(?![0-9]))?)</tvmultipartmatching><br />
</syntaxhighlight><br />
:* Text matching is compared case-insensitive.<br />
:* Specifying this option '''replaces''' the default value<br />
<br />
=== excludefromscan ===<br />
{{anchor|.3Cexcludefromscan.3E}}<br />
Matches filenames or folders which should be excluded from a library scan (except tvshows) using a list of ''[[Regular Expression (RegEx) Tutorial|Regular Expressions]]''. This can be for both Video or Audio sections of <tt>advancedsettings.xml</tt>.<br />
<br />
Defaults:<br />
<syntaxhighlight lang="xml" enclose="div"><br />
<video><br />
<excludefromscan><br />
<regexp>-trailer</regexp><br />
<regexp>[!-._ \\/]sample[-._ \\/]</regexp><br />
</excludefromscan><br />
</video><br />
</syntaxhighlight><br />
<br />
:* Arguments <tt>action="append"</tt> or <tt>action="prepend"</tt> will insert user specified expressions after, or before, the defaults above. (Further details in [[Advancedsettings.xml#.3Cmoviestacking.3E|moviestacking]] section)<br />
<br />
=== excludefromlisting ===<br />
{{anchor|.3Cexcludefromlisting.3E}}<br />
<syntaxhighlight lang="xml" enclose="div"><br />
<video> <br />
<excludefromlisting> <!-- Regular expressions that if evaluated to true won't be displayed in Files View --><br />
<regexp>[-\._ ](sample|trailer)[-\._ ]</regexp><br />
</excludefromlisting><br />
</video><br />
</syntaxhighlight><br />
<br />
=== excludetvshowsfromscan ===<br />
{{anchor|.3Cexcludetvshowsfromscan.3E}}<br />
Matches filenames or folders which should be excluded from a tvshow library scan using a list of ''[[Regular Expression (RegEx) Tutorial|Regular Expressions]]''<br />
<br />
Defaults:<br />
<syntaxhighlight lang="xml" enclose="div"><br />
<video><br />
<excludetvshowsfromscan><br />
<regexp>[!-._ \\/]sample[-._ \\/]</regexp><br />
</excludetvshowsfromscan><br />
</video><br />
</syntaxhighlight><br />
<br />
:* Arguments <tt>action="append"</tt> or <tt>action="prepend"</tt> will insert user specified expressions after, or before, the defaults above. (Further details in [[Advancedsettings.xml#.3Cmoviestacking.3E|moviestacking]] section)<br />
<br />
=== trailermatching ===<br />
{{anchor|.3Ctrailermatching.3E}}<br />
Contains "''[[Regular Expression (RegEx) Tutorial|Regular Expression]]''" syntax (commonly referred to as "''[[Regular Expression (RegEx) Tutorial|RegEx]]''" or "''[[Regular Expression (RegEx) Tutorial|RegExp]]''") to match the locally stored trailers to movies in the library.<br />
<br />
<syntaxhighlight lang="xml" enclose="div"><br />
<trailermatching><br />
<!-- This regexp will match moviename_Trailer.avi --><br />
<regexp>(.*?)(_Trailer)(\.[^.]+)$</regexp><br />
</trailermatching><br />
</syntaxhighlight><br />
<br />
=== videolibrary ===<br />
{{anchor|.3Cvideolibrary.3E}}<br />
Options specific to the Video Library<br />
<br />
<syntaxhighlight lang="xml" enclose="div"><br />
<videolibrary><br />
<allitemsonbottom>false</allitemsonbottom> <!-- sorts the "*All" items at the bottom of the list when in Ascending order --><br />
<backgroundupdate>false</backgroundupdate> <!-- set to "true" to hide the video scanner dialog from the GUI --><br />
<!-- NOTE: To get this working properly, you have to do a 'Clean Library' in settings the first time after you enable the setting. --><br />
<cleanonupdate>false</cleanonupdate> <!-- default set to false to prevent Kodi from removing items from the database while updating. --><br />
<usefasthash>true</usefasthash> <!-- defaults to true. Set to false in order to skip hashing based on the folders modification time. --><br />
<hideallitems>false</hideallitems> <!-- removes the "*All" items from the video library --> <!-- This will be replaced in v15 with a GUI option. --><br />
<hideemptyseries>false</hideemptyseries> <!-- set to "true" to hide empty series in the video library and prevent empty series from being removed during a library cleanup. --><br />
<recentlyaddeditems>35</recentlyaddeditems> <!-- number of recently added items. Defaults to 25 --><br />
<itemseparator> / </itemseparator> <!-- separator used for multiple artists/genres in tags. Note, this is *space* *slash* *space* --><br />
<exportautothumbs>false</exportautothumbs> <!-- export auto-generated thumbs. Defaults to false --><br />
<importwatchedstate>false</importwatchedstate> <!-- import previously exported playdate and playcount from .nfo files. Defaults to false --><br />
<importresumepoint>false</importresumepoint> <!-- import previously exported resume point from .nfo files. Defaults to false --><br />
<mymovies> <!-- Options specific to MyMovies XML file parsing --><br />
<categoriestogenres>false</categoriestogenres> <!-- Add MyMovies Custom Categories to Genres (boolean, default is false) --><br />
</mymovies><br />
<dateadded>1</dateadded> <!-- 0 results in using the current datetime when adding a video;<br />
1 (default) results in prefering to use the files mtime (if it's valid) and only using the file's ctime if the mtime isn't valid;<br />
2 results in using the newer datetime of the file's mtime and ctime --><br />
</videolibrary><br />
</syntaxhighlight><br />
<br />
=== videoscanner ===<br />
{{anchor|.3Cvideoscanner.3E}}<br />
Options specific to the Video scanner<br />
<syntaxhighlight lang="xml" enclose="div"><br />
<videoscanner><br />
<ignoreerrors>true</ignoreerrors> <!-- Set to true to silently ignore errors while scanning videos. This prevents the error dialogue box, so you don't have to keep hitting "yes" to keep scanning.--><br />
</videoscanner><br />
</syntaxhighlight><br />
<br />
=== myth ===<br />
{{anchor|.3Cmyth.3E}}<br />
Not seeing all the recordings you expected in the Movies folder? If so, it's very likely that the electronic program guide (EPG) used by MythTV doesn't accurately distinguish between TV Shows and Movies all the time. The following setting allows the length of the recording to also be used to determine if a recording is a Movie.<br />
<br />
<syntaxhighlight lang="xml" enclose="div"><br />
<myth><br />
<!-- Recordings longer than this will be added to the Movies folder (minutes). 0 = off --><br />
<movielength>0</movielength><br />
</myth><br />
</syntaxhighlight><br />
<br />
== Library artwork ==<br />
<br />
=== imageres ===<br />
{{anchor|.3Cimageres.3E}}<br />
This tag is new for v12 (Frodo), replacing <thumbsize>.<br />
<br />
<section begin="imageres description" />Specify the maximal resolution that art should be resized to in pixels. The width is automatically calculated as being 16/9*height. The image will be resized to fit within this size. e.g. an image that is 2000x500 will be cached at size 1280x320. An image that is 500x800 will be cached at size 450x720 using the default value of 720.<section end="imageres description" /><br />
<br />
<syntaxhighlight lang="xml" enclose="div"><br />
<imageres>720</imageres><br />
</syntaxhighlight><br />
<br />
=== fanartres ===<br />
{{anchor|.3Cfanartres.3E}}<br />
This tag is new for v12 (Frodo), replacing <fanartheight>.<br />
<br />
<section begin="fanartres description" />Specify the resolution that cached fanart should be resized to in pixels. The width is automatically calculated as being 16/9*height. Only images that are exactly 16x9 and equal to or greater than this resolution will be cached at this size - all other images will be cached using <imageres>. The default value is 1080.<section end="fanartres description" /><br />
<br />
<syntaxhighlight lang="xml" enclose="div"><br />
<fanartres>1080</fanartres><br />
</syntaxhighlight><br />
<br />
=== fanart ===<br />
{{anchor|.3Cfanart.3E}}<br />
As of v12 (Frodo), this tag is only used for music and not video.<br />
<br />
A list of additional files to try when searching for fanart images. (The defaults are fanart.jpg and fanart.png which can be removed.)<br />
<br />
Example:<br />
<syntaxhighlight lang="xml" enclose="div"><br />
<fanart><br />
<remove>fanart.jpg</remove><br />
<add>backdrop.jpg</add><br />
</fanart><br />
</syntaxhighlight><br />
<br />
=== musicthumbs ===<br />
{{anchor|.3Cmusicthumbs.3E}}<br />
A list of additional files to try when searching for music thumbnail images. (The default is folder.jpg which can be removed.)<br />
<br />
Example:<br />
<syntaxhighlight lang="xml" enclose="div"><br />
<musicthumbs><br />
<remove>folder.jpg</remove><br />
<add>thumb.jpg|cover.jpg</add><br />
</musicthumbs><br />
</syntaxhighlight><br />
<br />
=== useddsfanart ===<br />
{{anchor|.3Cuseddsfanart.3E}}<br />
This settings allows Kodi to use your GPU rendering fanart and some other images. This will make loading images considerably faster, especially on systems with slower processors (e.g. atom based systems). Do not use this option on ARM based systems (Apple TV2/iOS/RPi/many Android systems) as it is likely to degrade performance because DDS images are not supported.<br />
<br />
<syntaxhighlight lang="xml" enclose="div"><br />
<useddsfanart>true</useddsfanart><br />
</syntaxhighlight><br />
<br />
=== imagescalingalgorithm ===<br />
<br />
{| width="100%" style="background-color: #EBE6FF; border: 1px solid #808000; font-size: 95%; clear: both" |<br />
| width="57px" | [[File:Future.png|50px|link=]]<br />
| align="left" | <big>{{{raw|'''{{{2|Current Kodi v16 development version feature}}}:'''<br />{{{1|This page or section describes a feature that is only available in Kodi v16 currently in development.}}}</big> }}}<br />
|}<br />
<br /><br />
<syntaxhighlight lang="xml" enclose="div"><br />
<imagescalingalgorithm>bicubic</imagescalingalgorithm><br />
</syntaxhighlight><br />
<br />
[https://github.com/xbmc/xbmc/blob/1a8753d5cd93890dc6a9f9d4b2ce8848066ea5d0/xbmc/pictures/PictureScalingAlgorithm.cpp#L32-L43 Available image scaling algorithms]<br />
<br />
<syntaxhighlight lang="text" enclose="div"><br />
fast_bilinear<br />
bilinear<br />
bicubic<br />
experimental<br />
nearest_neighbor<br />
averaging_area<br />
bicublin<br />
gaussian<br />
sinc<br />
lanczos<br />
bicubic_spline<br />
</syntaxhighlight><br />
<br />
== Video and music library settings ==<br />
<br />
=== playlistasfolders ===<br />
{{anchor|.3Cplaylistasfolders.3E}}<br />
In the recent releases, playlists are treated as folders. Selecting a playlist no longer plays it, but opens it, as if it were a folder.<br />
<br />
Set to false to revert to the previous behaviour. When you select a playlist, its content is added to the list of elements to be played.<br />
<br />
:{{note|This setting will not affect smart playlists, they will always show as folders.}}<br />
<br />
;Example<br />
<syntaxhighlight lang="xml" enclose="div"><br />
<playlistasfolders>true</playlistasfolders><br />
</syntaxhighlight><br />
<br />
=== playlistretries ===<br />
{{anchor|.3Cplaylistretries.3E}}<br />
The number of retries attempted if a source is offline. With this control you can alter the number of consecutive failed items before a playlist fails.<br />
<br />
Default:<br />
<syntaxhighlight lang="xml" enclose="div"><br />
<playlistretries>100</playlistretries><br />
</syntaxhighlight><br />
<br />
=== playlisttimeout ===<br />
{{anchor|.3Cplaylisttimeout.3E}}<br />
The timeout, in seconds, before item failure.<br />
<br />
Default:<br />
<syntaxhighlight lang="xml" enclose="div"><br />
<playlisttimeout>20</playlisttimeout> <br />
</syntaxhighlight><br />
<br />
=== musicdatabase/videodatabase ===<br />
{{anchor|.3Cmusicdatabase.3E/.3Cvideodatabase.3E}}<br />
{{main|MySQL}}<br />
<section begin="videodatabase" /><br />
Allows advanced customization of the default database settings for both music and video.<br />
<br />
:{{note| '''It is HIGHLY recommended that you not attempt to place an sqlite3 database outside of kodi's path. sqlite3 contains no filesystem abstraction, so this will plain break on any non-local (as far as Kodi is concerned) paths. Use this for mysql only.'''}}<br />
<br />
'''type'''<br />
: Can be either "sqlite3" or "mysql" (default: sqlite3)<br />
<br />
<br />
;host<br />
* sqlite3: defines the relative path to the database file (eg. /usr/local/kodi/databases).<br />
* mysql: defines the host of the mysql socket (eg. localhost, 192.168.0.1, etc)<br />
<br />
<br />
;port<br />
* sqlite3: silently ignored<br />
* mysql: defines the port of the mysql socket (default: 3306)<br />
<br />
<br />
;name<br />
:by default "MyVideos"+DB number will be used.<br />
* sqlite3: defines the name of the database file to read from, excluding the ".db" extension.<br />
* mysql: defines the name of the database to use<br />
<br />
<br />
;user<br />
* sqlite3: silently ignored<br />
* mysql: defines the user with privileged access to the database<br />
<br />
<br />
;pass<br />
* sqlite3: silently ignored<br />
* mysql: defines the password for the user with privileged access to the database<br />
<br />
<br />
;key<br />
: Optional SSL setting for MySQL [https://github.com/xbmc/xbmc/pull/2566]<br />
<br />
<br />
;cert<br />
: Optional SSL setting for MySQL [https://github.com/xbmc/xbmc/pull/2566]<br />
<br />
<br />
;ca<br />
: Optional SSL setting for MySQL [https://github.com/xbmc/xbmc/pull/2566]<br />
<br />
<br />
;capath<br />
: Optional SSL setting for MySQL [https://github.com/xbmc/xbmc/pull/2566]<br />
<br />
<br />
;ciphers<br />
: Optional SSL setting for MySQL [https://github.com/xbmc/xbmc/pull/2566]<br />
<br />
<br />
{{future box|1=<br />
;compression<br />
: Defaults to false. Set to "true" to enable MySQL compression protocol. Performance benefit is going to be largely dependent on the network bandwidth, latency between database and clients and on the size of the result sets. [https://github.com/xbmc/xbmc/pull/6484]<br />
: {{Note|Slower clients (such as the RPi and others) won't benefit from it as the zlib de-compression overhead is higher than the actual compression savings}}<br />
}}<br />
<br />
<br />
'''Examples:'''<br />
<br />
1) Configure a database for MySQL.<br />
:{{note| ''The videodatabase and musicdatabase tags are interchangeable here.''}}<br />
<syntaxhighlight lang="xml" enclose="div"><br />
<videodatabase><br />
<type>mysql</type><br />
<host>192.168.0.10</host><br />
<name>kodi_video</name><br />
<user>kodi</user><br />
<pass>kodi</pass><br />
</videodatabase><br />
</syntaxhighlight><br />
<br />
2) Configure a database for an sqlite database.<br />
:{{note|''The videodatabase and musicdatabase tags are interchangeable here.''}}<br />
<syntaxhighlight lang="xml" enclose="div"><br />
<musicdatabase><br />
<type>sqlite3</type><br />
<host>/usr/local/share/kodi/databases</host><br />
<name>kodi_music</name><br />
</musicdatabase><br />
</syntaxhighlight><br />
<br />
<section end="videodatabase" /><br />
<br />
=== externalplayer ===<br />
{{anchor|.3Cexternalplayer.3E}}<br />
{{see|External players}}<br />
<br />
== Music settings ==<br />
<br />
=== musicextensions ===<br />
{{anchor|.3Cmusicextensions.3E}}<br />
A list of additional file-extensions to allow ('''add''') or exclude ('''remove''') in the My Music windows.<br />
<br />
Default extensions for MUSIC:<br />
<pre><br />
.nsv .m4a .flac .aac .strm .pls .rm .mpa .wav .wma .ogg .mp3 .mp2 .m3u .mod .amf .669 .dmf .dsm .far .gdm <br />
.imf .it .m15 .med .okt .s3m .stm .sfx .ult .uni .xm .sid .ac3 .dts .cue .aif .aiff .wpl .ape .mac .mpc <br />
.mp+ .mpp .shn .zip .rar .wv .nsf .spc .gym .adplug .adx .dsp .adp .ymf .ast .afc .hps .xsp<br />
</pre><br />
<br />
Examples:<br />
<syntaxhighlight lang="xml" enclose="div"><br />
<musicextensions><br />
<add>.ex1|.ex2</add><br />
<remove>.ex3|.ex4</remove><br />
</musicextensions><br />
</syntaxhighlight><br />
<br />
=== cddbaddress ===<br />
{{anchor|.3Ccddbaddress.3E}}<br />
The address of the online CDDb database. You may set this to another freedb mirror if there is a more suitable one. <br />
<br />
Default: <br />
<syntaxhighlight lang="XML" enclose="div><br />
<cddbaddress>freedb.freedb.org</cddbaddress><br />
</syntaxhighlight><br />
<br />
=== songinfoduration ===<br />
{{anchor|.3Csonginfoduration.3E}}<br />
This controls how long the song information will remain onscreen when the song changes during visualisations. The valid range is "1" to "Indefinite (0)", in seconds. This does not include the duration of any transition effects. <br />
<br />
Default:<br />
<syntaxhighlight lang="xml" enclose="div"><br />
<songinfoduration>10</songinfoduration><br />
</syntaxhighlight><br />
<br />
=== musicfilenamefilters ===<br />
{{anchor|.3Cmusicfilenamefilters.3E}}<br />
Contains filters to match music information (artist, title etc.) from a tag-less music filename. The first <filter> to match completely is used. Matched items include:<br />
<br />
<pre><br />
%A - Artist<br />
%T - Title<br />
%B - Album<br />
%N - Track number<br />
%S - Part of set (disk number)<br />
%D - Duration<br />
%G - Genre<br />
%Y - Year<br />
%R - Rating<br />
</pre><br />
<br />
Example:<br />
<syntaxhighlight lang="xml" enclose="div"><br />
<musicfilenamefilters><br />
<filter>%A - %T</filter><br />
</musicfilenamefilters><br />
</syntaxhighlight><br />
<br />
=== musiclibrary ===<br />
{{anchor|.3Cmusiclibrary.3E}}<br />
Options specific to the Music Library<br />
<br />
<syntaxhighlight lang="xml" enclose="div"><br />
<musiclibrary><br />
<hideallitems>true</hideallitems> <!-- removes the "*All" items from the music library --> <!-- This will be replaced in v15 with a GUI option. --><br />
<allitemsonbottom>true</allitemsonbottom> <!-- sorts the "*All" items at the bottom of the list when in Ascending order --><br />
<backgroundupdate>true</backgroundupdate> <!-- set to hide the music scanner dialog from the gui --><br />
<recentlyaddeditems>35</recentlyaddeditems> <!-- number of recently added items. Defaults to 25 --><br />
<albumssortbyartistthenyear>true</albumssortbyartistthenyear> <!-- at an albums listing, when you sort by artist, secondary sort will be year. --><br />
<albumformat>%B - %Y</albumformat> <!-- album label template, default is "%B" --><br />
<albumformatright>%A</albumformatright> <!-- album label template for right column, default is "%A" --><br />
<prioritiseapetags>true</prioritiseapetags> <!-- prioritise APEv2 tags over ID3v1/2 tags, default is false. --><br />
<itemseparator> / </itemseparator> <!-- separator used for multiple artists/genres in tags. Note, this is *space* *slash* *space* --><br />
</musiclibrary><br />
</syntaxhighlight><br />
<br />
=== karaoke ===<br />
{{anchor|.3Ckaraoke.3E}}<br />
{{Main|Karaoke}}<section begin="karaoke" /><br />
<syntaxhighlight lang="xml" enclose="div"><br />
<karaoke><br />
<!-- Music-lyrics delay for CDG format lyrics in SECONDS. Floating number, may be negative. --><br />
<syncdelaycdg>0.0</syncdelaycdg><br />
<!-- Music-lyrics delay for LRC format lyrics in 1/10 seconds. Floating number, may be negative. --><br />
<syncdelaylrc>0.0</syncdelaylrc><br />
<!-- If set to true, when the songs are added to the library, Kodi will automatically replace the song genre by "Karaoke"<br />
if the song has associated lyrics. Default is false. --><br />
<alwaysreplacegenre>false</alwaysreplacegenre><br />
<!-- If set to true, when the music-lyrics delay was modified while playing using subtitle delay buttons, the delay value<br />
for this song will be stored, and restored when the song is played next time. Default is true. --><br />
<storedelay>true</storedelay><br />
<!-- When karaoke songs are added to the library during scans, an autoincrement number is automatically assigned<br />
to each song, starting from the value specified below. Default starts from 1. --><br />
<autoassignstartfrom>1</autoassignstartfrom><br />
<!-- If set to true (default), the background for CDG songs is always empty (plain color) no matter what setting is set in <br />
defaultbackground below. When setting this to false, then one can see through the background and see the video or<br />
visualization.--><br />
<nocdgbackground>true</nocdgbackground><br />
<!-- Sets default background mode. Type could be "none", "vis" for visualisation, "image" or "video".<br />
For image/video types the "path" parameter should specify the image or video file to play. --><br />
<defaultbackground type="video" path="special://masterprofile/karaokevideobg.avi"/><br />
<!-- If non-zero, specifies the time in seconds left before the end of the current song when a window will pop up informing you<br />
about the next played song. The window does not pop up if there is no next song, or it is not a karaoke song --><br />
<nextsongpopuptime>0.0</nextsongpopuptime><br />
</karaoke><br />
</syntaxhighlight><br />
<section end="karaoke" /><br />
<br />
== Photos settings ==<br />
<br />
=== pictureextensions ===<br />
{{anchor|.3Cpictureextensions.3E}}<br />
A list of additional file-extensions to allow ('''add''') or exclude ('''remove''') in the My Pictures window.<br />
<br />
Default extensions for PICTURES:<br />
<pre><br />
.png .jpg .jpeg .bmp .gif .ico .tif .tiff .tga .pcx .cbz .zip .cbr .rar .m3u<br />
</pre><br />
<br />
Examples:<br />
<syntaxhighlight lang="xml" enclose="div"><br />
<pictureextensions><br />
<add>.ex1|.ex2</add><br />
<remove>.ex3|.ex4</remove><br />
</pictureextensions><br />
</syntaxhighlight><br />
<br />
=== pictureexcludes ===<br />
{{anchor|.3Cpictureexcludes.3E}}<br />
Matches filenames or folders which should be excluded from being displayed in My Pictures using a list of ''[[Regular Expression (RegEx) Tutorial|Regular Expressions]]''<br />
<br />
<syntaxhighlight lang="xml" enclose="div"><br />
<pictureexcludes> <!-- Regular expressions that if evaluated to true won't be displayed in My Pictures --><br />
<regexp>small</regexp><br />
<regexp>[-\._ ](sample|trailer)[-\._ ]</regexp><br />
</pictureexcludes><br />
</syntaxhighlight><br />
<br />
=== slideshow ===<br />
{{anchor|.3Cslideshow.3E}}<br />
<syntaxhighlight lang="xml" enclose="div"><br />
<slideshow><br />
<!-- Amount to pan images as a percentage of the screen --><br />
<panamount>2.5</panamount><br />
<!-- Amount to zoom images as a percentage of the screen --><br />
<zoomamount>5.0</zoomamount><br />
<!-- Amount to compensate (zoom) images to attempt to reduce black bars. --><br />
<!-- Results in cropping of the longer length of the image in order to reduce the black bars on the shorter length of the image. --><br />
<!-- Defaults to 20. --><br />
<blackbarcompensation>20</blackbarcompensation> <br />
</slideshow><br />
</syntaxhighlight><br />
<br />
== Network settings ==<br />
<br />
=== samba ===<br />
{{anchor|.3Csamba.3E}}<br />
<syntaxhighlight lang="xml" enclose="div"><br />
<samba><br />
<doscodepage></doscodepage> <!-- code page to use for filenames --><br />
<clienttimeout>10</clienttimeout> <!-- timeout (in seconds) --><br />
<statfiles>true</statfiles> <!-- Set to false to disable smb stat() on files to speed up listings of large directories (over slow links) --><br />
</samba><br />
</syntaxhighlight><br />
<br />
=== hosts ===<br />
{{anchor|.3Cfhosts.3E}}<br />
Static dns entries which take precedence over your dns server.<br />
<syntaxhighlight lang="xml" enclose="div"><br />
<hosts><br />
<entry name="HOSTNAME">IPADDRESS</entry><br />
</hosts><br />
</syntaxhighlight><br />
<br />
=== network ===<br />
{{anchor|.3Cnetwork.3E}}<br />
{{see also|HOW-TO:Modify the cache}}<br />
<syntaxhighlight lang="xml" enclose="div"><br />
<network><br />
<curlclienttimeout>10</curlclienttimeout> <!-- Timeout in seconds for libcurl (http/ftp) connections --><br />
<curllowspeedtime>5</curllowspeedtime> <!-- Time in seconds for libcurl to consider a connection lowspeed --><br />
<httpproxyusername></httpproxyusername> <!-- username for Basic Proxy Authentication --><br />
<httpproxypassword></httpproxypassword> <!-- password for Basic Proxy Authentication --><br />
<cachemembuffersize>20971520</cachemembuffersize> <!-- number of bytes used for buffering streams ahead in memory <br />
Kodi will not buffer ahead more than this. WARNING: for the bytes set here, Kodi will consume 3x the amount of RAM<br />
When set to 0 the cache will be written to disk instead of RAM, as of v12 Frodo --><br />
<buffermode>0</buffermode> <!-- Choose what to buffer:<br />
0) Buffer all internet filesystems (like "2" but additionally also ftp, webdav, etc.) (default)<br />
1) Buffer all filesystems (including local)<br />
2) Only buffer true internet filesystems (streams) (http, etc.)<br />
3) No buffer --><br />
<readbufferfactor>1.0</readbufferfactor> <!-- this factor determines the max readrate in terms of readbufferfactor * avg bitrate of a video file. <br />
This can help on bad connections to keep the cache filled. It will also greatly speed up buffering. Default value 1.0. --><br />
</network><br />
</syntaxhighlight><br />
<br />
=== tuxbox ===<br />
{{anchor|.3Ctuxbox.3E}}<br />
<syntaxhighlight lang="xml" enclose="div"><br />
<tuxbox><br />
<!-- "audiochannelselection"; default is 'false', 'true' will popup the audio channel selection if<br />
there is more then one audio stream !--><br />
<audiochannelselection>false</audiochannelselection><br />
<!-- "submenuselection"; default is 'false', 'true' will popup the Submenu selection !--><br />
<submenuselection>false</submenuselection><br />
<!-- "defaultrootmenu"; MODE: 0 = TV (Default), 1 = Radio, 2 = Data, 3 = Movies, 4 = Root !--><br />
<defaultrootmenu>0</defaultrootmenu><br />
<!-- "defaultsubmenu"; 1=Services 2=Satellites 3=Providers 4=Bouquets (default) !--><br />
<defaultsubmenu>4</defaultsubmenu><br />
<!-- "pictureicon"; default is 'true', will use the Picture Icons from folder /UserData/PictureIcon/ !--><br />
<pictureicon>true</pictureicon><br />
<!-- "epgrequesttime"; default is '10', 0-3600, defines the time in seconds between epg queries, some tuxbox<br />
devices need longer to response (Minimum: 1, Maximum: 3600) !--><br />
<epgrequesttime>10</epgrequesttime><br />
<!-- "zapwaittime"; default is '0' (0 = OFF), defines the time in seconds to wait for a valid PMT after the<br />
zaping was send (Minimum: 0, Maximum: 120) !--><br />
<zapwaittime>0</zapwaittime> <br />
</tuxbox><br />
</syntaxhighlight><br />
<br />
=== airtunesport ===<br />
{{anchor|.3Cairtunesport.3E}}<section begin="airtunesport" /><br />
This overwrites the defalt listening port of the AirTunes server (announced via zeroconf).<br />
<section end="airtunesport" /><br />
<br />
=== airplayport ===<br />
{{anchor|.3Cairplayport.3E}}<section begin="airplayport" /><br />
This overwrites the default listening port of the AirPlay server (announced via zeroconf).<br />
<section end="airplayport" /><br />
<br />
== File system settings ==<br />
<br />
=== packagefoldersize ===<br />
<section begin="packagefoldersize" /><br />
{{anchor|.3Cpackagefoldersize.3E}}<br />
{{xml setting<br />
| tag name = packagefoldersize<br />
| option type = numerical<br />
| option values = <br />
| default values = 200<br />
| platform = all<br />
| XBMC version = 12<br />
| description = The amount (in megabytes) of add-on zip packages saved from previous add-on installs. These packages are mainly used for the [[add-on]] rollback feature. Increasing the size should increase the amount of past versions saved.<br />
| example = Example: <syntaxhighlight lang="xml" enclose="div"><packagefoldersize>200</packagefoldersize> <!-- this example would keep up to 200MB of add-on packages. --></syntaxhighlight><br />
}}<br />
<section end="packagefoldersize" /><br />
=== detectasudf ===<br />
{{anchor|.3Cdetectasudf.3E}}<br />
Set to true if you wish to detect joint ISO9660/UDF disks as UDF. <br />
<br />
Default: False<br />
<br />
=== pathsubstitution ===<br />
{{anchor|.3Cpathsubstitution.3E}}<br />
{{main|Path substitution}}<br />
Path substitutions are for use for redirecting file paths. These are processed in order, and are useful for substituting an absolute path on a PC with a path suitable for Kodi to handle. <br />
<br />
Default: No path substitutions defined. <br />
<br />
Example:<br />
<syntaxhighlight lang="xml" enclose="div"><br />
<pathsubstitution><br />
<substitute><br />
<from>G:\dvds\</from><br />
<to>smb://somecomputer/g-share/dvds/</to> <!-- Note the difference between the usage of forward and backslashes --><br />
</substitute><br />
</pathsubstitution><br />
</syntaxhighlight><br />
<br />
== Input control settings ==<br />
<br />
=== remotedelay ===<br />
{{anchor|.3Cremotedelay.3E}}<br />
The repeat delay for a LIRC remote control. A delay value between 1 and 20 before a remote button starts repeating on a long keypress (i.e. continuously sending button pushes while it's held down). <br />
<br />
Default: 3<br />
<syntaxhighlight lang="xml" enclose="div"><br />
<remotedelay>10</remotedelay><br />
</syntaxhighlight><br />
<br />
=== remoterepeat ===<br />
{{anchor|.3Cremoterepeat.3E}}<br />
This used to adjust the amount of time in milliseconds between repeated keystrokes. Used to prevent key-bounce, in other words prevents Kodi (lirc?) seeing one key press as multiple key presses with certain remotes.<br />
<br />
<syntaxhighlight lang="xml" enclose="div"><br />
<remoterepeat>800</remoterepeat><br />
</syntaxhighlight><br />
<br />
=== controllerdeadzone ===<br />
{{anchor|.3Ccontrollerdeadzone.3E}}<br />
The controller deadzone is the region of movement around the center which is not recognized by the device. Because joysticks can have noise (report motion when still) and bias (report an offset when centered), spurious events can be reported even though the controller isn't being touched. If you notice these kinds of events, you most likely need to increase your controller's deadzone (both axes recommended). The values range from 0.0 (no deadzone, Kodi will see all input your controller is capable of registering) to 1.0 (it will ignore all input inside of the device's physical limits).<br />
<br />
<syntaxhighlight lang="xml" enclose="div"><br />
<controllerdeadzone>0.2</controllerdeadzone><br />
</syntaxhighlight><br />
<br />
=== enablemultimediakeys ===<br />
{{anchor|.3Cenablemultimediakeys.3E}}<br />
This setting only has any effect on Windows versions of Kodi, and only applies to builds from 28th May 2011 onwards.<br />
In Windows the multimedia keys generate a WM_APPCOMMAND message in addition the keypress. Kodi processes both keypresses and the WM_APPCOMMAND messages, and the end result would be that the command is executed twice. To avoid this, by default multimedia keypresses are disabled. Although it should rarely be necessary, the enablemultimediakeys setting allows you to enable the multimedia keys.<br />
<br />
Example:<br />
<syntaxhighlight lang="xml" enclose="div"><br />
<enablemultimediakeys>true</enablemultimediakeys><br />
</syntaxhighlight><br />
<br />
<br />
=== seeksteps ===<br />
{{Main|Skip steps}}<br />
{{future box|1=<br />
This setting changes which increments are available in the settings GUI for additive seeking. Note that <code><seeksteps></code> is not used to actually choose which seek steps are enabled.<br />
<br />
'''Default:'''<br />
<syntaxhighlight lang="xml" enclose="div"><br />
<seeksteps>7, 15, 30, 60, 180, 300, 600, 900, 1800</seeksteps><br />
</syntaxhighlight><br />
}}<br />
<br />
{{editor note|the defaults need to be updated for seeksteps.}}<br />
<br />
== Other interface settings ==<br />
<br />
=== window ===<br />
{{anchor|.3Cwindow.3E}}<br />
This allows you to manually set the default size of Kodi's windowed mode. If you resize the window, it will return to the set size when restarting.<br />
<br />
WIDTH and HEIGHT are the values for each dimension, in pixels.<br />
<br />
<syntaxhighlight lang="xml" enclose="div"><br />
<window><width>WIDTH</width><height>HEIGHT</height></window><br />
</syntaxhighlight><br />
<br />
=== allowd3d9ex ===<br />
{{anchor|.3Callowd3d9ex.3E}}<br />
Applies only to Windows Vista and up. Values: true/false. Allows Kodi to use Direct3D 9Ex, which is a bit more stable and robust than Direct3D 9.<br />
<br />
Default:<br />
<syntaxhighlight lang="xml" enclose="div"><br />
<allowd3d9ex>true</allowd3d9ex><br />
</syntaxhighlight><br />
<br />
=== restrictcapsmask ===<br />
{{anchor|.3Crestrictcapsmask.3E}}<br />
Windows only. A bitmask to prevent Kodi from using detected texture capabilities of the GPU. This helps work around buggy hardware/drivers.<br />
<br />
1: prevent the use of compressed textures (DXT1, DXT3, DXT5)<br />
2: prevent the use of non-power-of-two dimensions for textures<br />
4: prevent the use of compressed textures with non-power-of-two dimensions.<br />
<br />
<syntaxhighlight lang="xml" enclose="div"><br />
<restrictcapsmask>0</restrictcapsmask><br />
</syntaxhighlight><br />
<br />
=== forced3d9ex ===<br />
{{anchor|.3Cforced3d9ex.3E}}<br />
Windows only: Kodi attempts to detect drivers released for a version earlier than Vista, to avoid using advanced features which are often not emulated correctly. The detection may be incorrect and this setting allows forcing the using of D3D9Ex.<br />
<br />
<syntaxhighlight lang="xml" enclose="div"><br />
<forced3d9ex>false</forced3d9ex><br />
</syntaxhighlight><br />
<br />
=== algorithmdirtyregions ===<br />
{{anchor|.3Calgorithmdirtyregions.3E}}<br />
{{see also|HOW-TO:Modify dirty regions}}<br />
<section begin="algorithmdirtyregions" /> {{note|Some GPU/hardware configurations will have some minor issues (such as a visual "flicker"). For those situations try mode 2 or use the default (mode 3, which requires no advancedsetting). Almost all ARM-based devices (such as [[Android]]) willl likely have flickering issues.}}<br />
<br />
Enable dirty-region processing. Dirty regions are any parts of the screen that have changed since the last frame. By not re-rendering what hasn't changed the GUI can be sped up. Because all GPUs work differently, only Mode 3, combined with nofliptimeout=0, is guaranteed to work for everyone without flickering issues. This mode will reduce CPU/GPU usage, but will not increase GUI speed.<br />
<br />
{| class="prettytable"<br />
! value !! result !! description<br />
|-<br />
! 0<br />
| Off<br />
| The entire viewport is always rendered.<br />
|-<br />
! 1<br />
|Union<br />
|All dirty regions are grouped into the smallest possible rectangle. This is typically the fastest mode for slower GPUs due to only making one pass.<br />
|-<br />
! 2<br />
| {{nowrap|Cost reduction}}<br />
| Each dirty region is presented separately, in as many passes as there are regions.<br />
|-<br />
! 3<br />
| {{nowrap|Whole Screen}}<br />
| The entire screen is rendered if there are any dirty regions. This, combined with nofliptimeout is a safe default for drivers that clear buffer contents (manifests as blinking or vibrating images). '''Default'''<br />
|}<section end="algorithmdirtyregions" /><br />
<br />
Example:<br />
<syntaxhighlight lang="xml" enclose="div"><br />
<gui> <br />
<algorithmdirtyregions>1</algorithmdirtyregions><br />
</gui><br />
</syntaxhighlight><br />
<br />
=== nofliptimeout ===<br />
{{anchor|.3Cnofliptimeout.3E}}<br />
{{see also|HOW-TO:Modify dirty regions}}<br />
<section begin="nofliptimeout" />Specifies the timeout in milliseconds after which Kodi will not flip the graphics buffers anymore when nothing has been rendered, this lowers both CPU and GPU usage. Sometimes adjusting this value can help prevent flickering.<br />
<br />
* -1: disabled <br />
* 0 or higher: timeout in milliseconds '''(0 is default)'''<br />
<section end="nofliptimeout" /><br />
Example: <br />
<syntaxhighlight lang="xml" enclose="div"><br />
<gui> <br />
<nofliptimeout>1000</nofliptimeout><br />
</gui><br />
</syntaxhighlight><br />
<br />
=== visualizedirtyregions ===<br />
{{anchor|.3Cvisualizedirtyregions.3E}}<br />
{{see also|HOW-TO:Modify dirty regions}}<br />
<section begin="visualizedirtyregions" />Enable dirty-region visualization. Paints a rectangle over marked controls.<br />
<br />
* true: on<br />
* false: off '''(Default)'''<br />
<br />
{{note|This is only a development mode and isn't of use to normal users.}}<br />
<section end="visualizedirtyregions" /><br />
Example: <br />
<syntaxhighlight lang="xml" enclose="div"><br />
<gui> <br />
<visualizedirtyregions>true</visualizedirtyregions><br />
</gui><br />
</syntaxhighlight><br />
<br />
=== showexitbutton ===<br />
{{anchor|.3Cshowexitbutton.3E}}<br />
Setting to hide the exit button, useful for people running appliance based setup's where exit would only confuse/complicate the user. Modifiable via the advancedsettings.xml by setting showexitbutton to false, default is true (show)<br />
<br />
Example:<br />
<syntaxhighlight lang="xml" enclose="div"><br />
<showexitbutton>true</showexitbutton><br />
</syntaxhighlight><br />
<br />
=== fullscreen ===<br />
{{anchor|.3Cfullscreen.3E}}<br />
Starts Kodi in full screen (check resolutions!).<br />
<br />
<syntaxhighlight lang="xml" enclose="div"><br />
<fullscreen>false</fullscreen><br />
</syntaxhighlight><br />
<br />
=== splash ===<br />
{{anchor|.3Csplash.3E}}<br />
Set to false if you wish to disable the startup splash image. Defaults to true.<br />
<br />
<syntaxhighlight lang="xml" enclose="div"><br />
<splash>true</splash><br />
</syntaxhighlight><br />
<br />
=== cputempcommand ===<br />
{{anchor|.3Ccputempcommand.3E}}<br />
Provide a shell command Kodi will use to get CPU temperature. It should print out only "[temp as integer] [scale as one of "CcFf"]".<br /><br />
;<u>For Nvidia and Raspberry Pi</u><br />
<syntaxhighlight lang="xml" enclose="div"><br />
<cputempcommand>sed -e 's/\([0-9]*\)[0-9]\{3\}.*/\1 C/' /sys/class/thermal/thermal_zone0/temp</cputempcommand><br />
</syntaxhighlight><br />
or<br />
<syntaxhighlight lang="xml" enclose="div"><br />
<cputempcommand>echo "$(sensors -u | tail -n64 | grep temp1_input | awk '{print $2 }' |awk '{printf("%d\n",$1 + 0.5);}') C"</cputempcommand><br />
</syntaxhighlight><br />
;<u>For ATI/AMD</u><br />
<syntaxhighlight lang="xml" enclose="div"><br />
<cputempcommand>sensors|sed -ne "s/temp1: \+[-+]\([0-9]\+\).*/\1 C/p"</cputempcommand><br />
</syntaxhighlight><br />
<br />
=== gputempcommand ===<br />
{{anchor|.3Cgputempcommand.3E}}<br />
Provide a shell command Kodi will use to get GPU temperature. It should print out only "[temp as integer] [scale as one of "CcFf"]".<br /><br />
;<u>For Nvidia</u><br />
<syntaxhighlight lang="xml" enclose="div"><br />
<gputempcommand>echo "$(nvidia-settings -tq gpuCoreTemp) C"</gputempcommand><br />
</syntaxhighlight><br />
or<br />
<syntaxhighlight lang="xml" enclose="div"><br />
<gputempcommand>echo "$(nvidia-smi -q -d TEMPERATURE | grep Gpu | cut -c35-36) C"</gputempcommand><br />
</syntaxhighlight><br />
;<u>For ATI/AMD</u><br />
<syntaxhighlight lang="xml" enclose="div"><br />
<gputempcommand>/usr/bin/aticonfig --od-gettemperature | grep Temperature | cut -f 2 -d "-" | cut -f 1 -d "." | sed -e "s, ,," | sed 's/$/ C/'</gputempcommand><br />
</syntaxhighlight><br />
<br />
;<u>For Raspberry Pi</u><br />
<syntaxhighlight lang="xml" enclose="div"><br />
<gputempcommand>/opt/vc/bin/vcgencmd measure_temp | sed -e "s/temp=//" -e "s/\..*'/ /"</gputempcommand><br />
</syntaxhighlight><br />
<br />
=== glrectanglehack ===<br />
{{anchor|.3Cglrectanglehack.3E}}<br />
Problems with ghosting or videos which are only played back in the left upper quarter? The following ATI hack may solve it.<br />
<syntaxhighlight lang="xml" enclose="div"><br />
<glrectanglehack>yes</glrectanglehack><br />
</syntaxhighlight><br />
<br />
=== alwaysontop ===<br />
{{anchor|.3Calwaysontop.3E}}<br />
Added in XBMC v9.11 (Windows OS only). Keeps Kodi always on top when windowed.<br />
<syntaxhighlight lang="xml" enclose="div"><br />
<alwaysontop>yes</alwaysontop><br />
</syntaxhighlight><br />
<br />
Alternate code.<br />
<syntaxhighlight lang="xml" enclose="div"><br />
<videoscreen><br />
<fakefullscreen>false</fakefullscreen><br />
</videoscreen><br />
</syntaxhighlight><br />
<br />
== Recently removed tags ==<br />
* {{anchor|.3Cthumbsize.3E}}'''<thumbsize>''' - replaced by <[[#imageres|imageres]]> in v12 Frodo<br />
* {{anchor|.3Cfanartheight.3E}}'''<fanartheight>''' - replaced by <[[#fanartres|fanartres]]> in v12 Frodo<br />
* {{anchor|.3Cdvdthumbs.3E}}'''<dvdthumbs>''' - removed in v12 Frodo<br />
* {{anchor|.3Cbusydialogdelayms.3E}}'''<busydialogdelayms>''' - removed in v12 Frodo<br />
* {{anchor|.3Cbginfoloadermaxthreads.3E}}'''<bginfoloadermaxthreads>''' - removed in v13 Gotham<br />
* '''<showepginfoonselect>''' - replaced by a GUI setting in v13 Gotham<br />
* '''<resample>''', '''<forceDirectSound>''', '''<audiophile>''', '''<audiosinkbufferdurationmsec>''', '''<allowtranscode44100>''', and '''<streamsilence>''' - These were various sub-tags for <audio> that were removed in v13 Gotham and either replaced by GUI settings or were no longer needed.<br />
* {{anchor|.3Cenableairtunesdebuglog.3E}}'''<enableairtunesdebuglog>''' - replaced by a GUI option in v14 Helix<br />
* '''<videoDisableHi10pMultithreading>''' - renamed to <disableswmultithreading> in v14 Helix<br />
* '''<hideallitems>''' - For both the <code><videolibrary></code> and <code><musiclibrary></code> sections, this is replaced by a GUI option in v15 Isengard<br />
* '''<SmallStepBackSeconds>''' - In v15 the <code>SmallStepBack</code> [[action ID]] has been replaced by <code>seek(-7)</code> in default keymaps. See '''[[skip steps]]''' for details. When the original <code>SmallStepBack</code> action ID is used it defaults to the first backwards [[skip steps|additive seeking value]].<br />
* '''<timeseekforward>/<timeseekbackward>''' - In v15 these tags are replaced by GUI options via [[skip steps|additive seeking]], which is configured in the GUI. See '''[[skip steps]]''' for details.<br />
<br />
== guisettings.xml settings ==<br />
You can also define the settings normally defined in the GUI (and stored in guisettings.xml) in advancedsettings.xml. Most guisettings.xml settings defined in advancedsettings.xml will override the guisettings.xml values, and the settings will be removed completely from the interface.<br />
<br />
The easiest way to include a guisettings.xml setting is to first change the setting in the interface to the value that you want, and then open the '''[[userdata]]/guisettings.xml''' file and find the XML entry that corresponds to that setting.<br />
<br />
Then just add that entry to the advancedsettings.xml file.<br />
<br />
For instance, to set the Font Character Set (found in the appearance setting, in the Look and Feel section), you'd open up guisettings.xml and find:<br />
<br />
<syntaxhighlight lang="xml" enclose="div"><br />
<lookandfeel><br />
<charset>Hebrew (Windows)</charset><br />
</lookandfeel><br />
</syntaxhighlight><br />
<br />
Simply take that entry and place it in advancedsettings.xml. The option in Kodi's interface for the character set will then no longer be visible, and Kodi will always use the Hebrew (Windows) character set.<br />
<br />
{{Helix updated}}<br />
{{DISPLAYTITLE:advancedsettings.xml}}<br />
<br />
[[Category:Settings]]<br />
[[Category:Manual]]<br />
[[Category:Advanced topics]]</div>UNiversalhttps://kodi.wiki/index.php?title=Archive:Karaoke&diff=98183Archive:Karaoke2015-06-30T08:48:14Z<p>UNiversal: </p>
<hr />
<div>{{mininav|[[Music library]] }}<br />
{{greenv|'''NOTICE'''| Karaoke option requires enabling '''advanced''' settings level. See [[Settings#Settings_levels]].}}<br />
<br />
<br />
{{cleanup}}<br />
<br />
<section begin="intro" />This page provides information about karaoke playback in Kodi and provides advanced setup details.<section end="intro" /><br />
<br />
<br />
== Features ==<br />
Kodi supports the following Karaoke features:<br />
* Supports CDG, LRCv1 and LRCv2 lyrics formats;<br />
* Supports UltraStar song lyrics and video formats;<br />
* Supports MIDI music and KAR files;<br />
* Plays directly from MP3+CDG archived together;<br />
* Supports song numbering with permanent numbers, which means the song could be selected by number, even if another song is being played. The numbering information could be exported into HTML file and used to print catalogs.<br />
* Supports real-time lyrics timing modification, allowing to modify the lyrics-music delay. The delay is associated to the song, and then restored when this song is played again.<br />
* Supports different background modes, including visualization, still picture or video.<br />
<br />
== Missing features ==<br />
What is not currently supported:<br />
* Playing CD-G disks directly. The suggested workaround is to rip them into MP3+CDG files using available software.<br />
* Using digitized microphone input. The microphone should work in pass-through mode, but will not work in digitized mode, where the sound should be digitally processed by Kodi. This also means that any voice post-processing is not possible yet.<br />
* Pitch modification.<br />
<br />
== What will not be implemented ==<br />
* Playing vendor-specific Karaoke disks (like California Electronics or LG). Those disks need to be converted to playable files set first.<br />
* Automatic voice removal. This is not possible to do automatically without seriously degrading music quality.<br />
* Scoring table, nicknames and other attributes of karaoke-based games.<br />
<br />
== Supported formats ==<br />
The following karaoke formats are supported by Kodi.<br />
<br />
=== MP3+CDG ===<br />
The karaoke song consist of two files: the music file (usually MP3 but could be any playable type), and a separate binary file with the same file name as the music file, but with .cdg extension. This is the most popular format in the NA/USA, with a lot of English language music in this format available both legally and illegally. The source of those files are usually original CD disks in CD-G formats designed for hardware karaoke players. Those disks got ripped by any of freely available CD rippers, repacked and shared via typical channels, or sold on multiple web sites around the world.<br />
<br />
The main feature of this format is that the lyrics are stored in the binary format, in form of drawing instructions. This means the CDG file could contain text in any language, or even graphics, and will be properly rendered on any supported device no matter what fonts are installed. However those drawing instructions operate on a small 300x216 window, and therefore have to be upscaled. As a result, this format combines usually very good music quality with very poor graphics. Because of upscaling the lyrics visualization quality is the worst through all supported formats, especially on large screen TVs. Other problems of this format are inability for the ordinary user to fix the typos or synchronization issues in the song, and that software required to create .CDG files is not widely available. There are only two programs, and neither is cheap.<br />
<br />
<br />
<br />
=== MP3+LRC ===<br />
Same as with CDG, the karaoke song consist of two files: the music file (usually MP3 but could be any playable type), and a separate text file with the same file name as the music file, but with .lrc extension. This is the most popular format in the Asia, and the most widespread lyrics format in the Internet. The source of those files are either original karaoke CDs where text in CD-G format was replaced by text in LRC by the person who ripped it, or a home-made music often made from MIDI files. There is also a lot of legitimate lyrics web sites where the lyrics in LRC format are available for download, usually for free.<br />
<br />
The main feature of this format is that the lyrics are stored in the text file, usually in UTF-8 encoding. This means nothing but text (i.e. no graphics), and that the rendering software (Kodi) must have all necessary fonts installed. However since the rendering device uses real scalable fonts to render the text, the lyrics visualization quality is very good, especially on large screens. Being a text file it could also contain meta information (artist and song name, overall song delay and so on), is easy to edit/fix, and easy to create. Under Linux such files could be [[HOW-TO: Create karaoke lyrics|created]] in five minutes using free software.<br />
<br />
=== MP3+TXT (UltraStar) ===<br />
Similar to CDG and LRC, the karaoke song consist of several files. Usually it's just two files - the music file (usually MP3 but could be any playable type), and a separate text file with the same file name as the music file, but with .txt extension. This is relatively new and a very popular format due to its usage in UltraStar game and its numerous clones. This format also supports pitch, which is now ignored but in future may be used to track the individual performance. Also the song archive often includes video and pictures. At this moment the pictures are ignored, however the video will be played at background if available.<br />
<br />
There are several song packages available in Internet. For starters, the Performous web site, http://performous.org/, contains a few songs with a liberal license. A bunch of websites over Internet are also providing Ultrastar lyrics (only text, they do not provide music).<br />
<br />
You can create your own MP3 and TXT files from Karaoke MIDI files or ABC files. Since the timing of lyrics is already in the Karaoke MIDI file, it's easier to programatically convert this information to the TXT format rather than trying to create lyrics files by hand. See the tips under the Karaoke MIDI section for creating Karaoke MIDI files from ABC files. To convert a Karaoke MIDI file to MP3, you can use Timidity itself. Timidity can take a MIDI file and convert it to WAV or other formats. If your version of Timidity doesn't support MP3, you can convert to WAV and then use a program like Audacity or Sox to convert to MP3. Many UltraStar files are also availabe in [http://www.vorbis.com/ Ogg Vorbis] (rather than MP3). Again, you can use tools like Audacity or Sox to convert audio file formats as necessary. To create a text file with lyrics automatically from a Karaoke MIDI file, so far, the only program I've found for this is [http://ultrastar.fr.free.fr/index.php?name=Forums&file=viewtopic&t=62 MidiKar2UltraStar]. It's written in Java and isn't Open Source. It would be nice to find some Open Source programs to automate the lyrics conversion.<br />
<br />
=== MIDI/KAR ===<br />
The karaoke song consist of a single MIDI file which usually has .kar or .mid extension. The MIDI file inside usually contains multiple tracks, and one of those tracks contains lyrics synchronized with the music. Because MIDI file only contains instructions for the music synthesizer (like //play note "A" using instrument "Grand Piano"//) and do not contain the music itself, the file is usually very small. Most song files are around 50K. Vast majority of MIDI files is created by amateurs, and legally offered for download for free. This format is very popular in Eastern Europe. But for any language it's usually much easier to find a MIDI karaoke song than MP3 karaoke song.<br />
<br />
To play MIDI files, Kodi incorporates a MIDI synthesizer Timidity++. This is a full-featured synthesizer which supports soundfonts, but special configuration is required. Since the lyrics in the MIDI file are in text format, a good quality rendering is possible. However there is no standard which would require MIDI files to use only UTF8 encoding, and therefore some of them use UTF8, and some of them use local encoding. Kodi tries to auto-detect whether to use UTF-8 but it might not always succeed. The text in MIDI files is relatively hard to edit or modify, however a lot of editors are available on all platforms, and there is open-source free software like Rosegarden to edit MIDI files.<br />
<br />
You can create your own Karaoke MIDI files using a standard text editor, ABC notation and the Open Source program [http://abc.sourceforge.net/abcMIDI/ abc2midi]. This will work on all platforms. If you're familiar with notes or can read sheet music, [http://abcnotation.com/ ABC Notation] should be easy to work with. You can also convert available ABC files to MIDI or Karaoke MIDI files to use with Kodi. If you have a MIDI file and want to edit it to add or tweak lyrics or change some notes, you can use [http://abc.sourceforge.net/abcMIDI/ midi2abc] to convert to ABC notation and then edit in a text editor. (You may lose some information in the conversion to ABC, but you can now change the music however you want.) After editing, you can convert back to Karaoke MIDI using abc2midi. If you want a more lossless way to edit MIDI files, try mf2t and t2mf or midicomp (combination of mf2t and t2mf available at [http://freepats.zenvoid.org/ Freepats site]). These Open Source programs let you convert a Karoake MIDI file directly into a text format that can edited in any standard text editor. You can easily edit Karaoke lyrics in this format. The programs then convert the text file back to Karaoke MIDI format.<br />
<br />
== Configuration ==<br />
Kodi needs to be configured to support karaoke. You need is to enable karaoke in the Setup -> Music -> Karaoke. I also suggest to disable "Music -> General -> Auto play next item" as it's usually not desirable for karaoke.<br />
<br />
=== Skin selection ===<br />
Skins other than default Confluence might require extra files to support Karaoke. Please make sure everything works with the default skin before switching to another, and if something does not work, please make sure it does not work on default skin too. The rule is the following: bugs in karaoke which happen using default skin, are assigned to me. Bugs which only happen using non-default skin, should be assigned to the team/person responsible for this skin.<br />
<br />
=== Checking timings ===<br />
You need to make sure there is no delay between audio and lyrics, or set up the appropriate value to compensate it. For this, get a couple of songs which you're sure are synchronized properly, and try to play it. If the lyrics are not synchronized, adjust delay through advancedsettings.xml. Note that there are two different delays for CDG and for LRC files. There is no delay for MIDI playback, it must be always synchronized.<br />
<br />
=== MIDI playback ===<br />
There are two ways to configure embedded Timidity synthesizer and enable MIDI playback - a simple way, and a more advanced way.<br />
<br />
Simple way, you need a single soundfont file. Those are typically large (50Mb+) files with .sf2 extension, the most popular resource is http://www.sf2midi.com <br />
I recommend using widespread and well-tested SGM-180 soundfont, google for it or get 2.01 version from http://www.geocities.jp/shansoundfont/ (this one is included into Arch linux in the soundfont-sgm180 package). Download the file, rename it to '''soundfont.sf2''' and put it into your Kodi directory:<br />
* For revisions before 35301 copy it into '''system/players/paplayer/timidity''' subdirectory (you must create it first). <br />
* For revisions after 35301 copy it into '''timidity''' subdirectory in your home '''userdata''' folder, i.e. something like .kodi/userdata/timidity/soundfont.sf2<br />
<br />
Advanced way, you need to prepare timidity.cfg configuration file. Usually this is necessary when you use multiple soundfonts or want to add post-processing effects. This means you know enough of Timidity, and could handle it yourself. Kodi embeds [http://trac.kodi.tv/ticket/5490 version 2.13.2 of Timidity]. (Note: Versions of Timidity created in 2010 and after have better support for Karaoke midi files created by ABC notation and better timing for lyrics especially in the xaw part of the code.) Create timidity.cfg and put it in the '''system/players/paplayer/timidity''' subdirectory, and check Kodi log file for errors if it doesn't work. There's a soundfont configurator tool available online at [http://ocmnet.com/saxguru/Timidity.htm Tim Brechbill's Timidity site]. It's assumes you're on a Windows system, but should be okay with Posix systems too if you correct your paths appropriately. You can use it to generate the Timidity.cfg file for you. There are also links to other good soundfonts at this site.<br />
<br />
Please note that for SGM-180 soundfont playback you need a decent machine with at least 256Mb of RAM and at least Pentium 2.4GHz CPU. Otherwise get a smaller soundfont.<br />
<br />
If you want to use soundfonts with Open Source and/or Creative Commons licenses, check out the [http://freepats.zenvoid.org/ Freepats Project]. Many Linux distributions offer a Freepats package. The Freepats Project has Open Source and/or Creative Commons licensed soundfonts, instruments sounds and tools to create your own soundfonts.<br />
<br />
=== Selection by number ===<br />
To enable song selection by number, your music collection needs to be scanned (or rescanned if it was scanned already). During scan, the karaoke songs are detected, and the song numbers will be automatically assigned. After the scan is completed, you can export the numbered songs as HTML file (Setup -> Music -> Karaoke -> Export Karaoke titles... -> Export as HTML), open them in the OpenOffice Writer and print a song directory to have a professional Karaoke setup. Use two-column mode if you want to save space.<br />
<br />
It is also possible to change the song numbering if you don't like it or if you want to maintain compatibility with your printed guide. For this you need to export numbered songs as CSV (Setup -> Music -> Karaoke -> Export Karaoke titles... -> Export as CSV), modify it as necessary, and import it back (Setup -> Music -> Karaoke -> Import Karaoke titles). The CSV format is TAB-separated, no quotes, no escape characters. The first field is song number, second field is artist name, third is song name, and fourth is path to the music file. <br />
<br />
It is possible to select songs while a karaoke song is still played, by using numbers on your remote. This feature is enabled by default, however you need to make sure that the number buttons from your remote generate Number* events. By default they do not, so you need to modify your Keymap.xml. Put the following in your <remote> section:<br />
<br />
<pre><br />
<zero>Number0</zero><br />
<one>Number1</one><br />
<two>Number2</two><br />
<three>Number3</three><br />
<four>Number4</four><br />
<five>Number5</five><br />
<six>Number6</six><br />
<seven>Number7</seven><br />
<eight>Number8</eight><br />
<nine>Number9</nine><br />
</pre><br />
<br />
When you start pressing numbers, a small dialog will pop up in a left top screen corner. It will show selected song number and song name or "Unknown" if there is no such song for this name. Once the song is selected, press "Select" on your remote to add it into the playlist.<br />
<br />
=== Show song selector automatically ===<br />
If the setting "Show song selector automatically" is enabled, the song selection dialog will pop up after the karaoke song ends if there are no more songs in the queue. It will not pop up after a non-Karaoke song. This dialog works exactly as the in-song dialog, however once the song is selected, it starts playing immediately.<br />
<br />
=== Setting up default background mode ===<br />
Default background mode is "no background". If you wish to use visualization, video or a picture as background, it should be enabled in [[AdvancedSettings.xml#.3Ckaraoke.3E|advancedsettings.xml]].<br />
<br />
For video background the video file must be available in supported format. Currently all the formats which could be played by Kodi are supported with exception of DVD and DVD images. Video playback is in alpha phase, so currently only one video could be selected as background. Using highly compressed video is not recommended; MPEG2 is recommended for fast machines and MPEG1 for slow machines. Educational videos like National Geography look very good for background. Stripping audio is not needed, as any available audio stream will be ignored.<br />
<br />
When playing CDG+MP3 files, note that they usually have their own background which you can turn on/off in [[AdvancedSettings.xml#.3Ckaraoke.3E|advancedsettings.xml]] as well.<br />
<br />
== Where to get Karaoke files ==<br />
'''MP3+CDG'''. CD-G disks are available from many online retailers such as http://www.shopkaraoke.com or http://www.mycdg.com, as well as from some high street shops. Since at this moment Kodi cannot play such disks, you're suggested to rip them using available tools. Once you have ripped the disks to MP3+G format, you can play the songs directly from your hard disk using Kodi.<br />
<br />
Alternatively there are some online retailers offering downloadable MP3+G files. See http://www.tricerasoft.com for a good example. From sites like this you can download the files already in MP3+G format and play them directly using Kodi. There is also a bunch of web sites selling huge collections of MP3+G songs on multiple DVD disks.<br />
<br />
'''MP3+LRC'''. At this moment we do not know about any vendor which would sell legit MP3 karaoke files with LRC lyrics. A lot of LRC karaoke files and music are available on Asian (mostly Chinese) web sites, either freely or commercially, but their legality is questionable. However, LRC lyrics alone are freely available at a lot of web sites, and relatively easy to create, see the article in this wiki on [[HOW-TO create LRC karaoke lyrics files]].<br />
<br />
'''MP3+TXT'''. A few Creative Commons licensed songs come with UltraStar Deluxe. These will work on POSIX platforms as well as Windows. You can do a [http://search.creativecommons.org/ search on Creative Commons licensed MP3 files] to find songs you can legally share with others. You'll probably need to create your own lyrics files though. You can also check Ultrastar, Ultrastar Deluxe and Performous forums for more songs and/or lyrics. If you legally own songs on CD, you can rip them to WAV for personal use using Open Source tools like CDex or Asunder or K3B and then convert to MP3 with tools like Audacity or Sox. Some software may convert directly to MP3.<br />
<br />
'''MIDI'''. MIDI karaoke files are mostly available for free as "public domain", while only a few of them are available commercially. (Note: Some freely available MIDI Karaoke files have copyright notifications embedded in them. Also, just because the MIDI file is available for free, doesn't mean it's public domain. If the song itself is under copyright, the midi file is not legally in the public domain.) They are often found in specialized musician/karaoke forums as well as on [http://www.midikaraoke.com dedicated websites]. The MIDI format was very popular before introduction of MP3, and tons of them could be found in the old newsgroups archives. There's also a search engine for Karaoke MIDI files at the VanBasco site, but the site isn't always available.<br />
<br />
'''ABC'''. ABC Notation text files files can easily be converted to Karaoke MIDI files or even MP3 files with text lyrics. Many are free, in the public domain or have friendly licensing restrictions. There are several [http://abcnotation.com/search search engines] available for them. Another good place to look for them is [http://www.mudcat.org/ The Mudcat Cafe].<br />
<br />
== Playing ==<br />
Select the Karaoke song (either on disk or by number) and press "Select". The screen should change to visualization, and the song should start playing with the lyrics shown on screen. For us the best visualization for karaoke so far was Goom, but it is very resource-consuming so if your hardware is not top notch, you might want to switch to Project M instead, which is also very good.<br />
<br />
If the lyrics for this specific song need to start earlier or later, press the button associated with SubtitleDelayPlus or SubtitleDelayMinus until lyrics are synchronized. Each press changes the delay by 50ms.<br />
<br />
If you're in the middle of a song and decide you want to hear something else, press x to get back to your song listings. You can also move through your songs lists by pressing , or . to go backward or forward in your song listings.<br />
<br />
== Advanced settings ==<br />
The following advanced settings are added for karaoke support. All they must be stored in the advancedsettings.xml file in the <karaoke> section:<br />
{{#lst:Advancedsettings.xml|karaoke}}<br />
<br />
== See also ==<br />
{{#dpl: | category = Karaoke }}<br />
<br />
[[Category:Manual]]<br />
[[Category:How-to]]<br />
[[Category:Karaoke]]<br />
[[Category:Music library]]</div>UNiversalhttps://kodi.wiki/index.php?title=SSH&diff=97514SSH2015-06-12T09:59:30Z<p>UNiversal: argh capital Y</p>
<hr />
<div>{{Isengard updated}}{{greenv|Instructions:|This page contains instructions on how-to initiate a connections via SSH}}<br />
{{redv|Notice:|Check local legislation about use of encryption and programs that use them, e.g. PuTTY.}}<br />
<br />
Secure Shell (SSH) - (SSH client) is a program for logging into a remote machine and for executing commands on a remote machine, provides secure encrypted communications between two untrusted hosts over an insecure network. X11 connections and arbitrary TCP ports can also be forwarded over the secure channel.<br /><br />
<br />
== Connecting to Kodibuntu via SSH ==<br />
<br />
While you can use a SFTP GUI application to transfer and edit files similar can be achieved via command line<br />
<br />
=== Windows SSH using PuTTY ===<br />
<br />
# Under Host name (or IP address) enter the desired IP (e.g. 192.168.1.254)<br />
# Under port enter '''22'''<br />
# Click '''Open''' <br />
<br />
<br />
[[File:Putty1.png]]<br />
<br />
<br />
'''The first time you connect, you may see a dialog like:'''<br />
<br />
<br />
[[File:Putty2.png]]<br />
<br />
<br />
Click {{button|Yes}} to accept the key displayed.<br />
<br />
=== Linux or OS X Shell ===<br />
<br />
From a Linux or OS X shell. The command is:<br />
<br />
<pre><br />
ssh <username>@&lt;ip address><br />
</pre><br />
<br />
'''The first time you connect, you may see a prompt like:'''<br />
<br />
<pre><br />
The authenticity of host '192.168.1.80 (192.168.1.254)' can't be established.<br />
RSA key fingerprint is ad:4d:14:4d:74:19:fa:f1:fa:c6:ee:81:36:29:be:f4.<br />
Are you sure you want to continue connecting (yes/no)?<br />
</pre><br />
<br />
Type '''yes''' and press {{key press | Enter }}<br />
<br />
== See also ==<br />
* [[SFTP]]<br />
<br />
[[Category:Manual]]<br />
[[Category:Linux]]<br />
[[Category:IOS]]<br />
[[Category:Mac OS X]]<br />
[[Category:Kodibuntu]]</div>UNiversalhttps://kodi.wiki/index.php?title=SSH&diff=97513SSH2015-06-12T09:58:29Z<p>UNiversal: putty -> PuTTy</p>
<hr />
<div>{{Isengard updated}}{{greenv|Instructions:|This page contains instructions on how-to initiate a connections via SSH}}<br />
{{redv|Notice:|Check local legislation about use of encryption and programs that use them, e.g. PuTTy.}}<br />
<br />
Secure Shell (SSH) - (SSH client) is a program for logging into a remote machine and for executing commands on a remote machine, provides secure encrypted communications between two untrusted hosts over an insecure network. X11 connections and arbitrary TCP ports can also be forwarded over the secure channel.<br /><br />
<br />
== Connecting to Kodibuntu via SSH ==<br />
<br />
While you can use a SFTP GUI application to transfer and edit files similar can be achieved via command line<br />
<br />
=== Windows SSH using PuTTy ===<br />
<br />
# Under Host name (or IP address) enter the desired IP (e.g. 192.168.1.254)<br />
# Under port enter '''22'''<br />
# Click '''Open''' <br />
<br />
<br />
[[File:Putty1.png]]<br />
<br />
<br />
'''The first time you connect, you may see a dialog like:'''<br />
<br />
<br />
[[File:Putty2.png]]<br />
<br />
<br />
Click {{button|Yes}} to accept the key displayed.<br />
<br />
=== Linux or OS X Shell ===<br />
<br />
From a Linux or OS X shell. The command is:<br />
<br />
<pre><br />
ssh <username>@&lt;ip address><br />
</pre><br />
<br />
'''The first time you connect, you may see a prompt like:'''<br />
<br />
<pre><br />
The authenticity of host '192.168.1.80 (192.168.1.254)' can't be established.<br />
RSA key fingerprint is ad:4d:14:4d:74:19:fa:f1:fa:c6:ee:81:36:29:be:f4.<br />
Are you sure you want to continue connecting (yes/no)?<br />
</pre><br />
<br />
Type '''yes''' and press {{key press | Enter }}<br />
<br />
== See also ==<br />
* [[SFTP]]<br />
<br />
[[Category:Manual]]<br />
[[Category:Linux]]<br />
[[Category:IOS]]<br />
[[Category:Mac OS X]]<br />
[[Category:Kodibuntu]]</div>UNiversalhttps://kodi.wiki/index.php?title=SSH&diff=97512SSH2015-06-12T09:54:49Z<p>UNiversal: /* Connecting to Kodibuntu via SSH */ minor</p>
<hr />
<div>{{Isengard updated}}{{greenv|Instructions:|This page contains instructions on how-to initiate a connections via SSH}}<br />
{{redv|Notice:|Check local legislation about use of encryption and programs that use them, e.g. putty.}}<br />
<br />
Secure Shell (SSH) - (SSH client) is a program for logging into a remote machine and for executing commands on a remote machine, provides secure encrypted communications between two untrusted hosts over an insecure network. X11 connections and arbitrary TCP ports can also be forwarded over the secure channel.<br /><br />
<br />
== Connecting to Kodibuntu via SSH ==<br />
<br />
While you can use a SFTP GUI application to transfer and edit files similar can be achieved via command line<br />
<br />
=== Windows SSH using putty ===<br />
<br />
# Under Host name (or IP address) enter the desired IP (e.g. 192.168.1.254)<br />
# Under port enter '''22'''<br />
# Click '''Open''' <br />
<br />
<br />
[[File:Putty1.png]]<br />
<br />
<br />
'''The first time you connect, you may see a dialog like:'''<br />
<br />
<br />
[[File:Putty2.png]]<br />
<br />
<br />
Click {{button|Yes}} to accept the key displayed.<br />
<br />
=== Linux or OS X Shell ===<br />
<br />
From a Linux or OS X shell. The command is:<br />
<br />
<pre><br />
ssh <username>@&lt;ip address><br />
</pre><br />
<br />
'''The first time you connect, you may see a prompt like:'''<br />
<br />
<pre><br />
The authenticity of host '192.168.1.80 (192.168.1.254)' can't be established.<br />
RSA key fingerprint is ad:4d:14:4d:74:19:fa:f1:fa:c6:ee:81:36:29:be:f4.<br />
Are you sure you want to continue connecting (yes/no)?<br />
</pre><br />
<br />
Type '''yes''' and press {{key press | Enter }}<br />
<br />
== See also ==<br />
* [[SFTP]]<br />
<br />
[[Category:Manual]]<br />
[[Category:Linux]]<br />
[[Category:IOS]]<br />
[[Category:Mac OS X]]<br />
[[Category:Kodibuntu]]</div>UNiversalhttps://kodi.wiki/index.php?title=SSH&diff=97511SSH2015-06-12T09:52:11Z<p>UNiversal: </p>
<hr />
<div>{{Isengard updated}}{{greenv|Instructions:|This page contains instructions on how-to initiate a connections via SSH}}<br />
{{redv|Notice:|Check local legislation about use of encryption and programs that use them, e.g. putty.}}<br />
<br />
Secure Shell (SSH) - (SSH client) is a program for logging into a remote machine and for executing commands on a remote machine, provides secure encrypted communications between two untrusted hosts over an insecure network. X11 connections and arbitrary TCP ports can also be forwarded over the secure channel.<br /><br />
<br />
== Connecting to Kodibuntu via SSH ==<br />
<br />
While you can use a SFTP GUI application to transfer and edit files similar can be achieved via command line<br />
<br />
=== Windows SSH using putty ===<br />
<br />
# Under Host name (or IP address) enter the desired IP (e.g. 192.168.1.254)<br />
# Under port enter '''22'''<br />
# Click '''Open''' <br />
<br />
<br />
[[File:Putty1.png]]<br />
<br />
<br />
'''The first time you connect this may ask you something like:'''<br />
<br />
<br />
[[File:Putty2.png]]<br />
<br />
<br />
Click {{button|Yes}} To accept the key displayed.<br />
<br />
=== Linux or OS X Shell ===<br />
<br />
From a Linux or OS X shell. The command is:<br />
<br />
<pre><br />
ssh <username>@&lt;ip address><br />
</pre><br />
<br />
'''The first time you connect this may ask you something like:'''<br />
<br />
<pre><br />
The authenticity of host '192.168.1.80 (192.168.1.254)' can't be established.<br />
RSA key fingerprint is ad:4d:14:4d:74:19:fa:f1:fa:c6:ee:81:36:29:be:f4.<br />
Are you sure you want to continue connecting (yes/no)?<br />
</pre><br />
<br />
Type '''yes''' and press {{key press | Enter }}<br />
<br />
== See also ==<br />
* [[SFTP]]<br />
<br />
[[Category:Manual]]<br />
[[Category:Linux]]<br />
[[Category:IOS]]<br />
[[Category:Mac OS X]]<br />
[[Category:Kodibuntu]]</div>UNiversalhttps://kodi.wiki/index.php?title=SSH&diff=97510SSH2015-06-12T09:41:16Z<p>UNiversal: </p>
<hr />
<div>{{Isengard updated}}{{greenv|Instructions:|This page contains instructions on how-to initiate a connections via SSH}}<br />
{{redv|Notice:|Check local legislation about use of encryption and programs that use them, e.g. putty.}}<br />
<br />
Secure Shell (SSH) - (SSH client) is a program for logging into a remote machine and for executing commands on a remote machine, provides secure encrypted communications between two untrusted hosts over an insecure network. X11 connections and arbitrary TCP ports can also be forwarded over the secure channel.<br /><br />
<br />
== Connecting to Kodibuntu via SSH ==<br />
<br />
While you can use a SFTP GUI application to transfer and edit files similar can be achieved via command line<br />
<br />
=== Windows SSH using putty ===<br />
<br />
# Under Host name (or IP address) enter the desired IP (e.g. 192.168.1.254)<br />
# Under port enter '''22'''<br />
# Click '''Open''' <br />
<br />
<br />
[[File:Putty1.png]]<br />
<br />
<br />
'''The first time you connect this may ask you something like:'''<br />
<br />
<br />
[[File:Putty2.png]]<br />
<br />
<br />
Click '''Yes'''<br />
<br />
=== Linux or OS X Shell ===<br />
<br />
From a Linux or OS X shell. The command is:<br />
<br />
<pre><br />
ssh <username>@&lt;ip address><br />
</pre><br />
<br />
'''The first time you connect this may ask you something like:'''<br />
<br />
<pre><br />
The authenticity of host '192.168.1.80 (192.168.1.254)' can't be established.<br />
RSA key fingerprint is ad:4d:14:4d:74:19:fa:f1:fa:c6:ee:81:36:29:be:f4.<br />
Are you sure you want to continue connecting (yes/no)?<br />
</pre><br />
<br />
Type '''yes'''<br />
<br />
== See also ==<br />
* [[SFTP]]<br />
<br />
[[Category:Manual]]<br />
[[Category:Linux]]<br />
[[Category:IOS]]<br />
[[Category:Mac OS X]]<br />
[[Category:Kodibuntu]]</div>UNiversalhttps://kodi.wiki/index.php?title=SSH&diff=97509SSH2015-06-12T09:40:25Z<p>UNiversal: </p>
<hr />
<div>{{Helix updated}}{{greenv|Instructions:|This page contains instructions on how-to initiate a connections via SSH}}<br />
{{redv|Notice:|Check local legislation about use of encryption and programs that use them, e.g. putty.}}<br />
<br />
Secure Shell (SSH) - (SSH client) is a program for logging into a remote machine and for executing commands on a remote machine, provides secure encrypted communications between two untrusted hosts over an insecure network. X11 connections and arbitrary TCP ports can also be forwarded over the secure channel.<br /><br />
<br />
== Connecting to Kodibuntu via SSH ==<br />
<br />
While you can use a SFTP GUI application to transfer and edit files similar can be achieved via command line<br />
<br />
=== Windows SSH using putty ===<br />
<br />
# Under Host name (or IP address) enter the desired IP (e.g. 192.168.1.254)<br />
# Under port enter '''22'''<br />
# Click '''Open''' <br />
<br />
<br />
[[File:Putty1.png]]<br />
<br />
<br />
'''The first time you connect this may ask you something like:'''<br />
<br />
<br />
[[File:Putty2.png]]<br />
<br />
<br />
Click '''Yes'''<br />
<br />
=== Linux or OS X Shell ===<br />
<br />
From a Linux or OS X shell. The command is:<br />
<br />
<pre><br />
ssh <username>@&lt;ip address><br />
</pre><br />
<br />
'''The first time you connect this may ask you something like:'''<br />
<br />
<pre><br />
The authenticity of host '192.168.1.80 (192.168.1.254)' can't be established.<br />
RSA key fingerprint is ad:4d:14:4d:74:19:fa:f1:fa:c6:ee:81:36:29:be:f4.<br />
Are you sure you want to continue connecting (yes/no)?<br />
</pre><br />
<br />
Type '''yes'''<br />
<br />
== See also ==<br />
* [[SFTP]]<br />
<br />
[[Category:Manual]]<br />
[[Category:Linux]]<br />
[[Category:IOS]]<br />
[[Category:Mac OS X]]<br />
[[Category:Kodibuntu]]</div>UNiversalhttps://kodi.wiki/index.php?title=NFS&diff=94504NFS2015-05-08T23:22:55Z<p>UNiversal: </p>
<hr />
<div>{{mininav| [[Media sources]] | [[File sharing]] }}<br />
<section begin="intro"/>'''Network File System''', or '''[http://en.wikipedia.org/wiki/Network_File_System_%28protocol%29 NFS]''', is a way to share folders over a network, and was added to XBMC in v11 (Eden). The main benefits of using NFS instead of SMB are its low protocol overhead (which allows it to send data across a network more quickly) and its use of simple [http://en.wikipedia.org/wiki/User_identifier UID's] to authenticate users rather than username/password combinations. This part bears repeating, as many people are confused on this point and try to create usernames and passwords to get Kodi to work with NFS: '''NFS does not use usernames or passwords as logins;''' it uses a UNIX-based "userID" (UID) alone.<section end="intro"/><br />
<br />
NFS's main disadvantage in comparison to SMB (a commonly-encountered protocol in Windows environments) is that it can be more complicated to set up in some cases, since many non-technical users are unfamiliar with configuring UNIX-based protocols.<br />
<br />
NFS is commonly found on all Linux/UNIX distributions, as well as on OS X and Solaris, and offers several features:<br />
:* It is already incorporated in UNIX-like operating systems (such as OS X), eliminating the need for additional software and services to be installed on your computer.<br />
:* It allows for authentication by UID, thus eliminating the need to save usernames and passwords in XBMC source XML files (note, however, that this simple authentication also makes it more vulnerable to attacks; NFS should be only used inside a private LAN).<br />
:* Once properly configured, NFS will allow your network shares to be seen and accessed by not only Kodi, but also any other machine on your network.<br />
<br />
;{{note|If you already have a working NFS server check that the export options required by Kodi have been set (as described in the relevant section below).}} <br />
<br />
When configuring NFS shares to use as network sources for Kodi's music/video libraries, use the following format: '''nfs://1.2.3.4/path/to/folder''' (where "1.2.3.4" should be replaced with the IP of your NFS server, and "/path/to/folder" should be replaced with the path to the folder you want to share; a double slash between the server and the path is wrong, you '''should not''' use nfs://1.2.3.4//path/to/folder). See the sections below for help configuring NFS shares on various devices' operating systems.<br />
<br />
For more info on network sources for your music and video in Kodi, see [[Types of Media Sources]].<br /><br />
<br />
<br />
== NFS sharing from Windows ==<br />
Windows does not have any built-in native ability to share folders via NFS; and only a limited selection of Windows operating systems have the native ability to access NFS shares as a client. However, several third-party solutions attempt to provide NFS functionality, on both the server side and the client side.<br />
<br />
For ''serving'' (sharing) files from Windows using NFS, there seem to be three choices:<br />
:* Windows Server 2003 R2, Windows Server 2008 and Windows Server 2012 have built-in NFS Server and Client through Subsystem for UNIX-based Applications (SUA). With 64-bit support, this solution supports files up to 4TB in size<br />
:* [http://en.wikipedia.org/wiki/Microsoft_Windows_Services_for_UNIX Microsoft Windows Services for UNIX (SFU)] available [http://www.microsoft.com/download/en/details.aspx?id=274 here]for Windows 2000, Windows XP Professional (NOT Home edition, without a [http://www.networkedmediatank.com/showthread.php?tid=1434 hexedit hack]), Windows 2003 Server, and Windows Home Server (based on 2003 Server). SFU is 32-bit only, which ''may'' mean it only supports files up to 2GB in size, [http://www.suacommunity.com/SUA_Tools_Env_Start.htm#_Toc203389873 according to some sources] (this is unconfirmed). A good installation guide can be found [http://www.networkedmediatank.com/showthread.php?tid=1434 here]. Windows SFU will not install on Windows Vista or Windows 7, so there is no way to ''serve'' NFS from Windows Vista or Windows 7 with the possible exception of the haneWIN solution below, but it is unconfirmed if that works with Windows Vista/7.<br />
:* [http://www.hanewin.net/nfs-e.htm haneWIN NFS Server for Windows] - a shareware program that costs 19EUR for non-commercial use. Claims to work for "Windows 2000 and above."<br />
<br />
== NFS sharing from OS X ==<br />
{{see also|NFS Manager}}<br />
NFS is built into Mac OS X (OS 10.5 and later), and thus no additional software is required to set up NFS shares on a Mac OS X device.<br />
<br />
;{{note|The following assumes some basic knowledge of the UNIX/BSD operating system interface and environment, and assumes you are familiar with using a Mac's Terminal command-line utility. It also assumes you have a beginner's understanding of UNIX text editors such as [http://mintaka.sdsu.edu/reu/nano.html nano] or [http://www.eng.hawaii.edu/Tutor/vi.html vi].}}<br />
<br />
1. To allow regular (non-root) users to connect to your NFS shared folders, you'll need to edit the "/System/Library/LaunchDaemons/com.apple.nfsd.plist" file. Open it and add the option "-N" to the startup parameters as follows: <br />
<br />
<array><br />
<string>/sbin/nfsd</string><br />
'''<string>-N</string>'''<br />
</array><br />
<br />
If you don't do this step, Kodi will only be able to access the Mac's shared NFS folders if Kodi is running as root (normally, Kodi does not run as root, so you will almost certainly want to do this first step and add the -N parameter).<br />
<br />
2. The NFS server and its shared folders are set up in a config file named "exports", located in the /etc directory. Technically speaking, with NFS you "export a path" rather than "share a folder" (which is why the file is named "exports"), but we'll use the latter phrasing for simplicity's sake.<br />
<br />
The /etc/exports file may not yet exist; if not, you'll need to create it. The file is edited either manually (in Terminal, using a UNIX text editor such as '''nano''' or '''vi''') or via a GUI utility, the most well-known of which is [http://www.bresink.com/osx/NFSManager.html NFS Manager]. The following guide assumes you are using Terminal (if using NFS Manager, consult that software's documentation for help).<br />
<br />
To view the current contents of /etc/exports, if any, execute the following command in a Terminal window:<br />
<br />
'''cat /etc/exports'''<br />
<br />
Any folders to be shared via NFS should be listed on separate lines, along with any configuration parameters governing connections to those folders. The lines should follow this general format:<br />
<br />
/path/to/folder_name_to_share [-parameter1 -parameter2 ...] <IP address restriction (optional)><br />
<br />
<big>Examples</big><br />
<br />
In this sample /etc/exports file, we've set up four folders to be shared via NFS, using various parameters and options. The folders are all contained in a folder called "nfs_shares", and are named to indicate some things about how we've set them up; obviously, on your system, the folder names would be things like "video", "music", and so on.<br />
<br />
/nfs_shares/allread -ro -mapall=nobody -alldirs<br />
/nfs_shares/allwrite -mapall=nobody -alldirs -network 192.168.1.0 -mask 255.255.255.0<br />
/nfs_shares/writeAs501 -mapall=501 -alldirs 192.168.1.5<br />
/nfs_shares/Kodiuser<br />
<br />
Let's look at what each of these shared folder configurations means.<br />
<br />
* The folder "'''/nfs_shares/allread'''" can be accessed from all computers (because no IP address is given), is read-only ("'''-ro'''"), and all incoming connections are assigned the same permissions as the UNIX user "nobody", who has anonymous access ("'''-mapall=nobody'''"). This last parameter ensures that anyone can access the folder, but they will not have any rights on your NFS server other than those belonging to the "nobody" user. Also, the "'''-alldirs'''" parameter is used to indicate that incoming connections can mount either the /allread folder OR any subfolder underneath /allread.<br />
<br />
* The folder "'''/nfs_shares/allwrite'''" can be accessed from all computers on the subnet 192.168.1.0/255.255.255.0, has read and write permissions (we've omitted "'''-ro'''"), and again access rights for user "nobody" are assigned ("'''-mapall=nobody'''"). The "'''-alldirs'''" parameter is once again used to allow subfolders to be mounted directly.<br />
<br />
* The folder "'''/nfs_shares/writeAs501'''" can be accessed from the computer with an IP of 192.168.1.5, has read and write permissions (again we've omitted "'''-ro'''"), and access rights belonging to users on your system with a UID of 501 (see note below) will be inherited by all incoming connections ('''-mapall=501'''). The "'''-alldirs'''" parameter is once again used to allow subfolders to be mounted directly.<br />
<br />
:;{{note|As already mentioned, authentication to the NFS server is done by checking UIDs. For Kodi, this means that the UID which the Kodi process is running under is given to the NFS server to be authenticated. To find out your current UID, just type "id" into a console:}}<br />
<br />
Mac:~ [''your_user_name'']$ '''id'''<br />
<br />
::You should see something that begins like this:<br />
<br />
uid=501(''your_user_name'')<br />
<br />
:In this example, my UID is 501. If you are going to be connecting to your NFS shared folder from Kodi on iOS, keep in mind that on iOS Kodi runs as the user "mobile", which should have UID 501 also. <br />
<br />
* The folder "'''/nfs_shares/Kodiuser'''" can be accessed from all computers ('''no ip given'''), readwrite (no "'''-ro'''") and the access rights belonging to the UID which is connecting to the NFS server are used ("'''-mapall'''" removed). <br />
;{{note|The important effect of the absence of the -mapall parameter in this case: if someone connects to your NFS server as root, they will be running on your system as root! Also note that because "-alldirs" is not specified, incoming connections will only be able to connect to the /Kodiuser folder, NOT any folders underneath it.}}<br />
<br />
Bear in mind that any UID's that are used to connect to the NFS server, or that are specified with "-mapall", have to exist on your NFS server (i.e. on your Mac).<br />
<br />
'''Each change on the exports config file needs a restart of the nfs server! Just issue "sudo nfsd restart" for this.'''<br />
<br />
3. Once you've configured and saved your /etc/exports file, the NFS server can be started either by rebooting or by executing the following command:<br />
<br />
$ sudo nfsd start<br />
<br />
=== Troubleshooting NFS on OS X ===<br />
<br />
==== -N flag is set, but shares still won’t work ====<br />
<br />
Sometimes there are issues with NFS shares on OS X. Most of them result in the <code>-N</code> flag not being set, but they result in different error messages or issues. One of the root issues is the flag being set in the Property List file, but not read by launchd which controls the process. The following observations are pretty common in this case and if you see one of these points, it won’t hurt to either inspect the nfsd process on your Mac or restart the whole computer.<br />
<br />
* You have successfully shared the volume and you can mount it from other Macs in your network (via ⌘K in the Finder), but not from Kodi.<br />
* You can add the computer share (e.g. <code>nfs://192.168.1.5/</code>), but not the share that contains a path (e.g. <code>nfs://192.168.1.5/nfs_shares/allread</code>).<br />
* When you add the computer share, you can enter it in Kodi’s browser, but then clicking on one of the mount points does nothing.<br />
* You see either '''"Server responded: Procedure not available"''' or '''"RPC Packet not accepted by the server"''' in the error logs.<br />
<br />
In most cases it’s sufficient to restart nfsd via launchd, just killing the process with <code>kill -9</code> or <code>killall nfsd</code> after applying changes to the Property List file has no effects. To restart nfsd via launchd you have to type the following command in the Terminal:<br />
<br />
sudo launchctl unload /System/Library/LaunchDaemons/com.apple.nfsd.plist && \<br />
sudo launchctl load /System/Library/LaunchDaemons/com.apple.nfsd.plist<br />
<br />
When you use <code>ps</code> to inspect the process, <code>-N</code> should be visible at the end of the line. If it’s not, then launchd didn’t apply the changes and just (re-)started nfsd with the old configuration. A proper output looks like this:<br />
<br />
~ '''ps aux | grep nfsd'''<br />
root 55828 0,0 0,0 2500812 2332 ?? Ss 3:54pm 0:08.96 /sbin/nfsd '''-N'''<br />
chiefsucker 58788 0,0 0,0 2435268 496 s000 U+ 7:22pm 0:00.00 grep nfsd<br />
<br />
Pay attention to the <code>-N</code> flag being visible in the ps output. If the <code>-N</code> flag is visible, but your shares don’t work, then it’s probably another issue.<br />
<br />
==== NFS shares stopped working after OS X upgrade ====<br />
<br />
If your share stopped working after you upgraded your OS (e.g. from Lion to Mountain Lion) then it usually means that the installer did overwrite the Property List file and you have to add <code>-N</code> again.<br />
<br />
==== My Mac goes to sleep while playing a movie from a NFS share ====<br />
<br />
OS X 10.8 Mountain Lion introduced some changes that result in very aggressive sleep behaviour. Because NFS shares aren’t handled and treated like shares set from within the Sharing panel in System Preferences, OS X will ignore clients that access your NFS shares and just put it to sleep. Fortunately there are some workarounds:<br />
<br />
# Set '''Computer sleep''' in the Energy Saver pane of System Preferences to '''Never'''. Unfortunately this will affect the whole machine and you’ll have to put your Mac manually to sleep from now on.<br />
# Get the [http://itunes.apple.com/app/caffeine/id411246225?mt=12 free Caffeine app from the Mac App Store]. The app will reside in your menu bar and you can prevent your Mac from sleeping with just one mouse-click. If you disable Caffeine (again with one click), your Mac will go to sleep as set in the System Preferences. This has the benefit of adjustable sleep behavior, i.e. you turn Caffeine on when you watch movies and you turn it off otherwise to preserve energy and save the planet.<br />
# You can reach the same goal with the Terminal app <code>caffeinate</code> that gets shipped with the OS since OS X 10.8 Mountain Lion.<br />
<br />
== NFS sharing from Linux ==<br />
<br />
NFS sharing has been built into linux kernel for a long time.<br />
<br />
;{{note|This article assumes some basic knowledge of the Linux/UNIX/BSD operating-system interface and environment.}}<br />
<br />
The configuration of the NFS server takes place in the config file "/etc/exports". As already mentioned, the authentication to the NFS server is done through UIDs. For Kodi, this means the UID that the Kodi process is running under is used to authenticate on the NFS server. To find out what UID Kodi is using, just type "id" into a console:<br />
<br />
penix:~ [your_user_name]$ id<br />
uid=501(your_user_name)<br />
<br />
In this example, my UID is 501. For iOS devices, keep in mind that Kodi is running as the user "mobile", whose UID should also be 501.<br />
<br />
A basic configuration for exporting a path with NFS looks like this:<br />
<br />
/nfs/export <ip or iprange which is allowed to connect>(rw,all_squash,insecure)<br />
<br />
The important options here for use with Kodi are the "ip or iprange" and the "insecure" options. The "insecure" option is needed because we want to be able to run Kodi without root privileges. If the insecure option is not enabled, only the root user (uid 0) will have access to the nfs share. The "ip or iprange" specifies which hosts on the network will be allowed to access the exported NFS share. <br />
<br />
By changing some of the options of that line, we can use any of three different approaches for getting the access rights configured as we want:<br />
<br />
1. The option all_squash (most insecure) - all UIDs connected to the NFS server are mapped to UID 65534 (user nobody)<br />
::* In this case all files which shall be accessed on the NFS exported path should have the correct rights for the user "nobody".<br />
2. Using the option "all_squash" in conjunction with the option "anonuid" and "anongid"<br />
::* By adding the options "anonuid=501" and "anongid=501" all accesses would be mapped to the user with UID 501 (user "mobile" on iOS or user "memphis" in my example above)<br />
3. Removing the "all_squash" option the accesses will be done with the UID given from the user which is running Kodi<br />
::* So if Kodi is started with username foobar (which has UID 1000) all accesses to the NFS export path will be made with UID 1000.<br />
<br />
<big>Examples for exported paths:</big><br />
### access from ''all computers'' ("'''*'''"), ''readonly'' ("'''ro'''"), access for user ''nobody'' ("'''all_squash'''")<br />
/nfs/allread *(ro,all_squash,insecure)<br />
<br />
### access from the subnet 192.168.1.0/255.255.255.0, ''read/write'' ("'''rw'''"), access for user ''nobody''<br />
### ("'''all_squash'''"). Remember that "'''rw'''" doesn't automatically allow writes; the user "nobody" must<br />
### have write access to the path on the filesystem.<br />
/nfs/allwrite 192.168.1.0/24(rw,all_squash,insecure)<br />
<br />
### access from 192.168.1.5, ''read/write'' ("'''rw'''"), access for user with UID 501 (i.e. memphis, for me)<br />
### ("'''all_squash,anonuid=501,anongid=501'''")<br />
/nfs/writeAsMemphis 192.168.1.5(rw,all_squash,insecure,anonuid=501,anongid=501)<br />
<br />
### access from ''all computers'' ("'''*'''"), ''read/write'' ("'''rw'''"), access for the UID connecting to the<br />
### NFS server ("'''all_squash'''" removed)<br />
/nfs/Kodiuser *(rw,insecure)<br />
<br />
### NTFS export *SECURITY Warning: this gives the user ROOT access*<br />
### access from the subnet 192.168.1.0/255.255.255.0, ''read/write'' ("'''rw'''"), nfs client connects<br />
### as root ("'''no_root_squash'''"). Otherwise, permission is for ''nfsnobody'', (uid 65534).<br />
### NTFS is non-POSIX permissions compliant, so you must access the share as ''root''<br />
/nfs/NTFS_share 192.168.1.0/24(rw,'''no_root_squash''',insecure)<br />
<br />
<br />
The UIDs which are used to connect to the NFS server or which are specified with "anonuid" and "anongid" have to exist on the NFS server. Otherwise the filesystem permission can't be set.<br />
<br />
Remember - access rights are these you give in the filesystem. '''After each change to the exports config file issue "sudo exportfs -ra"!'''<br />
<br />
== NFS sharing from FreeBSD ==<br />
This will get you going with NFSv3. <br />
Edit rc.conf:<br />
nfs_server_enable="YES"<br />
rpcbind_enable="YES"<br />
mountd_flags="YES"<br />
rpc_lockd_enable="YES"<br />
rpc_statd_enable="YES"<br />
weak_mountd_authentication="yes"<br />
<br />
Edit /etc/exports (change to network as required):<br />
/path/to/share -alldirs -maproot=root -network=192.168.1.0/24<br />
After that you can reboot or start the daemons:<br />
service rpcbind start<br />
service nfsd start<br />
service mountd start<br />
== NFS sharing from NAS4Free 9.x (successor to legacy FreeNAS 7.x) ==<br />
The information in the Linux section above also applies for *BSD based systems (such as FreeBSD). This section addresses some specific issues to bear in mind if you are using NAS4Free 9.x or FreeNAS 7.x (aka. legacy) installations.<br />
<br />
;{{note|FREENAS 8.3.0-RELEASE or later does not require modifying the rc.conf file for Kodi to access NFS shares. You must however enable "allow non-root mount" which can be found under the SERVICES - NFS section in the Freenas 8.3.0 web GUI.}}<br />
<br />
Setup your NFS shares as normal. Remember: don't create shares inside other shares. The following would be illegal...<br />
/mnt/disk -alldirs,quiet -mapall=root -network 192.168.1.0 -mask 255.255.255.0<br />
/mnt/disk/folder -alldirs,quiet -mapall=root -network 192.168.1.0 -mask 255.255.255.0<br />
...because the "/mnt/disk/folder" directory is already shared by "/mnt/disk". If you remember to set the setting "All dirs" when creating your NFS shares, the flag "-alldirs" will be set. This flag allows you to mount any subdirectory of your share just as if it was a share itself. Said another way: It's not necessary to share "/mnt/disk/folder" because you can mount it through the "/mnt/disk" share.<br />
<br />
After having set up a standard NFS share on your NAS4Free box, you need to add a few variables to rc.conf on NAS4Free. This is done by going into System > Advanced > rc.conf .<br />
Here you need to add the following:<br />
Variable Value Comment<br />
mountd_flags -n Allow non-root mount requests to be served. <br />
nfs_reserved_port_only NO Allow for insecure ports to be used by NFS. <br />
nfs_server_flags -u -t -n 4 Serve UDP and TCP with 4 servers. <br />
<br />
After this, apply your changes and reboot NAS4Free. You should now be able to mount your NFS shares, as well as any subdirectory of those shares.<br />
<br />
== NFS sharing from ZFSGuru ==<br />
Very similar to FreeNAS solution.<br />
mountd needs the -n flag.<br />
In ZFSGuru you can achieve this by adding<br />
weak_mountd_authentication="YES"<br />
to /etc/rc.conf<br />
<br />
== NFS sharing from commercial NAS systems such as Synology or QNAP ==<br />
Each NAS manufacturer, if it allows you to share folders via NFS on its NAS systems, does so in its own way. Often this will involve setup via the NAS's control panel or administrator interface. You can also connect to many NAS systems via ssh and manually edit files in order to set up and configure NFS (consult your NAS manual to see if this is possible/desirable/necessary). Since most NAS systems are based on Linux/UNIX, if you need to manually edit files, you should be able to make use of the [[#NFS sharing from Linux|Linux instructions above]] to create/edit your NFS shares.<br />
<br />
=== Troubleshooting NFS on a commercial NAS with Kodi ===<br />
Your NFS server on your NAS needs to be able to allow connections on so-called '''unprivileged ports''', which are port numbers higher than 1023. However, most NAS's are set up by default to deny incoming NFS connections on these unprivileged ports. This is one of the most common reasons why Kodi users experience problems when trying to connect to an NFS shared folder on a NAS.<br />
<br />
If you are having trouble connecting to your NFS shares on your NAS from Kodi, make sure your NFS shares have the "insecure" option enabled, which will allow connections on unprivileged ports. To check, connect to your NAS via ssh and issue the '''cat /etc/exports''' command. Your shared folders will each have several parameters listed separated by commas. If the "insecure" parameter is not listed, you will need to add that parameter to the list. This will usually involve directly editing the /etc/exports file with a UNIX text editor and adding the "insecure" option manually, although some NAS's may offer the ability to add the option via an admin interface. Check your NAS manual for details, or explore the section below if your brand of NAS is listed.<br />
<br />
=== Commercial NAS NFS setup instructions ===<br />
Kodi users have contributed the following NFS setup instructions for various brands of NAS devices. If your NAS is listed below, feel free to follow the accompanying instructions to set up NFS on your system.<br />
<br />
==== Synology ====<br />
[[File:Synology.png|link=]]<br /><br />
;{{note|You do not need to create a special user account on your Synology NAS in order to make use of NFS for Kodi. The following guide assumes you are comfortable with using the simplest (least secure) internal setup on your NAS, which will normally be the case for the vast majority of Kodi users.}}<br />
<br />
<gallery widths=600px heights=340px><br />
File:Step1.png|'''<big>Step 1:</big>''' Log in to your Synology admin control panel.<br />
File:Step2.png|'''<big>Step 2:</big>''' Enable SSH (if not enabled already): Control Panel --> Terminal --> Enable SSH service --> {{button|OK}}<br />
<br />
File:Step3.png|'''<big>Step 3:</big>''' Enable NFS under Control Panel --> Win/MAC/NFS<br />
File:Step4.png|'''<big>Step 4:</big>''' NFS Services --> Enable NFS --> {{button|OK}}<br />
<br />
File:Step5.png|'''<big>Step 4:</big>''' Under Control Panel --> Shared Folder<br />
File:Step6.png|'''<big>Step 6:</big>''' On NFS Privileges tab select entry for the folders you want to share e.g. '''Movies'''<br />
File:Step7.png|'''<big>Step 7:</big>''' {{button|Create}} privileges for the selected share<br />
File:Step8.png|'''<big>Step 8:</big>''' As per example allow all IPs (or the desired IP for your HTPC) with '''read/write''' permissions with no mapping and enable '''asynchronous'''. The option to '''allow connections from non-priviledged hosts''' is new in DSM version 4.3-3776. Using DSM 5.0-4482 I had to use the "Squash" option and "Map all users to admin".<br />
<br />
'''With this option the steps 10 through 14 are no longer necessary.''' --> {{button|OK}}<br />
File:Step9.png|'''<big>Step 9:</big>''' Press {{button|OK}}<br />
</gallery><br />
<br />
;{{note|The below steps are necessary only if you are using a Synology DSM version less than 4.3-3776.}}<br />
<br />
'''<big>Step 10:</big>''' On your computer, in a command line window (Terminal on a Mac, CMD on a Windows PC, etc), ssh into your Synology:<br />
'''ssh root@<<YOUR.SYNOLOGY.IP.ADDRESS>>'''<br />
<br />
'''<big>Step 11:</big>''' Type in '''cat /etc/exports''' to make sure your previous steps have created exported NFS directories. If no entries are found, go back to the previous steps and make sure you've followed them correctly. You should be seeing something like this:<br />
<br />
[[File:Step11.png|600px]]<br />
<br />
'''<big>Step 12:</big>''' Type '''vi /etc/exports''' to edit the /etc/exports file, and change all the "insecure_locks" entries to simply read "insecure". If you don't know vi: press the INS[SERT] key, use arrows to go to the line to edit, and delete/edit the line. Then press the ESC key, and type ''':x''' to 'Save & Exit'.<br /><br />
13. Type '''cat /etc/exports''' again, and you should now see something like this (make sure it says "insecure" rather than "insecure_locks"):<br />
<br />
[[File:Step15.png|600px]]<br />
<br />
'''<big>Step 14:</big>''' Type '''exportfs -ra''' to initialize your newly exported directories, or reboot the NAS.<br /><br />
'''<big>Step 15:</big>''' You should now be able to browse NFS and get to your exported Synology subfolders in Kodi.<br /><br />
===== Synology DSM 5.1 =====<br />
<gallery widths=600px heights=340px><br />
File:syn5step1.png|'''<big>Step 1:</big>''' Enable NFS under Control Panel --> File Services<br />
File:syn5step2.png|'''<big>Step 2:</big>''' NFS Services --> Enable NFS --> Press Apply<br />
<br />
File:syn5step3.png|'''<big>Step 3:</big>''' Under Control Panel --> Shared Folder<br />
File:syn5step4.png|'''<big>Step 4:</big>''' Select entry for the folders you want to share e.g. '''video''' and click '''Edit'''<br />
File:syn5step5.png|'''<big>Step 5:</big>''' Under '''permissions''' tab add permission '''read/write''' for user '''admin'''<br />
File:syn5step6.png|'''<big>Step 6:</big>''' Under '''NFS Permissions''' tab add permission click '''Create''' to create NFS permissions <br />
File:syn5step7.png|'''<big>Step 7:</big>''' As per example allow all IPs (or the desired IP for your HTPC) with '''read/write''' permissions, Squash '''Map all users to admin''', Security '''sys''', and enable '''asynchronous'''. The option '''allow connections from non-priviledged ports''' selected. '''Allow users to access mounted subfolders''' also selected.<br />
</gallery><br />
'''<big>Step 8:</big>''' Click '''OK''' to save changes. And now you should be able to access video folder via NFS protocol<br />
==== QNAP ====<br />
[[File:QNAP.gif|link=]]<br /><br />
;{{note|You do not need to create a special user account on your QNAP NAS in order to make use of NFS for Kodi. The following guide assumes you are comfortable with using the simplest (least secure) internal setup on your NAS, which will normally be the case for the vast majority of Kodi users.}}<br />
<br />
This guide requires you to [[SSH]] into your QNAP, and also to use the terminal editor [http://en.wikipedia.org/wiki/Vi Vi] to edit files.<br />
<br />
Here's a couple of guides if you wish to learn more, but feel free to google for further reading: <br />
<br />
[http://www.tuxfiles.org/linuxhelp/vimcheat.html Vi Cheat Sheet]<br />
<br />
1. Log into your QNAP admin control panel. (Web browser = IP-ADDRESS:8080).<br />
<br />
<gallery widths=700px heights=340px><br />
File:QNAP_SSH.png|'''<big>Step 2:</big>''' Enable SSH (if not already): Network Services -> Telnet / SSH -> 'tick' Allow SSH connection, Press {{button|Apply}}<br />
File:QNAP_NFS.png|'''<big>Step 3:</big>''' Enable NFS: Network Services -> NFS Service -> 'tick' Enable NFS Service, Press {{button|Apply}}<br />
</gallery><br />
<gallery widths=600px heights=350px><br />
File:QNAP_Shares.png|'''<big>Step 3:</big>''' Set NFS Access Rights: Under "Enable NFS Service" Click on "Click here to set the NFS access right of the network share"<br />
File:QNAP_NFS_Access.png|'''<big>Step 4:</big>''' Click on the NFS icon next to Qmultimedia (or whatever the name of your media share on the QNAP) and set Access Right to No Limit and put in the IP Address of each individual device that requires NFS connection (ATV2, Desktop, Laptop, etc.), Press {{button|Apply}}<br />
</gallery><br />
<br />
6. On your computer, in a command line window (Terminal on a Mac, CMD on a Windows PC, etc), ssh into your QNAP:<br />
'''ssh admin@<<YOUR QNAP IP ADDRESS>>'''<br />
<br />
7. Type in '''cat /etc/exports''' to make sure your previous steps have created exported NFS directories. If no entries are found, go back to the previous steps and make sure you've followed them correctly. You should be seeing something like this:<br />
"/share/MD0_DATA/Qmultimedia" 192.168.1.15(rw,async,no_root_squash) 192.168.1.20(rw,async,no_root_squash) <br />
"/share/NFS/Qmultimedia" 192.168.1.15(rw,nohide,async,no_root_squash) 192.168.1.20(rw,nohide,async,no_root_squash)<br />
<br />
8. Type '''vi /etc/exports''' to edit the /etc/exports file, and add "insecure" entries inside the brackets in front "rw"(separated with a comma ","). If you don't know vi: press the "i" key, use arrows to go to the line to edit, and add the entries. Then press the ESC key, and type ''':wq''' to 'Save & Exit'. Your exports file should now look something like this:<br />
"/share/MD0_DATA/Qmultimedia" 192.168.1.15(insecure,rw,async,no_root_squash) 192.168.1.20(insecure,rw,async,no_root_squash) <br />
"/share/NFS/Qmultimedia" 192.168.1.15(insecure,rw,nohide,async,no_root_squash) 192.168.1.20(insecure,rw,nohide,async,no_root_squash)<br />
<br />
9. Type '''exportfs -ra''' to initialize your newly exported directories, <span style="color:#FF0000">'''DO NOT''' reboot the QNAP or restart NFS via the QNAP Admin page - If you do the QNAP will overwrite the changes you just made</span>.<br />
<br />
<gallery widths=415px heights=168px><br />
File:QNAP_nfssetting_before.png|'''<big>Step 10:</big>''' Now type '''vi /etc/config/nfssetting'''. You'll see something like this:<br />
File:QNAP_nfssetting_after.png‎|'''<big>Step 11:</big>'''Move your cursor to after the '''rw''' in the line '''/share/*****/Qmultimedia = rw''' (***** interchangeable with whatever yours says). Press {{keypress|i}} and add '''insecure''' separated by a ''',''' (comma). When you're done editing press {{keypress|esc}} and then ''':wq''' to save the changes and close the file. It will look something like this when finished:<br />
</gallery><br />
<span style="color:#FF0000">'''CAUTION: If you reboot your QNAP NAS at any time after completing the steps above, but before completing the steps below, the changes you've made will be wiped out and you will need to redo the process.'''</span><br />
<br />
12. That should be it for getting it working.. You should now be able to browse NFS and get to your exported QNAP folders in Kodi. Now there's just a few more steps to ensure all your hard work survives a reboot/firmware upgrade.<br />
<br />
* We're going to edit/create an autorun script that overwrites two files from backups we're going to make.<br />
<br />
13. Okay, you need to make a folder to store the backup files. You need to use the absolute path in the Autorun script. Type '''mkdir /share/MD0_DATA/backups''' and press '''enter'''. (The MD0_DATA part could be different on your model, I'm running a TS-509).<br />
<br />
14. Now type '''cp /etc/exports /share/MD0_DATA/backups/exports''' and press enter.<br />
<br />
15. Type '''cp /etc/config/nfssetting /share/MD0_DATA/backups/nfssetting''' and press enter.<br />
<br />
16. Now for the fun part. To mount the ramblock follow the procedure below. This is based on the guide here (Method 1): [http://wiki.qnap.com/wiki/Running_Your_Own_Application_at_Startup QNAP Autorun Wikiguide] <br />
<br />
17. Pick the method that is applicable to your QNAP model.<br />
## Model TS-201: Mount the config ramblock /dev/mtdblock4: <pre># mount -t ext2 /dev/mtdblock4 /tmp/config </pre> <br />
## Models TS-109, TS-109P, TS-110, TS-119, TS-209, TS-209P, TS-219, TS-409 (Marvell ARM), TS-419P: Mount the config ramblock /dev/mtdblock5: <pre># mount -t ext2 /dev/mtdblock5 /tmp/config</pre> <br />
## Models TS-439, TS-509, TS-639, TS-809, TS-809U (x86): Mount the config ramblock /dev/sdx6: <pre># mount -t ext2 /dev/sdx6 /tmp/config</pre> <br />
# Create/Edit /tmp/config/autorun.sh .<br />
## either using vi: <pre># vi /tmp/config/autorun.sh</pre><br />
### Get vi editor into edit mode: '''press i''' <br />
### Add these lines to the autorun.sh script:<br />
### '''cp /share/MD0_DATA/backups/exports /etc/exports'''<br />
### '''cp /share/MD0_DATA/backups/nfssetting /etc/config/nfssetting'''<br />
### Exit edit mode: '''press ESC''' <br />
### Save and exit: ''':wq''' <br />
## or editing it using a desktop PC and e.g. SFTP <br />
# Ensure that /tmp/config/autorun.sh is executable: <pre># chmod +x /tmp/config/autorun.sh</pre> <br />
# '''IMPORTANT:''' Unmount the mounted flash partition: <pre># cd /</pre> <pre># umount /tmp/config</pre><br />
<br />
18. Finish the linked guide, making sure to unmount the ramblock. (You will need to cd away from the /tmp/config directory to umount it.<br />
<br />
19. Should be done!<br />
<br />
==== Thecus ====<br />
[[File:thecuslogo.png|link=]]<br /><br />
<br />
<gallery widths=600px heights=340px><br />
File:Thecus1.png|'''<big>Step 1:</big>''' Log in to your ThecusOS interface and select '''Network Service'''.<br />
File:Thecus2.png|'''<big>Step 2:</big>''' Enable NFS and click {{button|Apply}}<br />
File:Thecus3.png|'''<big>Step 3:</big>''' Go to the '''Share Folders''' entry in the '''Storage'''-section. Select the folder, you want to share via NFS and click on NFS.<br />
File:Thecus4.png|'''<big>Step 4:</big>''' You can now define specific hosts and access rights. '''!!!IMPORTANT!!!''' Activate AIX as OS support, otherwise Android {{subst:Name}} won't be supported. {{button|Apply}}<br />
</gallery><br />
<br />
{{Isengard updated}}<br />
<br />
[[Category:File sharing]]<br />
[[Category:Linux]]<br />
[[Category:Mac OS X]]<br />
[[Category:How-to]]</div>UNiversalhttps://kodi.wiki/index.php?title=HOW-TO:Submit_a_patch&diff=93925HOW-TO:Submit a patch2015-04-29T12:24:09Z<p>UNiversal: kodi.tv and XBMC -> Kodi and some final typos.</p>
<hr />
<div>{{cleanup}}<br />
<br />
Kodi is a non-profit open source hobby project that is developed by volunteers in their spare time without any monetary gain.<br />
The team of developers working on Kodi encourage anyone submit source code patches for bug-fixes, new features/functions or improvements to existing ones.<br />
Any and all contributions to the source code are appreciated, though please understand that there is no guarantee that your patch will be accepted and implemented into Kodi.<br />
If you wish to have input from Kodi developers prior to implementing a feature or improvement, please open a discussion on the [http://forum.kodi.tv kodi forums]. Lastly, understand that it may take us a little while to review your patch, so please be patient - clean and well documented code will most likely be looked at sooner than messy or undocumented code.<br />
<br />
<br />
{{Bluev|'''NOTE!'''|<br />
We know our rules place a burden on you the submitter, but rest assured that maintaining a large, complex software project is even harder, so please accept the rules that have been set before you here. These rules are there for a reason, we cannot afford to spend too much of our time fixing buggy, broken or outdated patches. The closer you follow our rules the higher is the likelihood that your patch will be accepted.}}<br />
<br />
= Code submissions =<br />
Please submit all code submissions as a "''pull request''" to the [https://github.com/xbmc/xbmc/pulls Kodi Github ] - see the section below for information on how to create a pull request. Then to get some attention please also post a new thread in the development-section of our [http://forum.kodi.tv forums] describing the patch. Doing so allows for a more open discussion with the whole Kodi community including non-developers about possible improvements/enhancements or additions and bugs/fixes. Note that any code you submit will be (c) Team XBMC.<br />
<br />
== Minimum requirements ==<br />
We currently do not have any other minimum requirements other than the code being under [http://www.gnu.org/licenses/lgpl.html LGPL] or [http://www.gnu.org/copyleft/gpl.html GPL] license, that it is clean and that any comments and documentation be accurate and in English.<br />
<br />
== Code documentation ==<br />
Though not yet a standard in all Kodi source code, please try and document at least the "public" portions of your code using [http://www.doxygen.org doxygen] inline comments.<br />
If you are submitting a new feature or function, please also add a small "''readme.txt''" to the the patch describing the use of feature that may be used as a basis for user documentation in the wiki later. You are most welcome to format this up for the wiki after the patch is submitted.<br />
<br />
== Code guide-lines and formatting conventions ==<br />
:;Please consult:<br />
{{main|Official:Code guidelines and formatting conventions}}<br />
<br />
All code should strive to be platform agnostic - Kodi is multi-platform software, thus any single platform-specific features should be discussed with Kodi team members before being implemented.<br />
Major features should ideally be developed in a separate branch or in small increments so that other members have the opportunity to review the code and comment on it during development.<br />
<br />
== Patch format ==<br />
Please do not send complete files. These need to be diffed by hand to see the changes, which makes reviews harder and less likely to occur. Besides as soon as one of the files changes, your version becomes harder to apply, thus reducing its chances of being accepted. Please follow these simple rules when making patch for Kodi:<br />
<br />
:'''1.''' Use git to its full potential. The best thing is to fork the Kodi project on [https://github.com/xbmc/xbmc Kodi github], branch from there, and develop your patch on top of HEAD. See the [https://help.github.com excellent documentation at github] for help with this.<br />
<br />
:'''2.''' Make sure you keep each commit as simple as possible as well as self-contained. i.e. a commit series that builds at each commit and builds up the functionality required is much nicer than a single huge commit that changes lots of things at once.<br />
<br />
:'''3.''' When you're changing functions that require re-indenting, it's best to do the functionality change in one commit, with a second commit for the cosmetic re-indenting.<br />
<br />
:'''4.''' Check your commits for unnecessary cosmetic changes such as whitespace changes, particularly for whitespace at end of line.<br />
<br />
:'''5.''' Doxy and new functions added, particularly if they're to the public API of a class. Doxy classes as well if necessary. The important thing is what the function is supposed to do, what parameter values are (plus any default values) and what the return code is.<br />
<br />
:'''6.''' Make sure you maintain const'ness where reasonable.<br />
<br />
:'''7.''' If you implement new features or modify the behaviour of existing features, please do not forget to also point out whether any changes are required in the wiki documentation, and ideally perform these changes once your patch series is accepted.<br />
<br />
:'''8.''' When you're done, push to your github repo and do a pull request against the main Kodi repository. See the [https://help.github.com excellent documentation at github] for more information.<br />
<br />
:'''9.''' Give us a few days to react. We try to review patches as quickly as possible, but unfortunately we are constantly overloaded with work, be it Kodi-related or from our day to day lives. If your patch seems to be ignored, post a reminder asking for opinions in the forum's development section or as a reply to the original patch ticket, mentioning that you got ignored - we are interested in your work and will eventually either accept it or reject it with an explanation of what we liked and disliked about your patch. Note that we will often ask you to make changes to your patch to make it acceptable before we commit it, so please implement those changes, and update your branch with the changes made as you go. Some of these changes may seem trivial, but the less work we need to do, the faster it'll hit GIT.<br />
<br />
:'''10.''' Enjoy developing for Kodi :)<br />
<br />
= External Links =<br />
* [http://en.tldp.org/HOWTO/Software-Release-Practice-HOWTO/index.html Software releases and good patching practice HOW-TO] great guide for best practice for patches.<br />
<br />
[[Category:How-to|Submit a Patch]]<br />
[[Category:Development]]</div>UNiversalhttps://kodi.wiki/index.php?title=HOW-TO:Submit_a_patch&diff=93921HOW-TO:Submit a patch2015-04-29T12:12:32Z<p>UNiversal: </p>
<hr />
<div>{{cleanup}}<br />
<br />
Kodi is a non-profit open source hobby project that is developed by volunteers in their spare time without any monetary gain. The team of developers working on XBMC encourage anyone submit source code patches for bug-fixes, new features/functions or improvements to existing ones. Any and all contributions to the source code are appreciated, though please understand that there is no guarantee that your patch will be accepted and implemented into Kodi. If you wish to have input from Kodi developers prior to implementing a feature or improvement, please open a discussion on the [http://forum.xbmc.org forums]. Lastly, understand that it may take us a little while to review your patch, so please be patient - clean and well documented code will most likely be looked at sooner than messy or undocumented code.<br />
<br />
:'''Note!''' We know our rules place a burden on you the submitter, but rest assured that maintaining a large, complex software project is even harder, so please accept the rules that have been set before you here. These rules are there for a reason, we cannot afford to spend too much of our time fixing buggy, broken or outdated patches. The closer you follow our rules the higher is the likelihood that your patch will be accepted.<br />
<br />
= Code submissions =<br />
Please submit all code submissions as a "''pull request''" to the [https://github.com/xbmc/xbmc/pulls Kodi Github ] - see the section below for information on how to create a pull request. Then to get some attention please also post a new thread in the development-section of our [http://forum.xbmc.org forums] describing the patch. Doing so allows for a more open discussion with the whole Kodi community including non-developers about possible improvements/enhancements or additions and bugs/fixes. Note that any code you submit will be (c) Team XBMC.<br />
<br />
== Minimum requirements ==<br />
We currently do not have any other minimum requirements other than the code being under [http://www.gnu.org/licenses/lgpl.html LGPL] or [http://www.gnu.org/copyleft/gpl.html GPL] license, that it is clean and that any comments and documentation be accurate and in English.<br />
<br />
== Code documentation ==<br />
Though not yet a standard in all Kodi source code, please try and document at least the "public" portions of your code using [http://www.doxygen.org doxygen] inline comments. If you are submitting a new feature or function, please also add a small "''readme.txt''" to the the patch describing the use of feature that may be used as a basis for user documentation in the wiki later. You are most welcome to format this up for the wiki after the patch is submitted.<br />
<br />
== Code guide-lines and formatting conventions ==<br />
<br />
Consult {{main|Official:Code guidelines and formatting conventions}}<br />
<br />
All code should strive to be platform agnostic - Kodi is multi-platform software, thus any single platform-specific features should be discussed with Kodi team members before being implemented. Major features should ideally be developed in a separate branch or in small increments so that other members have the opportunity to review the code and comment on it during development.<br />
<br />
== Patch format ==<br />
Please do not send complete files. These need to be diffed by hand to see the changes, which makes reviews harder and less likely to occur. Besides as soon as one of the files changes, your version becomes harder to apply, thus reducing its chances of being accepted. Please follow these simple rules when making patch for Kodi:<br />
<br />
:'''1.''' Use git to its full potential. The best thing is to fork the Kodi project on [https://github.com/xbmc/xbmc github], branch from there, and develop your patch on top of HEAD. See the [https://help.github.com excellent documentation at github] for help with this.<br />
<br />
:'''2.''' Make sure you keep each commit as simple as possible as well as self-contained. i.e. a commit series that builds at each commit and builds up the functionality required is much nicer than a single huge commit that changes lots of things at once.<br />
<br />
:'''3.''' When you're changing functions that require re-indenting, it's best to do the functionality change in one commit, with a second commit for the cosmetic re-indenting.<br />
<br />
:'''4.''' Check your commits for unnecessary cosmetic changes such as whitespace changes, particularly for whitespace at end of line.<br />
<br />
:'''5.''' Doxy and new functions added, particularly if they're to the public API of a class. Doxy classes as well if necessary. The important thing is what the function is supposed to do, what parameter values are (plus any default values) and what the return code is.<br />
<br />
:'''6.''' Make sure you maintain const'ness where reasonable.<br />
<br />
:'''7.''' If you implement new features or modify the behavior of existing features, please do not forget to also point out whether any changes are required in the wiki documentation, and ideally perform these changes once your patch series is accepted.<br />
<br />
:'''8.''' When you're done, push to your github repo and do a pull request against the main Kodi repository. See the [https://help.github.com excellent documentation at github] for more information.<br />
<br />
:'''9.''' Give us a few days to react. We try to review patches as quickly as possible, but unfortunately we are constantly overloaded with work, be it Kodi-related or from our day to day lives. If your patch seems to be ignored, post a reminder asking for opinions in the forum's development section or as a reply to the original patch ticket, mentioning that you got ignored - we are interested in your work and will eventually either accept it or reject it with an explanation of what we liked and disliked about your patch. Note that we will often ask you to make changes to your patch to make it acceptable before we commit it, so please implement those changes, and update your branch with the changes made as you go. Some of these changes may seem trivial, but the less work we need to do, the faster it'll hit GIT.<br />
<br />
:'''10.''' Enjoy developing for Kodi :)<br />
<br />
= External Links =<br />
* [http://en.tldp.org/HOWTO/Software-Release-Practice-HOWTO/index.html Software releases and good patching practice HOW-TO] great guide for best practice for patches.<br />
<br />
[[Category:How-to|Submit a Patch]]<br />
[[Category:Development]]</div>UNiversalhttps://kodi.wiki/index.php?title=Archive:Codecinfo&diff=93803Archive:Codecinfo2015-04-28T12:47:30Z<p>UNiversal: XBMC -> Kodi</p>
<hr />
<div>{{mininav|[[Video library]]|[[Video playback|Playback]]}}<br />
<section begin="intro" />Whilst Kodi is playing media on screen you can activate the '''codecinfo''' overlay {{keypress|O}} key on a keyboard. This normally appears as white text on a black background bar located near the top of the screen (dependent on the skin being used). The codecinfo overlay displays a number of real time variables describing detailed information on the codecs currently in use.<section end="intro" /><br />
{{-}}<br />
== Current stable builds ==<br />
[[File:Helix codecinfo.png|700px|Helix|right]]<br />
;Video codecinfo window as seen in stable Kodi v14.x and newer builds.<br />
<br />
Information is split into 6 lines of text:<br />
* Audio information - '''D'''emuxer<br />
* Audio information - '''P'''layer<br />
* Video information - '''D'''emuxer<br />
* Video information - '''P'''layer<br />
* General playback information '''C'''<br />
* '''W'''indowing and System CPU information<br />
{{-}}<br />
<br />
=== Breakdown ===<br />
Samples from the screen(s) above:<br />
{| class="prettytable"<br />
! Audio information <br />
! Breakdown<br />
|-<br />
| aac || Audio codec<br />
|-<br />
| mp4a / 0x6134706D || Codec ID - Format profile <ref>http://matroska.org/technical/specs/index.html#CodecID</ref><br />
|-<br />
| 48000 Hz || Sampling rate<br />
|-<br />
| 5.1 || Audio channels<br />
|-<br />
| s16 || Sample size (s16 = signed 16-bit value)<br />
|-<br />
| fltp || float, planar <br />
|-<br />
| 437 kb/s || Average audio bitrate (reported by demuxer)<br />
|-<br />
| aq:99% || Audio queue saturation<br />
|-<br />
| Kb/s:437.41 || Current audio bitrate (reported by player)<br />
|-<br />
| att:0.0db || Attenuation / gain added by player<br />
|-<br />
! style="background: #DBDBDB;" | '''Video information''' <br />
! style="background: #DBDBDB;" | '''Breakdown'''<br />
|-<br />
| h264 (Main) (avc1 / 0x31637661) || Video codec<br />
|-<br />
| yuv420p || Color space / Chroma subsampling<br />
|-<br />
| 1920x1080 || Resolution<br />
|-<br />
| SAR 1:1 DAR 16x9 || '''S'''ource '''A'''spect '''R'''atio - '''D'''isplay '''A'''spect '''R'''atio<br />
|-<br />
| 9282 kb/s || Average audio bitrate (reported by demuxer)<br />
|-<br />
| fr:24.000 || Source framerate<br />
|-<br />
| vq:88% || Video queue saturation<br />
|-<br />
| dc:ff-h264-dxva2 || Video library performing decode<br />
|-<br />
| Mb/s:7.79 || Current video bitrate (reported by player)<br />
|-<br />
| drop:12 || Number of dropped frames<br />
|-<br />
| skip:13 || Number of skipped frames<br />
|-<br />
| pc:1 || Pullup correction pattern length<br />
|-<br />
! style="background: #DBDBDB;" | '''General playback information''' <br />
! style="background: #DBDBDB;" | '''Breakdown'''<br />
|-<br />
| ad:0.000 || Audio delay (configured)<br />
|-<br />
| a/v:0.030 || Audio/video sync difference (real time)<br />
|-<br />
| edl:- || [[Edit decision list]]<br />
|-<br />
| dcpu: 0% || Relative CPU Usage of the player thread<br />
|-<br />
| acpu: 0% || Relative CPU usage of the audio decode thread<br />
|-<br />
| vcpu: 0% || Relative CPU Usage of the video decode thread<br />
|-<br />
| cache:0 B 100% || Size of cached data and % of cache utilized<br />
|-<br />
! style="background: #DBDBDB;" | '''Windowing information'''<br />
! style="background: #DBDBDB;" | '''Breakdown'''<br />
|-<br />
| fps:24.00 || Video framerate <ref>This value fluctuates due to being affected by [[dirty regions]]</ref><br />
|-<br />
| CPU 4 core(s) || System processor information (this display is OS-dependent)<br />
|-<br />
| average: 4.7% || Average CPU load across all cores<br />
|-<br />
! style="background: #DBDBDB;" | '''Sync to screen information'''<br />
! style="background: #DBDBDB;" | '''Breakdown'''<br />
|-<br />
| refresh || Actual refresh-rate being displayed<br />
|-<br />
| missed || Number of missed frames<br />
|-<br />
| speed || Audio speed correction to sync<br />
|-<br />
| sync || Video speed to enable sync<br />
|-<br />
| avg || Avg amount of correction<br />
|-<br />
| error || Percentage of errors syncing<br />
|}<br />
<br />
== Current development builds ==<br />
{{Isengard || <big>Isengard Feature</big>}}<br />
<br />
{{-}}<br />
<br />
== References ==<br />
<references/><br />
<br />
== Further information/discussion ==<br />
* See the [[forum:70743|Video Diagnostic Screen]] forum topic for discussion and more information.<br />
{{helix updated}}<br />
<br />
[[Category:Manual]]<br />
[[Category:Troubleshooting]]<br />
[[Category:Video library]]</div>UNiversalhttps://kodi.wiki/index.php?title=Archive:Codecinfo&diff=93802Archive:Codecinfo2015-04-28T12:45:53Z<p>UNiversal: Helix / Isengard @fernetmenta explanation about windowing FPS fluctuation reasoning.</p>
<hr />
<div>{{mininav|[[Video library]]|[[Video playback|Playback]]}}<br />
<section begin="intro" />Whilst XBMC is playing media on screen you can activate the '''codecinfo''' overlay {{keypress|O}} key on a keyboard. This normally appears as white text on a black background bar located near the top of the screen (dependent on the skin being used). The codecinfo overlay displays a number of real time variables describing detailed information on the codecs currently in use.<section end="intro" /><br />
{{-}}<br />
== Current stable builds ==<br />
[[File:Helix codecinfo.png|700px|Helix|right]]<br />
;Video codecinfo window as seen in stable XBMC v13.x "Gotham" builds.<br />
<br />
Information is split into 6 lines of text:<br />
* Audio information - '''D'''emuxer<br />
* Audio information - '''P'''layer<br />
* Video information - '''D'''emuxer<br />
* Video information - '''P'''layer<br />
* General playback information '''C'''<br />
* '''W'''indowing and System CPU information<br />
{{-}}<br />
<br />
=== Breakdown ===<br />
Samples from the screen(s) above:<br />
{| class="prettytable"<br />
! Audio information <br />
! Breakdown<br />
|-<br />
| aac || Audio codec<br />
|-<br />
| mp4a / 0x6134706D || Codec ID - Format profile <ref>http://matroska.org/technical/specs/index.html#CodecID</ref><br />
|-<br />
| 48000 Hz || Sampling rate<br />
|-<br />
| 5.1 || Audio channels<br />
|-<br />
| s16 || Sample size (s16 = signed 16-bit value)<br />
|-<br />
| fltp || float, planar <br />
|-<br />
| 437 kb/s || Average audio bitrate (reported by demuxer)<br />
|-<br />
| aq:99% || Audio queue saturation<br />
|-<br />
| Kb/s:437.41 || Current audio bitrate (reported by player)<br />
|-<br />
| att:0.0db || Attenuation / gain added by player<br />
|-<br />
! style="background: #DBDBDB;" | '''Video information''' <br />
! style="background: #DBDBDB;" | '''Breakdown'''<br />
|-<br />
| h264 (Main) (avc1 / 0x31637661) || Video codec<br />
|-<br />
| yuv420p || Color space / Chroma subsampling<br />
|-<br />
| 1920x1080 || Resolution<br />
|-<br />
| SAR 1:1 DAR 16x9 || '''S'''ource '''A'''spect '''R'''atio - '''D'''isplay '''A'''spect '''R'''atio<br />
|-<br />
| 9282 kb/s || Average audio bitrate (reported by demuxer)<br />
|-<br />
| fr:24.000 || Source framerate<br />
|-<br />
| vq:88% || Video queue saturation<br />
|-<br />
| dc:ff-h264-dxva2 || Video library performing decode<br />
|-<br />
| Mb/s:7.79 || Current video bitrate (reported by player)<br />
|-<br />
| drop:12 || Number of dropped frames<br />
|-<br />
| skip:13 || Number of skipped frames<br />
|-<br />
| pc:1 || Pullup correction pattern length<br />
|-<br />
! style="background: #DBDBDB;" | '''General playback information''' <br />
! style="background: #DBDBDB;" | '''Breakdown'''<br />
|-<br />
| ad:0.000 || Audio delay (configured)<br />
|-<br />
| a/v:0.030 || Audio/video sync difference (real time)<br />
|-<br />
| edl:- || [[Edit decision list]]<br />
|-<br />
| dcpu: 0% || Relative CPU Usage of the player thread<br />
|-<br />
| acpu: 0% || Relative CPU usage of the audio decode thread<br />
|-<br />
| vcpu: 0% || Relative CPU Usage of the video decode thread<br />
|-<br />
| cache:0 B 100% || Size of cached data and % of cache utilized<br />
|-<br />
! style="background: #DBDBDB;" | '''Windowing information'''<br />
! style="background: #DBDBDB;" | '''Breakdown'''<br />
|-<br />
| fps:24.00 || Video framerate <ref>This value fluctuates due to being affected by [[dirty regions]]</ref><br />
|-<br />
| CPU 4 core(s) || System processor information (this display is OS-dependent)<br />
|-<br />
| average: 4.7% || Average CPU load across all cores<br />
|-<br />
! style="background: #DBDBDB;" | '''Sync to screen information'''<br />
! style="background: #DBDBDB;" | '''Breakdown'''<br />
|-<br />
| refresh || Actual refresh-rate being displayed<br />
|-<br />
| missed || Number of missed frames<br />
|-<br />
| speed || Audio speed correction to sync<br />
|-<br />
| sync || Video speed to enable sync<br />
|-<br />
| avg || Avg amount of correction<br />
|-<br />
| error || Percentage of errors syncing<br />
|}<br />
<br />
== Current development builds ==<br />
{{Isengard || <big>Isengard Feature</big>}}<br />
<br />
{{-}}<br />
<br />
== References ==<br />
<references/><br />
<br />
== Further information/discussion ==<br />
* See the [[forum:70743|Video Diagnostic Screen]] forum topic for discussion and more information.<br />
{{helix updated}}<br />
<br />
[[Category:Manual]]<br />
[[Category:Troubleshooting]]<br />
[[Category:Video library]]</div>UNiversalhttps://kodi.wiki/index.php?title=Template:JSON-RPC_API_nav&diff=92925Template:JSON-RPC API nav2015-04-21T13:31:04Z<p>UNiversal: </p>
<hr />
<div>{{Navigation<br />
| nav name = JSON-RPC API<br />
| link1 = JSON-RPC API<br />
| link1 name = Overview<br />
| link2 = JSON-RPC API/v2<br />
| link2 name = v2 (Dharma)<br />
| link3 = JSON-RPC API/v4<br />
| link3 name = v4 (Eden)<br />
| link4 = JSON-RPC API/v6<br />
| link4 name = v6 (Frodo/Gotham/Helix/Isengard)<br />
}}<noinclude>[[Category:Navigation templates]]</noinclude></div>UNiversalhttps://kodi.wiki/index.php?title=Archive:HOW-TO:Install_Kodibuntu_from_a_USB_drive&diff=88980Archive:HOW-TO:Install Kodibuntu from a USB drive2015-04-14T11:05:47Z<p>UNiversal: bugger.</p>
<hr />
<div>{{mininav|[[General topics]]{{l2|[[Devices]]}}|[[Installing]]{{l2|[[Linux]]}}}}<br />
<section begin="intro" />This page explains procedures and methods to create a USB bootable drive or install Kodi into a USB flash drive. The instructions are written for [[Kodibuntu]], but may work for other installs with ISO images.<section end="intro" /><br />
{{redv|Warning|'''Backup your data before proceeding.''' The instructions contained in this page will format drives and will destroy data contained in said drives.}}<!-- --><br />
{{note|This article uses the term "USB flash drive" instead of: USB stick, USB drive, thumb drive and USB HDD.}}<br /><br />
<br />
<br />
= Outline =<br />
<br />
The general procedure to install Kodibuntu from a USB flash drive is:<br />
<br />
# Acquire the correct Kodibuntu installation files ('the ISO')<br />
# Put Kodibuntu/Ubuntu onto your USB flash drive<br />
# Configure your computer to boot from USB flash drive and boot from it<br />
# Try Kodibuntu/Ubuntu or install it to your hard drive.<br />
<br />
= Introduction =<br />
<br />
Kodibuntu can be installed from a USB flash drive, much like Ubuntu. This may be necessary for netbooks and other computers without CD drives, and is convenient for others. Also, configuration changes can be saved on the USB flash drive, unlike a CD-ROM drive. <br />
<br />
Booting from a USB flash drive created with this utility will behave as if you had booted from the install CD. It will show the language selection and then the install menu, from which you can install Kodibuntu onto the computer's hard drive or launch the Live USB environment.<br />
<br />
Kodibuntu can also be installed to a USB flash drive, though the life-span of the drive may be reduced slightly, due to the extra read/write cycles that Kodi requires. A tmpfs can be created to mitigate this though it is not covered by these instructions.<br />
<br />
You can also install Ubuntu and then Kodi on top, but this guide is only about creating a bootable flash drive from an ISO. It's either-or, '''not both'''.<br />
<br />
= Prerequisites =<br />
<br />
To create a USB installation disk, you will need:<br />
* Your favorite bootable USB creator tool<ref>In no particular order: [http://rufus.akeo.ie/ Rufus] [http://www.wintobootic.com wintobootic] [http://www.pendrivelinux.com/universal-usb-installer-easy-as-1-2-3/ Universal usb installer] [http://www.pendrivelinux.com/yumi-multiboot-usb-creator/ YUMI] [http://unetbootin.sourceforge.net/ unetbootin] [http://www.linuxliveusb.com/ Lili] [http://joshcellsoftwares.com/products/zotacwinusbmaker/ Winusbmaker] </ref><br />
* A 2GB or bigger USB flash drive. Files on this USB disk will be erased, so back up your data first. Make sure this USB disk is properly formatted and mounted.<br />
* A Kodibuntu ISO file. See [http://Kodi.org/download/ Kodi Download] to download it.<br />
{{note|If you're installing Kodi on top of Ubuntu, use the Ubuntu ISO instead of the Kodibuntu ISO. The ISO-to-flash drive process is similar for both Kodibuntu.iso and Ubuntu.iso -- '''see next line'''}}<br />
* A Ubuntu image file. See [[http://www.ubuntu.com/download/alternative-downloads|Ubuntu Download]] to download it.<br />
<br />
= Creating a bootable Kodibuntu USB flash drive =<br />
<br />
== From Ubuntu ==<br />
[[File:Usb-creator.png|frame|right|Be aware existent data contained in the usb flash drive will be lost.]]<br />
<br />
* Install and run usb-creator<br />
{{redv|'''NOTE THAT''':| Linux has many bootable usb creating tools, which some may work better than others, so if something fails, try another of these programs.}}<br />
You can find usb-creator-gtk in the Unity Dash by typing "Startup Disk Creator" (Ubuntu Desktop) or usb-creator-kde in K-Menu-->Applications-->System-->Startup Disk Creator (Kubuntu).<br />
If it is not there, then you can install it using the [https://help.ubuntu.com/community/SynapticHowto Synaptic Package Manager] or [https://help.ubuntu.com/community/UbuntuSoftwareCenter Ubuntu Software Center]<br />
* Insert and mount the USB drive. Inserting the USB drive should auto-mount it. <br />
* Start usb-creator. It looks like this:<br />
<br />
* in the top pane of usb-creator, pick the .iso file that you downloaded.<br />
* if the .iso file isn't listed, click "Other" to locate and select the .iso file that you downloaded.<br />
* Alternately, if you have a CD or DVD-ROM with the Ubuntu version you want to install on the USB flash drive, insert it in your CD-ROM drive and usb-creator can use that. <br />
<br />
* It is not necessary to erase the USB flash drive, however it is advisable that you do so.<br />
# Select the first bootable partition on the USB device as the disk to use<br />
# The bootable partition should be formatted as either a FAT16 or FAT32 filesystem. This is the default for most USB flash drives.<br />
<br />
{{note|'''NEVER''' use one of your hard drive partitions in this process unless you really know what you are doing, as data will get erased.}}<br />
* There may be a bug during the formatting which will cause two partitions to appear when booting from the USB flash drive. Try selecting each of them and one should work. If not, restart the computer and try booting from the USB flash drive again.<br />
* If you get a DBus error with usb-creator, this bug report may be helpful: https://bugs.launchpad.net/ubuntu/+source/usb-creator/+bug/458334<br />
{{-}}<br />
<br />
== From Mac OSX ==<br />
<br />
=== UNetbootin (Automated, graphical approach) ===<br />
[[File:UNetbootinOSX.png|right|frame|150px|Unetbooting lets you create bootable images in OSX, resulting USB Flash drives are only bootable on PC's]]<br />
<br />
[http://unetbootin.sourceforge.net/ UNetbootin for Mac OS X] can be used to automate the process of extracting the ISO file to USB, and making the USB drive bootable. The resulting USB drive, however, can be booted on PCs only. If attempting to make a USB drive that can be booted from a Mac, or if UNetbootin does not successfully create a bootable drive, follow the instructions below.<br />
{{-}}<br />
<br />
=== Manual Approach ===<br />
<br />
If you would prefer to use a USB bootable in Mac, please follow the instructions below.<br />
<br />
{{note|This procedure requires an .img file that you will be required to create from the .iso file you download.}}<br />
{{tip|Drag and Drop a file from Finder to Terminal to 'paste' the full path without typing and risking type errors.}}<br />
* Download the desired file<br />
* Open the Terminal (in /Applications/Utilities/ or query '''Terminal''' in Spotlight)<br />
* Convert the .iso file to .img using the convert option of ''hdiutil'' (e.g.) <br />
<pre><br />
hdiutil convert -format UDRW -o ~/path/to/target.img ~/path/to/Kodibuntu.iso<br />
</pre><br />
{{tip|OS X tends to put the .dmg ending on the output file automatically.}}<br />
* Run<br />
<pre><br />
diskutil list<br />
</pre> to get the current list of devices<br />
* Insert your flash media<br />
* Run <br />
<pre><br />
diskutil list<br />
</pre><br />
again and determine the device node assigned to your flash media (e.g. /dev/disk2)<br />
* Run<br />
<pre><br />
diskutil unmountDisk /dev/diskN<br />
</pre><br />
(replace '''N''' with the disk number from the last command; in the previous example, N would be 2)<br />
* Execute <br />
<pre><br />
sudo dd if=/path/to/downloaded.img of=/dev/diskN bs=1m<br />
</pre><br />
(replace /path/to/downloaded.img with the path where the image file is located; for example, ./Kodibuntu.img or ./Kodibuntu.dmg).<br />
* Using ''/dev/rdisk'' instead of ''/dev/disk'' may be faster.<br />
** If you see the error ''dd: Invalid number '1m','' you are using GNU dd. Use the same command but replace ''bs=1m'' with ''bs=1M''.<br />
** If you see the error ''dd: /dev/diskN: Resource busy,'' make sure the disk is not in use. Start the '''Disk Utility.app''' and unmount (don't eject) the drive.<br />
* Run<br />
<pre><br />
diskutil eject /dev/diskN<br />
</pre><br />
and remove your flash media when the command completes<br />
* Restart your Mac and press '''Option''' while the Mac is restarting to choose the USB flash drive<br />
<br />
=== MacBook Air 13" 2010 ===<br />
'''Please notice:''' While all of the info and above commands are executed properly on a MacBook Air 3,2 (that is the 2010 version 13" version of the Air) the end result will ''not'' produce a bootable USB device, at least not with the image for Ubuntu 10.10 64-bit. When booting of the USB device the following message or something similar will appear: ''"Missing operating system"'' and the process is auto-magically halted. <br />
<br />
<br />
To get the USB device (e.g. a USB stick) to ''show up'' at all in the boot menu you also may have to reboot/turn on/off the computer a couple of times and also ''resync'' the partition tables using rEFIt.<br />
After doing this the USB should then appear as a bootable device while holding in the ''alt'' or ''c'' key when you are rebooting the computer. Notice that both the computers built in bootloader and rEFIt will identify the USB device as a Windows device, but that's not a problem and expected. <br />
<br />
A workaround to the-usb-device-is-not-booting-problem is to:<br />
* Install rEFIt.<br />
* Create a bootable start disk using Ubuntu and a USB stick.<br />
* Create a separate partition on the Airs HD.<br />
* dd the whole USB stick to that partition.<br />
* Resync with rEFIt. Turn power off and on.<br />
* Select Pingo/Windows logo: Install should start. (Here you might want to press F6 to change parameters, e.g. use nomodeset)<br />
<br />
Alternatively, burning a CD and installing via an external CD-drive will work fine on the Macbook Air 3,2.<br />
<br />
== From Windows ==<br />
[[File:Liliusb.jpg|thumb|300px|Creating a Kodibuntu or Ubuntu USB disk is easy, including Live mode.]]<br />
Download and use [http://www.linuxliveusb.com/en/download Linux Live USB Creator] aka LiLi.<br />
<br />
# Choose a USB flash drive in the dropdown list.<br />
# Select an ISO/IMG/ZIP file, or Download.<br />
# If you want to create a Live USB choose the size of persistent data (usually between 250 MB and 2 GB or more depending on size of library and amount of artwork you likely to store in [[userdata]]).<br />
# Check the options you want.<br />
# Click the lightning button to start the creation.<br />
<br />
Steps 1, 2, and 3 are mandatory, and each has a traffic light to indicate its state:<br />
* Red light: the step has not been completed correctly, and you cannot start creating a Live USB key<br />
* Orange light: there is a non-critical problem with this step, but you can still start the creation<br />
* Green light: everything is fine, go ahead<br />
<br />
{{note|Instead of usb-creator.exe you can use Unetbootin to create a bootable USB flash drive. http://unetbootin.sourceforge.net/}}<br />
You won't be able to select the USB flash drive if it wasn't formatted in a way that Windows can see it. You may have to format it using Windows Explorer in order for it to show up in a creator tool.<br />
{{-}}<br />
<br />
= Booting the Computer from USB =<br />
<br />
# Remove all unneeded USB items, but keep the network cable attached.<br />
# Insert the bootable USB flash drive that you just created in your target computer and restart it. Most newer computers can boot from a USB flash drive. If your computer does not automatically do so, you might need to edit the BIOS settings.<br />
# Restart your computer, and watch for a message telling you which key to press to enter the BIOS setup. It will usually be one of F1, F2, F8, DEL, ESC or F10. Press this key while your computer is booting to edit your BIOS settings. (On HP Mini Netbooks, they correct key is usually F9, Asrock ION machines is F11)<br />
# Instead of editing BIOS settings, you can chose a boot device from the boot menu. Press the function key to enter the boot menu when your computer is booting. Typically, the boot screen displays which key you need to press. It maybe one of F11, F12, F10. Note: with some motherboards you have to select 'hard disk/USB-HDD0' to choose the USB flash disk.<br />
# If you need to edit the Boot Order, depending on your computer, and how your USB key was formatted, you should see an entry for "removable drive" or "USB media". Move this to the top of the list to make the computer attempt to boot from the USB device before booting from the hard disk.<br />
{{note|Some Machines may not support booting from USB flash drive. Plop boot manager makes it simple to boot from CD and then boot from USB flash drive, you still require a CD drive in the machine via this method.}}<br />
* [http://www.plop.at/en/bootmanagers.html Plop boot manager] For more instructions and download.<br />
<br />
== Mac ==<br />
* Restart your Mac and press '''Option''' while the Mac is restarting to choose the USB flash drive<br />
<br />
= Alternative methods =<br />
<br />
== Installing Kodibuntu directly on a USB flash drive ==<br />
In order to install a fully working Kodibuntu operating system on your USB flash drive make sure that:<br />
<br />
* Your USB flash drive has more than 2GB of space<br />
* Your USB flash drive is bootable<br />
* Your USB flash drive has a high read/write speed and is USB 2.0 or newer enabled.<br />
* Your USB flash drive has persistence enabled<br />
<br />
'''''See [http://rudd-o.com/linux-and-free-software/a-better-way-to-create-a-customized-ubuntu-live-usb-drive A better way to create a customized Ubuntu live usb drive]<br />
{{note|Though it refers to Ubuntu you can adapt it 100% to Kodibuntu iso, since being a variant of Ubuntu anyway.}}<br />
<br />
== Create Bootable USB Manually ==<br />
<br />
Here is a way to create a bootable USB flash drive manually. The advantage is you don't have to empty your USB flash drive as long as you have enough space for the files. It also allows multi boot, so you can, for example, have your USB flash drive holding other OS and other Boot CD tools at the same time.<br />
<br />
In order to do so you need : <br />
<br />
* Bootable USB flash drive ( NTFS / FAT32 / FAT 16 ), Disk with MBR, you can do this with gparted in Linux or HP format in Win, fdisk ....etc<br />
* Kodibuntu or Ubuntu ISO<br />
* Tools to extract files from the ISO ( ISO Mount, WinZIP, WinRAR, 7Zip, etc....)<br />
* Grub4Dos<br />
# [http://www.rmprepusb.com/tutorials/grub4dos Grub4DOS Tutorial]<br />
# [http://download.gna.org/grub4dos/grub4dos-0.4.4-2009-06-20.zip Grub4DOS 0.4.4 for WIN9x/DOS/Linux (Download Here)]<br />
# [http://download.gna.org/grubutil/grubinst-1.1-src-2008-01-01.zip Grub4DOS GUI for WINXP/Vista/7 (Download Here]<br />
<br />
<br />
First you need to install grub onto the USB's MBR. Follow the link to the Grub4DOS Wiki:<br />
Simple example:<br />
<pre><br />
./bootlace /dev/sdx<br />
</pre><br />
For more details, visit: <br />
[http://sourceforge.net/projects/grub4dos/ grub4dos]<br />
<br />
Next, you open up the ISO file and extract the files in casper directory. The size (and possibly manifest) are needed if you want to install from the USB flash drive otherwise the install will fail.<br />
<br />
<pre><br />
total 701060<br />
-rwxr-xr-x 1 adrian adrian 38784 2010-07-27 16:15 filesystem.manifest<br />
-rwxr-xr-x 1 adrian adrian 10 2010-07-27 16:15 filesystem.size<br />
-rwxrwxrwx 2 adrian adrian 704487424 2010-04-29 05:38 filesystem.squashfs*<br />
-rwxrwxrwx 1 adrian adrian 9365872 2010-04-29 05:34 initrd.lz*<br />
-rwxrwxrwx 1 adrian adrian 4029792 2010-04-16 06:01 vmlinuz*<br />
/media/Fujitsu 60GB USB/bootimg/ubuntu.10.4.x86$<br />
</pre><br />
<br />
Copy grldr to the root of the drive.<br />
<pre><br />
drwx------ 1 adrian adrian 4096 2010-05-05 16:49 bootimg/<br />
-rwxrwxrwx 1 adrian adrian 220049 2009-09-24 17:30 grldr*<br />
-rwxrwxrwx 1 adrian adrian 2760 2010-05-04 23:08 menu.lst*<br />
/media/Fujitsu 60GB USB$<br />
</pre><br />
Now create menu.lst at the root of USB.<br />
Example of menu.lst:<br />
<pre><br />
default /default<br />
##################### <br />
title Ubuntu 10.04 LiveCD<br />
find --set-root /bootimg/ubuntu.10.4.x86/initrd.lz<br />
kernel /bootimg/ubuntu.10.4.x86/vmlinuz boot=casper live-media-path=/bootimg/ubuntu.10.4.x86/ ignore_uuid<br />
initrd /bootimg/ubuntu.10.4.x86/initrd.lz<br />
boot<br />
</pre><br />
<br />
Make sure the path match where the files you copy to.<br />
<br />
Now, reboot.<br />
<br />
=== Simpler way using the ISO file ===<br />
<br />
Another way is just using the ISO file as it is on an already bootable USB flash drive that uses Grub (to create one, see above).<br />
* Copy the iso file onto the USB flash drive in the root (top) directory<br />
* Add these lines to the menu.lst file:<br />
<pre><br />
title Ubuntu 11.04 i386<br />
find --set-root /ubuntu-11.04-desktop-i386.iso<br />
map /ubuntu-11.04-desktop-i386.iso (0xff)<br />
map --hook<br />
root (0xff)<br />
kernel /casper/vmlinuz file=/cdrom/preseed/ubuntu.seed boot=casper iso-scan/filename=/ubuntu-11.04-desktop-i386.iso splash quiet --<br />
initrd /casper/initrd.lz<br />
</pre><br />
<br />
{{note|This might not work with all versions of grub. It was tested with GRUB4DOS 0.4.4 2008-11-11}}<br />
<br />
= Known Issues =<br />
<br />
Ubuntu 11.04 is having issues with USB flash drives from SanDisk that have U3 Launchpad. You can either use another brand or use either '''u3-tool''' from Ubuntu Repositories or SanDisk's [http://u3.sandisk.com/launchpadremoval.htm U3 Launchpad Removal Tool] to remove U3.<br />
<br />
Ubuntu 10.04.3 is having issues. You might get a segmentation fault if used from command line. <br />
There are many launchpad bugs regarding segmentation fault (eg: 572611).<br />
<br />
Some BIOS's (eg., the Eee PC netbook') have trouble recognizing that the USB is bootable. You may have to trick it into booting using the following method: At boot, enter the BIOS by pressing F2. Then, right as you exit the BIOS, hit the Esc key. For some systems, this will bring up the boot menu.<br />
<br />
The error "'''Can not mount /dev/loop1 on /cow'''" is because usb-creator.exe is not creating a valid casper-rw file holding ext2/ext3 filesystem.<br />
Fixes:<br />
# Use Unetbootin or<br />
# After running usb-creator.exe, recreate casper-rw using cygwin tools or http://www.pendrivelinux.com/casper-rw-creator-make-a-persistent-file-from-windows/. (As of April 2010)<br />
<br />
You need Mac OS X to create a USB flash drive that can boot on Macs. Even so, the process is less reliable than using a CD, as the USB flash drive is not always recognized on boot. Reversely, you can't create bootable USB flash drives for other platforms than Macs from withing Mac OS X. This is because Macs use a custom EFI bios with a custom boot-loader and need a special filesystem layout to boot correctly.<br />
<br />
== Resolving problematic installs ==<br />
<br />
If you are having problems not being able to get the installer to behave, below some steps that should correct that.<br />
<br />
# Boot your system with the installer thumbdrive and select the "Try Ubuntu" option. This should boot into Kodi.<br />
# Click the Shutdown menu in Kodi (lower-left corner) and select "Exit"<br />
# You should be presented with a log-in screen. Click "Other..." and enter '''Kodi''' as the login and select '''Kodibuntu''' from the dropdown menu (below the Login field).<br />
# Click "Login" and you will be prompted for the Password; just leave it blank.<br />
# Click "Login" again and the Kodibuntu desktop should be displayed.<br />
# On the top-left corner of the desktop should be an icon to install Ubuntu. Double-click the icon and, hopefully, you'll get the installation wizard this time.<br />
<br />
= See also =<br />
<big>{{see also|Kodibuntu|Kodibuntu FAQ}}</big><br /><br />
<br />
= References =<br />
<br />
<references><br />
<br />
= Credits =<br />
These instructions have been adapted from the Ubuntu Community Documentation and credits for its creation are attributed Ubuntu Documentation Team as per their creative commons licence 3.0.<br />
<br />
[[Category:How-to]]<br />
[[Category:Installation]]<br />
[[Category:Linux]]<br />
{{frodo updated}}</div>UNiversalhttps://kodi.wiki/index.php?title=Archive:HOW-TO:Install_Kodibuntu_from_a_USB_drive&diff=88979Archive:HOW-TO:Install Kodibuntu from a USB drive2015-04-14T11:03:22Z<p>UNiversal: XBMC -> Kodi</p>
<hr />
<div>{{mininav|[[General topics]]{{l2|[[Devices]]}}|[[Installing]]{{l2|[[Linux]]}}}}<br />
<section begin="intro" />This page explains procedures and methods to create a USB bootable drive or install Kodi into a USB flash drive. The instructions are written for [[Kodibuntu]], but may work for other installs with ISO images.<section end="intro" /><br />
{{redv|Warning|'''Backup your data before proceeding.''' The instructions contained in this page will format drives and will destroy data contained in said drives.}}<!-- --><br />
{{note|This article uses the term "USB flash drive" instead of: USB stick, USB drive, thumb drive and USB HDD.}}<br /><br />
<br />
<br />
= Outline =<br />
<br />
The general procedure to install Kodibuntu from a USB flash drive is:<br />
<br />
# Acquire the correct Kodibuntu installation files ('the ISO')<br />
# Put Kodibuntu/Ubuntu onto your USB flash drive<br />
# Configure your computer to boot from USB flash drive and boot from it<br />
# Try Kodibuntu/Ubuntu or install it to your hard drive.<br />
<br />
= Introduction =<br />
<br />
Kodibuntu can be installed from a USB flash drive, much like Ubuntu. This may be necessary for netbooks and other computers without CD drives, and is convenient for others. Also, configuration changes can be saved on the USB flash drive, unlike a CD-ROM drive. <br />
<br />
Booting from a USB flash drive created with this utility will behave as if you had booted from the install CD. It will show the language selection and then the install menu, from which you can install Kodibuntu onto the computer's hard drive or launch the Live USB environment.<br />
<br />
Kodibuntu can also be installed to a USB flash drive, though the life-span of the drive may be reduced slightly, due to the extra read/write cycles that Kodi requires. A tmpfs can be created to mitigate this though it is not covered by these instructions.<br />
<br />
You can also install Ubuntu and then Kodi on top, but this guide is only about creating a bootable flash drive from an ISO. It's either-or, '''not both'''.<br />
<br />
= Prerequisites =<br />
<br />
To create a USB installation disk, you will need:<br />
* Your favorite bootable USB creator tool<ref>In no particular order: [http://rufus.akeo.ie/ Rufus] [http://www.wintobootic.com wintobootic] [http://www.pendrivelinux.com/universal-usb-installer-easy-as-1-2-3/ Universal usb installer] [http://www.pendrivelinux.com/yumi-multiboot-usb-creator/ YUMI] [http://unetbootin.sourceforge.net/ unetbootin] [http://www.linuxliveusb.com/ Lili] [http://joshcellsoftwares.com/products/zotacwinusbmaker/ Winusbmaker] </ref><br />
* A 2GB or bigger USB flash drive. Files on this USB disk will be erased, so back up your data first. Make sure this USB disk is properly formatted and mounted.<br />
* A Kodibuntu ISO file. See [http://Kodi.org/download/ Kodi Download] to download it.<br />
{{note|If you're installing Kodi on top of Ubuntu, use the Ubuntu ISO instead of the Kodibuntu ISO. The ISO-to-flash drive process is similar for both XBCMbuntu.iso and Ubuntu.iso -- '''see next line'''}}<br />
* A Ubuntu image file. See [[http://www.ubuntu.com/download/alternative-downloads|Ubuntu Download]] to download it.<br />
<br />
= Creating a bootable Kodibuntu USB flash drive =<br />
<br />
== From Ubuntu ==<br />
[[File:Usb-creator.png|frame|right|Be aware existent data contained in the usb flash drive will be lost.]]<br />
<br />
* Install and run usb-creator<br />
{{redv|'''NOTE THAT''':| Linux has many bootable usb creating tools, which some may work better than others, so if something fails, try another of these programs.}}<br />
You can find usb-creator-gtk in the Unity Dash by typing "Startup Disk Creator" (Ubuntu Desktop) or usb-creator-kde in K-Menu-->Applications-->System-->Startup Disk Creator (Kubuntu).<br />
If it is not there, then you can install it using the [https://help.ubuntu.com/community/SynapticHowto Synaptic Package Manager] or [https://help.ubuntu.com/community/UbuntuSoftwareCenter Ubuntu Software Center]<br />
* Insert and mount the USB drive. Inserting the USB drive should auto-mount it. <br />
* Start usb-creator. It looks like this:<br />
<br />
* in the top pane of usb-creator, pick the .iso file that you downloaded.<br />
* if the .iso file isn't listed, click "Other" to locate and select the .iso file that you downloaded.<br />
* Alternately, if you have a CD or DVD-ROM with the Ubuntu version you want to install on the USB flash drive, insert it in your CD-ROM drive and usb-creator can use that. <br />
<br />
* It is not necessary to erase the USB flash drive, however it is advisable that you do so.<br />
# Select the first bootable partition on the USB device as the disk to use<br />
# The bootable partition should be formatted as either a FAT16 or FAT32 filesystem. This is the default for most USB flash drives.<br />
<br />
{{note|'''NEVER''' use one of your hard drive partitions in this process unless you really know what you are doing, as data will get erased.}}<br />
* There may be a bug during the formatting which will cause two partitions to appear when booting from the USB flash drive. Try selecting each of them and one should work. If not, restart the computer and try booting from the USB flash drive again.<br />
* If you get a DBus error with usb-creator, this bug report may be helpful: https://bugs.launchpad.net/ubuntu/+source/usb-creator/+bug/458334<br />
{{-}}<br />
<br />
== From Mac OSX ==<br />
<br />
=== UNetbootin (Automated, graphical approach) ===<br />
[[File:UNetbootinOSX.png|right|frame|150px|Unetbooting lets you create bootable images in OSX, resulting USB Flash drives are only bootable on PC's]]<br />
<br />
[http://unetbootin.sourceforge.net/ UNetbootin for Mac OS X] can be used to automate the process of extracting the ISO file to USB, and making the USB drive bootable. The resulting USB drive, however, can be booted on PCs only. If attempting to make a USB drive that can be booted from a Mac, or if UNetbootin does not successfully create a bootable drive, follow the instructions below.<br />
{{-}}<br />
<br />
=== Manual Approach ===<br />
<br />
If you would prefer to use a USB bootable in Mac, please follow the instructions below.<br />
<br />
{{note|This procedure requires an .img file that you will be required to create from the .iso file you download.}}<br />
{{tip|Drag and Drop a file from Finder to Terminal to 'paste' the full path without typing and risking type errors.}}<br />
* Download the desired file<br />
* Open the Terminal (in /Applications/Utilities/ or query '''Terminal''' in Spotlight)<br />
* Convert the .iso file to .img using the convert option of ''hdiutil'' (e.g.) <br />
<pre><br />
hdiutil convert -format UDRW -o ~/path/to/target.img ~/path/to/Kodibuntu.iso<br />
</pre><br />
{{tip|OS X tends to put the .dmg ending on the output file automatically.}}<br />
* Run<br />
<pre><br />
diskutil list<br />
</pre> to get the current list of devices<br />
* Insert your flash media<br />
* Run <br />
<pre><br />
diskutil list<br />
</pre><br />
again and determine the device node assigned to your flash media (e.g. /dev/disk2)<br />
* Run<br />
<pre><br />
diskutil unmountDisk /dev/diskN<br />
</pre><br />
(replace '''N''' with the disk number from the last command; in the previous example, N would be 2)<br />
* Execute <br />
<pre><br />
sudo dd if=/path/to/downloaded.img of=/dev/diskN bs=1m<br />
</pre><br />
(replace /path/to/downloaded.img with the path where the image file is located; for example, ./Kodibuntu.img or ./Kodibuntu.dmg).<br />
* Using ''/dev/rdisk'' instead of ''/dev/disk'' may be faster.<br />
** If you see the error ''dd: Invalid number '1m','' you are using GNU dd. Use the same command but replace ''bs=1m'' with ''bs=1M''.<br />
** If you see the error ''dd: /dev/diskN: Resource busy,'' make sure the disk is not in use. Start the '''Disk Utility.app''' and unmount (don't eject) the drive.<br />
* Run<br />
<pre><br />
diskutil eject /dev/diskN<br />
</pre><br />
and remove your flash media when the command completes<br />
* Restart your Mac and press '''Option''' while the Mac is restarting to choose the USB flash drive<br />
<br />
=== MacBook Air 13" 2010 ===<br />
'''Please notice:''' While all of the info and above commands are executed properly on a MacBook Air 3,2 (that is the 2010 version 13" version of the Air) the end result will ''not'' produce a bootable USB device, at least not with the image for Ubuntu 10.10 64-bit. When booting of the USB device the following message or something similar will appear: ''"Missing operating system"'' and the process is auto-magically halted. <br />
<br />
<br />
To get the USB device (e.g. a USB stick) to ''show up'' at all in the boot menu you also may have to reboot/turn on/off the computer a couple of times and also ''resync'' the partition tables using rEFIt.<br />
After doing this the USB should then appear as a bootable device while holding in the ''alt'' or ''c'' key when you are rebooting the computer. Notice that both the computers built in bootloader and rEFIt will identify the USB device as a Windows device, but that's not a problem and expected. <br />
<br />
A workaround to the-usb-device-is-not-booting-problem is to:<br />
* Install rEFIt.<br />
* Create a bootable start disk using Ubuntu and a USB stick.<br />
* Create a separate partition on the Airs HD.<br />
* dd the whole USB stick to that partition.<br />
* Resync with rEFIt. Turn power off and on.<br />
* Select Pingo/Windows logo: Install should start. (Here you might want to press F6 to change parameters, e.g. use nomodeset)<br />
<br />
Alternatively, burning a CD and installing via an external CD-drive will work fine on the Macbook Air 3,2.<br />
<br />
== From Windows ==<br />
[[File:Liliusb.jpg|thumb|300px|Creating a Kodibuntu or Ubuntu USB disk is easy, including Live mode.]]<br />
Download and use [http://www.linuxliveusb.com/en/download Linux Live USB Creator] aka LiLi.<br />
<br />
# Choose a USB flash drive in the dropdown list.<br />
# Select an ISO/IMG/ZIP file, or Download.<br />
# If you want to create a Live USB choose the size of persistent data (usually between 250 MB and 2 GB or more depending on size of library and amount of artwork you likely to store in [[userdata]]).<br />
# Check the options you want.<br />
# Click the lightning button to start the creation.<br />
<br />
Steps 1, 2, and 3 are mandatory, and each has a traffic light to indicate its state:<br />
* Red light: the step has not been completed correctly, and you cannot start creating a Live USB key<br />
* Orange light: there is a non-critical problem with this step, but you can still start the creation<br />
* Green light: everything is fine, go ahead<br />
<br />
{{note|Instead of usb-creator.exe you can use Unetbootin to create a bootable USB flash drive. http://unetbootin.sourceforge.net/}}<br />
You won't be able to select the USB flash drive if it wasn't formatted in a way that Windows can see it. You may have to format it using Windows Explorer in order for it to show up in a creator tool.<br />
{{-}}<br />
<br />
= Booting the Computer from USB =<br />
<br />
# Remove all unneeded USB items, but keep the network cable attached.<br />
# Insert the bootable USB flash drive that you just created in your target computer and restart it. Most newer computers can boot from a USB flash drive. If your computer does not automatically do so, you might need to edit the BIOS settings.<br />
# Restart your computer, and watch for a message telling you which key to press to enter the BIOS setup. It will usually be one of F1, F2, F8, DEL, ESC or F10. Press this key while your computer is booting to edit your BIOS settings. (On HP Mini Netbooks, they correct key is usually F9, Asrock ION machines is F11)<br />
# Instead of editing BIOS settings, you can chose a boot device from the boot menu. Press the function key to enter the boot menu when your computer is booting. Typically, the boot screen displays which key you need to press. It maybe one of F11, F12, F10. Note: with some motherboards you have to select 'hard disk/USB-HDD0' to choose the USB flash disk.<br />
# If you need to edit the Boot Order, depending on your computer, and how your USB key was formatted, you should see an entry for "removable drive" or "USB media". Move this to the top of the list to make the computer attempt to boot from the USB device before booting from the hard disk.<br />
{{note|Some Machines may not support booting from USB flash drive. Plop boot manager makes it simple to boot from CD and then boot from USB flash drive, you still require a CD drive in the machine via this method.}}<br />
* [http://www.plop.at/en/bootmanagers.html Plop boot manager] For more instructions and download.<br />
<br />
== Mac ==<br />
* Restart your Mac and press '''Option''' while the Mac is restarting to choose the USB flash drive<br />
<br />
= Alternative methods =<br />
<br />
== Installing Kodibuntu directly on a USB flash drive ==<br />
In order to install a fully working Kodibuntu operating system on your USB flash drive make sure that:<br />
<br />
* Your USB flash drive has more than 2GB of space<br />
* Your USB flash drive is bootable<br />
* Your USB flash drive has a high read/write speed and is USB 2.0 or newer enabled.<br />
* Your USB flash drive has persistence enabled<br />
<br />
'''''See [http://rudd-o.com/linux-and-free-software/a-better-way-to-create-a-customized-ubuntu-live-usb-drive A better way to create a customized Ubuntu live usb drive]<br />
{{note|Though it refers to Ubuntu you can adapt it 100% to Kodibuntu iso, since being a variant of Ubuntu anyway.}}<br />
<br />
== Create Bootable USB Manually ==<br />
<br />
Here is a way to create a bootable USB flash drive manually. The advantage is you don't have to empty your USB flash drive as long as you have enough space for the files. It also allows multi boot, so you can, for example, have your USB flash drive holding other OS and other Boot CD tools at the same time.<br />
<br />
In order to do so you need : <br />
<br />
* Bootable USB flash drive ( NTFS / FAT32 / FAT 16 ), Disk with MBR, you can do this with gparted in Linux or HP format in Win, fdisk ....etc<br />
* Kodibuntu or Ubuntu ISO<br />
* Tools to extract files from the ISO ( ISO Mount, WinZIP, WinRAR, 7Zip, etc....)<br />
* Grub4Dos<br />
# [http://www.rmprepusb.com/tutorials/grub4dos Grub4DOS Tutorial]<br />
# [http://download.gna.org/grub4dos/grub4dos-0.4.4-2009-06-20.zip Grub4DOS 0.4.4 for WIN9x/DOS/Linux (Download Here)]<br />
# [http://download.gna.org/grubutil/grubinst-1.1-src-2008-01-01.zip Grub4DOS GUI for WINXP/Vista/7 (Download Here]<br />
<br />
<br />
First you need to install grub onto the USB's MBR. Follow the link to the Grub4DOS Wiki:<br />
Simple example:<br />
<pre><br />
./bootlace /dev/sdx<br />
</pre><br />
For more details, visit: <br />
[http://sourceforge.net/projects/grub4dos/ grub4dos]<br />
<br />
Next, you open up the ISO file and extract the files in casper directory. The size (and possibly manifest) are needed if you want to install from the USB flash drive otherwise the install will fail.<br />
<br />
<pre><br />
total 701060<br />
-rwxr-xr-x 1 adrian adrian 38784 2010-07-27 16:15 filesystem.manifest<br />
-rwxr-xr-x 1 adrian adrian 10 2010-07-27 16:15 filesystem.size<br />
-rwxrwxrwx 2 adrian adrian 704487424 2010-04-29 05:38 filesystem.squashfs*<br />
-rwxrwxrwx 1 adrian adrian 9365872 2010-04-29 05:34 initrd.lz*<br />
-rwxrwxrwx 1 adrian adrian 4029792 2010-04-16 06:01 vmlinuz*<br />
/media/Fujitsu 60GB USB/bootimg/ubuntu.10.4.x86$<br />
</pre><br />
<br />
Copy grldr to the root of the drive.<br />
<pre><br />
drwx------ 1 adrian adrian 4096 2010-05-05 16:49 bootimg/<br />
-rwxrwxrwx 1 adrian adrian 220049 2009-09-24 17:30 grldr*<br />
-rwxrwxrwx 1 adrian adrian 2760 2010-05-04 23:08 menu.lst*<br />
/media/Fujitsu 60GB USB$<br />
</pre><br />
Now create menu.lst at the root of USB.<br />
Example of menu.lst:<br />
<pre><br />
default /default<br />
##################### <br />
title Ubuntu 10.04 LiveCD<br />
find --set-root /bootimg/ubuntu.10.4.x86/initrd.lz<br />
kernel /bootimg/ubuntu.10.4.x86/vmlinuz boot=casper live-media-path=/bootimg/ubuntu.10.4.x86/ ignore_uuid<br />
initrd /bootimg/ubuntu.10.4.x86/initrd.lz<br />
boot<br />
</pre><br />
<br />
Make sure the path match where the files you copy to.<br />
<br />
Now, reboot.<br />
<br />
=== Simpler way using the ISO file ===<br />
<br />
Another way is just using the ISO file as it is on an already bootable USB flash drive that uses Grub (to create one, see above).<br />
* Copy the iso file onto the USB flash drive in the root (top) directory<br />
* Add these lines to the menu.lst file:<br />
<pre><br />
title Ubuntu 11.04 i386<br />
find --set-root /ubuntu-11.04-desktop-i386.iso<br />
map /ubuntu-11.04-desktop-i386.iso (0xff)<br />
map --hook<br />
root (0xff)<br />
kernel /casper/vmlinuz file=/cdrom/preseed/ubuntu.seed boot=casper iso-scan/filename=/ubuntu-11.04-desktop-i386.iso splash quiet --<br />
initrd /casper/initrd.lz<br />
</pre><br />
<br />
{{note|This might not work with all versions of grub. It was tested with GRUB4DOS 0.4.4 2008-11-11}}<br />
<br />
= Known Issues =<br />
<br />
Ubuntu 11.04 is having issues with USB flash drives from SanDisk that have U3 Launchpad. You can either use another brand or use either '''u3-tool''' from Ubuntu Repositories or SanDisk's [http://u3.sandisk.com/launchpadremoval.htm U3 Launchpad Removal Tool] to remove U3.<br />
<br />
Ubuntu 10.04.3 is having issues. You might get a segmentation fault if used from command line. <br />
There are many launchpad bugs regarding segmentation fault (eg: 572611).<br />
<br />
Some BIOS's (eg., the Eee PC netbook') have trouble recognizing that the USB is bootable. You may have to trick it into booting using the following method: At boot, enter the BIOS by pressing F2. Then, right as you exit the BIOS, hit the Esc key. For some systems, this will bring up the boot menu.<br />
<br />
The error "'''Can not mount /dev/loop1 on /cow'''" is because usb-creator.exe is not creating a valid casper-rw file holding ext2/ext3 filesystem.<br />
Fixes:<br />
# Use Unetbootin or<br />
# After running usb-creator.exe, recreate casper-rw using cygwin tools or http://www.pendrivelinux.com/casper-rw-creator-make-a-persistent-file-from-windows/. (As of April 2010)<br />
<br />
You need Mac OS X to create a USB flash drive that can boot on Macs. Even so, the process is less reliable than using a CD, as the USB flash drive is not always recognized on boot. Reversely, you can't create bootable USB flash drives for other platforms than Macs from withing Mac OS X. This is because Macs use a custom EFI bios with a custom boot-loader and need a special filesystem layout to boot correctly.<br />
<br />
== Resolving problematic installs ==<br />
<br />
If you are having problems not being able to get the installer to behave, below some steps that should correct that.<br />
<br />
# Boot your system with the installer thumbdrive and select the "Try Ubuntu" option. This should boot into Kodi.<br />
# Click the Shutdown menu in Kodi (lower-left corner) and select "Exit"<br />
# You should be presented with a log-in screen. Click "Other..." and enter '''Kodi''' as the login and select '''Kodibuntu''' from the dropdown menu (below the Login field).<br />
# Click "Login" and you will be prompted for the Password; just leave it blank.<br />
# Click "Login" again and the Kodibuntu desktop should be displayed.<br />
# On the top-left corner of the desktop should be an icon to install Ubuntu. Double-click the icon and, hopefully, you'll get the installation wizard this time.<br />
<br />
= See also =<br />
<big>{{see also|Kodibuntu|Kodibuntu FAQ}}</big><br /><br />
<br />
= References =<br />
<br />
<references><br />
<br />
= Credits =<br />
These instructions have been adapted from the Ubuntu Community Documentation and credits for its creation are attributed Ubuntu Documentation Team as per their creative commons licence 3.0.<br />
<br />
[[Category:How-to]]<br />
[[Category:Installation]]<br />
[[Category:Linux]]<br />
{{frodo updated}}</div>UNiversalhttps://kodi.wiki/index.php?title=Archive:Kodibuntu&diff=88978Archive:Kodibuntu2015-04-14T10:36:42Z<p>UNiversal: </p>
<hr />
<div>{{mininav|[[Linux]] {{l2| [[Devices]] }} }}<br />
{{to do}}<br />
<section begin="intro" />Kodibuntu is a combination Kodi/operating system for use on PCs that are mainly just running Kodi. It is an alternative to installing Windows or a larger (and sometimes more complicated) Linux-based OS.<section end="intro" /><br />
<br />
== Hardware requirements ==<br />
{{see also|Supported hardware}}<br />
<br />
Kodibuntu should work with the general hardware requirements for Linux:<br />
{{Collapse top|Click to show hardware requirements -->}}<br />
{{#lst:Supported hardware|Linux}}<br />
{{Collapse bottom}}<br />
<br />
== Installing ==<br />
{{main|HOW-TO:Install KodiBuntu from a USB drive}}<br />
Kodibuntu comes in an ISO form that can be written to a USB drive or burned to an optical disc.<br />
<br />
Download the current stable Kodibuntu image from: '''<code>http://kodi.tv/download/</code>'''<br />
<br />
{{note|<br />
* Kodibuntu has only one iso image file for all x86 computers, regardless of GPU.<br />
* Currently, only a '''64-bit''' version is available, but this should cover the vast majority of users.<br />
* A pre release 32bit exists in mirrors with unstable ppa and RC candidate Kodi, which can be upgraded to stable kodi}}<br />
<br />
== Upgrading Kodi Media Center ==<br />
{{main|HOW-TO:Install Kodi for Linux#Upgrading}}<br />
{{#lst:HOW-TO:Install Kodi for Linux|Ubuntu upgrade}}<br />
<br />
=== Upgrading the OS ===<br />
<br />
Current Kodibuntu is based on a LTS release (long term release) which is supported for 5 years, this means that you wont require to upgrade the OS base in order to obtain updated or upgrade application packages.<br />
<br />
See [https://wiki.ubuntu.com/Releases Current Ubuntu releases] if your current distro is listed under End of life table, you will need to upgrade your OS to a supported release.<br />
<br />
However should you need to upgrade the OS base a quick how-to follows.<br />
<br />
{{#lst:Kodibuntu FAQ|upgradeOS}}<br />
<br />
== Basic use ==<br />
<br />
=== Desktop mode ===<br />
<br />
Kodibuntu can boot directly into Kodi or it can also boot into a desktop mode for using applications such as a web browser.<br />
<br />
In order to enter desktop mode, follow those steps below:<br />
<gallery widths=500px heights=313px><br />
File:kodi-exit.png|'''Step 1:''' ''Exit'' Kodi.<br />
File:kodi-session.png|'''Step 2:''' Select ''Lubuntu'' and enter your ''username'' and ''password''.<br />
</gallery><br />
<br />
The username may differ from the one you supplied during installation. So please be aware, that "xbmc" (as shown in the screenshot) might not be the username you will see and/or have to use. <br />
<br />
{{note|If you last booted directly or switched to desktop and shutdown the HTPC while in desktop, on next reboot you will get the last used session by default.}} <br />
<br />
To return to Kodi, '''logout''', select '''Kodi''' as session in the top-right pulldown menu and enter your ''username'' and ''password'' again.<br />
<br />
=== Login ===<br />
To login to the command line interface press {{keypress|Ctrl|Alt|F1 - F6 }} or connect over [[SSH]] by using usernamne and password supplied during installation.<br />
<br />
{{note|For the use of {{keypress|Ctrl|Alt|F1 - F6 }} no username and password is required. You are logged in directly to the command line.}} <br />
<br />
<br />
=== Media center ===<br />
Kodibuntu contains [[Linux|Kodi for Linux]] compiled with the 'standalone' mode, this enabled certain functions that are not available in normal Kodi installations (Windows, Mac Linux), these functions include Power Management, and Network Management.<br />
<br />
=== Using desktop mode ===<br />
<br />
== KodiBuntu FAQ ==<br />
{{See|KodiBuntu FAQ}}<br />
<br />
== See also ==<br />
* [[Linux]]<br />
* [[HOW-TO:Install Kodi for Linux]]<br />
* [[JeOS implementations for Kodi]]<br />
* [[OpenELEC]]<br />
<br />
{{Helix updated}}<br />
<br />
[[Category:Installation]]<br />
[[Category:Linux]]<br />
[[Category:Kodibuntu|*]]<br />
[[Category:Manual]]</div>UNiversalhttps://kodi.wiki/index.php?title=Archive:Kodibuntu&diff=88977Archive:Kodibuntu2015-04-14T10:35:31Z<p>UNiversal: /* Installing */</p>
<hr />
<div>{{mininav|[[Linux]] {{l2| [[Devices]] }} }}<br />
{{to do}}<br />
<section begin="intro" />Kodibuntu is a combination Kodi/operating system for use on PCs that are mainly just running Kodi. It is an alternative to installing Windows or a larger (and sometimes more complicated) Linux-based OS.<section end="intro" /><br />
<br />
== Hardware requirements ==<br />
{{see also|Supported hardware}}<br />
<br />
Kodibuntu should work with the general hardware requirements for Linux:<br />
{{Collapse top|Click to show hardware requirements -->}}<br />
{{#lst:Supported hardware|Linux}}<br />
{{Collapse bottom}}<br />
<br />
== Installing ==<br />
{{main|HOW-TO:Install KodiBuntu from a USB drive}}<br />
Kodibuntu comes in an ISO form that can be written to a USB drive or burned to an optical disc.<br />
<br />
Download the current stable Kodibuntu image from: '''<code>http://kodi.tv/download/</code>'''<br />
<br />
{{note|<br />
* Kodibuntu has only one iso image file for all x86 computers, regardless of GPU.<br />
* Currently, only a '''64-bit''' version is available, but this should cover the vast majority of users.<br />
* A pre release 32bit exists in mirrors with unstable ppa and RC candidate Kodi, which can be upgraded to stable kodi}}<br />
<br />
== Upgrading Kodi Media Center ==<br />
{{main|HOW-TO:Install Kodi for Linux#Upgrading}}<br />
{{#lst:HOW-TO:Install Kodi for Linux|Ubuntu upgrade}}<br />
<br />
=== Upgrading the OS ===<br />
<br />
Current Kodibuntu is based on a LTS release (long term release) which is supported for 5 years, this means that you wont require to upgrade the OS base in order to obtain updated or upgrade application packages.<br />
<br />
See [https://wiki.ubuntu.com/Releases Current Ubuntu releases] if your current distro is listed under End of life table, you will need to upgrade your OS to a supported release.<br />
<br />
However should you need to upgrade the OS base a quick how-to follows.<br />
<br />
{{#lst:Kodibuntu FAQ|upgradeOS}}<br />
<br />
== KodiBuntu FAQ ==<br />
{{See|KodiBuntu FAQ}}<br />
<br />
== Basic use ==<br />
<br />
=== Desktop mode ===<br />
<br />
Kodibuntu can boot directly into Kodi or it can also boot into a desktop mode for using applications such as a web browser.<br />
<br />
In order to enter desktop mode, follow those steps below:<br />
<gallery widths=500px heights=313px><br />
File:kodi-exit.png|'''Step 1:''' ''Exit'' Kodi.<br />
File:kodi-session.png|'''Step 2:''' Select ''Lubuntu'' and enter your ''username'' and ''password''.<br />
</gallery><br />
<br />
The username may differ from the one you supplied during installation. So please be aware, that "xbmc" (as shown in the screenshot) might not be the username you will see and/or have to use. <br />
<br />
{{note|If you last booted directly or switched to desktop and shutdown the HTPC while in desktop, on next reboot you will get the last used session by default.}} <br />
<br />
To return to Kodi, '''logout''', select '''Kodi''' as session in the top-right pulldown menu and enter your ''username'' and ''password'' again.<br />
<br />
=== Login ===<br />
To login to the command line interface press {{keypress|Ctrl|Alt|F1 - F6 }} or connect over [[SSH]] by using usernamne and password supplied during installation.<br />
<br />
{{note|For the use of {{keypress|Ctrl|Alt|F1 - F6 }} no username and password is required. You are logged in directly to the command line.}} <br />
<br />
<br />
=== Media center ===<br />
Kodibuntu contains [[Linux|Kodi for Linux]] compiled with the 'standalone' mode, this enabled certain functions that are not available in normal Kodi installations (Windows, Mac Linux), these functions include Power Management, and Network Management.<br />
<br />
=== Using desktop mode ===<br />
<br />
== See also ==<br />
* [[Linux]]<br />
* [[HOW-TO:Install Kodi for Linux]]<br />
* [[JeOS implementations for Kodi]]<br />
* [[OpenELEC]]<br />
<br />
{{Helix updated}}<br />
<br />
[[Category:Installation]]<br />
[[Category:Linux]]<br />
[[Category:Kodibuntu|*]]<br />
[[Category:Manual]]</div>UNiversalhttps://kodi.wiki/index.php?title=Archive:Skin_features_compatibility_list&diff=88806Archive:Skin features compatibility list2015-04-05T12:14:03Z<p>UNiversal: </p>
<hr />
<div>{{mininav|Skins}}<br />
{{wiki revamp}}<br />
<br />
__TOC__<br />
== Kodi v14 Helix skins ==<br />
<!-- Migration to a dynamically created list, so all editing, even to be shown here, is done on the individual skin pages. --><br />
<DPL><br />
category = Skins<br />
category = Helix add-on repository<br />
notcategory = Broken add-ons<br />
namespace = Add-on<br />
includepage = {Skin features} dpl<br />
mode=userformat<br />
format = \n{|class="wikitable" \n! align="center"; rowspan="3" | Skin \n|-\n! align="center"; colspan="22" | Features \n|-\n|\n| [[Custom home items]] \n| TV show logos \n| [[Add-on:Artwork Downloader|Artwork Downloader]] \n| Clear Art \n| cdArt \n| [[Extra fanart]] \n| [[Add-on:TV Show - Next Aired|Next Aired]] \n| [[Add-on:TvTunes|TvTunes]] \n| Skin Widgets \n| Metadata Actors \n| Cinema Experience \n|Intro movie \n| Touch support \n| [[PVR|Live TV/PVR]] ,\n|-\n|[[%PAGE%|%TITLE%]],,\n|}<br />
secseparators = \n|<br />
</DPL><br />
<br />
== XBMC v13 Gotham skins ==<br />
<!-- Migration to a dynamically created list, so all editing, even to be shown here, is done on the individual skin pages. --><br />
<DPL><br />
category = Skins<br />
category = Gotham add-on repository<br />
notcategory = Broken add-ons<br />
namespace = Add-on<br />
includepage = {Skin features} dpl<br />
mode=userformat<br />
format = \n{|class="wikitable" \n! align="center"; rowspan="3" | Skin \n|-\n! align="center"; colspan="22" | Features \n|-\n|\n| [[Custom home items]] \n| TV show logos \n| [[Add-on:Artwork Downloader|Artwork Downloader]] \n| Clear Art \n| cdArt \n| [[Extra fanart]] \n| [[Add-on:TV Show - Next Aired|Next Aired]] \n| [[Add-on:TvTunes|TvTunes]] \n| Skin Widgets \n| Metadata Actors \n| Cinema Experience \n|Intro movie \n| Touch support \n| [[PVR|Live TV/PVR]] ,\n|-\n|[[%PAGE%|%TITLE%]],,\n|}<br />
secseparators = \n|<br />
</DPL><br />
<br />
== XBMC v12 Frodo skins ==<br />
<!-- Migration to a dynamically created list, so all editing, even to be shown here, is done on the individual skin pages. --><br />
<DPL><br />
category = Skins<br />
category = Frodo add-on repository<br />
notcategory = Broken add-ons<br />
namespace = Add-on<br />
includepage = {Skin features} dpl<br />
mode=userformat<br />
format = \n{|class="wikitable" \n! align="center"; rowspan="3" | Skin \n|-\n! align="center"; colspan="22" | Features \n|-\n|\n| [[Custom home items]] \n| TV show logos \n| [[Add-on:Artwork Downloader|Artwork Downloader]] \n| Clear Art \n| cdArt \n| [[Extra fanart]] \n| [[Add-on:TV Show - Next Aired|Next Aired]] \n| [[Add-on:TvTunes|TvTunes]] \n| Skin Widgets \n| Metadata Actors \n| Cinema Experience \n|Intro movie \n| Touch support \n| [[PVR|Live TV/PVR]] ,\n|-\n|[[%PAGE%|%TITLE%]],,\n|}<br />
secseparators = \n|<br />
</DPL><br />
<br />
== Other skins ==<br />
<br />
<!-- Migration to a dynamically created list, so all editing, even to be shown here, is done on the individual skin pages. --><br />
<DPL><br />
category = Skins<br />
notcategory = Gotham add-on repository<br />
notcategory = Frodo add-on repository<br />
notcategory = Broken add-ons<br />
namespace = Add-on<br />
includepage = {Skin features} dpl<br />
mode=userformat<br />
format = \n{|class="wikitable" \n! align="center"; rowspan="3" | Skin \n|-\n! align="center"; colspan="22" | Features \n|-\n|\n| [[Custom home items]] \n| TV show logos \n| [[Add-on:Artwork Downloader|Artwork Downloader]] \n| Clear Art \n| cdArt \n| [[Extra fanart]] \n| [[Add-on:TV Show - Next Aired|Next Aired]] \n| [[Add-on:TvTunes|TvTunes]] \n| Skin Widgets \n| Metadata Actors \n| Cinema Experience \n|Intro movie \n| Touch support \n| [[PVR|Live TV/PVR]] ,\n|-\n|[[%PAGE%|%TITLE%]],,\n|}<br />
secseparators = \n|<br />
</DPL><br />
<br />
[[Category:Skins|*Comparison of skin features]]</div>UNiversalhttps://kodi.wiki/index.php?title=User:UNiversal&diff=88436User:UNiversal2015-03-29T07:16:02Z<p>UNiversal: </p>
<hr />
<div>{{DISPLAYTITLE:User:uNiversal}}<br />
<br />
[[File:XBMC splash by uNiversal.jpg|left|500px|'''Done especially for xbmc Settings menu [[forum:183508|Click here to see forums thread''']]]]<br />
<br />
{{Infobox<br />
|bodystyle = <br />
|above = uNiversal<br />
|titlestyle = <br />
<br />
|image = [[File:Zappy-omg.png|200px|alt=uNiversal|link=]]<br />
|imagestyle = <br />
|caption = '''''Error!''''' Out of Memory!<br />
|captionstyle = <br />
|headerstyle = background:#A0CC54;<br />
|labelstyle = background:#84B334;<br />
|datastyle = background:#A0CC54;<br />
<br />
|header1 = XBMC user<br />
|header2 = <br />
|header3 =<br />
|label3 = System Details:<br />
|data3 = '''Linux.4.0~Custom'''<br />
|header4 = <br />
|label4 = Brain Version:<br />
|data4 = '''Positronic 2.0'''<br />
|header5 = <br />
|label5 = Power Matrix:<br />
|data5 = '''Hybrid/Biologic'''<br />
|belowstyle = <br />
|below = {{keypress|'''Ctrl|Alt|Del'''}}<br />
}}<br />
{{-}}<br />
{{progress|100}}<br />
<br />
==Sandbox==<br />
{{hidden<br />
| style = border:1px dashed red; width: 50%;<br />
| headerstyle = background: #ccccff; font-size: 110%;<br />
| contentstyle = text-align: center; color:green;<br />
| header = Sandbox<br />
| content = <br />
<!-- --><br />
[[Template:orangev]]<br />
<div style="background:#fefefe; padding:0 1em 0 1.1em;margin: .5em 0 .5em 0;"><br />
<div style="border-left:.5em solid #E3871E;padding:.2em .5em .4em 1em;"><span style="font-weight: bold; color:#E3871E; padding:.2em .5em .4em 0em;"><u>{{{1}}}</u> </span>{{{1}}}</div></div><br />
<noinclude>{{documentation}}</noinclude><br />
<br />
<!-- --><br />
[[Template:goldv]]<br />
<div style="background:#fefefe; padding:0 1em 0 1.1em;margin: .5em 0 .5em 0;"><br />
<div style="border-left:.5em solid #E3BF1E;padding:.2em .5em .4em 1em;"><span style="font-weight: bold; color:#E3BF1E; padding:.2em .5em .4em 0em;"><u>{{{1}}}</u> </span>{{{1}}}</div></div><br />
<noinclude><br />
{{Documentation}}<br />
[[Category:Templates]]<br />
</noinclude><br />
<br />
<!-- --><br />
[[Template:Quote]]<br />
<div style="background-color:#F6FFD6; border: 3px dashed #6EBA1C;">{{{1}}}</div><br />
<noinclude><br />
{{Documentation}}<br />
[[Category:Templates]]<br />
</noinclude><br />
<br />
<!--<br />
[[Template:helpn]]<br />
{| style="background-color:#F6FFD6; width=100%; border: 3px dashed #6EBA1C; font-size: 100%; margin-top: 2px; margin-bottom: 2px;" | <br />
| width="10px" | [[File:help.png|50px|link=|HELP]]<br />
| align="right" | {{{raw|'''{{{2|NOTICE}}}:''' {{{1}}}}}}<br />
|}<br />
<noinclude><br />
{{Documentation}}<br />
[[Category:Templates]]<br />
</noinclude><br />
--><br />
<br />
<!-- --><br />
[[Template:Note]]<br />
[[File:Note.png|40px|link=|REMEMBER]]<br />
<noinclude><br />
{{Documentation}}<br />
[[Category:Templates]]<br />
</noinclude><br />
<br />
<!-- --><br />
[[Template:Tip]]<br />
[[File:Lightbulb.png|35px|link=|TIP]]<br />
<noinclude><br />
{{Documentation}}<br />
[[Category:Templates]]<br />
</noinclude><br />
<br />
<!-- --><br />
[[Template:Help]]<br />
[[File:Help.png|35px|link=|HELP]]<br />
<noinclude><br />
{{Documentation}}<br />
[[Category:Templates]]<br />
</noinclude><br />
|headerstyle=background:#ccccff<br />
|style=text-align:center;<br />
}}<br />
<br />
== video Hardware ==<br />
{| class="prettytable" style="text-align: center; color: black;"<br />
! colspan="23" style="background-color:#E6E6E6;" | '''Hardware and video playback compatibility<br/>'''<br />
|-<br />
! colspan="5" style="background-color:#B8D0FF;" | '''HTPC Hardware'''<br />
! colspan="3" style="background-color:#FFE5CC;" | '''External Equipment'''<br />
! style="background-color:#DBDBFF;" | '''Decoder'''<br />
! colspan="10" style="background-color:#DBFF94;" | '''Video Capabilities<br/>'''<br />
! rowspan="2" style="background-color:#FFEBCC;" | '''Operative<br/>System'''<br />
! colspan="2" style="background-color:#E5FF97;" | '''Driver'''<br />
! rowspan="2" style="background-color:#B8D0FF;" | '''XBMC<br/>Version'''<br />
|-<br />
! style="background-color:#B8D0FF;" | '''Model'''<br />
! style="background-color:#B8D0FF;" | '''GPU - VPU type'''<br />
! style="background-color:#B8D0FF;" | '''CPU type'''<br />
! style="background-color:#B8D0FF;" | '''Code Names'''<br />
! style="background-color:#B8D0FF;" | '''Limitation'''<br />
| style="background-color:#FFE5CC;" | '''Plug'''<br />
| style="background-color:#FFE5CC;" | '''AVR'''<br />
| style="background-color:#FFE5CC;" | '''Television'''<br />
! rowspan="0" style="background-color:#DBDBFF;" | '''GPU<br/>VPU<br/>CPU<br/>'''<br />
| style="background-color:#DBFF94;" | '''H.262'''<br />
| style="background-color:#DBFF94;" | '''H.263'''<br />
| style="background-color:#DBFF94;" | '''H.264'''<br />
| style="background-color:#DBFF94;" | '''H.265'''<br />
| style="background-color:#DBFF94;" | '''MPEG-4v3'''<br />
| style="background-color:#DBFF94;" | '''WMV'''<br />
| style="background-color:#DBFF94;" | '''On2'''<br />
| style="background-color:#DBFF94;" | '''720/1080'''<br />
| style="background-color:#DBFF94;" | '''Blu-ray'''<br />
| style="background-color:#DBFF94;" | '''3D'''<br />
! style="background-color:#E5FF97;" | '''Version'''<br />
! style="background-color:#E5FF97;" | '''Limitation'''<br />
|-<br />
| Some ficticious<br />
| ugabuga<br />
| holahoops<br />
| armadillo<br />
| {{yes}}<br />
| HDMI <br />
| AVRBONGO<br />
| Smugsung<br />
| cpu<br />
| gpu<br />
| cpu<br />
| {{no}}<br />
| {{no}}<br />
| {{no}}<br />
| {{yes}}<br />
| {{yes}}<br />
| {{NA}}<br />
| {{yes}}<br />
|some os<br />
| {{NA}}<br />
| {{wip}}<br />
| V12.3<br />
|-<br />
| R-type MXU<br />
| Positronic<br />
| Quantum X<br />
| armadillo<br />
| {{yes}}<br />
| HDMI <br />
| AVRBONGO<br />
| Smugsung<br />
| vpu<br />
| vpu<br />
| cpu<br />
| {{no}}<br />
| {{no}}<br />
| {{no}}<br />
| {{yes}}<br />
| {{yes}}<br />
| {{NA}}<br />
| {{yes}}<br />
| LinWinDrA<br />
| {{no}}<br />
| {{wip}}<br />
| V14-alpha1-7asd43e<br />
|}<br />
<br />
== audio hardware ==<br />
{| class="prettytable" style="text-align: center; color: black;"<br />
! colspan="23" style="background-color:#E6E6E6;" | '''Hardware and audio playback compatibility<br/>'''<br />
|-<br />
! colspan="5" style="background-color:#B8D0FF;" | '''HTPC Hardware'''<br />
! colspan="3" style="background-color:#FFE5CC;" | '''External Equipment'''<br />
! colspan="7" style="background-color:#DBFF94;" | '''Audio Capabilities<br/>'''<br />
! rowspan="2" style="background-color:#FFEBCC;" | '''Operative<br/>System'''<br />
! colspan="2" style="background-color:#E5FF97;" | '''Driver'''<br />
! rowspan="2" style="background-color:#B8D0FF;" | '''XBMC<br/>Version'''<br />
|-<br />
! style="color:#000000; background-color:#B8D0FF;" | '''Model'''<br />
! style="color:#000000; background-color:#B8D0FF;" | '''GPU - VPU type'''<br />
! style="color:#000000; background-color:#B8D0FF;" | '''Audio device'''<br />
! style="color:#000000; background-color:#B8D0FF;" | '''Code Name'''<br />
! style="color:#000000; background-color:#B8D0FF;" | '''Limitation'''<br />
! style="color:#000000; background-color:#FFE5CC;" | '''Plug'''<br />
! style="color:#000000; background-color:#FFE5CC;" | '''Receiver'''<br />
! style="color:#000000; background-color:#FFE5CC;" | '''Television'''<br />
! style="color:#000000; background-color:#DBFF94;" | '''AC3'''<br />
! style="color:#000000; background-color:#DBFF94;" | '''LPCM'''<br />
! style="color:#000000; background-color:#DBFF94;" | '''DTS'''<br />
! style="color:#000000; background-color:#DBFF94;" | '''DTS-HD MA'''<br />
! style="color:#000000; background-color:#DBFF94;" | '''DTS-HD'''<br />
! style="color:#000000; background-color:#DBFF94;" | '''TrueHD'''<br />
! style="color:#000000; background-color:#DBFF94;" | '''DD+/E-AC3'''<br />
! style="color:#000000; background-color:#E5FF97;" | '''Version'''<br />
! style="color:#000000; background-color:#E5FF97;" | '''Limitation'''<br />
|-<br />
| ASRock E350M1 <br />
| Radeon HD 6310<br />
| {{?}}<br />
| Wrestler<br />
| {{No}}<br />
| '''HDMI'''<br />
| '''Onkyo HT-R380'''<br />
| {{?}}<br />
| {{Yes}}<br />
| {{?}}<br />
| {{Yes}}<br />
| {{Yes}}<br />
| {{Yes}}<br />
| {{Yes}}<br />
| {{?}}<br />
| Windows 8 Pro, x64<br />
| '''13.2 Beta6'''<br />
| {{No}}<br />
| {{?}}<br />
|-<br />
| ASRock E350M1 <br />
| Radeon HD 6310<br />
| {{?}}<br />
| Wrestler<br />
| {{No}}<br />
| '''HDMI'''<br />
| '''Onkyo HT-R380'''<br />
| {{?}}<br />
| {{yes}}<br />
| {{?}}<br />
| {{yes}}<br />
| {{No}}<br />
| {{No}}<br />
| {{No}}<br />
| {{?}}<br />
| OpenELEC 3.0 RC4 (2.99.4)<br />
| '''12.10'''<br />
| {{No}}<br />
| {{?}}<br />
|-<br />
| ZOTAC ZBOX AD04 PLUS<br />
| Radeon HD 6320<br />
| {{?}}<br />
| Zacate<br />
| {{Yes}}<br />
| '''HDMI'''<br />
| '''Denon AVR-1713'''<br />
| {{?}}<br />
| {{yes}}<br />
| {{Yes}}<br />
| {{No}}<br />
| {{No}}<br />
| {{no}}<br />
| {{?}}<br />
| {{yes}}<br />
| XBMCbuntu 12.0 "FRODO"<br />
| {{?}}<br />
| {{yes}}<br />
| XBMC v12.0<br />
|-<br />
| Zotac ZBOX AD06<br />
| Radeon HD 7340<br />
| {{?}}<br />
| Zacate<br />
| {{Yes}}<br />
| '''HDMI'''<br />
| '''Samsung AV-R720'''<br />
| {{?}}<br />
| {{Yes}}<br />
| {{Yes}}<br />
| {{No}}<br />
| {{No}}<br />
| {{No}}<br />
| {{?}}<br />
| {{Yes}}<br />
| OpenELEC 3.0.0<br />
| '''12.10?'''<br />
| {{yes}}<br />
| {{?}}<br />
|-<br />
| M5A78L-M/USB3<br />
| Radeon HD 6850<br />
| {{?}}<br />
| Barts<br />
| {{no}}<br />
| '''HDMI'''<br />
| '''Denon AVR-4310'''<br />
| {{?}}<br />
| {{Yes}}<br />
| {{Yes}}<br />
| {{Yes}}<br />
| {{Yes}}<br />
| {{Yes}}<br />
| {{Yes}}<br />
| {{Yes}}<br />
| OpenELEC (official) - 3.2.4 x64<br />
| {{?}}<br />
| {{no}}<br />
| {{?}}<br />
|-<br />
|}<br />
<br />
= '''Video harware setups reported to work avr-tv-htpc combo''' =<br />
{{mininav|[[Audio hardware compatibility]]}}<br />
{{wiki revamp}}{{progress|55}}<br />
;If you ever asked the questions:<br />
<br />
* What HTPC should I get?<br />
* What TV Should I get?<br />
* What AVR/Receiver should I get?<br />
* What Combination of the above 3 work best?<br />
* What OS should XBMC be on?<br />
* What drivers if any are reported to work?<br />
* What limitations does this machine/setup have over another?<br />
* What General capabilities does it have be it xyz audio/video?<br />
<br />
;Then this page is for you, ideally!<br />
<br />
<br />
{{greenv| Notice:| This page is a user generated/driven content, with their hardware and setup's that work or dont work in any of these situations.}}<br />
{{bluev| Updating:| Feel free to update this list accordingly and add fields to table for other video types your hardware can or cant do.}}<br />
<br />
<big>'''''Please add your experience below.'''''</big><br />
<br />
== Legend key ==<br />
{{legendav}}<br />
<br />
== Video hardware capabilities and reported to work ==<br />
<br />
{{note|'''H265''' a.k.a. '''HEVC''' is not yet supported in XBMC (as of XBMC v13) Until next ffmpeg bump}}<br />
<br />
{| class="prettytable" style="text-align: center; color: black;"<br />
! {{VWorklistHeader}}<br />
|-<br />
| '''fictitious'''<br />
| '''ugabuga'''<br />
| '''holahoops'''<br />
| '''armadillo'''<br />
| {{yes}}<br />
| '''HDMI''' <br />
| '''AVRBONGO'''<br />
| '''Smugsung'''<br />
| '''cpu'''<br />
| '''gpu'''<br />
| '''vpu'''<br />
| {{?}}<br />
| {{no}}<br />
| {{no}}<br />
| {{yes}}<br />
| {{yes}}<br />
| {{NA}}<br />
| {{yes}}<br />
| '''Liwindra os'''<br />
| {{?}}<br />
| {{wip}}<br />
| V14-alpha1-7asd43e<br />
|}<br />
<br />
<noinclude><br />
[[Category:Hardware]]<br />
</noinclude><br />
<br />
= '''Audio hardware setups reported to work htpc-avr-tv combos''' =<br />
{{mininav|[[Video hardware compatibility]]}}<br />
{{wiki revamp}}{{progress|65}}<br />
<br />
;If you ever asked the questions:<br />
<br />
* What HTPC should I get?<br />
* What TV Should I get?<br />
* What AVR/Receiver should I get?<br />
* What Combination of the above 3 work best?<br />
* What OS should XBMC be on?<br />
* What drivers if any are reported to work?<br />
* What limitations does this machine/setup have over another?<br />
* What General capabilities does it have be it xyz audio/video?<br />
<br />
;Then this page is for you, ideally!<br />
<br />
<br />
{{greenv| Notice:| This page is a user generated/driven content, with their hardware and setup's that work or dont work in any of these situations.}}<br />
{{bluev| Updating:| Feel free to update this list accordingly and add fields to table for other video types your hardware can or cant do.}}<br />
<br />
<big>'''''Please add your experience below.'''''</big><br />
<br />
== Legend key ==<br />
{{legendav}}<br />
<br />
== Audio hardware capabilities and reported to work ==<br />
<br />
{{note|'''Dolby Digital Plus''' a.k.a. '''DD+ or E-AC-3''' is supported in AE > ActiveAE (as of XBMC v13) and will not work properly in XBMC 12.3 or Older.}}<br />
<br />
== AMD Based ==<br />
{| class="prettytable" style="text-align: center; color: black;"<br />
! {{AWorklistHeader}}<br />
|-<br />
| AMD A4-2800K APU<br />
| Radeon HD 6450M<br />
| {{?}}<br />
| Caicos<br />
| {{no}}<br />
| '''HDMI'''<br />
| '''Denon'''<br />
| {{?}}<br />
| {{Yes}}<br />
| {{Yes}}<br />
| {{Yes}}<br />
| {{NA}}<br />
| {{Yes}}<br />
| {{Yes}}<br />
| {{Yes}}<br />
| Windows 7 x64 Pro<br />
| '''12.1'''<br />
| {{no}}<br />
| {{?}}<br />
|-<br />
| AMD A4-3400 APU<br />
| Radeon HD 6410D<br />
| {{?}}<br />
| WinterPark<br />
| {{no}}<br />
| {{?}}<br />
| {{?}}<br />
| {{?}}<br />
| {{Yes}}<br />
| {{Yes}}<br />
| {{yes}}<br />
| {{NA}}<br />
| {{?}}<br />
| {{?}}<br />
| {{?}}<br />
| Windows 8 RTM<br />
| '''5.12.0.13'''<br />
| {{no}}<br />
| {{?}}<br />
|-<br />
| AMD A6-5400K APU <br />
| Radeon HD 7540D<br />
| {{?}}<br />
| Trinity<br />
| {{no}}<br />
| '''HDMI'''<br />
| '''Onkyo TX-NR626'''<br />
| {{?}}<br />
| {{Yes}}<br />
| {{Yes}}<br />
| {{Yes}}<br />
| {{NA}}<br />
| {{Yes}}<br />
| {{Yes}}<br />
| {{?}}<br />
| Windows 8 Pro, x64<br />
| '''9.0.0.9903'''<br />
| {{no}}<br />
| {{?}}<br />
|-<br />
| AMD A8-3870K APU<br />
| Radeon HD 6550D<br />
| {{?}}<br />
| BeaverCreek<br />
| {{no}}<br />
| {{?}}<br />
| {{?}}<br />
| {{?}}<br />
| {{Yes}}<br />
| {{No}}<br />
| {{Yes}}<br />
| {{No}}<br />
| {{No}}<br />
| {{No}}<br />
| {{?}}<br />
| Ubuntu 12.04 LTS<br />
| '''12.1'''<br />
| {{Yes}}<br />
| {{?}}<br />
|-<br />
| AMD A8-3870K APU<br />
| Radeon HD 6550D<br />
| {{?}}<br />
| BeaverCreek<br />
| {{no}}<br />
| {{?}}<br />
| {{?}}<br />
| {{?}}<br />
| {{?}}<br />
| {{yes}}<br />
| {{?}}<br />
| {{?}}<br />
| {{Yes}}<br />
| {{yes}}<br />
| {{?}}<br />
| Windows 7 x64 Pro<br />
| '''12.4'''<br />
| {{no}}<br />
| {{?}}<br />
|-<br />
| ASRock E350M1 <br />
| Radeon HD 6310<br />
| {{?}}<br />
| Wrestler<br />
| {{No}}<br />
| '''HDMI'''<br />
| '''Onkyo HT-R380'''<br />
| {{?}}<br />
| {{Yes}}<br />
| {{?}}<br />
| {{Yes}}<br />
| {{Yes}}<br />
| {{Yes}}<br />
| {{Yes}}<br />
| {{?}}<br />
| Windows 8 Pro, x64<br />
| '''13.2 Beta6'''<br />
| {{No}}<br />
| {{?}}<br />
|-<br />
| ASRock E350M1 <br />
| Radeon HD 6310<br />
| {{?}}<br />
| Wrestler<br />
| {{No}}<br />
| '''HDMI'''<br />
| '''Onkyo HT-R380'''<br />
| {{?}}<br />
| {{yes}}<br />
| {{?}}<br />
| {{yes}}<br />
| {{No}}<br />
| {{No}}<br />
| {{No}}<br />
| {{?}}<br />
| OpenELEC 3.0 RC4 (2.99.4)<br />
| '''12.10'''<br />
| {{No}}<br />
| {{?}}<br />
|-<br />
| Asus E45M1-I Deluxe<br />
| Radeon HD 6320<br />
| {{?}}<br />
| Zacate<br />
| {{Yes}}<br />
| '''HDMI'''<br />
| '''Denon AVR-3312'''<br />
| {{?}}<br />
| {{Yes}}<br />
| {{Yes}}<br />
| {{No}}<br />
| {{No}}<br />
| {{No}}<br />
| {{?}}<br />
| {{Yes}}<br />
| OpenELEC 3.0 (RC 1)<br />
| '''12.10'''<br />
| {{yes}}<br />
| {{?}}<br />
|-<br />
| ZOTAC ZBOX AD04 PLUS<br />
| Radeon HD 6320<br />
| {{?}}<br />
| Zacate<br />
| {{Yes}}<br />
| '''HDMI'''<br />
| '''Denon AVR-1713'''<br />
| {{?}}<br />
| {{yes}}<br />
| {{Yes}}<br />
| {{No}}<br />
| {{No}}<br />
| {{no}}<br />
| {{?}}<br />
| {{yes}}<br />
| XBMCbuntu 12.0 "FRODO"<br />
| {{?}}<br />
| {{yes}}<br />
| XBMC v12.0<br />
|-<br />
| Zotac ZBOX AD06<br />
| Radeon HD 7340<br />
| {{?}}<br />
| Zacate<br />
| {{Yes}}<br />
| '''HDMI'''<br />
| '''Samsung AV-R720'''<br />
| {{?}}<br />
| {{Yes}}<br />
| {{Yes}}<br />
| {{No}}<br />
| {{No}}<br />
| {{No}}<br />
| {{?}}<br />
| {{Yes}}<br />
| OpenELEC 3.0.0<br />
| '''12.10?'''<br />
| {{yes}}<br />
| {{?}}<br />
|-<br />
| M5A78L-M/USB3<br />
| Radeon HD 6850<br />
| {{?}}<br />
| Barts<br />
| {{no}}<br />
| '''HDMI'''<br />
| '''Denon AVR-4310'''<br />
| {{?}}<br />
| {{Yes}}<br />
| {{Yes}}<br />
| {{Yes}}<br />
| {{Yes}}<br />
| {{Yes}}<br />
| {{Yes}}<br />
| {{Yes}}<br />
| OpenELEC (official) - 3.2.4 x64<br />
| {{?}}<br />
| {{no}}<br />
| {{?}}<br />
|-<br />
|}<br />
<br />
== Nvidia Based ==<br />
{| class="prettytable" style="text-align: center; color: black;"<br />
! {{AWorklistHeader}}<br />
|-<br />
| Gigabyte GV-N560OC-1GI<br />
| GeForce GTX 560<br />
| {{?}}<br />
| GF110/GF114<br />
| {{no}}<br />
| '''HDMI'''<br />
| {{NA}}<br />
| {{?}}<br />
| {{yes}}<br />
| {{yes}}<br />
| {{yes}}<br />
| {{NA}}<br />
| {{yes}}<br />
| {{yes}}<br />
| {{yes}}<br />
| OpenELEC 3.0<br />
| '''313.09'''<br />
| {{no}}<br />
| Frodo 12.1<br />
|-<br />
| Asus ENGT430 DC SL DI<br />
| GeForce GT 430<br />
| {{?}}<br />
| GF108<br />
| {{no}}<br />
| '''HDMI'''<br />
| {{NA}}<br />
| {{?}}<br />
| {{Yes}}<br />
| {{yes}}<br />
| {{yes}}<br />
| {{NA}}<br />
| {{yes}}<br />
| {{yes}}<br />
| {{yes}}<br />
| Ubuntu 12.04 LTS<br />
| '''295.59'''<br />
| {{no}}<br />
| Frodo 12.2<br />
|-<br />
| Asus ENGT520<br />
| GeForce GT 520<br />
| {{?}}<br />
| GF119<br />
| {{no}}<br />
| '''HDMI'''<br />
| '''Yamaha/HTR-4063'''<br />
| {{?}}<br />
| {{Yes}}<br />
| {{yes}}<br />
| {{yes}}<br />
| {{NA}}<br />
| {{yes}}<br />
| {{yes}}<br />
| {{yes}}<br />
| Debian Wheezy<br />
| '''310.19'''<br />
| {{no}}<br />
| {{?}}<br />
|-<br />
| EVGA GTX550<br />
| GeForce GTX 550 ti<br />
| {{?}}<br />
| GF116<br />
| {{no}}<br />
| '''HDMI'''<br />
| '''Sony/STR-DN610'''<br />
| {{?}}<br />
| {{Yes}}<br />
| {{Yes}}<br />
| {{Yes}}<br />
| {{NA}}<br />
| {{yes}}<br />
| {{yes}}<br />
| {{yes}}<br />
| Ubuntu 12.10<br />
| '''304.43'''<br />
| {{no}}<br />
| {{?}}<br />
|-<br />
| Asus ENGTX560<br />
| GTX 560 TI<br />
| {{?}}<br />
| GF110/GF114<br />
| {{no}}<br />
| {{?}}<br />
| {{?}}<br />
| {{?}}<br />
| {{Yes}}<br />
| {{Yes}}<br />
| {{Yes}}<br />
| {{NA}}<br />
| {{Yes}}<br />
| {{Yes}}<br />
| {{?}}<br />
| Ubuntu 12.04 LTS<br />
| '''304.43'''<br />
| {{no}}<br />
| {{?}}<br />
|-<br />
| Palit GT640<br />
| GeForce GT 640<br />
| {{?}}<br />
| GK107<br />
| {{no}}<br />
| {{?}}<br />
| {{?}}<br />
| {{?}}<br />
| {{Yes}}<br />
| {{Yes}}<br />
| {{Yes}}<br />
| {{NA}}<br />
| {{Yes}}<br />
| {{Yes}}<br />
| {{Yes}}<br />
| Ubuntu 12.04 LTS<br />
| '''304.43'''<br />
| {{No}}<br />
| {{?}}<br />
|-<br />
| Asus GT610-SL-1GD3-L<br />
| Geforce GT610<br />
| {{?}}<br />
| GF119<br />
| {{no}}<br />
| '''HDMI'''<br />
| '''Onkyo TX-NR807'''<br />
| {{?}}<br />
| {{Yes}}<br />
| {{Yes}}<br />
| {{Yes}}<br />
| {{NA}}<br />
| {{Yes}}<br />
| {{Yes}}<br />
| {{Yes}}<br />
| Slackware 13.37<br />
| '''310.19'''<br />
| {{No}}<br />
| {{?}}<br />
|-<br />
| Zotac GT430 Zone Edition<br />
| GeForce GT 430<br />
| {{?}}<br />
| GF108<br />
| {{no}}<br />
| {{?}}<br />
| {{?}}<br />
| {{?}}<br />
| {{Yes}}<br />
| {{yes}}<br />
| {{yes}}<br />
| {{NA}}<br />
| {{yes}}<br />
| {{yes}}<br />
| {{yes}}<br />
| Windows 7 x64 Pro<br />
| '''306.97'''<br />
| {{no}}<br />
| {{?}}<br />
|-<br />
| Asrock ION 330HT<br />
| GeForce 9400M G<br />
| gpu - #dev2<br />
| G96a/G96b<br />
| {{Yes}}<br />
| '''HDMI'''<br />
| {{?}}<br />
| '''Samsung<br/>Series 5'''<br />
| {{Yes}}<br />
| {{yes}}<br />
| {{yes}}<br />
| {{NA}}<br />
| {{no}}<br />
| {{no}}<br />
| {{?}}<br />
| Ubuntu 12.04.4 LTS<br />
| '''304.64'''<br />
| {{no}}<br />
| XBMC-V13alpha7<br />
|-<br />
| ZOTAC GT 610 ZONE Ed.<br />
| Geforce GT610<br />
| {{?}}<br />
| GF119<br />
| {{no}}<br />
| '''HDMI'''<br />
| '''Onkyo TX-SR608'''<br />
| {{?}}<br />
| {{Yes}}<br />
| {{Yes}}<br />
| {{Yes}}<br />
| {{NA}}<br />
| {{yes}}<br />
| {{yes}}<br />
| {{yes}}<br />
| Win8 64bit + XBMCbuntu<br />
| '''331.65'''<br />
| {{no}}<br />
| {{?}}<br />
|-<br />
|}<br />
<br />
== Intel Based ==<br />
{| class="prettytable" style="text-align: center; color: black;"<br />
! colspan="23" style="background-color:#E6E6E6;" | '''Hardware and audio playback compatibility<br/>'''<br />
|-<br />
| {{AWorklistHeader}}<br />
|-<br />
| EXAMPLE<br />
| HD4000<br />
| {{?}}<br />
| {{NA}}<br />
| {{no}}<br />
| 313.09<br />
| {{No}}<br />
| '''HDMI'''<br />
| {{NA}}<br />
| '''Smugsung X'''<br />
| {{Yes}}<br />
| {{Yes}}<br />
| {{Yes}}<br />
| {{Yes}}<br />
| {{?}}<br />
| {{Yes}}<br />
| {{?}}<br />
| XBMCbuntu v13<br />
| '''V13-beta3-e3sd46g<br />
|}<br />
<br />
<noinclude><br />
[[Category:Audio]]<br />
[[Category:Hardware]]<br />
</noinclude><br />
<br />
= '''Editor references''' =<br />
==== Old AMD audio table / format ====<br />
{| class="prettytable" style="text-align: center; color: black;"<br />
! colspan="23" style="background-color:#E6E6E6;" | '''Hardware and audio playback compatibility<br/>'''<br />
|-<br />
! style="color:#000000; background-color:#DBDBDB;" | '''Model Name'''<br />
! style="color:#000000; background-color:#DBDBDB;" | '''GPU'''<br />
! style="color:#000000; background-color:#DBDBDB;" | '''Code Name'''<br />
! style="color:#000000; background-color:#DBDBDB;" | '''AC3'''<br />
! style="color:#000000; background-color:#DBDBDB;" | '''LPCM'''<br />
! style="color:#000000; background-color:#DBDBDB;" | '''DTS'''<br />
! style="color:#000000; background-color:#DBDBDB;" | '''DTS-HD MA'''<br />
! style="color:#000000; background-color:#DBDBDB;" | '''DTS-HD'''<br />
! style="color:#000000; background-color:#DBDBDB;" | '''TrueHD'''<br />
! style="color:#000000; background-color:#DBDBDB;" | '''DD+/E-AC3'''<br />
! style="color:#000000; background-color:#DBDBDB;" | '''Driver Version'''<br />
! style="color:#000000; background-color:#DBDBDB;" | '''Driver limitation'''<br />
! style="color:#000000; background-color:#DBDBDB;" | '''HW Limitation'''<br />
! style="color:#000000; background-color:#DBDBDB;" | '''Plug'''<br />
! style="color:#000000; background-color:#DBDBDB;" | '''Receiver'''<br />
! style="color:#000000; background-color:#DBDBDB;" | '''Operating System'''<br />
||||||<br />
|-<br />
| AMD A4-2800K APU<br />
| Radeon HD 6450M<br />
| Caicos<br />
| {{Yes}}<br />
| {{Yes}}<br />
| {{Yes}}<br />
| {{Yes}}<br />
| {{Yes}}<br />
| {{Yes}}<br />
| {{?}}<br />
| 12.1<br />
| {{No}}<br />
| {{No}}<br />
| '''HDMI'''<br />
| '''Denon'''<br />
| Windows 7 x64 Pro<br />
|-<br />
| AMD A4-3400 APU<br />
| Radeon HD 6410D<br />
| WinterPark<br />
| {{Yes}}<br />
| {{Yes}}<br />
| {{Yes}}<br />
| {{?}}<br />
| {{?}}<br />
| {{Yes}}<br />
| {{?}}<br />
| 5.12.0.13<br />
| {{No}}<br />
| {{No}}<br />
| {{?}}<br />
| {{?}}<br />
| Windows 8 RTM<br />
|-<br />
| AMD A6-5400K APU <br />
| Radeon HD 7540D<br />
| Trinity<br />
| {{Yes}}<br />
| {{Yes}}<br />
| {{Yes}}<br />
| {{Yes}}<br />
| {{Yes}}<br />
| {{Yes}}<br />
| {{?}}<br />
| 9.0.0.9903<br />
| {{No}}<br />
| {{No}}<br />
| '''HDMI'''<br />
| '''Onkyo TX-NR626'''<br />
| Windows 8 Pro, x64<br />
|-<br />
| AMD A8-3870K APU<br />
| Radeon HD 6550D<br />
| BeaverCreek<br />
| {{Yes}}<br />
| {{No}}<br />
| {{Yes}}<br />
| {{No}}<br />
| {{No}}<br />
| {{No}}<br />
| {{?}}<br />
| 12.1<br />
| {{Yes}}<br />
| {{No}}<br />
| {{?}}<br />
| {{?}}<br />
| Ubuntu 12.04 LTS<br />
|-<br />
| AMD A8-3870K APU<br />
| Radeon HD 6550D<br />
| BeaverCreek<br />
| {{?}}<br />
| {{Yes}}<br />
| {{?}}<br />
| {{Yes}}<br />
| {{?}}<br />
| {{Yes}}<br />
| {{?}}<br />
| 12.4<br />
| {{No}}<br />
| {{No}}<br />
| {{?}}<br />
| {{?}}<br />
| Windows 7 x64 Pro<br />
|-<br />
| ASRock E350M1 <br />
| Radeon HD 6310<br />
| Wrestler<br />
| {{Yes}}<br />
| {{?}}<br />
| {{Yes}}<br />
| {{Yes}}<br />
| {{Yes}}<br />
| {{Yes}}<br />
| {{?}}<br />
| 13.2 Beta6<br />
| {{No}}<br />
| {{No}}<br />
| '''HDMI'''<br />
| '''Onkyo HT-R380'''<br />
| Windows 8 Pro, x64<br />
|-<br />
| ASRock E350M1 <br />
| Radeon HD 6310<br />
| Wrestler<br />
| {{Yes}}<br />
| {{?}}<br />
| {{Yes}}<br />
| {{No}}<br />
| {{No}}<br />
| {{No}}<br />
| {{?}}<br />
| 12.10<br />
| {{Yes}}<br />
| {{No}}<br />
| '''HDMI'''<br />
| '''Onkyo HT-R380'''<br />
| OpenELEC 3.0 RC4 (2.99.4)<br />
<br />
|-<br />
| Asus E45M1-I Deluxe<br />
| Radeon HD 6320<br />
| Zacate<br />
| {{Yes}}<br />
| {{Yes}}<br />
| {{Yes}}<br />
| {{No}}<br />
| {{No}}<br />
| {{No}}<br />
| {{?}}<br />
| 12.10<br />
| {{Yes}}<br />
| {{No}}<br />
| '''HDMI'''<br />
| '''Denon AVR-3312'''<br />
| OpenELEC 3.0 (RC 1)<br />
|-<br />
| ZOTAC ZBOX AD04 PLUS<br />
| Radeon HD 6320<br />
| Zacate<br />
| {{Yes}}<br />
| {{yes}}<br />
| {{Yes}}<br />
| {{No}}<br />
| {{No}}<br />
| {{no}}<br />
| {{?}}<br />
| {{?}}<br />
| {{Yes}}<br />
| {{No}}<br />
| '''HDMI'''<br />
| '''Denon AVR-1713'''<br />
| XBMCbuntu 12.0 "FRODO"<br />
|-<br />
| Zotac ZBOX AD06<br />
| Radeon HD 7340<br />
| Zacate<br />
| {{Yes}}<br />
| {{Yes}}<br />
| {{Yes}}<br />
| {{No}}<br />
| {{No}}<br />
| {{No}}<br />
| {{?}}<br />
| 12.10?<br />
| {{Yes}}<br />
| {{No}}<br />
| '''HDMI'''<br />
| '''Samsung AV-R720'''<br />
| OpenELEC 3.0.0<br />
|-<br />
| M5A78L-M/USB3<br />
| Radeon HD 6850<br />
| Barts<br />
| {{Yes}}<br />
| {{Yes}}<br />
| {{Yes}}<br />
| {{Yes}}<br />
| {{Yes}}<br />
| {{Yes}}<br />
| {{Yes}}<br />
| {{?}}<br />
| {{No}}<br />
| {{No}}<br />
| '''HDMI'''<br />
| '''Denon AVR-4310'''<br />
| OpenELEC (official) - 3.2.4 x64<br />
|-<br />
|}<br />
<br />
=== Legend key Template ===<br />
{|class="prettytable" style="text-align: center; color: black;"<br />
! colspan="17" style="background-color:#F1F1F1;"|'''Legend - Templates - Formatting'''<br />
|-<br />
| colspan="5" style="background-color:#EAD1FF;" | '''General use indicator'''<br />
| colspan="1" style="background-color:#E5FF97;" | '''Decode indicator'''<br />
! colspan="7" style="background-color:#B8D0FF;" | '''HTPC H/W Codename lookup'''<br />
! colspan="4" style="background-color:#FFE5CC;" | '''External equipment'''<br />
|-<br />
| {{yes}}<br />
| {{no}}<br />
| {{NA}}<br />
| {{wip}}<br />
| {{?}}<br />
| ''' cpu - vpu - gpu '''<br />
| rowspan="2" | [http://en.wikipedia.org/wiki/Comparison_of_AMD_graphics_processing_units See: <br/>ATI]<br />
| rowspan="2" | [http://en.wikipedia.org/wiki/Comparison_of_Nvidia_graphics_processing_units See: <br/>Nvidia]<br />
| rowspan="2" | [http://en.wikipedia.org/wiki/Comparison_of_Intel_graphics_processing_units See: <br/>Intel]<br />
| rowspan="2" | [http://en.wikipedia.org/wiki/Allwinner_Technology See: <br/>allwinner]<br />
| rowspan="2" | [http://en.wikipedia.org/wiki/I.MX#i.MX6x_series See: <br/>Freescale]<br />
| rowspan="2" | [http://en.wikipedia.org/wiki/ARM_architecture See: <br/>ARM]<br />
| rowspan="2" | [http://en.wikipedia.org/wiki/Comparison_of_Android_devices See: <br/>Android]<br />
! colspan="4" style="background-color:#FFE5CC;" | '''Plug - Receiver - TV / models'''<br />
|- <br />
| <nowiki>{{yes}}</nowiki><br />
| <nowiki>{{no}}</nowiki><br />
| <nowiki>{{NA}}</nowiki><br />
| <nowiki>{{wip}}</nowiki><br />
| <nowiki>{{?}}</nowiki><br />
| <nowiki>''' cpu - vpu - gpu '''</nowiki><br />
| <nowiki>'''HDMI'''</nowiki><br />
| <nowiki>'''Optical'''</nowiki><br />
| <nowiki>'''Analog'''</nowiki><br />
| <nowiki>'''TV - AVR / Model'''</nowiki><br />
|}<br />
<br />
=== AVWorklistHeader Template ===<br />
{|class="prettytable" style="text-align: center; color: black;"<br />
! colspan="19" style="background-color:#F1F1F1;"|'''Audio - Templates - Formatting'''<br />
|-<br />
! colspan="5" style="background-color:#B8D0FF;" | '''HTPC Hardware'''<br />
! colspan="3" style="background-color:#FFE5CC;" | '''External Equipment'''<br />
! colspan="7" style="background-color:#DBFF94;" | '''Audio Capabilities<br/>'''<br />
! rowspan="2" style="background-color:#FFEBCC;" | '''Operative<br/>System'''<br />
! colspan="2" style="background-color:#E5FF97;" | '''Driver'''<br />
! rowspan="2" style="background-color:#B8D0FF;" | '''XBMC<br/>Version'''<br />
|-<br />
! style="color:#000000; background-color:#B8D0FF;" | '''Model'''<br />
! style="color:#000000; background-color:#B8D0FF;" | '''GPU - VPU type'''<br />
! style="color:#000000; background-color:#B8D0FF;" | '''Audio device'''<br />
! style="color:#000000; background-color:#B8D0FF;" | '''Code Name'''<br />
! style="color:#000000; background-color:#B8D0FF;" | '''Limitation'''<br />
! style="color:#000000; background-color:#FFE5CC;" | '''Plug'''<br />
! style="color:#000000; background-color:#FFE5CC;" | '''Receiver'''<br />
! style="color:#000000; background-color:#FFE5CC;" | '''Television'''<br />
! style="color:#000000; background-color:#DBFF94;" | '''AC3'''<br />
! style="color:#000000; background-color:#DBFF94;" | '''LPCM'''<br />
! style="color:#000000; background-color:#DBFF94;" | '''DTS'''<br />
! style="color:#000000; background-color:#DBFF94;" | '''DTS-HD MA'''<br />
! style="color:#000000; background-color:#DBFF94;" | '''DTS-HD'''<br />
! style="color:#000000; background-color:#DBFF94;" | '''TrueHD'''<br />
! style="color:#000000; background-color:#DBFF94;" | '''DD+/E-AC3'''<br />
! style="color:#000000; background-color:#E5FF97;" | '''Version'''<br />
! style="color:#000000; background-color:#E5FF97;" | '''Limitation'''<br />
|}<br />
<br />
=== VWorklistHeader Template ===<br />
{|class="prettytable" style="text-align: center; color: black;"<br />
! colspan="23" style="background-color:#E6E6E6;" | '''Hardware and video playback compatibility<br/>'''<br />
|-<br />
! colspan="5" style="background-color:#B8D0FF;" | '''HTPC Hardware'''<br />
! colspan="3" style="background-color:#FFE5CC;" | '''External Equipment'''<br />
! style="background-color:#DBDBFF;" | '''Decoder'''<br />
! colspan="10" style="background-color:#E5FF97;" | '''Capabilities<br/>'''<br />
! rowspan="2" style="background-color:#FFEBCC;" | '''Operative<br/>System'''<br />
! colspan="2" style="background-color:#E5FF97;" | '''Driver'''<br />
! rowspan="2" style="background-color:#B8D0FF;" | '''XBMC<br/>Version'''<br />
|-<br />
! style="background-color:#B8D0FF;" | '''Model'''<br />
! style="background-color:#B8D0FF;" | '''GPU - VPU type'''<br />
! style="background-color:#B8D0FF;" | '''CPU type'''<br />
! style="background-color:#B8D0FF;" | '''Code Names'''<br />
! style="background-color:#B8D0FF;" | '''Limitation'''<br />
| style="background-color:#FFE5CC;" | '''Plug'''<br />
| style="background-color:#FFE5CC;" | '''Reveiver'''<br />
| style="background-color:#FFE5CC;" | '''Television'''<br />
! rowspan="0" style="background-color:#DBDBFF;" | '''GPU<br/>VPU<br/>CPU<br/>'''<br />
| style="background-color:#E5FF97;" | '''H.262'''<br />
| style="background-color:#E5FF97;" | '''H.263'''<br />
| style="background-color:#E5FF97;" | '''H.264'''<br />
| style="background-color:#E5FF97;" | '''H.265'''<br />
| style="background-color:#E5FF97;" | '''MPEG-4v3'''<br />
| style="background-color:#E5FF97;" | '''WMV'''<br />
| style="background-color:#E5FF97;" | '''On2'''<br />
| style="background-color:#E5FF97;" | '''720/1080'''<br />
| style="background-color:#E5FF97;" | '''Blu-ray'''<br />
| style="background-color:#E5FF97;" | '''3D'''<br />
! style="background-color:#E5FF97;" | '''Version'''<br />
! style="background-color:#E5FF97;" | '''Limitation'''<br />
|}<br />
<br />
== Package management F.A.Q. ==<br />
Here we give detailed information on '''Advanced Packaging Tool''', a.k.a. '''APT'''. and the necessary commands to retrieve, install, update, upgrade and or remove the application also known as XBMC or Kodi on Ubuntu and variants such as XBMCbuntu/KodiBuntu. Such information is widespread on any Ubuntu documentation and is duplicated here for simplicity and general user base benefit.<br />
<br />
<section begin="package_maintenance" /><br />
{| width="100%"<br />
{{FAQ|1=Why_XBMC_ppa<br />
| BGcolor=whitesmoke<br />
| Question= Why are XBMC packages from Ubuntu repositories incorrect?<br />
| Answer=<br />
The simple answer is that, these packages derive from externally modified XBMC versions which are either '''outdated''' and '''broken''' or both, and are 100% officially '''unsupported''' at this time.<br />
<br />
The main thing you must understand is that if you looking for supported official builds, you simply should not use other repositories, unless otherwise indicated by a Team Member or a informed community member.<br />
}}<br />
<br />
{{FAQ|1=Dependencies<br />
| BGcolor=<br />
| Question=Are any dependencies required to manage repo's or ppa's?<br />
| Answer=<br />
Some dependencies are required to manage ppa's/repos within your distro, install these by typing:<br />
<source lang="bash" enclose="div"><br />
sudo apt-get install python-software-properties pkg-config<br />
</source><br />
}}<br />
<br />
{| width="100%"<br />
{{FAQ|1=What_ppa_do_I_have<br />
| BGcolor=whitesmoke<br />
| Question= How do I find out what repo/ppa I am currently using?<br />
| Answer=<br />
You can get a complete listing of what repositories are part of your sources list by typing:<br />
<source lang="bash" enclose="div"><br />
sudo apt-cache policy<br />
</source><br />
}}<br />
<br />
{{FAQ|1=Adding or removing ppas<br />
| BGcolor=<br />
| Question=How do I add or remove ppa's?<br />
| Answer=<br />
After you determined which ppa you would like to '''add''' or '''remove''' follow the instructions below.<br />
;You can remove a ppa from your distro's sources list via terminal, by typing:<br />
<source lang="bash" enclose="div"><br />
sudo add-apt-repository -r ppa:current_XBMC_providing_ppa<br />
</source><br />
<br />
;You can add a ppa to your distro's sources list via terminal, by typing:<br />
<br />
<source lang="bash" enclose="div"><br />
sudo add-apt-repository ppa:the_ppa_you_wish_to_use<br />
</source><br />
<br /><br />
}}<br />
{{note|<br />
* The process of adding and removing repositories is recommended when changing the repo's in use.<br />
* Changing the PPA repo for XBMC will change what type of install is used (stable, nightly, beta, etc).}}<br />
<br />
== Installing, updating or upgrading ==<br />
If applicable you can check what package versions are installed in your system, this is helpful when determining what procedures to choose.<br />
{{FAQ|1=check current version<br />
| BGcolor=whitesmoke<br />
| Question=How can check what current XBMC version is installed?<br />
| Answer=<br />
Check what XBMC versions you have access to:<br />
<source lang="bash"><br />
sudo apt-cache policy xbmc<br />
</source><br />
}}<br />
<br />
{{FAQ|1=Installing XBMC<br />
| BGcolor=<br />
| Question=How do I install XBMC?<br />
| Answer=<br />
After adding or removing any ppa you need to refresh your sources list and finally install XBMC, by typing:<br />
<syntaxhighlight lang="bash" enclose="div"><br />
sudo apt-get update<br />
sudo apt-get install xbmc xbmc-bin<br />
</syntaxhighlight><br />
}}<br />
<br />
{{FAQ|1=Updating XBMC<br />
| BGcolor=whitesmoke<br />
| Question=How do I update XBMC?<br />
| Answer=<br />
To update XBMC/Kodi when a new version is released, just do a general system/package or use the following commands in the terminal (or via [[SSH]]):<br />
<br />
<source lang="bash"><br />
sudo apt-get update<br />
sudo apt-get install xbmc xbmc-bin<br />
</source><br />
}}<br />
<br />
{{FAQ|1=Upgrading XBMC<br />
| BGcolor=<br />
| Question=How do I upgrade XBMC?<br />
| Answer=<br />
After adding or removing any ppa you need to refresh your sources list and finally upgrade xbmc, by typing:<br />
<syntaxhighlight lang="bash" enclose="div"><br />
sudo apt-get update<br />
sudo apt-get --only-upgrade install xbmc xbmc-bin<br />
</syntaxhighlight><br />
}}<br />
<section begin="whynoupgrade" /><br />
{{FAQ|1=XBMC wont upgrade<br />
| BGcolor=whitesmoke<br />
| Question=Why wont XBMC upgrade?<br />
| Answer=<br />
After following the above instructions, XBMC is still not upgraded, the main reason why this happens is because the distribution you are using, is no longer supported and has reached an '''''end of life status'''''.<br />
<br />
See [https://wiki.ubuntu.com/Releases Current Ubuntu releases] if your current distro is listed under End of life table, you will need to upgrade your OS to a supported release.<br />
<br />
LTS releases are better for long term install and forget, installing obviously the very latest LTS release available.<br />
{{#lst:XBMCbuntu FAQ|upgradeOS}}<br />
}}<section end="whynoupgrade" /><br />
<br />
{{FAQ|1=Specific package versions.<br />
| BGcolor=<br />
| Question=How to install a specific versions?<br />
| Answer=<br />
In the event you need to install either by upgrade or downgrade a specific XBMC version (a reason may be a bug or to test a specific version), the PPA providing said version active must be in your '''sources.list.d''' along with a updated list of the packages.<br />
If the packages you intend to install are on a different PPA, you should probably remove that PPA to avoid confusion.<br />
<code>apt-get install packagename=version</code> is one way to achieve this.<br />
<syntaxhighlight lang="bash" enclose="div"><br />
sudo apt-get update<br />
sudo apt-get install xbmc=2:13.1~git20140606.0917-gotham-0trusty xbmc-bin=2:13.1~git20140606.0917-gotham-0trusty <br />
</syntaxhighlight><br />
<br />
Hint: For e.g. You can use result of <code>apt-cache policy xbmc</code> to see the candidates <packagename><version> available to you.<br />
{{Note| Removing/purging any previous versions if they are greater version of the package you are looking to install is necessary.}}<br />
}}<br />
<br />
{{FAQ|1=beta_unstable<br />
| BGcolor=whitesmoke<br />
| Question=How can I install a beta/unstable version?<br />
| Answer=<br />
To install a beta/unstable version of XBMC you must first add the unstable repository, then install XBMC:<br />
<source lang="bash"><br />
sudo add-apt-repository ppa:team-xbmc/unstable<br />
sudo apt-get update<br />
sudo apt-get install xbmc xbmc-bin<br />
</source><br />
:;or:<br />
<source lang="bash"><br />
sudo add-apt-repository ppa:team-xbmc/nightly<br />
sudo apt-get update<br />
sudo apt-get install xbmc xbmc-bin<br />
</source><br />
Follow the prompts to add the repository, then to add the updates, and finally install the new version of XBMC.<br />
{{note|1=You may need to restart your computer for the newly installed version to be working.}}<br />
}}<br />
<br />
{{FAQ|1=beta_unstable_to_stable<br />
| BGcolor=<br />
| Question=How can I move from a beta/unstable to a stable version?<br />
| Answer=<br />
Check what XBMC versions you have access to by typing:<br />
<source lang="bash"><br />
sudo apt-cache policy xbmc<br />
</source><br />
<br />
The response in terminal should be something like:<br />
<source lang="xml"><br />
xbmc:<br />
Installed: 2:13.2~git20140719.0900-beta2-0trusty<br />
Candidate: 2:13.2~git20140719.0900-beta2-0trusty<br />
Version table:<br />
*** 2:13.2~git20140719.0900-beta2-0trusty 0<br />
500 http://ppa.launchpad.net/team-xbmc/unstable/ubuntu/ trusty/main amd64 Packages<br />
100 /var/lib/dpkg/status<br />
2:13.1~git20140606.0917-gotham-0trusty 0<br />
500 http://ppa.launchpad.net/team-xbmc/ppa/ubuntu/ trusty/main amd64 Packages<br />
2:12.3+dfsg1-3ubuntu1 0<br />
500 http://us.archive.ubuntu.com/ubuntu/ trusty/universe amd64 Packages<br />
</source><br />
{{note|1=In the above example we have an unstable ('''team-xbmc/unstable''') and the release versions ('''team-xbmc/ppa''') available. The version with the '''***''' is the currently installed version (unstable)}}<br />
<br />
To install the release version we need to install the team-xbmc/ppa version (in the above example: "2:13.1~git20140606.0917-gotham-0trusty"). This requires the install of both the [[Team_XBMC_PPA#Installing_XBMC |"'''xbmc'''" and the "'''xbmc-bin'''" package.]]<br />
<source lang="bash"><br />
sudo apt-get install xbmc=2:13.1~git20140606.0917-gotham-0trusty xbmc-bin=2:13.1~git20140606.0917-gotham-0trusty<br />
</source><br />
{{note|1=You will get a warning you are downgrading, hit Y when asked to continue}}<br />
<br />
Remove the beta/unstable repository from XBMC to clean up:<br />
<source lang="bash"><br />
sudo add-apt-repository -r ppa:team-xbmc/unstable<br />
</source><br />
}}<br />
<br />
== Uninstalling or Removing ==<br />
{{FAQ|1=Uninstalling XBMC<br />
| BGcolor=<br />
| Question=How do I uninstall XBMC?<br />
| Answer=<br />
If you need to remove and purge an application and finally removing/purging also the application configurations files, do so by typing:<br />
<syntaxhighlight lang="bash" enclose="div"><br />
sudo apt-get update<br />
sudo apt-get remove xbmc*<br />
sudo apt-get purge xbmc*<br />
</syntaxhighlight><br />
}}<section end="package_maintenance" /><br />
<br />
== Build Dependencies ==<br />
{{FAQ|1=PPA Build deps<br />
| BGcolor=whitesmoke<br />
| Question=What are PPA build dependencies?<br />
| Answer=<br />
These build dependencies are versions of a library pre-packaged by Team XBMC, because the distro provided versions are behind the current requirements of XBMC.<br />
Both [https://github.com/xbmc/xbmc/blob/master/docs/README.linux REAME.linux] and/or [https://github.com/xbmc/xbmc/blob/master/docs/README.ubuntu README.ubuntu] documents using XBMC ppa build dependencies refer to these dependencies in the Team XBMC PPA's used in conjunction, when compiling on Ubuntu or derivatives distros.<br />
}}<br />
|}<br />
<br />
== See also ==<br />
* [https://help.ubuntu.com/community/AptGet/Howto apt-get/How-to]</div>UNiversalhttps://kodi.wiki/index.php?title=User:UNiversal&diff=88435User:UNiversal2015-03-29T07:11:45Z<p>UNiversal: /* See also */</p>
<hr />
<div>{{DISPLAYTITLE:User:uNiversal}}<br />
<br />
[[File:XBMC splash by uNiversal.jpg|left|500px|'''Done especially for xbmc Settings menu [[forum:183508|Click here to see forums thread''']]]]<br />
<br />
{{Infobox<br />
|bodystyle = <br />
|above = uNiversal<br />
|titlestyle = <br />
<br />
|image = [[File:Zappy-omg.png|200px|alt=uNiversal|link=]]<br />
|imagestyle = <br />
|caption = '''''Error!''''' Out of Memory!<br />
|captionstyle = <br />
|headerstyle = background:#A0CC54;<br />
|labelstyle = background:#84B334;<br />
|datastyle = background:#A0CC54;<br />
<br />
|header1 = XBMC user<br />
|header2 = <br />
|header3 =<br />
|label3 = System Details:<br />
|data3 = '''Linux.4.0~Custom'''<br />
|header4 = <br />
|label4 = Brain Version:<br />
|data4 = '''Positronic 2.0'''<br />
|header5 = <br />
|label5 = Power Matrix:<br />
|data5 = '''Hybrid/Biologic'''<br />
|belowstyle = <br />
|below = {{keypress|'''Ctrl|Alt|Del'''}}<br />
}}<br />
{{-}}<br />
{{progress|100}}<br />
<br />
==Sandbox==<br />
{{hidden<br />
| style = border:1px dashed red; width: 50%;<br />
| headerstyle = background: #ccccff; font-size: 110%;<br />
| contentstyle = text-align: center; color:green;<br />
| header = Sandbox<br />
| content = <br />
<!-- --><br />
[[Template:orangev]]<br />
<div style="background:#fefefe; padding:0 1em 0 1.1em;margin: .5em 0 .5em 0;"><br />
<div style="border-left:.5em solid #E3871E;padding:.2em .5em .4em 1em;"><span style="font-weight: bold; color:#E3871E; padding:.2em .5em .4em 0em;"><u>{{{1}}}</u> </span>{{{1}}}</div></div><br />
<noinclude>{{documentation}}</noinclude><br />
<br />
<!-- --><br />
[[Template:goldv]]<br />
<div style="background:#fefefe; padding:0 1em 0 1.1em;margin: .5em 0 .5em 0;"><br />
<div style="border-left:.5em solid #E3BF1E;padding:.2em .5em .4em 1em;"><span style="font-weight: bold; color:#E3BF1E; padding:.2em .5em .4em 0em;"><u>{{{1}}}</u> </span>{{{1}}}</div></div><br />
<noinclude><br />
{{Documentation}}<br />
[[Category:Templates]]<br />
</noinclude><br />
<br />
<!-- --><br />
[[Template:Quote]]<br />
<div style="background-color:#F6FFD6; border: 3px dashed #6EBA1C;">{{{1}}}</div><br />
<noinclude><br />
{{Documentation}}<br />
[[Category:Templates]]<br />
</noinclude><br />
<br />
<!--<br />
[[Template:helpn]]<br />
{| style="background-color:#F6FFD6; width=100%; border: 3px dashed #6EBA1C; font-size: 100%; margin-top: 2px; margin-bottom: 2px;" | <br />
| width="10px" | [[File:help.png|50px|link=|HELP]]<br />
| align="right" | {{{raw|'''{{{2|NOTICE}}}:''' {{{1}}}}}}<br />
|}<br />
<noinclude><br />
{{Documentation}}<br />
[[Category:Templates]]<br />
</noinclude><br />
--><br />
<br />
<!-- --><br />
[[Template:Note]]<br />
[[File:Note.png|40px|link=|REMEMBER]]<br />
<noinclude><br />
{{Documentation}}<br />
[[Category:Templates]]<br />
</noinclude><br />
<br />
<!-- --><br />
[[Template:Tip]]<br />
[[File:Lightbulb.png|35px|link=|TIP]]<br />
<noinclude><br />
{{Documentation}}<br />
[[Category:Templates]]<br />
</noinclude><br />
<br />
<!-- --><br />
[[Template:Help]]<br />
[[File:Help.png|35px|link=|HELP]]<br />
<noinclude><br />
{{Documentation}}<br />
[[Category:Templates]]<br />
</noinclude><br />
|headerstyle=background:#ccccff<br />
|style=text-align:center;<br />
}}<br />
<br />
== video Hardware ==<br />
{| class="prettytable" style="text-align: center; color: black;"<br />
! colspan="23" style="background-color:#E6E6E6;" | '''Hardware and video playback compatibility<br/>'''<br />
|-<br />
! colspan="5" style="background-color:#B8D0FF;" | '''HTPC Hardware'''<br />
! colspan="3" style="background-color:#FFE5CC;" | '''External Equipment'''<br />
! style="background-color:#DBDBFF;" | '''Decoder'''<br />
! colspan="10" style="background-color:#DBFF94;" | '''Video Capabilities<br/>'''<br />
! rowspan="2" style="background-color:#FFEBCC;" | '''Operative<br/>System'''<br />
! colspan="2" style="background-color:#E5FF97;" | '''Driver'''<br />
! rowspan="2" style="background-color:#B8D0FF;" | '''XBMC<br/>Version'''<br />
|-<br />
! style="background-color:#B8D0FF;" | '''Model'''<br />
! style="background-color:#B8D0FF;" | '''GPU - VPU type'''<br />
! style="background-color:#B8D0FF;" | '''CPU type'''<br />
! style="background-color:#B8D0FF;" | '''Code Names'''<br />
! style="background-color:#B8D0FF;" | '''Limitation'''<br />
| style="background-color:#FFE5CC;" | '''Plug'''<br />
| style="background-color:#FFE5CC;" | '''AVR'''<br />
| style="background-color:#FFE5CC;" | '''Television'''<br />
! rowspan="0" style="background-color:#DBDBFF;" | '''GPU<br/>VPU<br/>CPU<br/>'''<br />
| style="background-color:#DBFF94;" | '''H.262'''<br />
| style="background-color:#DBFF94;" | '''H.263'''<br />
| style="background-color:#DBFF94;" | '''H.264'''<br />
| style="background-color:#DBFF94;" | '''H.265'''<br />
| style="background-color:#DBFF94;" | '''MPEG-4v3'''<br />
| style="background-color:#DBFF94;" | '''WMV'''<br />
| style="background-color:#DBFF94;" | '''On2'''<br />
| style="background-color:#DBFF94;" | '''720/1080'''<br />
| style="background-color:#DBFF94;" | '''Blu-ray'''<br />
| style="background-color:#DBFF94;" | '''3D'''<br />
! style="background-color:#E5FF97;" | '''Version'''<br />
! style="background-color:#E5FF97;" | '''Limitation'''<br />
|-<br />
| Some ficticious<br />
| ugabuga<br />
| holahoops<br />
| armadillo<br />
| {{yes}}<br />
| HDMI <br />
| AVRBONGO<br />
| Smugsung<br />
| cpu<br />
| gpu<br />
| cpu<br />
| {{no}}<br />
| {{no}}<br />
| {{no}}<br />
| {{yes}}<br />
| {{yes}}<br />
| {{NA}}<br />
| {{yes}}<br />
|some os<br />
| {{NA}}<br />
| {{wip}}<br />
| V12.3<br />
|-<br />
| R-type MXU<br />
| Positronic<br />
| Quantum X<br />
| armadillo<br />
| {{yes}}<br />
| HDMI <br />
| AVRBONGO<br />
| Smugsung<br />
| vpu<br />
| vpu<br />
| cpu<br />
| {{no}}<br />
| {{no}}<br />
| {{no}}<br />
| {{yes}}<br />
| {{yes}}<br />
| {{NA}}<br />
| {{yes}}<br />
| LinWinDrA<br />
| {{no}}<br />
| {{wip}}<br />
| V14-alpha1-7asd43e<br />
|}<br />
<br />
== audio hardware ==<br />
{| class="prettytable" style="text-align: center; color: black;"<br />
! colspan="23" style="background-color:#E6E6E6;" | '''Hardware and audio playback compatibility<br/>'''<br />
|-<br />
! colspan="5" style="background-color:#B8D0FF;" | '''HTPC Hardware'''<br />
! colspan="3" style="background-color:#FFE5CC;" | '''External Equipment'''<br />
! colspan="7" style="background-color:#DBFF94;" | '''Audio Capabilities<br/>'''<br />
! rowspan="2" style="background-color:#FFEBCC;" | '''Operative<br/>System'''<br />
! colspan="2" style="background-color:#E5FF97;" | '''Driver'''<br />
! rowspan="2" style="background-color:#B8D0FF;" | '''XBMC<br/>Version'''<br />
|-<br />
! style="color:#000000; background-color:#B8D0FF;" | '''Model'''<br />
! style="color:#000000; background-color:#B8D0FF;" | '''GPU - VPU type'''<br />
! style="color:#000000; background-color:#B8D0FF;" | '''Audio device'''<br />
! style="color:#000000; background-color:#B8D0FF;" | '''Code Name'''<br />
! style="color:#000000; background-color:#B8D0FF;" | '''Limitation'''<br />
! style="color:#000000; background-color:#FFE5CC;" | '''Plug'''<br />
! style="color:#000000; background-color:#FFE5CC;" | '''Receiver'''<br />
! style="color:#000000; background-color:#FFE5CC;" | '''Television'''<br />
! style="color:#000000; background-color:#DBFF94;" | '''AC3'''<br />
! style="color:#000000; background-color:#DBFF94;" | '''LPCM'''<br />
! style="color:#000000; background-color:#DBFF94;" | '''DTS'''<br />
! style="color:#000000; background-color:#DBFF94;" | '''DTS-HD MA'''<br />
! style="color:#000000; background-color:#DBFF94;" | '''DTS-HD'''<br />
! style="color:#000000; background-color:#DBFF94;" | '''TrueHD'''<br />
! style="color:#000000; background-color:#DBFF94;" | '''DD+/E-AC3'''<br />
! style="color:#000000; background-color:#E5FF97;" | '''Version'''<br />
! style="color:#000000; background-color:#E5FF97;" | '''Limitation'''<br />
|-<br />
| ASRock E350M1 <br />
| Radeon HD 6310<br />
| {{?}}<br />
| Wrestler<br />
| {{No}}<br />
| '''HDMI'''<br />
| '''Onkyo HT-R380'''<br />
| {{?}}<br />
| {{Yes}}<br />
| {{?}}<br />
| {{Yes}}<br />
| {{Yes}}<br />
| {{Yes}}<br />
| {{Yes}}<br />
| {{?}}<br />
| Windows 8 Pro, x64<br />
| '''13.2 Beta6'''<br />
| {{No}}<br />
| {{?}}<br />
|-<br />
| ASRock E350M1 <br />
| Radeon HD 6310<br />
| {{?}}<br />
| Wrestler<br />
| {{No}}<br />
| '''HDMI'''<br />
| '''Onkyo HT-R380'''<br />
| {{?}}<br />
| {{yes}}<br />
| {{?}}<br />
| {{yes}}<br />
| {{No}}<br />
| {{No}}<br />
| {{No}}<br />
| {{?}}<br />
| OpenELEC 3.0 RC4 (2.99.4)<br />
| '''12.10'''<br />
| {{No}}<br />
| {{?}}<br />
|-<br />
| ZOTAC ZBOX AD04 PLUS<br />
| Radeon HD 6320<br />
| {{?}}<br />
| Zacate<br />
| {{Yes}}<br />
| '''HDMI'''<br />
| '''Denon AVR-1713'''<br />
| {{?}}<br />
| {{yes}}<br />
| {{Yes}}<br />
| {{No}}<br />
| {{No}}<br />
| {{no}}<br />
| {{?}}<br />
| {{yes}}<br />
| XBMCbuntu 12.0 "FRODO"<br />
| {{?}}<br />
| {{yes}}<br />
| XBMC v12.0<br />
|-<br />
| Zotac ZBOX AD06<br />
| Radeon HD 7340<br />
| {{?}}<br />
| Zacate<br />
| {{Yes}}<br />
| '''HDMI'''<br />
| '''Samsung AV-R720'''<br />
| {{?}}<br />
| {{Yes}}<br />
| {{Yes}}<br />
| {{No}}<br />
| {{No}}<br />
| {{No}}<br />
| {{?}}<br />
| {{Yes}}<br />
| OpenELEC 3.0.0<br />
| '''12.10?'''<br />
| {{yes}}<br />
| {{?}}<br />
|-<br />
| M5A78L-M/USB3<br />
| Radeon HD 6850<br />
| {{?}}<br />
| Barts<br />
| {{no}}<br />
| '''HDMI'''<br />
| '''Denon AVR-4310'''<br />
| {{?}}<br />
| {{Yes}}<br />
| {{Yes}}<br />
| {{Yes}}<br />
| {{Yes}}<br />
| {{Yes}}<br />
| {{Yes}}<br />
| {{Yes}}<br />
| OpenELEC (official) - 3.2.4 x64<br />
| {{?}}<br />
| {{no}}<br />
| {{?}}<br />
|-<br />
|}<br />
<br />
= '''Video harware setups reported to work avr-tv-htpc combo''' =<br />
{{mininav|[[Audio hardware compatibility]]}}<br />
{{wiki revamp}}{{progress|55}}<br />
;If you ever asked the questions:<br />
<br />
* What HTPC should I get?<br />
* What TV Should I get?<br />
* What AVR/Receiver should I get?<br />
* What Combination of the above 3 work best?<br />
* What OS should XBMC be on?<br />
* What drivers if any are reported to work?<br />
* What limitations does this machine/setup have over another?<br />
* What General capabilities does it have be it xyz audio/video?<br />
<br />
;Then this page is for you, ideally!<br />
<br />
<br />
{{greenv| Notice:| This page is a user generated/driven content, with their hardware and setup's that work or dont work in any of these situations.}}<br />
{{bluev| Updating:| Feel free to update this list accordingly and add fields to table for other video types your hardware can or cant do.}}<br />
<br />
<big>'''''Please add your experience below.'''''</big><br />
<br />
== Legend key ==<br />
{{legendav}}<br />
<br />
== Video hardware capabilities and reported to work ==<br />
<br />
{{note|'''H265''' a.k.a. '''HEVC''' is not yet supported in XBMC (as of XBMC v13) Until next ffmpeg bump}}<br />
<br />
{| class="prettytable" style="text-align: center; color: black;"<br />
! {{VWorklistHeader}}<br />
|-<br />
| '''fictitious'''<br />
| '''ugabuga'''<br />
| '''holahoops'''<br />
| '''armadillo'''<br />
| {{yes}}<br />
| '''HDMI''' <br />
| '''AVRBONGO'''<br />
| '''Smugsung'''<br />
| '''cpu'''<br />
| '''gpu'''<br />
| '''vpu'''<br />
| {{?}}<br />
| {{no}}<br />
| {{no}}<br />
| {{yes}}<br />
| {{yes}}<br />
| {{NA}}<br />
| {{yes}}<br />
| '''Liwindra os'''<br />
| {{?}}<br />
| {{wip}}<br />
| V14-alpha1-7asd43e<br />
|}<br />
<br />
<noinclude><br />
[[Category:Hardware]]<br />
</noinclude><br />
<br />
= '''Audio hardware setups reported to work htpc-avr-tv combos''' =<br />
{{mininav|[[Video hardware compatibility]]}}<br />
{{wiki revamp}}{{progress|65}}<br />
<br />
;If you ever asked the questions:<br />
<br />
* What HTPC should I get?<br />
* What TV Should I get?<br />
* What AVR/Receiver should I get?<br />
* What Combination of the above 3 work best?<br />
* What OS should XBMC be on?<br />
* What drivers if any are reported to work?<br />
* What limitations does this machine/setup have over another?<br />
* What General capabilities does it have be it xyz audio/video?<br />
<br />
;Then this page is for you, ideally!<br />
<br />
<br />
{{greenv| Notice:| This page is a user generated/driven content, with their hardware and setup's that work or dont work in any of these situations.}}<br />
{{bluev| Updating:| Feel free to update this list accordingly and add fields to table for other video types your hardware can or cant do.}}<br />
<br />
<big>'''''Please add your experience below.'''''</big><br />
<br />
== Legend key ==<br />
{{legendav}}<br />
<br />
== Audio hardware capabilities and reported to work ==<br />
<br />
{{note|'''Dolby Digital Plus''' a.k.a. '''DD+ or E-AC-3''' is supported in AE > ActiveAE (as of XBMC v13) and will not work properly in XBMC 12.3 or Older.}}<br />
<br />
== AMD Based ==<br />
{| class="prettytable" style="text-align: center; color: black;"<br />
! {{AWorklistHeader}}<br />
|-<br />
| AMD A4-2800K APU<br />
| Radeon HD 6450M<br />
| {{?}}<br />
| Caicos<br />
| {{no}}<br />
| '''HDMI'''<br />
| '''Denon'''<br />
| {{?}}<br />
| {{Yes}}<br />
| {{Yes}}<br />
| {{Yes}}<br />
| {{NA}}<br />
| {{Yes}}<br />
| {{Yes}}<br />
| {{Yes}}<br />
| Windows 7 x64 Pro<br />
| '''12.1'''<br />
| {{no}}<br />
| {{?}}<br />
|-<br />
| AMD A4-3400 APU<br />
| Radeon HD 6410D<br />
| {{?}}<br />
| WinterPark<br />
| {{no}}<br />
| {{?}}<br />
| {{?}}<br />
| {{?}}<br />
| {{Yes}}<br />
| {{Yes}}<br />
| {{yes}}<br />
| {{NA}}<br />
| {{?}}<br />
| {{?}}<br />
| {{?}}<br />
| Windows 8 RTM<br />
| '''5.12.0.13'''<br />
| {{no}}<br />
| {{?}}<br />
|-<br />
| AMD A6-5400K APU <br />
| Radeon HD 7540D<br />
| {{?}}<br />
| Trinity<br />
| {{no}}<br />
| '''HDMI'''<br />
| '''Onkyo TX-NR626'''<br />
| {{?}}<br />
| {{Yes}}<br />
| {{Yes}}<br />
| {{Yes}}<br />
| {{NA}}<br />
| {{Yes}}<br />
| {{Yes}}<br />
| {{?}}<br />
| Windows 8 Pro, x64<br />
| '''9.0.0.9903'''<br />
| {{no}}<br />
| {{?}}<br />
|-<br />
| AMD A8-3870K APU<br />
| Radeon HD 6550D<br />
| {{?}}<br />
| BeaverCreek<br />
| {{no}}<br />
| {{?}}<br />
| {{?}}<br />
| {{?}}<br />
| {{Yes}}<br />
| {{No}}<br />
| {{Yes}}<br />
| {{No}}<br />
| {{No}}<br />
| {{No}}<br />
| {{?}}<br />
| Ubuntu 12.04 LTS<br />
| '''12.1'''<br />
| {{Yes}}<br />
| {{?}}<br />
|-<br />
| AMD A8-3870K APU<br />
| Radeon HD 6550D<br />
| {{?}}<br />
| BeaverCreek<br />
| {{no}}<br />
| {{?}}<br />
| {{?}}<br />
| {{?}}<br />
| {{?}}<br />
| {{yes}}<br />
| {{?}}<br />
| {{?}}<br />
| {{Yes}}<br />
| {{yes}}<br />
| {{?}}<br />
| Windows 7 x64 Pro<br />
| '''12.4'''<br />
| {{no}}<br />
| {{?}}<br />
|-<br />
| ASRock E350M1 <br />
| Radeon HD 6310<br />
| {{?}}<br />
| Wrestler<br />
| {{No}}<br />
| '''HDMI'''<br />
| '''Onkyo HT-R380'''<br />
| {{?}}<br />
| {{Yes}}<br />
| {{?}}<br />
| {{Yes}}<br />
| {{Yes}}<br />
| {{Yes}}<br />
| {{Yes}}<br />
| {{?}}<br />
| Windows 8 Pro, x64<br />
| '''13.2 Beta6'''<br />
| {{No}}<br />
| {{?}}<br />
|-<br />
| ASRock E350M1 <br />
| Radeon HD 6310<br />
| {{?}}<br />
| Wrestler<br />
| {{No}}<br />
| '''HDMI'''<br />
| '''Onkyo HT-R380'''<br />
| {{?}}<br />
| {{yes}}<br />
| {{?}}<br />
| {{yes}}<br />
| {{No}}<br />
| {{No}}<br />
| {{No}}<br />
| {{?}}<br />
| OpenELEC 3.0 RC4 (2.99.4)<br />
| '''12.10'''<br />
| {{No}}<br />
| {{?}}<br />
|-<br />
| Asus E45M1-I Deluxe<br />
| Radeon HD 6320<br />
| {{?}}<br />
| Zacate<br />
| {{Yes}}<br />
| '''HDMI'''<br />
| '''Denon AVR-3312'''<br />
| {{?}}<br />
| {{Yes}}<br />
| {{Yes}}<br />
| {{No}}<br />
| {{No}}<br />
| {{No}}<br />
| {{?}}<br />
| {{Yes}}<br />
| OpenELEC 3.0 (RC 1)<br />
| '''12.10'''<br />
| {{yes}}<br />
| {{?}}<br />
|-<br />
| ZOTAC ZBOX AD04 PLUS<br />
| Radeon HD 6320<br />
| {{?}}<br />
| Zacate<br />
| {{Yes}}<br />
| '''HDMI'''<br />
| '''Denon AVR-1713'''<br />
| {{?}}<br />
| {{yes}}<br />
| {{Yes}}<br />
| {{No}}<br />
| {{No}}<br />
| {{no}}<br />
| {{?}}<br />
| {{yes}}<br />
| XBMCbuntu 12.0 "FRODO"<br />
| {{?}}<br />
| {{yes}}<br />
| XBMC v12.0<br />
|-<br />
| Zotac ZBOX AD06<br />
| Radeon HD 7340<br />
| {{?}}<br />
| Zacate<br />
| {{Yes}}<br />
| '''HDMI'''<br />
| '''Samsung AV-R720'''<br />
| {{?}}<br />
| {{Yes}}<br />
| {{Yes}}<br />
| {{No}}<br />
| {{No}}<br />
| {{No}}<br />
| {{?}}<br />
| {{Yes}}<br />
| OpenELEC 3.0.0<br />
| '''12.10?'''<br />
| {{yes}}<br />
| {{?}}<br />
|-<br />
| M5A78L-M/USB3<br />
| Radeon HD 6850<br />
| {{?}}<br />
| Barts<br />
| {{no}}<br />
| '''HDMI'''<br />
| '''Denon AVR-4310'''<br />
| {{?}}<br />
| {{Yes}}<br />
| {{Yes}}<br />
| {{Yes}}<br />
| {{Yes}}<br />
| {{Yes}}<br />
| {{Yes}}<br />
| {{Yes}}<br />
| OpenELEC (official) - 3.2.4 x64<br />
| {{?}}<br />
| {{no}}<br />
| {{?}}<br />
|-<br />
|}<br />
<br />
== Nvidia Based ==<br />
{| class="prettytable" style="text-align: center; color: black;"<br />
! {{AWorklistHeader}}<br />
|-<br />
| Gigabyte GV-N560OC-1GI<br />
| GeForce GTX 560<br />
| {{?}}<br />
| GF110/GF114<br />
| {{no}}<br />
| '''HDMI'''<br />
| {{NA}}<br />
| {{?}}<br />
| {{yes}}<br />
| {{yes}}<br />
| {{yes}}<br />
| {{NA}}<br />
| {{yes}}<br />
| {{yes}}<br />
| {{yes}}<br />
| OpenELEC 3.0<br />
| '''313.09'''<br />
| {{no}}<br />
| Frodo 12.1<br />
|-<br />
| Asus ENGT430 DC SL DI<br />
| GeForce GT 430<br />
| {{?}}<br />
| GF108<br />
| {{no}}<br />
| '''HDMI'''<br />
| {{NA}}<br />
| {{?}}<br />
| {{Yes}}<br />
| {{yes}}<br />
| {{yes}}<br />
| {{NA}}<br />
| {{yes}}<br />
| {{yes}}<br />
| {{yes}}<br />
| Ubuntu 12.04 LTS<br />
| '''295.59'''<br />
| {{no}}<br />
| Frodo 12.2<br />
|-<br />
| Asus ENGT520<br />
| GeForce GT 520<br />
| {{?}}<br />
| GF119<br />
| {{no}}<br />
| '''HDMI'''<br />
| '''Yamaha/HTR-4063'''<br />
| {{?}}<br />
| {{Yes}}<br />
| {{yes}}<br />
| {{yes}}<br />
| {{NA}}<br />
| {{yes}}<br />
| {{yes}}<br />
| {{yes}}<br />
| Debian Wheezy<br />
| '''310.19'''<br />
| {{no}}<br />
| {{?}}<br />
|-<br />
| EVGA GTX550<br />
| GeForce GTX 550 ti<br />
| {{?}}<br />
| GF116<br />
| {{no}}<br />
| '''HDMI'''<br />
| '''Sony/STR-DN610'''<br />
| {{?}}<br />
| {{Yes}}<br />
| {{Yes}}<br />
| {{Yes}}<br />
| {{NA}}<br />
| {{yes}}<br />
| {{yes}}<br />
| {{yes}}<br />
| Ubuntu 12.10<br />
| '''304.43'''<br />
| {{no}}<br />
| {{?}}<br />
|-<br />
| Asus ENGTX560<br />
| GTX 560 TI<br />
| {{?}}<br />
| GF110/GF114<br />
| {{no}}<br />
| {{?}}<br />
| {{?}}<br />
| {{?}}<br />
| {{Yes}}<br />
| {{Yes}}<br />
| {{Yes}}<br />
| {{NA}}<br />
| {{Yes}}<br />
| {{Yes}}<br />
| {{?}}<br />
| Ubuntu 12.04 LTS<br />
| '''304.43'''<br />
| {{no}}<br />
| {{?}}<br />
|-<br />
| Palit GT640<br />
| GeForce GT 640<br />
| {{?}}<br />
| GK107<br />
| {{no}}<br />
| {{?}}<br />
| {{?}}<br />
| {{?}}<br />
| {{Yes}}<br />
| {{Yes}}<br />
| {{Yes}}<br />
| {{NA}}<br />
| {{Yes}}<br />
| {{Yes}}<br />
| {{Yes}}<br />
| Ubuntu 12.04 LTS<br />
| '''304.43'''<br />
| {{No}}<br />
| {{?}}<br />
|-<br />
| Asus GT610-SL-1GD3-L<br />
| Geforce GT610<br />
| {{?}}<br />
| GF119<br />
| {{no}}<br />
| '''HDMI'''<br />
| '''Onkyo TX-NR807'''<br />
| {{?}}<br />
| {{Yes}}<br />
| {{Yes}}<br />
| {{Yes}}<br />
| {{NA}}<br />
| {{Yes}}<br />
| {{Yes}}<br />
| {{Yes}}<br />
| Slackware 13.37<br />
| '''310.19'''<br />
| {{No}}<br />
| {{?}}<br />
|-<br />
| Zotac GT430 Zone Edition<br />
| GeForce GT 430<br />
| {{?}}<br />
| GF108<br />
| {{no}}<br />
| {{?}}<br />
| {{?}}<br />
| {{?}}<br />
| {{Yes}}<br />
| {{yes}}<br />
| {{yes}}<br />
| {{NA}}<br />
| {{yes}}<br />
| {{yes}}<br />
| {{yes}}<br />
| Windows 7 x64 Pro<br />
| '''306.97'''<br />
| {{no}}<br />
| {{?}}<br />
|-<br />
| Asrock ION 330HT<br />
| GeForce 9400M G<br />
| gpu - #dev2<br />
| G96a/G96b<br />
| {{Yes}}<br />
| '''HDMI'''<br />
| {{?}}<br />
| '''Samsung<br/>Series 5'''<br />
| {{Yes}}<br />
| {{yes}}<br />
| {{yes}}<br />
| {{NA}}<br />
| {{no}}<br />
| {{no}}<br />
| {{?}}<br />
| Ubuntu 12.04.4 LTS<br />
| '''304.64'''<br />
| {{no}}<br />
| XBMC-V13alpha7<br />
|-<br />
| ZOTAC GT 610 ZONE Ed.<br />
| Geforce GT610<br />
| {{?}}<br />
| GF119<br />
| {{no}}<br />
| '''HDMI'''<br />
| '''Onkyo TX-SR608'''<br />
| {{?}}<br />
| {{Yes}}<br />
| {{Yes}}<br />
| {{Yes}}<br />
| {{NA}}<br />
| {{yes}}<br />
| {{yes}}<br />
| {{yes}}<br />
| Win8 64bit + XBMCbuntu<br />
| '''331.65'''<br />
| {{no}}<br />
| {{?}}<br />
|-<br />
|}<br />
<br />
== Intel Based ==<br />
{| class="prettytable" style="text-align: center; color: black;"<br />
! colspan="23" style="background-color:#E6E6E6;" | '''Hardware and audio playback compatibility<br/>'''<br />
|-<br />
| {{AWorklistHeader}}<br />
|-<br />
| EXAMPLE<br />
| HD4000<br />
| {{?}}<br />
| {{NA}}<br />
| {{no}}<br />
| 313.09<br />
| {{No}}<br />
| '''HDMI'''<br />
| {{NA}}<br />
| '''Smugsung X'''<br />
| {{Yes}}<br />
| {{Yes}}<br />
| {{Yes}}<br />
| {{Yes}}<br />
| {{?}}<br />
| {{Yes}}<br />
| {{?}}<br />
| XBMCbuntu v13<br />
| '''V13-beta3-e3sd46g<br />
|}<br />
<br />
<noinclude><br />
[[Category:Audio]]<br />
[[Category:Hardware]]<br />
</noinclude><br />
<br />
= '''Editor references''' =<br />
==== Old AMD audio table / format ====<br />
{| class="prettytable" style="text-align: center; color: black;"<br />
! colspan="23" style="background-color:#E6E6E6;" | '''Hardware and audio playback compatibility<br/>'''<br />
|-<br />
! style="color:#000000; background-color:#DBDBDB;" | '''Model Name'''<br />
! style="color:#000000; background-color:#DBDBDB;" | '''GPU'''<br />
! style="color:#000000; background-color:#DBDBDB;" | '''Code Name'''<br />
! style="color:#000000; background-color:#DBDBDB;" | '''AC3'''<br />
! style="color:#000000; background-color:#DBDBDB;" | '''LPCM'''<br />
! style="color:#000000; background-color:#DBDBDB;" | '''DTS'''<br />
! style="color:#000000; background-color:#DBDBDB;" | '''DTS-HD MA'''<br />
! style="color:#000000; background-color:#DBDBDB;" | '''DTS-HD'''<br />
! style="color:#000000; background-color:#DBDBDB;" | '''TrueHD'''<br />
! style="color:#000000; background-color:#DBDBDB;" | '''DD+/E-AC3'''<br />
! style="color:#000000; background-color:#DBDBDB;" | '''Driver Version'''<br />
! style="color:#000000; background-color:#DBDBDB;" | '''Driver limitation'''<br />
! style="color:#000000; background-color:#DBDBDB;" | '''HW Limitation'''<br />
! style="color:#000000; background-color:#DBDBDB;" | '''Plug'''<br />
! style="color:#000000; background-color:#DBDBDB;" | '''Receiver'''<br />
! style="color:#000000; background-color:#DBDBDB;" | '''Operating System'''<br />
||||||<br />
|-<br />
| AMD A4-2800K APU<br />
| Radeon HD 6450M<br />
| Caicos<br />
| {{Yes}}<br />
| {{Yes}}<br />
| {{Yes}}<br />
| {{Yes}}<br />
| {{Yes}}<br />
| {{Yes}}<br />
| {{?}}<br />
| 12.1<br />
| {{No}}<br />
| {{No}}<br />
| '''HDMI'''<br />
| '''Denon'''<br />
| Windows 7 x64 Pro<br />
|-<br />
| AMD A4-3400 APU<br />
| Radeon HD 6410D<br />
| WinterPark<br />
| {{Yes}}<br />
| {{Yes}}<br />
| {{Yes}}<br />
| {{?}}<br />
| {{?}}<br />
| {{Yes}}<br />
| {{?}}<br />
| 5.12.0.13<br />
| {{No}}<br />
| {{No}}<br />
| {{?}}<br />
| {{?}}<br />
| Windows 8 RTM<br />
|-<br />
| AMD A6-5400K APU <br />
| Radeon HD 7540D<br />
| Trinity<br />
| {{Yes}}<br />
| {{Yes}}<br />
| {{Yes}}<br />
| {{Yes}}<br />
| {{Yes}}<br />
| {{Yes}}<br />
| {{?}}<br />
| 9.0.0.9903<br />
| {{No}}<br />
| {{No}}<br />
| '''HDMI'''<br />
| '''Onkyo TX-NR626'''<br />
| Windows 8 Pro, x64<br />
|-<br />
| AMD A8-3870K APU<br />
| Radeon HD 6550D<br />
| BeaverCreek<br />
| {{Yes}}<br />
| {{No}}<br />
| {{Yes}}<br />
| {{No}}<br />
| {{No}}<br />
| {{No}}<br />
| {{?}}<br />
| 12.1<br />
| {{Yes}}<br />
| {{No}}<br />
| {{?}}<br />
| {{?}}<br />
| Ubuntu 12.04 LTS<br />
|-<br />
| AMD A8-3870K APU<br />
| Radeon HD 6550D<br />
| BeaverCreek<br />
| {{?}}<br />
| {{Yes}}<br />
| {{?}}<br />
| {{Yes}}<br />
| {{?}}<br />
| {{Yes}}<br />
| {{?}}<br />
| 12.4<br />
| {{No}}<br />
| {{No}}<br />
| {{?}}<br />
| {{?}}<br />
| Windows 7 x64 Pro<br />
|-<br />
| ASRock E350M1 <br />
| Radeon HD 6310<br />
| Wrestler<br />
| {{Yes}}<br />
| {{?}}<br />
| {{Yes}}<br />
| {{Yes}}<br />
| {{Yes}}<br />
| {{Yes}}<br />
| {{?}}<br />
| 13.2 Beta6<br />
| {{No}}<br />
| {{No}}<br />
| '''HDMI'''<br />
| '''Onkyo HT-R380'''<br />
| Windows 8 Pro, x64<br />
|-<br />
| ASRock E350M1 <br />
| Radeon HD 6310<br />
| Wrestler<br />
| {{Yes}}<br />
| {{?}}<br />
| {{Yes}}<br />
| {{No}}<br />
| {{No}}<br />
| {{No}}<br />
| {{?}}<br />
| 12.10<br />
| {{Yes}}<br />
| {{No}}<br />
| '''HDMI'''<br />
| '''Onkyo HT-R380'''<br />
| OpenELEC 3.0 RC4 (2.99.4)<br />
<br />
|-<br />
| Asus E45M1-I Deluxe<br />
| Radeon HD 6320<br />
| Zacate<br />
| {{Yes}}<br />
| {{Yes}}<br />
| {{Yes}}<br />
| {{No}}<br />
| {{No}}<br />
| {{No}}<br />
| {{?}}<br />
| 12.10<br />
| {{Yes}}<br />
| {{No}}<br />
| '''HDMI'''<br />
| '''Denon AVR-3312'''<br />
| OpenELEC 3.0 (RC 1)<br />
|-<br />
| ZOTAC ZBOX AD04 PLUS<br />
| Radeon HD 6320<br />
| Zacate<br />
| {{Yes}}<br />
| {{yes}}<br />
| {{Yes}}<br />
| {{No}}<br />
| {{No}}<br />
| {{no}}<br />
| {{?}}<br />
| {{?}}<br />
| {{Yes}}<br />
| {{No}}<br />
| '''HDMI'''<br />
| '''Denon AVR-1713'''<br />
| XBMCbuntu 12.0 "FRODO"<br />
|-<br />
| Zotac ZBOX AD06<br />
| Radeon HD 7340<br />
| Zacate<br />
| {{Yes}}<br />
| {{Yes}}<br />
| {{Yes}}<br />
| {{No}}<br />
| {{No}}<br />
| {{No}}<br />
| {{?}}<br />
| 12.10?<br />
| {{Yes}}<br />
| {{No}}<br />
| '''HDMI'''<br />
| '''Samsung AV-R720'''<br />
| OpenELEC 3.0.0<br />
|-<br />
| M5A78L-M/USB3<br />
| Radeon HD 6850<br />
| Barts<br />
| {{Yes}}<br />
| {{Yes}}<br />
| {{Yes}}<br />
| {{Yes}}<br />
| {{Yes}}<br />
| {{Yes}}<br />
| {{Yes}}<br />
| {{?}}<br />
| {{No}}<br />
| {{No}}<br />
| '''HDMI'''<br />
| '''Denon AVR-4310'''<br />
| OpenELEC (official) - 3.2.4 x64<br />
|-<br />
|}<br />
<br />
=== Legend key Template ===<br />
{|class="prettytable" style="text-align: center; color: black;"<br />
! colspan="17" style="background-color:#F1F1F1;"|'''Legend - Templates - Formatting'''<br />
|-<br />
| colspan="5" style="background-color:#EAD1FF;" | '''General use indicator'''<br />
| colspan="1" style="background-color:#E5FF97;" | '''Decode indicator'''<br />
! colspan="7" style="background-color:#B8D0FF;" | '''HTPC H/W Codename lookup'''<br />
! colspan="4" style="background-color:#FFE5CC;" | '''External equipment'''<br />
|-<br />
| {{yes}}<br />
| {{no}}<br />
| {{NA}}<br />
| {{wip}}<br />
| {{?}}<br />
| ''' cpu - vpu - gpu '''<br />
| rowspan="2" | [http://en.wikipedia.org/wiki/Comparison_of_AMD_graphics_processing_units See: <br/>ATI]<br />
| rowspan="2" | [http://en.wikipedia.org/wiki/Comparison_of_Nvidia_graphics_processing_units See: <br/>Nvidia]<br />
| rowspan="2" | [http://en.wikipedia.org/wiki/Comparison_of_Intel_graphics_processing_units See: <br/>Intel]<br />
| rowspan="2" | [http://en.wikipedia.org/wiki/Allwinner_Technology See: <br/>allwinner]<br />
| rowspan="2" | [http://en.wikipedia.org/wiki/I.MX#i.MX6x_series See: <br/>Freescale]<br />
| rowspan="2" | [http://en.wikipedia.org/wiki/ARM_architecture See: <br/>ARM]<br />
| rowspan="2" | [http://en.wikipedia.org/wiki/Comparison_of_Android_devices See: <br/>Android]<br />
! colspan="4" style="background-color:#FFE5CC;" | '''Plug - Receiver - TV / models'''<br />
|- <br />
| <nowiki>{{yes}}</nowiki><br />
| <nowiki>{{no}}</nowiki><br />
| <nowiki>{{NA}}</nowiki><br />
| <nowiki>{{wip}}</nowiki><br />
| <nowiki>{{?}}</nowiki><br />
| <nowiki>''' cpu - vpu - gpu '''</nowiki><br />
| <nowiki>'''HDMI'''</nowiki><br />
| <nowiki>'''Optical'''</nowiki><br />
| <nowiki>'''Analog'''</nowiki><br />
| <nowiki>'''TV - AVR / Model'''</nowiki><br />
|}<br />
<br />
=== AVWorklistHeader Template ===<br />
{|class="prettytable" style="text-align: center; color: black;"<br />
! colspan="19" style="background-color:#F1F1F1;"|'''Audio - Templates - Formatting'''<br />
|-<br />
! colspan="5" style="background-color:#B8D0FF;" | '''HTPC Hardware'''<br />
! colspan="3" style="background-color:#FFE5CC;" | '''External Equipment'''<br />
! colspan="7" style="background-color:#DBFF94;" | '''Audio Capabilities<br/>'''<br />
! rowspan="2" style="background-color:#FFEBCC;" | '''Operative<br/>System'''<br />
! colspan="2" style="background-color:#E5FF97;" | '''Driver'''<br />
! rowspan="2" style="background-color:#B8D0FF;" | '''XBMC<br/>Version'''<br />
|-<br />
! style="color:#000000; background-color:#B8D0FF;" | '''Model'''<br />
! style="color:#000000; background-color:#B8D0FF;" | '''GPU - VPU type'''<br />
! style="color:#000000; background-color:#B8D0FF;" | '''Audio device'''<br />
! style="color:#000000; background-color:#B8D0FF;" | '''Code Name'''<br />
! style="color:#000000; background-color:#B8D0FF;" | '''Limitation'''<br />
! style="color:#000000; background-color:#FFE5CC;" | '''Plug'''<br />
! style="color:#000000; background-color:#FFE5CC;" | '''Receiver'''<br />
! style="color:#000000; background-color:#FFE5CC;" | '''Television'''<br />
! style="color:#000000; background-color:#DBFF94;" | '''AC3'''<br />
! style="color:#000000; background-color:#DBFF94;" | '''LPCM'''<br />
! style="color:#000000; background-color:#DBFF94;" | '''DTS'''<br />
! style="color:#000000; background-color:#DBFF94;" | '''DTS-HD MA'''<br />
! style="color:#000000; background-color:#DBFF94;" | '''DTS-HD'''<br />
! style="color:#000000; background-color:#DBFF94;" | '''TrueHD'''<br />
! style="color:#000000; background-color:#DBFF94;" | '''DD+/E-AC3'''<br />
! style="color:#000000; background-color:#E5FF97;" | '''Version'''<br />
! style="color:#000000; background-color:#E5FF97;" | '''Limitation'''<br />
|}<br />
<br />
=== VWorklistHeader Template ===<br />
{|class="prettytable" style="text-align: center; color: black;"<br />
! colspan="23" style="background-color:#E6E6E6;" | '''Hardware and video playback compatibility<br/>'''<br />
|-<br />
! colspan="5" style="background-color:#B8D0FF;" | '''HTPC Hardware'''<br />
! colspan="3" style="background-color:#FFE5CC;" | '''External Equipment'''<br />
! style="background-color:#DBDBFF;" | '''Decoder'''<br />
! colspan="10" style="background-color:#E5FF97;" | '''Capabilities<br/>'''<br />
! rowspan="2" style="background-color:#FFEBCC;" | '''Operative<br/>System'''<br />
! colspan="2" style="background-color:#E5FF97;" | '''Driver'''<br />
! rowspan="2" style="background-color:#B8D0FF;" | '''XBMC<br/>Version'''<br />
|-<br />
! style="background-color:#B8D0FF;" | '''Model'''<br />
! style="background-color:#B8D0FF;" | '''GPU - VPU type'''<br />
! style="background-color:#B8D0FF;" | '''CPU type'''<br />
! style="background-color:#B8D0FF;" | '''Code Names'''<br />
! style="background-color:#B8D0FF;" | '''Limitation'''<br />
| style="background-color:#FFE5CC;" | '''Plug'''<br />
| style="background-color:#FFE5CC;" | '''Reveiver'''<br />
| style="background-color:#FFE5CC;" | '''Television'''<br />
! rowspan="0" style="background-color:#DBDBFF;" | '''GPU<br/>VPU<br/>CPU<br/>'''<br />
| style="background-color:#E5FF97;" | '''H.262'''<br />
| style="background-color:#E5FF97;" | '''H.263'''<br />
| style="background-color:#E5FF97;" | '''H.264'''<br />
| style="background-color:#E5FF97;" | '''H.265'''<br />
| style="background-color:#E5FF97;" | '''MPEG-4v3'''<br />
| style="background-color:#E5FF97;" | '''WMV'''<br />
| style="background-color:#E5FF97;" | '''On2'''<br />
| style="background-color:#E5FF97;" | '''720/1080'''<br />
| style="background-color:#E5FF97;" | '''Blu-ray'''<br />
| style="background-color:#E5FF97;" | '''3D'''<br />
! style="background-color:#E5FF97;" | '''Version'''<br />
! style="background-color:#E5FF97;" | '''Limitation'''<br />
|}<br />
<br />
== Package management F.A.Q. ==<br />
Here we give detailed information on '''Advanced Packaging Tool''', a.k.a. '''APT'''. and the necessary commands to retrieve, install, update, upgrade and or remove the application also known as XBMC or Kodi on Ubuntu and variants such as XBMCbuntu/KodiBuntu. Such information is widespread on any Ubuntu documentation and is duplicated here for simplicity and general user base benefit.<br />
<br />
<section begin="package_maintenance" /><br />
{| width="100%"<br />
{{FAQ|1=Why_XBMC_ppa<br />
| BGcolor=whitesmoke<br />
| Question= Why are XBMC packages from Ubuntu repositories incorrect?<br />
| Answer=<br />
The simple answer is that, these packages derive from externally modified XBMC versions which are either '''outdated''' and '''broken''' or both, and are 100% officially '''unsupported''' at this time.<br />
<br />
The main thing you must understand is that if you looking for supported official builds, you simply should not use other repositories, unless otherwise indicated by a Team Member or a informed community member.<br />
}}<br />
<br />
{{FAQ|1=Dependencies<br />
| BGcolor=<br />
| Question=Are any dependencies required to manage repo's or ppa's?<br />
| Answer=<br />
Some dependencies are required to manage ppa's/repos within your distro, install these by typing:<br />
<source lang="bash" enclose="div"><br />
sudo apt-get install python-software-properties pkg-config<br />
</source><br />
}}<br />
<br />
{| width="100%"<br />
{{FAQ|1=What_ppa_do_I_have<br />
| BGcolor=whitesmoke<br />
| Question= How do I find out what repo/ppa I am currently using?<br />
| Answer=<br />
You can get a complete listing of what repositories are part of your sources list by typing:<br />
<source lang="bash" enclose="div"><br />
sudo apt-cache policy<br />
</source><br />
}}<br />
<br />
{{FAQ|1=Adding or removing ppas<br />
| BGcolor=<br />
| Question=How do I add or remove ppa's?<br />
| Answer=<br />
After you determined which ppa you would like to '''add''' or '''remove''' follow the instructions below.<br />
;You can remove a ppa from your distro's sources list via terminal, by typing:<br />
<source lang="bash" enclose="div"><br />
sudo add-apt-repository -r ppa:current_XBMC_providing_ppa<br />
</source><br />
<br />
;You can add a ppa to your distro's sources list via terminal, by typing:<br />
<br />
<source lang="bash" enclose="div"><br />
sudo add-apt-repository ppa:the_ppa_you_wish_to_use<br />
</source><br />
<br /><br />
}}<br />
{{note|<br />
* The process of adding and removing repositories is recommended when changing the repo's in use.<br />
* Changing the PPA repo for XBMC will change what type of install is used (stable, nightly, beta, etc).}}<br />
<br />
== Installing, updating or upgrading ==<br />
If applicable you can check what package versions are installed in your system, this is helpful when determining what procedures to choose.<br />
{{FAQ|1=check current version<br />
| BGcolor=whitesmoke<br />
| Question=How can check what current XBMC version is installed?<br />
| Answer=<br />
Check what XBMC versions you have access to:<br />
<source lang="bash"><br />
sudo apt-cache policy xbmc<br />
</source><br />
}}<br />
<br />
{{FAQ|1=Installing XBMC<br />
| BGcolor=<br />
| Question=How do I install XBMC?<br />
| Answer=<br />
After adding or removing any ppa you need to refresh your sources list and finally install XBMC, by typing:<br />
<syntaxhighlight lang="bash" enclose="div"><br />
sudo apt-get update<br />
sudo apt-get install xbmc xbmc-bin<br />
</syntaxhighlight><br />
}}<br />
<br />
{{FAQ|1=Updating XBMC<br />
| BGcolor=whitesmoke<br />
| Question=How do I update XBMC?<br />
| Answer=<br />
To update XBMC/Kodi when a new version is released, just do a general system/package or use the following commands in the terminal (or via [[SSH]]):<br />
<br />
<source lang="bash"><br />
sudo apt-get update<br />
sudo apt-get install xbmc xbmc-bin<br />
</source><br />
}}<br />
<br />
{{FAQ|1=Upgrading XBMC<br />
| BGcolor=<br />
| Question=How do I upgrade XBMC?<br />
| Answer=<br />
After adding or removing any ppa you need to refresh your sources list and finally upgrade xbmc, by typing:<br />
<syntaxhighlight lang="bash" enclose="div"><br />
sudo apt-get update<br />
sudo apt-get --only-upgrade install xbmc xbmc-bin<br />
</syntaxhighlight><br />
}}<br />
<section begin="whynoupgrade" /><br />
{{FAQ|1=XBMC wont upgrade<br />
| BGcolor=whitesmoke<br />
| Question=Why wont XBMC upgrade?<br />
| Answer=<br />
After following the above instructions, XBMC is still not upgraded, the main reason why this happens is because the distribution you are using, is no longer supported and has reached an '''''end of life status'''''.<br />
<br />
See [https://wiki.ubuntu.com/Releases Current Ubuntu releases] if your current distro is listed under End of life table, you will need to upgrade your OS to a supported release.<br />
<br />
LTS releases are better for long term install and forget, installing obviously the very latest LTS release available.<br />
{{#lst:XBMCbuntu FAQ|upgradeOS}}<br />
}}<section end="whynoupgrade" /><br />
<br />
{{FAQ|1=Specific package versions.<br />
| BGcolor=<br />
| Question=How to install a specific versions?<br />
| Answer=<br />
In the event you need to install either by upgrade or downgrade a specific XBMC version (a reason may be a bug or to test a specific version), the PPA providing said version active must be in your '''sources.list.d''' along with a updated list of the packages.<br />
If the packages you intend to install are on a different PPA, you should probably remove that PPA to avoid confusion.<br />
<code>apt-get install packagename=version</code> is one way to achieve this.<br />
<syntaxhighlight lang="bash" enclose="div"><br />
sudo apt-get update<br />
sudo apt-get install xbmc=2:13.1~git20140606.0917-gotham-0trusty xbmc-bin=2:13.1~git20140606.0917-gotham-0trusty <br />
</syntaxhighlight><br />
<br />
Hint: For e.g. You can use result of <code>apt-cache policy xbmc</code> to see the candidates <packagename><version> available to you.<br />
{{Note| Removing/purging any previous versions if they are greater version of the package you are looking to install is necessary.}}<br />
}}<br />
<br />
{{FAQ|1=beta_unstable<br />
| BGcolor=whitesmoke<br />
| Question=How can I install a beta/unstable version?<br />
| Answer=<br />
To install a beta/unstable version of XBMC you must first add the unstable repository, then install XBMC:<br />
<source lang="bash"><br />
sudo add-apt-repository ppa:team-xbmc/unstable<br />
sudo apt-get update<br />
sudo apt-get install xbmc xbmc-bin<br />
</source><br />
:;or:<br />
<source lang="bash"><br />
sudo add-apt-repository ppa:team-xbmc/nightly<br />
sudo apt-get update<br />
sudo apt-get install xbmc xbmc-bin<br />
</source><br />
Follow the prompts to add the repository, then to add the updates, and finally install the new version of XBMC.<br />
{{note|1=You may need to restart your computer for the newly installed version to be working.}}<br />
}}<br />
<br />
{{FAQ|1=beta_unstable_to_stable<br />
| BGcolor=<br />
| Question=How can I move from a beta/unstable to a stable version?<br />
| Answer=<br />
Check what XBMC versions you have access to by typing:<br />
<source lang="bash"><br />
sudo apt-cache policy xbmc<br />
</source><br />
<br />
The response in terminal should be something like:<br />
<source lang="xml"><br />
xbmc:<br />
Installed: 2:13.2~git20140719.0900-beta2-0trusty<br />
Candidate: 2:13.2~git20140719.0900-beta2-0trusty<br />
Version table:<br />
*** 2:13.2~git20140719.0900-beta2-0trusty 0<br />
500 http://ppa.launchpad.net/team-xbmc/unstable/ubuntu/ trusty/main amd64 Packages<br />
100 /var/lib/dpkg/status<br />
2:13.1~git20140606.0917-gotham-0trusty 0<br />
500 http://ppa.launchpad.net/team-xbmc/ppa/ubuntu/ trusty/main amd64 Packages<br />
2:12.3+dfsg1-3ubuntu1 0<br />
500 http://us.archive.ubuntu.com/ubuntu/ trusty/universe amd64 Packages<br />
</source><br />
{{note|1=In the above example we have an unstable ('''team-xbmc/unstable''') and the release versions ('''team-xbmc/ppa''') available. The version with the '''***''' is the currently installed version (unstable)}}<br />
<br />
To install the release version we need to install the team-xbmc/ppa version (in the above example: "2:13.1~git20140606.0917-gotham-0trusty"). This requires the install of both the [[Team_XBMC_PPA#Installing_XBMC |"'''xbmc'''" and the "'''xbmc-bin'''" package.]]<br />
<source lang="bash"><br />
sudo apt-get install xbmc=2:13.1~git20140606.0917-gotham-0trusty xbmc-bin=2:13.1~git20140606.0917-gotham-0trusty<br />
</source><br />
{{note|1=You will get a warning you are downgrading, hit Y when asked to continue}}<br />
<br />
Remove the beta/unstable repository from XBMC to clean up:<br />
<source lang="bash"><br />
sudo add-apt-repository -r ppa:team-xbmc/unstable<br />
</source><br />
}}<br />
<br />
== Uninstalling or Removing ==<br />
{{FAQ|1=Uninstalling XBMC<br />
| BGcolor=<br />
| Question=How do I uninstall XBMC?<br />
| Answer=<br />
If you need to remove and purge an application and finally removing/purging also the application configurations files, do so by typing:<br />
<syntaxhighlight lang="bash" enclose="div"><br />
sudo apt-get update<br />
sudo apt-get remove xbmc*<br />
sudo apt-get purge xbmc*<br />
</syntaxhighlight><br />
}}<section end="package_maintenance" /><br />
<br />
== Build Dependencies ==<br />
{{FAQ|1=PPA Build deps<br />
| BGcolor=whitesmoke<br />
| Question=What are PPA build dependencies?<br />
| Answer=<br />
These build dependencies are versions of a library pre-packaged by Team XBMC, because the distro provided versions are behind the current requirements of XBMC.<br />
Both [https://github.com/xbmc/xbmc/blob/master/docs/README.linux REAME.linux] and/or [https://github.com/xbmc/xbmc/blob/master/docs/README.ubuntu README.ubuntu] documents using XBMC ppa build dependencies refer to these dependencies in the Team XBMC PPA's used in conjunction, when compiling on Ubuntu or derivatives distros.<br />
}}<br />
|}<br />
<br />
== See also ==<br />
* [https://help.ubuntu.com/community/AptGet/Howto apt-get/How-to]<br />
<br />
===testheadertabs===<br />
<br />
=David1977 wants add this tab=<br />
'''But How does he do it?:'''<br />
#OH dear let me writesomething here<br />
#see more<br />
{{progress|65}}<br />
<br />
=After figuring it out=<br />
'''Some other tab is now easy to add:'''<br />
*Right ok think I got this.<br />
using some template inside tabs<br />
{{wiki revamp}}<br />
<br />
<headertabs /></div>UNiversalhttps://kodi.wiki/index.php?title=TexturePacker&diff=87758TexturePacker2015-03-13T06:42:31Z<p>UNiversal: /* Texturepacker build bat */ update, build.bat</p>
<hr />
<div>{{mininav|[[Development]]|[[Add-on development]]|[[Skinning]]}}<br />
<section begin="intro" />Kodi uses a tool named TexturePacker to compile all images used in a skin into a single file. The benefit of it is that images inside the Textures.xbt will load faster in the skin. This is done by converting all images into a format that take less processing by Kodi when they need to be rendered onto the screen.<br />
<br />
A common misconception is that TexturPacker will just compress the images into a single file, this if far from the truth, so don't be surprised if the Textures.xbt file is much larger than to total size of all the individual images.<br />
<section end="intro" /><br />
== How To Get It ==<br />
If you are using Windows, you can simply download a zipfile with an up-to-date version of TexturePacker from the Kodi mirrors.<br />
<br /><big>'''It is available here:''' [http://mirrors.kodi.tv/build-deps//win32/texturepacker-1.0.2-win32.7z '''Download TexturePacker 1.0.2''']</big><br />
{{note| This is a dll free self contained texturepacker executable for windows.}}<br />
<br />
On other platforms, you will have to compile TexturePacker yourself. This is done by compiling Kodi and when the compile is finished, you can find TexturePacker inside the ../tools/depends/native/TexturePacker directory.<br />
<br />
== Usage ==<br />
Since TexturePacker is a command-line tool, you will need to open a dos box/terminal/console in order to run it. The general usage is:<br />
<pre>TexturePacker -input skin.name\media -output skin.name\media\Textures.xbt</pre><br />
<br />
Optionally, you can run TexturePacker with the ''-dupecheck'' option. This is useful if you have included the same image multiple times in your media folder. For example, if your skin includes a lot of studio logos, most likely a lot of them are included multiple times but with a slightly different filename. The '-dupecheck' option will make sure each unique image is included only once in the Textures.xbt file and thus keeping the size of it as small as possible.<br />
<br />
If your skins includes [[Skin_development_introduction#Skin_Themes]] you should also run TexturePacker on your theme folders:<br />
<pre>TexturePacker -input skin.name\themes\Blue -output skin.name\media\Blue.xbt</pre><br />
<br />
{{Note| When using an XBT file in your skin, your file paths will '''not''' be case sensitive, even if your skin resides on a case sensitive file system!}}<br />
<br />
=== Texturepacker build bat ===<br />
Create a Texturepacker.bat with the contents below, inside the skin.name directory along with all the texturepacker.exe, a double click on the bat file does all the work for you.<br />
<pre><br />
@ECHO OFF<br />
<br />
COLOR A<br />
<br />
ECHO -------------------------------------------------------------------------<br />
ECHO ^> ** Creating excludes... **<br />
<br />
ECHO .svn>exclude.txt<br />
ECHO .git>>exclude.txt<br />
ECHO Thumbs.db>>exclude.txt<br />
ECHO Desktop.ini>>exclude.txt<br />
ECHO dsstdfx.bin>>exclude.txt<br />
ECHO build.bat>>exclude.txt<br />
ECHO \skin.confluence\media\>>exclude.txt<br />
ECHO \skin.confluence\backgrounds\>>exclude.txt<br />
ECHO exclude.txt>>exclude.txt<br />
<br />
ECHO -------------------------------------------------------------------------<br />
ECHO.<br />
<br />
ECHO -------------------------------------------------------------------------<br />
ECHO ** Creating Textures XBT File... **<br />
ECHO -------------------------------------------------------------------------<br />
<br />
ECHO.<br />
PING -n 2 -w 1000 127.0.0.1 > NUL<br />
START /B /WAIT TexturePacker -dupecheck -input media\ -output media\Texture.xbt<br />
PING -n 2 -w 20000 127.0.0.1 > NUL<br />
ECHO.<br />
ECHO.<br />
ECHO -------------------------------------------------------------------------<br />
ECHO ^> Deleting excludes...<br />
DEL exclude.txt<br />
ECHO ^> Done<br />
ECHO -------------------------------------------------------------------------<br />
ECHO.<br />
ECHO.<br />
<br />
ECHO -------------------------------------------------------------------------<br />
ECHO ** XBT build complete - scroll up to check for errors. **<br />
ECHO -------------------------------------------------------------------------<br />
<br />
PING -n 50 -w 5000 127.0.0.1 > NUL<br />
</pre><br />
<br />
[[Category:Add-on development]]<br />
[[Category:Skin development]]<br />
[[Category:Development]]</div>UNiversalhttps://kodi.wiki/index.php?title=TexturePacker&diff=87757TexturePacker2015-03-13T06:37:01Z<p>UNiversal: /* How To Get It */ Update texture-packer to latest build.</p>
<hr />
<div>{{mininav|[[Development]]|[[Add-on development]]|[[Skinning]]}}<br />
<section begin="intro" />Kodi uses a tool named TexturePacker to compile all images used in a skin into a single file. The benefit of it is that images inside the Textures.xbt will load faster in the skin. This is done by converting all images into a format that take less processing by Kodi when they need to be rendered onto the screen.<br />
<br />
A common misconception is that TexturPacker will just compress the images into a single file, this if far from the truth, so don't be surprised if the Textures.xbt file is much larger than to total size of all the individual images.<br />
<section end="intro" /><br />
== How To Get It ==<br />
If you are using Windows, you can simply download a zipfile with an up-to-date version of TexturePacker from the Kodi mirrors.<br />
<br /><big>'''It is available here:''' [http://mirrors.kodi.tv/build-deps//win32/texturepacker-1.0.2-win32.7z '''Download TexturePacker 1.0.2''']</big><br />
{{note| This is a dll free self contained texturepacker executable for windows.}}<br />
<br />
On other platforms, you will have to compile TexturePacker yourself. This is done by compiling Kodi and when the compile is finished, you can find TexturePacker inside the ../tools/depends/native/TexturePacker directory.<br />
<br />
== Usage ==<br />
Since TexturePacker is a command-line tool, you will need to open a dos box/terminal/console in order to run it. The general usage is:<br />
<pre>TexturePacker -input skin.name\media -output skin.name\media\Textures.xbt</pre><br />
<br />
Optionally, you can run TexturePacker with the ''-dupecheck'' option. This is useful if you have included the same image multiple times in your media folder. For example, if your skin includes a lot of studio logos, most likely a lot of them are included multiple times but with a slightly different filename. The '-dupecheck' option will make sure each unique image is included only once in the Textures.xbt file and thus keeping the size of it as small as possible.<br />
<br />
If your skins includes [[Skin_development_introduction#Skin_Themes]] you should also run TexturePacker on your theme folders:<br />
<pre>TexturePacker -input skin.name\themes\Blue -output skin.name\media\Blue.xbt</pre><br />
<br />
{{Note| When using an XBT file in your skin, your file paths will '''not''' be case sensitive, even if your skin resides on a case sensitive file system!}}<br />
<br />
=== Texturepacker build bat ===<br />
Create a Texturepacker.bat with the contents below, inside the skin.name directory along with all the texturepacker.exe, a double click on the bat file does all the work for you.<br />
<pre><br />
@echo off<br />
ECHO ----------------------------------------<br />
echo Creating excludes<br />
<br />
Echo .svn>exclude.txt<br />
Echo .git>exclude.txt<br />
Echo Thumbs.db>>exclude.txt<br />
Echo Desktop.ini>>exclude.txt<br />
Echo dsstdfx.bin>>exclude.txt<br />
Echo build.bat>>exclude.txt<br />
Echo \skin.confluence\media\>>exclude.txt<br />
Echo exclude.txt>>exclude.txt<br />
<br />
ECHO ----------------------------------------<br />
ECHO Creating XBT File...<br />
<br />
START /B /WAIT TexturePacker -dupecheck -input media\ -output media\Textures.xbt<br />
<br />
del exclude.txt<br />
<br />
echo Textures.xbt build complete - Scroll Up to check for errors.<br />
pause<br />
</pre><br />
<br />
[[Category:Add-on development]]<br />
[[Category:Skin development]]<br />
[[Category:Development]]</div>UNiversalhttps://kodi.wiki/index.php?title=TexturePacker&diff=84623TexturePacker2015-02-01T09:47:35Z<p>UNiversal: </p>
<hr />
<div>{{mininav|[[Development]]|[[Add-on development]]|[[Skinning]]}}<br />
<section begin="intro" />Kodi uses a tool named TexturePacker to compile all images used in a skin into a single file. The benefit of it is that images inside the Textures.xbt will load faster in the skin. This is done by converting all images into a format that take less processing by Kodi when they need to be rendered onto the screen.<br />
<br />
A common misconception is that TexturPacker will just compress the images into a single file, this if far from the truth, so don't be surprised if the Textures.xbt file is much larger than to total size of all the individual images.<br />
<section end="intro" /><br />
== How To Get It ==<br />
If you are using Windows, you can simply download a zipfile with an up-to-date version of TexturePacker from the Kodi mirrors.<br />
<br />'''It is available here:''' [http://mirrors.xbmc.org/build-deps/win32/texturepacker-1.0.1-win32.7z '''Download TexturePacker 1.0.1''']<br />
{{note| This is a dll free self contained texturepacker executable for windows.}}<br />
<br />
On other platforms, you will have to compile TexturePacker yourself. This is done by compiling Kodi and when the compile is finished, you can find TexturePacker inside the ../tools/depends/native/TexturePacker directory.<br />
<br />
== Usage ==<br />
Since TexturePacker is a command-line tool, you will need to open a dos box/terminal/console in order to run it. The general usage is:<br />
<pre>TexturePacker -input skin.name\media -output skin.name\media\Textures.xbt</pre><br />
<br />
Optionally, you can run TexturePacker with the ''-dupecheck'' option. This is useful if you have included the same image multiple times in your media folder. For example, if your skin includes a lot of studio logos, most likely a lot of them are included multiple times but with a slightly different filename. The '-dupecheck' option will make sure each unique image is included only once in the Textures.xbt file and thus keeping the size of it as small as possible.<br />
<br />
If your skins includes [[Skin_development_introduction#Skin_Themes]] you should also run TexturePacker on your theme folders:<br />
<pre>TexturePacker -input skin.name\themes\Blue -output skin.name\media\Blue.xbt</pre><br />
<br />
{{Note| When using an XBT file in your skin, your file paths will '''not''' be case sensitive, even if your skin resides on a case sensitive file system!}}<br />
<br />
=== Texturepacker build bat ===<br />
Create a Texturepacker.bat with the contents below, inside the skin.name directory along with all the texturepacker.exe, a double click on the bat file does all the work for you.<br />
<pre><br />
@echo off<br />
ECHO ----------------------------------------<br />
echo Creating excludes<br />
<br />
Echo .svn>exclude.txt<br />
Echo .git>exclude.txt<br />
Echo Thumbs.db>>exclude.txt<br />
Echo Desktop.ini>>exclude.txt<br />
Echo dsstdfx.bin>>exclude.txt<br />
Echo build.bat>>exclude.txt<br />
Echo \skin.confluence\media\>>exclude.txt<br />
Echo exclude.txt>>exclude.txt<br />
<br />
ECHO ----------------------------------------<br />
ECHO Creating XBT File...<br />
<br />
START /B /WAIT TexturePacker -dupecheck -input media\ -output media\Textures.xbt<br />
<br />
del exclude.txt<br />
<br />
echo Textures.xbt build complete - Scroll Up to check for errors.<br />
pause<br />
</pre><br />
<br />
[[Category:Add-on development]]<br />
[[Category:Skin development]]<br />
[[Category:Development]]</div>UNiversalhttps://kodi.wiki/index.php?title=User:UNiversal&diff=78969User:UNiversal2014-09-18T12:56:17Z<p>UNiversal: /* VWorklistHeader Template */</p>
<hr />
<div>{{DISPLAYTITLE:User:uNiversal}}<br />
<br />
[[File:XBMC splash by uNiversal.jpg|left|500px|'''Done especially for xbmc Settings menu [[forum:183508|Click here to see forums thread''']]]]<br />
<br />
{{Infobox<br />
|bodystyle = <br />
|above = uNiversal<br />
|titlestyle = <br />
<br />
|image = [[File:Zappy-omg.png|200px|alt=uNiversal|link=]]<br />
|imagestyle = <br />
|caption = '''''Error!''''' Out of Memory!<br />
|captionstyle = <br />
|headerstyle = background:#A0CC54;<br />
|labelstyle = background:#84B334;<br />
|datastyle = background:#A0CC54;<br />
<br />
|header1 = XBMC user<br />
|header2 = <br />
|header3 =<br />
|label3 = System Details:<br />
|data3 = '''Linux.4.0~Custom'''<br />
|header4 = <br />
|label4 = Brain Version:<br />
|data4 = '''Positronic 2.0'''<br />
|header5 = <br />
|label5 = Power Matrix:<br />
|data5 = '''Hybrid/Biologic'''<br />
|belowstyle = <br />
|below = {{keypress|'''Ctrl|Alt|Del'''}}<br />
}}<br />
{{-}}<br />
{{progress|100}}<br />
<br />
==Sandbox==<br />
{{hidden<br />
| style = border:1px dashed red; width: 50%;<br />
| headerstyle = background: #ccccff; font-size: 110%;<br />
| contentstyle = text-align: center; color:green;<br />
| header = Sandbox<br />
| content = <br />
<!-- --><br />
[[Template:orangev]]<br />
<div style="background:#fefefe; padding:0 1em 0 1.1em;margin: .5em 0 .5em 0;"><br />
<div style="border-left:.5em solid #E3871E;padding:.2em .5em .4em 1em;"><span style="font-weight: bold; color:#E3871E; padding:.2em .5em .4em 0em;"><u>{{{1}}}</u> </span>{{{1}}}</div></div><br />
<noinclude>{{documentation}}</noinclude><br />
<br />
<!-- --><br />
[[Template:goldv]]<br />
<div style="background:#fefefe; padding:0 1em 0 1.1em;margin: .5em 0 .5em 0;"><br />
<div style="border-left:.5em solid #E3BF1E;padding:.2em .5em .4em 1em;"><span style="font-weight: bold; color:#E3BF1E; padding:.2em .5em .4em 0em;"><u>{{{1}}}</u> </span>{{{1}}}</div></div><br />
<noinclude><br />
{{Documentation}}<br />
[[Category:Templates]]<br />
</noinclude><br />
<br />
<!-- --><br />
[[Template:Quote]]<br />
<div style="background-color:#F6FFD6; border: 3px dashed #6EBA1C;">{{{1}}}</div><br />
<noinclude><br />
{{Documentation}}<br />
[[Category:Templates]]<br />
</noinclude><br />
<br />
<!--<br />
[[Template:helpn]]<br />
{| style="background-color:#F6FFD6; width=100%; border: 3px dashed #6EBA1C; font-size: 100%; margin-top: 2px; margin-bottom: 2px;" | <br />
| width="10px" | [[File:help.png|50px|link=|HELP]]<br />
| align="right" | {{{raw|'''{{{2|NOTICE}}}:''' {{{1}}}}}}<br />
|}<br />
<noinclude><br />
{{Documentation}}<br />
[[Category:Templates]]<br />
</noinclude><br />
--><br />
<br />
<!-- --><br />
[[Template:Note]]<br />
[[File:Note.png|40px|link=|REMEMBER]]<br />
<noinclude><br />
{{Documentation}}<br />
[[Category:Templates]]<br />
</noinclude><br />
<br />
<!-- --><br />
[[Template:Tip]]<br />
[[File:Lightbulb.png|35px|link=|TIP]]<br />
<noinclude><br />
{{Documentation}}<br />
[[Category:Templates]]<br />
</noinclude><br />
<br />
<!-- --><br />
[[Template:Help]]<br />
[[File:Help.png|35px|link=|HELP]]<br />
<noinclude><br />
{{Documentation}}<br />
[[Category:Templates]]<br />
</noinclude><br />
|headerstyle=background:#ccccff<br />
|style=text-align:center;<br />
}}<br />
<br />
== video Hardware ==<br />
{| class="prettytable" style="text-align: center; color: black;"<br />
! colspan="23" style="background-color:#E6E6E6;" | '''Hardware and video playback compatibility<br/>'''<br />
|-<br />
! colspan="5" style="background-color:#B8D0FF;" | '''HTPC Hardware'''<br />
! colspan="3" style="background-color:#FFE5CC;" | '''External Equipment'''<br />
! style="background-color:#DBDBFF;" | '''Decoder'''<br />
! colspan="10" style="background-color:#DBFF94;" | '''Video Capabilities<br/>'''<br />
! rowspan="2" style="background-color:#FFEBCC;" | '''Operative<br/>System'''<br />
! colspan="2" style="background-color:#E5FF97;" | '''Driver'''<br />
! rowspan="2" style="background-color:#B8D0FF;" | '''XBMC<br/>Version'''<br />
|-<br />
! style="background-color:#B8D0FF;" | '''Model'''<br />
! style="background-color:#B8D0FF;" | '''GPU - VPU type'''<br />
! style="background-color:#B8D0FF;" | '''CPU type'''<br />
! style="background-color:#B8D0FF;" | '''Code Names'''<br />
! style="background-color:#B8D0FF;" | '''Limitation'''<br />
| style="background-color:#FFE5CC;" | '''Plug'''<br />
| style="background-color:#FFE5CC;" | '''AVR'''<br />
| style="background-color:#FFE5CC;" | '''Television'''<br />
! rowspan="0" style="background-color:#DBDBFF;" | '''GPU<br/>VPU<br/>CPU<br/>'''<br />
| style="background-color:#DBFF94;" | '''H.262'''<br />
| style="background-color:#DBFF94;" | '''H.263'''<br />
| style="background-color:#DBFF94;" | '''H.264'''<br />
| style="background-color:#DBFF94;" | '''H.265'''<br />
| style="background-color:#DBFF94;" | '''MPEG-4v3'''<br />
| style="background-color:#DBFF94;" | '''WMV'''<br />
| style="background-color:#DBFF94;" | '''On2'''<br />
| style="background-color:#DBFF94;" | '''720/1080'''<br />
| style="background-color:#DBFF94;" | '''Blu-ray'''<br />
| style="background-color:#DBFF94;" | '''3D'''<br />
! style="background-color:#E5FF97;" | '''Version'''<br />
! style="background-color:#E5FF97;" | '''Limitation'''<br />
|-<br />
| Some ficticious<br />
| ugabuga<br />
| holahoops<br />
| armadillo<br />
| {{yes}}<br />
| HDMI <br />
| AVRBONGO<br />
| Smugsung<br />
| cpu<br />
| gpu<br />
| cpu<br />
| {{no}}<br />
| {{no}}<br />
| {{no}}<br />
| {{yes}}<br />
| {{yes}}<br />
| {{NA}}<br />
| {{yes}}<br />
|some os<br />
| {{NA}}<br />
| {{wip}}<br />
| V12.3<br />
|-<br />
| R-type MXU<br />
| Positronic<br />
| Quantum X<br />
| armadillo<br />
| {{yes}}<br />
| HDMI <br />
| AVRBONGO<br />
| Smugsung<br />
| vpu<br />
| vpu<br />
| cpu<br />
| {{no}}<br />
| {{no}}<br />
| {{no}}<br />
| {{yes}}<br />
| {{yes}}<br />
| {{NA}}<br />
| {{yes}}<br />
| LinWinDrA<br />
| {{no}}<br />
| {{wip}}<br />
| V14-alpha1-7asd43e<br />
|}<br />
<br />
== audio hardware ==<br />
{| class="prettytable" style="text-align: center; color: black;"<br />
! colspan="23" style="background-color:#E6E6E6;" | '''Hardware and audio playback compatibility<br/>'''<br />
|-<br />
! colspan="5" style="background-color:#B8D0FF;" | '''HTPC Hardware'''<br />
! colspan="3" style="background-color:#FFE5CC;" | '''External Equipment'''<br />
! colspan="7" style="background-color:#DBFF94;" | '''Audio Capabilities<br/>'''<br />
! rowspan="2" style="background-color:#FFEBCC;" | '''Operative<br/>System'''<br />
! colspan="2" style="background-color:#E5FF97;" | '''Driver'''<br />
! rowspan="2" style="background-color:#B8D0FF;" | '''XBMC<br/>Version'''<br />
|-<br />
! style="color:#000000; background-color:#B8D0FF;" | '''Model'''<br />
! style="color:#000000; background-color:#B8D0FF;" | '''GPU - VPU type'''<br />
! style="color:#000000; background-color:#B8D0FF;" | '''Audio device'''<br />
! style="color:#000000; background-color:#B8D0FF;" | '''Code Name'''<br />
! style="color:#000000; background-color:#B8D0FF;" | '''Limitation'''<br />
! style="color:#000000; background-color:#FFE5CC;" | '''Plug'''<br />
! style="color:#000000; background-color:#FFE5CC;" | '''Receiver'''<br />
! style="color:#000000; background-color:#FFE5CC;" | '''Television'''<br />
! style="color:#000000; background-color:#DBFF94;" | '''AC3'''<br />
! style="color:#000000; background-color:#DBFF94;" | '''LPCM'''<br />
! style="color:#000000; background-color:#DBFF94;" | '''DTS'''<br />
! style="color:#000000; background-color:#DBFF94;" | '''DTS-HD MA'''<br />
! style="color:#000000; background-color:#DBFF94;" | '''DTS-HD'''<br />
! style="color:#000000; background-color:#DBFF94;" | '''TrueHD'''<br />
! style="color:#000000; background-color:#DBFF94;" | '''DD+/E-AC3'''<br />
! style="color:#000000; background-color:#E5FF97;" | '''Version'''<br />
! style="color:#000000; background-color:#E5FF97;" | '''Limitation'''<br />
|-<br />
| ASRock E350M1 <br />
| Radeon HD 6310<br />
| {{?}}<br />
| Wrestler<br />
| {{No}}<br />
| '''HDMI'''<br />
| '''Onkyo HT-R380'''<br />
| {{?}}<br />
| {{Yes}}<br />
| {{?}}<br />
| {{Yes}}<br />
| {{Yes}}<br />
| {{Yes}}<br />
| {{Yes}}<br />
| {{?}}<br />
| Windows 8 Pro, x64<br />
| '''13.2 Beta6'''<br />
| {{No}}<br />
| {{?}}<br />
|-<br />
| ASRock E350M1 <br />
| Radeon HD 6310<br />
| {{?}}<br />
| Wrestler<br />
| {{No}}<br />
| '''HDMI'''<br />
| '''Onkyo HT-R380'''<br />
| {{?}}<br />
| {{yes}}<br />
| {{?}}<br />
| {{yes}}<br />
| {{No}}<br />
| {{No}}<br />
| {{No}}<br />
| {{?}}<br />
| OpenELEC 3.0 RC4 (2.99.4)<br />
| '''12.10'''<br />
| {{No}}<br />
| {{?}}<br />
|-<br />
| ZOTAC ZBOX AD04 PLUS<br />
| Radeon HD 6320<br />
| {{?}}<br />
| Zacate<br />
| {{Yes}}<br />
| '''HDMI'''<br />
| '''Denon AVR-1713'''<br />
| {{?}}<br />
| {{yes}}<br />
| {{Yes}}<br />
| {{No}}<br />
| {{No}}<br />
| {{no}}<br />
| {{?}}<br />
| {{yes}}<br />
| XBMCbuntu 12.0 "FRODO"<br />
| {{?}}<br />
| {{yes}}<br />
| XBMC v12.0<br />
|-<br />
| Zotac ZBOX AD06<br />
| Radeon HD 7340<br />
| {{?}}<br />
| Zacate<br />
| {{Yes}}<br />
| '''HDMI'''<br />
| '''Samsung AV-R720'''<br />
| {{?}}<br />
| {{Yes}}<br />
| {{Yes}}<br />
| {{No}}<br />
| {{No}}<br />
| {{No}}<br />
| {{?}}<br />
| {{Yes}}<br />
| OpenELEC 3.0.0<br />
| '''12.10?'''<br />
| {{yes}}<br />
| {{?}}<br />
|-<br />
| M5A78L-M/USB3<br />
| Radeon HD 6850<br />
| {{?}}<br />
| Barts<br />
| {{no}}<br />
| '''HDMI'''<br />
| '''Denon AVR-4310'''<br />
| {{?}}<br />
| {{Yes}}<br />
| {{Yes}}<br />
| {{Yes}}<br />
| {{Yes}}<br />
| {{Yes}}<br />
| {{Yes}}<br />
| {{Yes}}<br />
| OpenELEC (official) - 3.2.4 x64<br />
| {{?}}<br />
| {{no}}<br />
| {{?}}<br />
|-<br />
|}<br />
<br />
= '''Video harware setups reported to work avr-tv-htpc combo''' =<br />
{{mininav|[[Audio hardware compatibility]]}}<br />
{{wiki revamp}}{{progress|55}}<br />
;If you ever asked the questions:<br />
<br />
* What HTPC should I get?<br />
* What TV Should I get?<br />
* What AVR/Receiver should I get?<br />
* What Combination of the above 3 work best?<br />
* What OS should XBMC be on?<br />
* What drivers if any are reported to work?<br />
* What limitations does this machine/setup have over another?<br />
* What General capabilities does it have be it xyz audio/video?<br />
<br />
;Then this page is for you, ideally!<br />
<br />
<br />
{{greenv| Notice:| This page is a user generated/driven content, with their hardware and setup's that work or dont work in any of these situations.}}<br />
{{bluev| Updating:| Feel free to update this list accordingly and add fields to table for other video types your hardware can or cant do.}}<br />
<br />
<big>'''''Please add your experience below.'''''</big><br />
<br />
== Legend key ==<br />
{{legendav}}<br />
<br />
== Video hardware capabilities and reported to work ==<br />
<br />
{{note|'''H265''' a.k.a. '''HEVC''' is not yet supported in XBMC (as of XBMC v13) Until next ffmpeg bump}}<br />
<br />
{| class="prettytable" style="text-align: center; color: black;"<br />
! {{VWorklistHeader}}<br />
|-<br />
| '''fictitious'''<br />
| '''ugabuga'''<br />
| '''holahoops'''<br />
| '''armadillo'''<br />
| {{yes}}<br />
| '''HDMI''' <br />
| '''AVRBONGO'''<br />
| '''Smugsung'''<br />
| '''cpu'''<br />
| '''gpu'''<br />
| '''vpu'''<br />
| {{?}}<br />
| {{no}}<br />
| {{no}}<br />
| {{yes}}<br />
| {{yes}}<br />
| {{NA}}<br />
| {{yes}}<br />
| '''Liwindra os'''<br />
| {{?}}<br />
| {{wip}}<br />
| V14-alpha1-7asd43e<br />
|}<br />
<br />
<noinclude><br />
[[Category:Hardware]]<br />
</noinclude><br />
<br />
= '''Audio hardware setups reported to work htpc-avr-tv combos''' =<br />
{{mininav|[[Video hardware compatibility]]}}<br />
{{wiki revamp}}{{progress|65}}<br />
<br />
;If you ever asked the questions:<br />
<br />
* What HTPC should I get?<br />
* What TV Should I get?<br />
* What AVR/Receiver should I get?<br />
* What Combination of the above 3 work best?<br />
* What OS should XBMC be on?<br />
* What drivers if any are reported to work?<br />
* What limitations does this machine/setup have over another?<br />
* What General capabilities does it have be it xyz audio/video?<br />
<br />
;Then this page is for you, ideally!<br />
<br />
<br />
{{greenv| Notice:| This page is a user generated/driven content, with their hardware and setup's that work or dont work in any of these situations.}}<br />
{{bluev| Updating:| Feel free to update this list accordingly and add fields to table for other video types your hardware can or cant do.}}<br />
<br />
<big>'''''Please add your experience below.'''''</big><br />
<br />
== Legend key ==<br />
{{legendav}}<br />
<br />
== Audio hardware capabilities and reported to work ==<br />
<br />
{{note|'''Dolby Digital Plus''' a.k.a. '''DD+ or E-AC-3''' is supported in AE > ActiveAE (as of XBMC v13) and will not work properly in XBMC 12.3 or Older.}}<br />
<br />
== AMD Based ==<br />
{| class="prettytable" style="text-align: center; color: black;"<br />
! {{AWorklistHeader}}<br />
|-<br />
| AMD A4-2800K APU<br />
| Radeon HD 6450M<br />
| {{?}}<br />
| Caicos<br />
| {{no}}<br />
| '''HDMI'''<br />
| '''Denon'''<br />
| {{?}}<br />
| {{Yes}}<br />
| {{Yes}}<br />
| {{Yes}}<br />
| {{NA}}<br />
| {{Yes}}<br />
| {{Yes}}<br />
| {{Yes}}<br />
| Windows 7 x64 Pro<br />
| '''12.1'''<br />
| {{no}}<br />
| {{?}}<br />
|-<br />
| AMD A4-3400 APU<br />
| Radeon HD 6410D<br />
| {{?}}<br />
| WinterPark<br />
| {{no}}<br />
| {{?}}<br />
| {{?}}<br />
| {{?}}<br />
| {{Yes}}<br />
| {{Yes}}<br />
| {{yes}}<br />
| {{NA}}<br />
| {{?}}<br />
| {{?}}<br />
| {{?}}<br />
| Windows 8 RTM<br />
| '''5.12.0.13'''<br />
| {{no}}<br />
| {{?}}<br />
|-<br />
| AMD A6-5400K APU <br />
| Radeon HD 7540D<br />
| {{?}}<br />
| Trinity<br />
| {{no}}<br />
| '''HDMI'''<br />
| '''Onkyo TX-NR626'''<br />
| {{?}}<br />
| {{Yes}}<br />
| {{Yes}}<br />
| {{Yes}}<br />
| {{NA}}<br />
| {{Yes}}<br />
| {{Yes}}<br />
| {{?}}<br />
| Windows 8 Pro, x64<br />
| '''9.0.0.9903'''<br />
| {{no}}<br />
| {{?}}<br />
|-<br />
| AMD A8-3870K APU<br />
| Radeon HD 6550D<br />
| {{?}}<br />
| BeaverCreek<br />
| {{no}}<br />
| {{?}}<br />
| {{?}}<br />
| {{?}}<br />
| {{Yes}}<br />
| {{No}}<br />
| {{Yes}}<br />
| {{No}}<br />
| {{No}}<br />
| {{No}}<br />
| {{?}}<br />
| Ubuntu 12.04 LTS<br />
| '''12.1'''<br />
| {{Yes}}<br />
| {{?}}<br />
|-<br />
| AMD A8-3870K APU<br />
| Radeon HD 6550D<br />
| {{?}}<br />
| BeaverCreek<br />
| {{no}}<br />
| {{?}}<br />
| {{?}}<br />
| {{?}}<br />
| {{?}}<br />
| {{yes}}<br />
| {{?}}<br />
| {{?}}<br />
| {{Yes}}<br />
| {{yes}}<br />
| {{?}}<br />
| Windows 7 x64 Pro<br />
| '''12.4'''<br />
| {{no}}<br />
| {{?}}<br />
|-<br />
| ASRock E350M1 <br />
| Radeon HD 6310<br />
| {{?}}<br />
| Wrestler<br />
| {{No}}<br />
| '''HDMI'''<br />
| '''Onkyo HT-R380'''<br />
| {{?}}<br />
| {{Yes}}<br />
| {{?}}<br />
| {{Yes}}<br />
| {{Yes}}<br />
| {{Yes}}<br />
| {{Yes}}<br />
| {{?}}<br />
| Windows 8 Pro, x64<br />
| '''13.2 Beta6'''<br />
| {{No}}<br />
| {{?}}<br />
|-<br />
| ASRock E350M1 <br />
| Radeon HD 6310<br />
| {{?}}<br />
| Wrestler<br />
| {{No}}<br />
| '''HDMI'''<br />
| '''Onkyo HT-R380'''<br />
| {{?}}<br />
| {{yes}}<br />
| {{?}}<br />
| {{yes}}<br />
| {{No}}<br />
| {{No}}<br />
| {{No}}<br />
| {{?}}<br />
| OpenELEC 3.0 RC4 (2.99.4)<br />
| '''12.10'''<br />
| {{No}}<br />
| {{?}}<br />
|-<br />
| Asus E45M1-I Deluxe<br />
| Radeon HD 6320<br />
| {{?}}<br />
| Zacate<br />
| {{Yes}}<br />
| '''HDMI'''<br />
| '''Denon AVR-3312'''<br />
| {{?}}<br />
| {{Yes}}<br />
| {{Yes}}<br />
| {{No}}<br />
| {{No}}<br />
| {{No}}<br />
| {{?}}<br />
| {{Yes}}<br />
| OpenELEC 3.0 (RC 1)<br />
| '''12.10'''<br />
| {{yes}}<br />
| {{?}}<br />
|-<br />
| ZOTAC ZBOX AD04 PLUS<br />
| Radeon HD 6320<br />
| {{?}}<br />
| Zacate<br />
| {{Yes}}<br />
| '''HDMI'''<br />
| '''Denon AVR-1713'''<br />
| {{?}}<br />
| {{yes}}<br />
| {{Yes}}<br />
| {{No}}<br />
| {{No}}<br />
| {{no}}<br />
| {{?}}<br />
| {{yes}}<br />
| XBMCbuntu 12.0 "FRODO"<br />
| {{?}}<br />
| {{yes}}<br />
| XBMC v12.0<br />
|-<br />
| Zotac ZBOX AD06<br />
| Radeon HD 7340<br />
| {{?}}<br />
| Zacate<br />
| {{Yes}}<br />
| '''HDMI'''<br />
| '''Samsung AV-R720'''<br />
| {{?}}<br />
| {{Yes}}<br />
| {{Yes}}<br />
| {{No}}<br />
| {{No}}<br />
| {{No}}<br />
| {{?}}<br />
| {{Yes}}<br />
| OpenELEC 3.0.0<br />
| '''12.10?'''<br />
| {{yes}}<br />
| {{?}}<br />
|-<br />
| M5A78L-M/USB3<br />
| Radeon HD 6850<br />
| {{?}}<br />
| Barts<br />
| {{no}}<br />
| '''HDMI'''<br />
| '''Denon AVR-4310'''<br />
| {{?}}<br />
| {{Yes}}<br />
| {{Yes}}<br />
| {{Yes}}<br />
| {{Yes}}<br />
| {{Yes}}<br />
| {{Yes}}<br />
| {{Yes}}<br />
| OpenELEC (official) - 3.2.4 x64<br />
| {{?}}<br />
| {{no}}<br />
| {{?}}<br />
|-<br />
|}<br />
<br />
== Nvidia Based ==<br />
{| class="prettytable" style="text-align: center; color: black;"<br />
! {{AWorklistHeader}}<br />
|-<br />
| Gigabyte GV-N560OC-1GI<br />
| GeForce GTX 560<br />
| {{?}}<br />
| GF110/GF114<br />
| {{no}}<br />
| '''HDMI'''<br />
| {{NA}}<br />
| {{?}}<br />
| {{yes}}<br />
| {{yes}}<br />
| {{yes}}<br />
| {{NA}}<br />
| {{yes}}<br />
| {{yes}}<br />
| {{yes}}<br />
| OpenELEC 3.0<br />
| '''313.09'''<br />
| {{no}}<br />
| Frodo 12.1<br />
|-<br />
| Asus ENGT430 DC SL DI<br />
| GeForce GT 430<br />
| {{?}}<br />
| GF108<br />
| {{no}}<br />
| '''HDMI'''<br />
| {{NA}}<br />
| {{?}}<br />
| {{Yes}}<br />
| {{yes}}<br />
| {{yes}}<br />
| {{NA}}<br />
| {{yes}}<br />
| {{yes}}<br />
| {{yes}}<br />
| Ubuntu 12.04 LTS<br />
| '''295.59'''<br />
| {{no}}<br />
| Frodo 12.2<br />
|-<br />
| Asus ENGT520<br />
| GeForce GT 520<br />
| {{?}}<br />
| GF119<br />
| {{no}}<br />
| '''HDMI'''<br />
| '''Yamaha/HTR-4063'''<br />
| {{?}}<br />
| {{Yes}}<br />
| {{yes}}<br />
| {{yes}}<br />
| {{NA}}<br />
| {{yes}}<br />
| {{yes}}<br />
| {{yes}}<br />
| Debian Wheezy<br />
| '''310.19'''<br />
| {{no}}<br />
| {{?}}<br />
|-<br />
| EVGA GTX550<br />
| GeForce GTX 550 ti<br />
| {{?}}<br />
| GF116<br />
| {{no}}<br />
| '''HDMI'''<br />
| '''Sony/STR-DN610'''<br />
| {{?}}<br />
| {{Yes}}<br />
| {{Yes}}<br />
| {{Yes}}<br />
| {{NA}}<br />
| {{yes}}<br />
| {{yes}}<br />
| {{yes}}<br />
| Ubuntu 12.10<br />
| '''304.43'''<br />
| {{no}}<br />
| {{?}}<br />
|-<br />
| Asus ENGTX560<br />
| GTX 560 TI<br />
| {{?}}<br />
| GF110/GF114<br />
| {{no}}<br />
| {{?}}<br />
| {{?}}<br />
| {{?}}<br />
| {{Yes}}<br />
| {{Yes}}<br />
| {{Yes}}<br />
| {{NA}}<br />
| {{Yes}}<br />
| {{Yes}}<br />
| {{?}}<br />
| Ubuntu 12.04 LTS<br />
| '''304.43'''<br />
| {{no}}<br />
| {{?}}<br />
|-<br />
| Palit GT640<br />
| GeForce GT 640<br />
| {{?}}<br />
| GK107<br />
| {{no}}<br />
| {{?}}<br />
| {{?}}<br />
| {{?}}<br />
| {{Yes}}<br />
| {{Yes}}<br />
| {{Yes}}<br />
| {{NA}}<br />
| {{Yes}}<br />
| {{Yes}}<br />
| {{Yes}}<br />
| Ubuntu 12.04 LTS<br />
| '''304.43'''<br />
| {{No}}<br />
| {{?}}<br />
|-<br />
| Asus GT610-SL-1GD3-L<br />
| Geforce GT610<br />
| {{?}}<br />
| GF119<br />
| {{no}}<br />
| '''HDMI'''<br />
| '''Onkyo TX-NR807'''<br />
| {{?}}<br />
| {{Yes}}<br />
| {{Yes}}<br />
| {{Yes}}<br />
| {{NA}}<br />
| {{Yes}}<br />
| {{Yes}}<br />
| {{Yes}}<br />
| Slackware 13.37<br />
| '''310.19'''<br />
| {{No}}<br />
| {{?}}<br />
|-<br />
| Zotac GT430 Zone Edition<br />
| GeForce GT 430<br />
| {{?}}<br />
| GF108<br />
| {{no}}<br />
| {{?}}<br />
| {{?}}<br />
| {{?}}<br />
| {{Yes}}<br />
| {{yes}}<br />
| {{yes}}<br />
| {{NA}}<br />
| {{yes}}<br />
| {{yes}}<br />
| {{yes}}<br />
| Windows 7 x64 Pro<br />
| '''306.97'''<br />
| {{no}}<br />
| {{?}}<br />
|-<br />
| Asrock ION 330HT<br />
| GeForce 9400M G<br />
| gpu - #dev2<br />
| G96a/G96b<br />
| {{Yes}}<br />
| '''HDMI'''<br />
| {{?}}<br />
| '''Samsung<br/>Series 5'''<br />
| {{Yes}}<br />
| {{yes}}<br />
| {{yes}}<br />
| {{NA}}<br />
| {{no}}<br />
| {{no}}<br />
| {{?}}<br />
| Ubuntu 12.04.4 LTS<br />
| '''304.64'''<br />
| {{no}}<br />
| XBMC-V13alpha7<br />
|-<br />
| ZOTAC GT 610 ZONE Ed.<br />
| Geforce GT610<br />
| {{?}}<br />
| GF119<br />
| {{no}}<br />
| '''HDMI'''<br />
| '''Onkyo TX-SR608'''<br />
| {{?}}<br />
| {{Yes}}<br />
| {{Yes}}<br />
| {{Yes}}<br />
| {{NA}}<br />
| {{yes}}<br />
| {{yes}}<br />
| {{yes}}<br />
| Win8 64bit + XBMCbuntu<br />
| '''331.65'''<br />
| {{no}}<br />
| {{?}}<br />
|-<br />
|}<br />
<br />
== Intel Based ==<br />
{| class="prettytable" style="text-align: center; color: black;"<br />
! colspan="23" style="background-color:#E6E6E6;" | '''Hardware and audio playback compatibility<br/>'''<br />
|-<br />
| {{AWorklistHeader}}<br />
|-<br />
| EXAMPLE<br />
| HD4000<br />
| {{?}}<br />
| {{NA}}<br />
| {{no}}<br />
| 313.09<br />
| {{No}}<br />
| '''HDMI'''<br />
| {{NA}}<br />
| '''Smugsung X'''<br />
| {{Yes}}<br />
| {{Yes}}<br />
| {{Yes}}<br />
| {{Yes}}<br />
| {{?}}<br />
| {{Yes}}<br />
| {{?}}<br />
| XBMCbuntu v13<br />
| '''V13-beta3-e3sd46g<br />
|}<br />
<br />
<noinclude><br />
[[Category:Audio]]<br />
[[Category:Hardware]]<br />
</noinclude><br />
<br />
= '''Editor references''' =<br />
==== Old AMD audio table / format ====<br />
{| class="prettytable" style="text-align: center; color: black;"<br />
! colspan="23" style="background-color:#E6E6E6;" | '''Hardware and audio playback compatibility<br/>'''<br />
|-<br />
! style="color:#000000; background-color:#DBDBDB;" | '''Model Name'''<br />
! style="color:#000000; background-color:#DBDBDB;" | '''GPU'''<br />
! style="color:#000000; background-color:#DBDBDB;" | '''Code Name'''<br />
! style="color:#000000; background-color:#DBDBDB;" | '''AC3'''<br />
! style="color:#000000; background-color:#DBDBDB;" | '''LPCM'''<br />
! style="color:#000000; background-color:#DBDBDB;" | '''DTS'''<br />
! style="color:#000000; background-color:#DBDBDB;" | '''DTS-HD MA'''<br />
! style="color:#000000; background-color:#DBDBDB;" | '''DTS-HD'''<br />
! style="color:#000000; background-color:#DBDBDB;" | '''TrueHD'''<br />
! style="color:#000000; background-color:#DBDBDB;" | '''DD+/E-AC3'''<br />
! style="color:#000000; background-color:#DBDBDB;" | '''Driver Version'''<br />
! style="color:#000000; background-color:#DBDBDB;" | '''Driver limitation'''<br />
! style="color:#000000; background-color:#DBDBDB;" | '''HW Limitation'''<br />
! style="color:#000000; background-color:#DBDBDB;" | '''Plug'''<br />
! style="color:#000000; background-color:#DBDBDB;" | '''Receiver'''<br />
! style="color:#000000; background-color:#DBDBDB;" | '''Operating System'''<br />
||||||<br />
|-<br />
| AMD A4-2800K APU<br />
| Radeon HD 6450M<br />
| Caicos<br />
| {{Yes}}<br />
| {{Yes}}<br />
| {{Yes}}<br />
| {{Yes}}<br />
| {{Yes}}<br />
| {{Yes}}<br />
| {{?}}<br />
| 12.1<br />
| {{No}}<br />
| {{No}}<br />
| '''HDMI'''<br />
| '''Denon'''<br />
| Windows 7 x64 Pro<br />
|-<br />
| AMD A4-3400 APU<br />
| Radeon HD 6410D<br />
| WinterPark<br />
| {{Yes}}<br />
| {{Yes}}<br />
| {{Yes}}<br />
| {{?}}<br />
| {{?}}<br />
| {{Yes}}<br />
| {{?}}<br />
| 5.12.0.13<br />
| {{No}}<br />
| {{No}}<br />
| {{?}}<br />
| {{?}}<br />
| Windows 8 RTM<br />
|-<br />
| AMD A6-5400K APU <br />
| Radeon HD 7540D<br />
| Trinity<br />
| {{Yes}}<br />
| {{Yes}}<br />
| {{Yes}}<br />
| {{Yes}}<br />
| {{Yes}}<br />
| {{Yes}}<br />
| {{?}}<br />
| 9.0.0.9903<br />
| {{No}}<br />
| {{No}}<br />
| '''HDMI'''<br />
| '''Onkyo TX-NR626'''<br />
| Windows 8 Pro, x64<br />
|-<br />
| AMD A8-3870K APU<br />
| Radeon HD 6550D<br />
| BeaverCreek<br />
| {{Yes}}<br />
| {{No}}<br />
| {{Yes}}<br />
| {{No}}<br />
| {{No}}<br />
| {{No}}<br />
| {{?}}<br />
| 12.1<br />
| {{Yes}}<br />
| {{No}}<br />
| {{?}}<br />
| {{?}}<br />
| Ubuntu 12.04 LTS<br />
|-<br />
| AMD A8-3870K APU<br />
| Radeon HD 6550D<br />
| BeaverCreek<br />
| {{?}}<br />
| {{Yes}}<br />
| {{?}}<br />
| {{Yes}}<br />
| {{?}}<br />
| {{Yes}}<br />
| {{?}}<br />
| 12.4<br />
| {{No}}<br />
| {{No}}<br />
| {{?}}<br />
| {{?}}<br />
| Windows 7 x64 Pro<br />
|-<br />
| ASRock E350M1 <br />
| Radeon HD 6310<br />
| Wrestler<br />
| {{Yes}}<br />
| {{?}}<br />
| {{Yes}}<br />
| {{Yes}}<br />
| {{Yes}}<br />
| {{Yes}}<br />
| {{?}}<br />
| 13.2 Beta6<br />
| {{No}}<br />
| {{No}}<br />
| '''HDMI'''<br />
| '''Onkyo HT-R380'''<br />
| Windows 8 Pro, x64<br />
|-<br />
| ASRock E350M1 <br />
| Radeon HD 6310<br />
| Wrestler<br />
| {{Yes}}<br />
| {{?}}<br />
| {{Yes}}<br />
| {{No}}<br />
| {{No}}<br />
| {{No}}<br />
| {{?}}<br />
| 12.10<br />
| {{Yes}}<br />
| {{No}}<br />
| '''HDMI'''<br />
| '''Onkyo HT-R380'''<br />
| OpenELEC 3.0 RC4 (2.99.4)<br />
<br />
|-<br />
| Asus E45M1-I Deluxe<br />
| Radeon HD 6320<br />
| Zacate<br />
| {{Yes}}<br />
| {{Yes}}<br />
| {{Yes}}<br />
| {{No}}<br />
| {{No}}<br />
| {{No}}<br />
| {{?}}<br />
| 12.10<br />
| {{Yes}}<br />
| {{No}}<br />
| '''HDMI'''<br />
| '''Denon AVR-3312'''<br />
| OpenELEC 3.0 (RC 1)<br />
|-<br />
| ZOTAC ZBOX AD04 PLUS<br />
| Radeon HD 6320<br />
| Zacate<br />
| {{Yes}}<br />
| {{yes}}<br />
| {{Yes}}<br />
| {{No}}<br />
| {{No}}<br />
| {{no}}<br />
| {{?}}<br />
| {{?}}<br />
| {{Yes}}<br />
| {{No}}<br />
| '''HDMI'''<br />
| '''Denon AVR-1713'''<br />
| XBMCbuntu 12.0 "FRODO"<br />
|-<br />
| Zotac ZBOX AD06<br />
| Radeon HD 7340<br />
| Zacate<br />
| {{Yes}}<br />
| {{Yes}}<br />
| {{Yes}}<br />
| {{No}}<br />
| {{No}}<br />
| {{No}}<br />
| {{?}}<br />
| 12.10?<br />
| {{Yes}}<br />
| {{No}}<br />
| '''HDMI'''<br />
| '''Samsung AV-R720'''<br />
| OpenELEC 3.0.0<br />
|-<br />
| M5A78L-M/USB3<br />
| Radeon HD 6850<br />
| Barts<br />
| {{Yes}}<br />
| {{Yes}}<br />
| {{Yes}}<br />
| {{Yes}}<br />
| {{Yes}}<br />
| {{Yes}}<br />
| {{Yes}}<br />
| {{?}}<br />
| {{No}}<br />
| {{No}}<br />
| '''HDMI'''<br />
| '''Denon AVR-4310'''<br />
| OpenELEC (official) - 3.2.4 x64<br />
|-<br />
|}<br />
<br />
=== Legend key Template ===<br />
{|class="prettytable" style="text-align: center; color: black;"<br />
! colspan="17" style="background-color:#F1F1F1;"|'''Legend - Templates - Formatting'''<br />
|-<br />
| colspan="5" style="background-color:#EAD1FF;" | '''General use indicator'''<br />
| colspan="1" style="background-color:#E5FF97;" | '''Decode indicator'''<br />
! colspan="7" style="background-color:#B8D0FF;" | '''HTPC H/W Codename lookup'''<br />
! colspan="4" style="background-color:#FFE5CC;" | '''External equipment'''<br />
|-<br />
| {{yes}}<br />
| {{no}}<br />
| {{NA}}<br />
| {{wip}}<br />
| {{?}}<br />
| ''' cpu - vpu - gpu '''<br />
| rowspan="2" | [http://en.wikipedia.org/wiki/Comparison_of_AMD_graphics_processing_units See: <br/>ATI]<br />
| rowspan="2" | [http://en.wikipedia.org/wiki/Comparison_of_Nvidia_graphics_processing_units See: <br/>Nvidia]<br />
| rowspan="2" | [http://en.wikipedia.org/wiki/Comparison_of_Intel_graphics_processing_units See: <br/>Intel]<br />
| rowspan="2" | [http://en.wikipedia.org/wiki/Allwinner_Technology See: <br/>allwinner]<br />
| rowspan="2" | [http://en.wikipedia.org/wiki/I.MX#i.MX6x_series See: <br/>Freescale]<br />
| rowspan="2" | [http://en.wikipedia.org/wiki/ARM_architecture See: <br/>ARM]<br />
| rowspan="2" | [http://en.wikipedia.org/wiki/Comparison_of_Android_devices See: <br/>Android]<br />
! colspan="4" style="background-color:#FFE5CC;" | '''Plug - Receiver - TV / models'''<br />
|- <br />
| <nowiki>{{yes}}</nowiki><br />
| <nowiki>{{no}}</nowiki><br />
| <nowiki>{{NA}}</nowiki><br />
| <nowiki>{{wip}}</nowiki><br />
| <nowiki>{{?}}</nowiki><br />
| <nowiki>''' cpu - vpu - gpu '''</nowiki><br />
| <nowiki>'''HDMI'''</nowiki><br />
| <nowiki>'''Optical'''</nowiki><br />
| <nowiki>'''Analog'''</nowiki><br />
| <nowiki>'''TV - AVR / Model'''</nowiki><br />
|}<br />
<br />
=== AVWorklistHeader Template ===<br />
{|class="prettytable" style="text-align: center; color: black;"<br />
! colspan="19" style="background-color:#F1F1F1;"|'''Audio - Templates - Formatting'''<br />
|-<br />
! colspan="5" style="background-color:#B8D0FF;" | '''HTPC Hardware'''<br />
! colspan="3" style="background-color:#FFE5CC;" | '''External Equipment'''<br />
! colspan="7" style="background-color:#DBFF94;" | '''Audio Capabilities<br/>'''<br />
! rowspan="2" style="background-color:#FFEBCC;" | '''Operative<br/>System'''<br />
! colspan="2" style="background-color:#E5FF97;" | '''Driver'''<br />
! rowspan="2" style="background-color:#B8D0FF;" | '''XBMC<br/>Version'''<br />
|-<br />
! style="color:#000000; background-color:#B8D0FF;" | '''Model'''<br />
! style="color:#000000; background-color:#B8D0FF;" | '''GPU - VPU type'''<br />
! style="color:#000000; background-color:#B8D0FF;" | '''Audio device'''<br />
! style="color:#000000; background-color:#B8D0FF;" | '''Code Name'''<br />
! style="color:#000000; background-color:#B8D0FF;" | '''Limitation'''<br />
! style="color:#000000; background-color:#FFE5CC;" | '''Plug'''<br />
! style="color:#000000; background-color:#FFE5CC;" | '''Receiver'''<br />
! style="color:#000000; background-color:#FFE5CC;" | '''Television'''<br />
! style="color:#000000; background-color:#DBFF94;" | '''AC3'''<br />
! style="color:#000000; background-color:#DBFF94;" | '''LPCM'''<br />
! style="color:#000000; background-color:#DBFF94;" | '''DTS'''<br />
! style="color:#000000; background-color:#DBFF94;" | '''DTS-HD MA'''<br />
! style="color:#000000; background-color:#DBFF94;" | '''DTS-HD'''<br />
! style="color:#000000; background-color:#DBFF94;" | '''TrueHD'''<br />
! style="color:#000000; background-color:#DBFF94;" | '''DD+/E-AC3'''<br />
! style="color:#000000; background-color:#E5FF97;" | '''Version'''<br />
! style="color:#000000; background-color:#E5FF97;" | '''Limitation'''<br />
|}<br />
<br />
=== VWorklistHeader Template ===<br />
{|class="prettytable" style="text-align: center; color: black;"<br />
! colspan="23" style="background-color:#E6E6E6;" | '''Hardware and video playback compatibility<br/>'''<br />
|-<br />
! colspan="5" style="background-color:#B8D0FF;" | '''HTPC Hardware'''<br />
! colspan="3" style="background-color:#FFE5CC;" | '''External Equipment'''<br />
! style="background-color:#DBDBFF;" | '''Decoder'''<br />
! colspan="10" style="background-color:#E5FF97;" | '''Capabilities<br/>'''<br />
! rowspan="2" style="background-color:#FFEBCC;" | '''Operative<br/>System'''<br />
! colspan="2" style="background-color:#E5FF97;" | '''Driver'''<br />
! rowspan="2" style="background-color:#B8D0FF;" | '''XBMC<br/>Version'''<br />
|-<br />
! style="background-color:#B8D0FF;" | '''Model'''<br />
! style="background-color:#B8D0FF;" | '''GPU - VPU type'''<br />
! style="background-color:#B8D0FF;" | '''CPU type'''<br />
! style="background-color:#B8D0FF;" | '''Code Names'''<br />
! style="background-color:#B8D0FF;" | '''Limitation'''<br />
| style="background-color:#FFE5CC;" | '''Plug'''<br />
| style="background-color:#FFE5CC;" | '''Reveiver'''<br />
| style="background-color:#FFE5CC;" | '''Television'''<br />
! rowspan="0" style="background-color:#DBDBFF;" | '''GPU<br/>VPU<br/>CPU<br/>'''<br />
| style="background-color:#E5FF97;" | '''H.262'''<br />
| style="background-color:#E5FF97;" | '''H.263'''<br />
| style="background-color:#E5FF97;" | '''H.264'''<br />
| style="background-color:#E5FF97;" | '''H.265'''<br />
| style="background-color:#E5FF97;" | '''MPEG-4v3'''<br />
| style="background-color:#E5FF97;" | '''WMV'''<br />
| style="background-color:#E5FF97;" | '''On2'''<br />
| style="background-color:#E5FF97;" | '''720/1080'''<br />
| style="background-color:#E5FF97;" | '''Blu-ray'''<br />
| style="background-color:#E5FF97;" | '''3D'''<br />
! style="background-color:#E5FF97;" | '''Version'''<br />
! style="background-color:#E5FF97;" | '''Limitation'''<br />
|}<br />
<br />
== Package management F.A.Q. ==<br />
Here we give detailed information on '''Advanced Packaging Tool''', a.k.a. '''APT'''. and the necessary commands to retrieve, install, update, upgrade and or remove the application also known as XBMC or Kodi on Ubuntu and variants such as XBMCbuntu/KodiBuntu. Such information is widespread on any Ubuntu documentation and is duplicated here for simplicity and general user base benefit.<br />
<br />
<section begin="package_maintenance" /><br />
{| width="100%"<br />
{{FAQ|1=Why_XBMC_ppa<br />
| BGcolor=whitesmoke<br />
| Question= Why are XBMC packages from Ubuntu repositories incorrect?<br />
| Answer=<br />
The simple answer is that, these packages derive from externally modified XBMC versions which are either '''outdated''' and '''broken''' or both, and are 100% officially '''unsupported''' at this time.<br />
<br />
The main thing you must understand is that if you looking for supported official builds, you simply should not use other repositories, unless otherwise indicated by a Team Member or a informed community member.<br />
}}<br />
<br />
{{FAQ|1=Dependencies<br />
| BGcolor=<br />
| Question=Are any dependencies required to manage repo's or ppa's?<br />
| Answer=<br />
Some dependencies are required to manage ppa's/repos within your distro, install these by typing:<br />
<source lang="bash" enclose="div"><br />
sudo apt-get install python-software-properties pkg-config<br />
</source><br />
}}<br />
<br />
{| width="100%"<br />
{{FAQ|1=What_ppa_do_I_have<br />
| BGcolor=whitesmoke<br />
| Question= How do I find out what repo/ppa I am currently using?<br />
| Answer=<br />
You can get a complete listing of what repositories are part of your sources list by typing:<br />
<source lang="bash" enclose="div"><br />
sudo apt-cache policy<br />
</source><br />
}}<br />
<br />
{{FAQ|1=Adding or removing ppas<br />
| BGcolor=<br />
| Question=How do I add or remove ppa's?<br />
| Answer=<br />
After you determined which ppa you would like to '''add''' or '''remove''' follow the instructions below.<br />
;You can remove a ppa from your distro's sources list via terminal, by typing:<br />
<source lang="bash" enclose="div"><br />
sudo add-apt-repository -r ppa:current_XBMC_providing_ppa<br />
</source><br />
<br />
;You can add a ppa to your distro's sources list via terminal, by typing:<br />
<br />
<source lang="bash" enclose="div"><br />
sudo add-apt-repository ppa:the_ppa_you_wish_to_use<br />
</source><br />
<br /><br />
}}<br />
{{note|<br />
* The process of adding and removing repositories is recommended when changing the repo's in use.<br />
* Changing the PPA repo for XBMC will change what type of install is used (stable, nightly, beta, etc).}}<br />
<br />
== Installing, updating or upgrading ==<br />
If applicable you can check what package versions are installed in your system, this is helpful when determining what procedures to choose.<br />
{{FAQ|1=check current version<br />
| BGcolor=whitesmoke<br />
| Question=How can check what current XBMC version is installed?<br />
| Answer=<br />
Check what XBMC versions you have access to:<br />
<source lang="bash"><br />
sudo apt-cache policy xbmc<br />
</source><br />
}}<br />
<br />
{{FAQ|1=Installing XBMC<br />
| BGcolor=<br />
| Question=How do I install XBMC?<br />
| Answer=<br />
After adding or removing any ppa you need to refresh your sources list and finally install XBMC, by typing:<br />
<syntaxhighlight lang="bash" enclose="div"><br />
sudo apt-get update<br />
sudo apt-get install xbmc xbmc-bin<br />
</syntaxhighlight><br />
}}<br />
<br />
{{FAQ|1=Updating XBMC<br />
| BGcolor=whitesmoke<br />
| Question=How do I update XBMC?<br />
| Answer=<br />
To update XBMC/Kodi when a new version is released, just do a general system/package or use the following commands in the terminal (or via [[SSH]]):<br />
<br />
<source lang="bash"><br />
sudo apt-get update<br />
sudo apt-get install xbmc xbmc-bin<br />
</source><br />
}}<br />
<br />
{{FAQ|1=Upgrading XBMC<br />
| BGcolor=<br />
| Question=How do I upgrade XBMC?<br />
| Answer=<br />
After adding or removing any ppa you need to refresh your sources list and finally upgrade xbmc, by typing:<br />
<syntaxhighlight lang="bash" enclose="div"><br />
sudo apt-get update<br />
sudo apt-get --only-upgrade install xbmc xbmc-bin<br />
</syntaxhighlight><br />
}}<br />
<section begin="whynoupgrade" /><br />
{{FAQ|1=XBMC wont upgrade<br />
| BGcolor=whitesmoke<br />
| Question=Why wont XBMC upgrade?<br />
| Answer=<br />
After following the above instructions, XBMC is still not upgraded, the main reason why this happens is because the distribution you are using, is no longer supported and has reached an '''''end of life status'''''.<br />
<br />
See [https://wiki.ubuntu.com/Releases Current Ubuntu releases] if your current distro is listed under End of life table, you will need to upgrade your OS to a supported release.<br />
<br />
LTS releases are better for long term install and forget, installing obviously the very latest LTS release available.<br />
{{#lst:XBMCbuntu FAQ|upgradeOS}}<br />
}}<section end="whynoupgrade" /><br />
<br />
{{FAQ|1=Specific package versions.<br />
| BGcolor=<br />
| Question=How to install a specific versions?<br />
| Answer=<br />
In the event you need to install either by upgrade or downgrade a specific XBMC version (a reason may be a bug or to test a specific version), the PPA providing said version active must be in your '''sources.list.d''' along with a updated list of the packages.<br />
If the packages you intend to install are on a different PPA, you should probably remove that PPA to avoid confusion.<br />
<code>apt-get install packagename=version</code> is one way to achieve this.<br />
<syntaxhighlight lang="bash" enclose="div"><br />
sudo apt-get update<br />
sudo apt-get install xbmc=2:13.1~git20140606.0917-gotham-0trusty xbmc-bin=2:13.1~git20140606.0917-gotham-0trusty <br />
</syntaxhighlight><br />
<br />
Hint: For e.g. You can use result of <code>apt-cache policy xbmc</code> to see the candidates <packagename><version> available to you.<br />
{{Note| Removing/purging any previous versions if they are greater version of the package you are looking to install is necessary.}}<br />
}}<br />
<br />
{{FAQ|1=beta_unstable<br />
| BGcolor=whitesmoke<br />
| Question=How can I install a beta/unstable version?<br />
| Answer=<br />
To install a beta/unstable version of XBMC you must first add the unstable repository, then install XBMC:<br />
<source lang="bash"><br />
sudo add-apt-repository ppa:team-xbmc/unstable<br />
sudo apt-get update<br />
sudo apt-get install xbmc xbmc-bin<br />
</source><br />
:;or:<br />
<source lang="bash"><br />
sudo add-apt-repository ppa:team-xbmc/nightly<br />
sudo apt-get update<br />
sudo apt-get install xbmc xbmc-bin<br />
</source><br />
Follow the prompts to add the repository, then to add the updates, and finally install the new version of XBMC.<br />
{{note|1=You may need to restart your computer for the newly installed version to be working.}}<br />
}}<br />
<br />
{{FAQ|1=beta_unstable_to_stable<br />
| BGcolor=<br />
| Question=How can I move from a beta/unstable to a stable version?<br />
| Answer=<br />
Check what XBMC versions you have access to by typing:<br />
<source lang="bash"><br />
sudo apt-cache policy xbmc<br />
</source><br />
<br />
The response in terminal should be something like:<br />
<source lang="xml"><br />
xbmc:<br />
Installed: 2:13.2~git20140719.0900-beta2-0trusty<br />
Candidate: 2:13.2~git20140719.0900-beta2-0trusty<br />
Version table:<br />
*** 2:13.2~git20140719.0900-beta2-0trusty 0<br />
500 http://ppa.launchpad.net/team-xbmc/unstable/ubuntu/ trusty/main amd64 Packages<br />
100 /var/lib/dpkg/status<br />
2:13.1~git20140606.0917-gotham-0trusty 0<br />
500 http://ppa.launchpad.net/team-xbmc/ppa/ubuntu/ trusty/main amd64 Packages<br />
2:12.3+dfsg1-3ubuntu1 0<br />
500 http://us.archive.ubuntu.com/ubuntu/ trusty/universe amd64 Packages<br />
</source><br />
{{note|1=In the above example we have an unstable ('''team-xbmc/unstable''') and the release versions ('''team-xbmc/ppa''') available. The version with the '''***''' is the currently installed version (unstable)}}<br />
<br />
To install the release version we need to install the team-xbmc/ppa version (in the above example: "2:13.1~git20140606.0917-gotham-0trusty"). This requires the install of both the [[Team_XBMC_PPA#Installing_XBMC |"'''xbmc'''" and the "'''xbmc-bin'''" package.]]<br />
<source lang="bash"><br />
sudo apt-get install xbmc=2:13.1~git20140606.0917-gotham-0trusty xbmc-bin=2:13.1~git20140606.0917-gotham-0trusty<br />
</source><br />
{{note|1=You will get a warning you are downgrading, hit Y when asked to continue}}<br />
<br />
Remove the beta/unstable repository from XBMC to clean up:<br />
<source lang="bash"><br />
sudo add-apt-repository -r ppa:team-xbmc/unstable<br />
</source><br />
}}<br />
<br />
== Uninstalling or Removing ==<br />
{{FAQ|1=Uninstalling XBMC<br />
| BGcolor=<br />
| Question=How do I uninstall XBMC?<br />
| Answer=<br />
If you need to remove and purge an application and finally removing/purging also the application configurations files, do so by typing:<br />
<syntaxhighlight lang="bash" enclose="div"><br />
sudo apt-get update<br />
sudo apt-get remove xbmc*<br />
sudo apt-get purge xbmc*<br />
</syntaxhighlight><br />
}}<section end="package_maintenance" /><br />
<br />
== Build Dependencies ==<br />
{{FAQ|1=PPA Build deps<br />
| BGcolor=whitesmoke<br />
| Question=What are PPA build dependencies?<br />
| Answer=<br />
These build dependencies are versions of a library pre-packaged by Team XBMC, because the distro provided versions are behind the current requirements of XBMC.<br />
Both [https://github.com/xbmc/xbmc/blob/master/docs/README.linux REAME.linux] and/or [https://github.com/xbmc/xbmc/blob/master/docs/README.ubuntu README.ubuntu] documents using XBMC ppa build dependencies refer to these dependencies in the Team XBMC PPA's used in conjunction, when compiling on Ubuntu or derivatives distros.<br />
}}<br />
|}<br />
<br />
== See also ==<br />
* [https://help.ubuntu.com/community/AptGet/Howto apt-get/How-to]</div>UNiversalhttps://kodi.wiki/index.php?title=Talk:Installing&diff=78919Talk:Installing2014-09-18T09:56:13Z<p>UNiversal: Created page with "== Something for the future == The ubuntu minimal install + Xbmc in standalone is also an option thought these instruction and how tos need updating. this menu goes here as ..."</p>
<hr />
<div>== Something for the future ==<br />
<br />
The ubuntu minimal install + Xbmc in standalone is also an option thought these instruction and how tos need updating.<br />
<br />
this menu goes here as a representation of that work in progress just from my reference on how to add it up later if required.<br />
<br />
==Standalone (linux)==<br />
{| width="100%" cellpadding="5"<br />
|- valign="top"<br />
| [[File:XBMCbuntu.png|60x60px|link=XBMCbuntu]]<br />
| width="50%" | {{big|'''[[XBMCbuntu]]'''}}<br />{{#lst:XBMCbuntu|intro}}<br />
| [[File:OpenELEC.png|60x60px|link=OpenELEC]]<br />
| width="50%" | {{big|'''[[OpenELEC]]'''}}<br />{{#lst:OpenELEC|intro}}<br />
|- valign="top"<br />
| [[File:LiveUSB Instal - logo.png|60x60px|link=Run or install XBMC from USB drive]]<br />
| {{big|'''[[Run or install XBMC from USB drive]]'''}}<br />{{#lst:Run or install XBMC from USB drive|intro}}<br />
| [[File:Linux OS.png|60x60px|link=HOW-TO:Install XBMC for Linux]]<br />
| width="50" | {{big|'''[[HOW-TO:Install XBMC for Linux | Install XBMC Standalone in Ubuntu minimal]]<br />|intro}}<br />
|}</div>UNiversalhttps://kodi.wiki/index.php?title=Official_Ubuntu_PPA&diff=78917Official Ubuntu PPA2014-09-18T09:39:29Z<p>UNiversal: updated mininav.</p>
<hr />
<div>{{mininav|[[General topics]]{{l2|[[FAQs]]}}|[[Installing]]}}<br />
<br />
<section begin="intro" />[[w:Personal Package Archive|Personal Package Archive]]s, or '''PPA'''s are software repositories that hold compiled version of software, primarily for [[w:Ubuntu|Ubuntu]] and various Ubuntu derivatives (such as Lubuntu, non-Debian versions of Linux Mint, XBMCbuntu, and many others).<br />
<br />
The Team XBMC PPA provides the only officially supported pre-compiled binaries for Ubuntu and Ubuntu-based systems.<br />
<br />
{{redv|NOTICE|'''All users should use the Team XBMC PPA instead of the system repositories (or any build that uses external ffmpeg/libav) for proper support and best running operation.'''}}<section end="intro" /><br />
<br />
== Repositories ==<br />
<section begin="repos" /><br />
The XBMC repositories are as follows:<br />
<br />
{| class="prettytable" width="100%"<br />
| https://launchpad.net/~team-xbmc/+archive/ppa || <code>'''ppa:team-xbmc/ppa'''</code> || Final release builds<br />
|-<br />
| https://launchpad.net/~team-xbmc/+archive/unstable || <code>'''ppa:team-xbmc/unstable'''</code> || [[beta|Betas and release candidates]]<br />
|-<br />
| https://launchpad.net/~team-xbmc/+archive/xbmc-nightly || <code>'''ppa:team-xbmc/xbmc-nightly'''</code> || [[Nightly builds]]<br />
|}<section end="repos" /><br />
{| class="prettytable" width="100%"<br />
| colspan="3" | For the users looking for compile with the PPA build depends in addition to the nightly PPA:<br />
|-<br />
| https://launchpad.net/~team-xbmc/+archive/xbmc-ppa-build-depends || <code>'''ppa:team-xbmc/xbmc-ppa-build-depends'''</code> || Build Depends<br />
|}<br />
<br />
== Package management F.A.Q. ==<br />
Here we give detailed information on '''Advanced Packaging Tool''', a.k.a. '''APT'''. and the necessary commands to retrieve, install, update, upgrade and or remove the application also known as XBMC or Kodi on Ubuntu and variants such as XBMCbuntu/KodiBuntu. Such information is widespread on any Ubuntu documentation and is duplicated here for simplicity and general user base benefit.<br />
<br />
<section begin="package_maintenance" /><br />
{| width="100%"<br />
{{FAQ|1=Why_XBMC_ppa<br />
| BGcolor=whitesmoke<br />
| Question= Why are XBMC packages from Ubuntu repositories incorrect?<br />
| Answer=<br />
The simple answer is that, these packages derive from externally modified XBMC versions which are either '''outdated''' and '''broken''' or both, and are 100% officially '''unsupported''' at this time.<br />
<br />
The main thing you must understand is that if you looking for supported official builds, you simply should not use other repositories, unless otherwise indicated by a Team Member or a informed community member.<br />
}}<br />
<br />
{{FAQ|1=Dependencies<br />
| BGcolor=<br />
| Question=Are any dependencies required to manage repo's or ppa's?<br />
| Answer=<br />
Some dependencies are required to manage ppa's/repos within your distro, install these by typing:<br />
<source lang="bash" enclose="div"><br />
sudo apt-get install python-software-properties pkg-config<br />
</source><br />
}}<br />
<br />
{| width="100%"<br />
{{FAQ|1=What_ppa_do_I_have<br />
| BGcolor=whitesmoke<br />
| Question= How do I find out what repo/ppa I am currently using?<br />
| Answer=<br />
You can get a complete listing of what repositories are part of your sources list by typing:<br />
<source lang="bash" enclose="div"><br />
sudo apt-cache policy<br />
</source><br />
}}<br />
<br />
{{FAQ|1=Adding or removing ppas<br />
| BGcolor=<br />
| Question=How do I add or remove ppa's?<br />
| Answer=<br />
After you determined which ppa you would like to '''add''' or '''remove''' follow the instructions below.<br />
;You can remove a ppa from your distro's sources list via terminal, by typing:<br />
<source lang="bash" enclose="div"><br />
sudo add-apt-repository -r ppa:current_XBMC_providing_ppa<br />
</source><br />
<br />
;You can add a ppa to your distro's sources list via terminal, by typing:<br />
<br />
<source lang="bash" enclose="div"><br />
sudo add-apt-repository ppa:the_ppa_you_wish_to_use<br />
</source><br />
<br /><br />
}}<br />
{{note|<br />
* The process of adding and removing repositories is recommended when changing the repo's in use.<br />
* Changing the PPA repo for XBMC will change what type of install is used (stable, nightly, beta, etc).}}<br />
<br />
== Installing, updating or upgrading ==<br />
If applicable you can check what package versions are installed in your system, this is helpful when determining what procedures to choose.<br />
{{FAQ|1=check current version<br />
| BGcolor=whitesmoke<br />
| Question=How can check what current XBMC version is installed?<br />
| Answer=<br />
Check what XBMC versions you have access to:<br />
<source lang="bash"><br />
sudo apt-cache policy xbmc<br />
</source><br />
}}<br />
<br />
{{FAQ|1=Installing XBMC<br />
| BGcolor=<br />
| Question=How do I install XBMC?<br />
| Answer=<br />
After adding or removing any ppa you need to refresh your sources list and finally install XBMC, by typing:<br />
<syntaxhighlight lang="bash" enclose="div"><br />
sudo apt-get update<br />
sudo apt-get install xbmc xbmc-bin<br />
</syntaxhighlight><br />
}}<br />
<br />
{{FAQ|1=Updating XBMC<br />
| BGcolor=whitesmoke<br />
| Question=How do I update XBMC?<br />
| Answer=<br />
To update XBMC/Kodi when a new version is released, just do a general system/package or use the following commands in the terminal (or via [[SSH]]):<br />
<br />
<source lang="bash"><br />
sudo apt-get update<br />
sudo apt-get install xbmc xbmc-bin<br />
</source><br />
}}<br />
<br />
{{FAQ|1=Upgrading XBMC<br />
| BGcolor=<br />
| Question=How do I upgrade XBMC?<br />
| Answer=<br />
After adding or removing any ppa you need to refresh your sources list and finally upgrade xbmc, by typing:<br />
<syntaxhighlight lang="bash" enclose="div"><br />
sudo apt-get update<br />
sudo apt-get --only-upgrade install xbmc xbmc-bin<br />
</syntaxhighlight><br />
}}<br />
<section begin="whynoupgrade" /><br />
{{FAQ|1=XBMC wont upgrade<br />
| BGcolor=whitesmoke<br />
| Question=Why wont XBMC upgrade?<br />
| Answer=<br />
After following the above instructions, XBMC is still not upgraded, the main reason why this happens is because the distribution you are using, is no longer supported and has reached an '''''end of life status'''''.<br />
<br />
See [https://wiki.ubuntu.com/Releases Current Ubuntu releases] if your current distro is listed under End of life table, you will need to upgrade your OS to a supported release.<br />
<br />
LTS releases are better for long term install and forget, installing obviously the very latest LTS release available.<br />
{{#lst:XBMCbuntu FAQ|upgradeOS}}<br />
}}<section end="whynoupgrade" /><br />
<br />
{{FAQ|1=Specific package versions.<br />
| BGcolor=<br />
| Question=How to install a specific versions?<br />
| Answer=<br />
In the event you need to install either by upgrade or downgrade a specific XBMC version (a reason may be a bug or to test a specific version), the PPA providing said version active must be in your '''sources.list.d''' along with a updated list of the packages.<br />
If the packages you intend to install are on a different PPA, you should probably remove that PPA to avoid confusion.<br />
<code>apt-get install packagename=version</code> is one way to achieve this.<br />
<syntaxhighlight lang="bash" enclose="div"><br />
sudo apt-get update<br />
sudo apt-get install xbmc=2:13.1~git20140606.0917-gotham-0trusty xbmc-bin=2:13.1~git20140606.0917-gotham-0trusty <br />
</syntaxhighlight><br />
<br />
Hint: For e.g. You can use result of <code>apt-cache policy xbmc</code> to see the candidates <packagename><version> available to you.<br />
{{Note| Removing/purging any previous versions if they are greater version of the package you are looking to install is necessary.}}<br />
}}<br />
<br />
{{FAQ|1=beta_unstable<br />
| BGcolor=whitesmoke<br />
| Question=How can I install a beta/unstable version?<br />
| Answer=<br />
To install a beta/unstable version of XBMC you must first add the unstable repository, then install XBMC:<br />
<source lang="bash"><br />
sudo add-apt-repository ppa:team-xbmc/unstable<br />
sudo apt-get update<br />
sudo apt-get install xbmc xbmc-bin<br />
</source><br />
:;or:<br />
<source lang="bash"><br />
sudo add-apt-repository ppa:team-xbmc/nightly<br />
sudo apt-get update<br />
sudo apt-get install xbmc xbmc-bin<br />
</source><br />
Follow the prompts to add the repository, then to add the updates, and finally install the new version of XBMC.<br />
{{note|1=You may need to restart your computer for the newly installed version to be working.}}<br />
}}<br />
<br />
{{FAQ|1=beta_unstable_to_stable<br />
| BGcolor=<br />
| Question=How can I move from a beta/unstable to a stable version?<br />
| Answer=<br />
Check what XBMC versions you have access to by typing:<br />
<source lang="bash"><br />
sudo apt-cache policy xbmc<br />
</source><br />
<br />
The response in terminal should be something like:<br />
<source lang="xml"><br />
xbmc:<br />
Installed: 2:13.2~git20140719.0900-beta2-0trusty<br />
Candidate: 2:13.2~git20140719.0900-beta2-0trusty<br />
Version table:<br />
*** 2:13.2~git20140719.0900-beta2-0trusty 0<br />
500 http://ppa.launchpad.net/team-xbmc/unstable/ubuntu/ trusty/main amd64 Packages<br />
100 /var/lib/dpkg/status<br />
2:13.1~git20140606.0917-gotham-0trusty 0<br />
500 http://ppa.launchpad.net/team-xbmc/ppa/ubuntu/ trusty/main amd64 Packages<br />
2:12.3+dfsg1-3ubuntu1 0<br />
500 http://us.archive.ubuntu.com/ubuntu/ trusty/universe amd64 Packages<br />
</source><br />
{{note|1=In the above example we have an unstable ('''team-xbmc/unstable''') and the release versions ('''team-xbmc/ppa''') available. The version with the '''***''' is the currently installed version (unstable)}}<br />
<br />
To install the release version we need to install the team-xbmc/ppa version (in the above example: "2:13.1~git20140606.0917-gotham-0trusty"). This requires the install of both the [[Team_XBMC_PPA#Installing_XBMC |"'''xbmc'''" and the "'''xbmc-bin'''" package.]]<br />
<source lang="bash"><br />
sudo apt-get install xbmc=2:13.1~git20140606.0917-gotham-0trusty xbmc-bin=2:13.1~git20140606.0917-gotham-0trusty<br />
</source><br />
{{note|1=You will get a warning you are downgrading, hit Y when asked to continue}}<br />
<br />
Remove the beta/unstable repository from XBMC to clean up:<br />
<source lang="bash"><br />
sudo add-apt-repository -r ppa:team-xbmc/unstable<br />
</source><br />
}}<br />
<br />
== Uninstalling or Removing ==<br />
{{FAQ|1=Uninstalling XBMC<br />
| BGcolor=<br />
| Question=How do I uninstall XBMC?<br />
| Answer=<br />
If you need to remove and purge an application and finally removing/purging also the application configurations files, do so by typing:<br />
<syntaxhighlight lang="bash" enclose="div"><br />
sudo apt-get update<br />
sudo apt-get remove xbmc*<br />
sudo apt-get purge xbmc*<br />
</syntaxhighlight><br />
}}<section end="package_maintenance" /><br />
<br />
== Build Dependencies ==<br />
{{FAQ|1=PPA Build deps<br />
| BGcolor=whitesmoke<br />
| Question=What are PPA build dependencies?<br />
| Answer=<br />
These build dependencies are versions of a library pre-packaged by Team XBMC, because the distro provided versions are behind the current requirements of XBMC.<br />
Both [https://github.com/xbmc/xbmc/blob/master/docs/README.linux REAME.linux] and/or [https://github.com/xbmc/xbmc/blob/master/docs/README.ubuntu README.ubuntu] documents using XBMC ppa build dependencies refer to these dependencies in the Team XBMC PPA's used in conjunction, when compiling on Ubuntu or derivatives distros.<br />
}}<br />
|}<br />
<br />
== See also ==<br />
* [https://help.ubuntu.com/community/AptGet/Howto apt-get/How-to]</div>UNiversalhttps://kodi.wiki/index.php?title=Archive:Kodibuntu&diff=78915Archive:Kodibuntu2014-09-18T09:26:15Z<p>UNiversal: /* Basic use */</p>
<hr />
<div>{{mininav|[[Linux]] {{l2| [[Devices]] }} {{l2| [[XBMCbuntu FAQ]] }} }}<br />
{{to do}}<br />
<section begin="intro" />XBMCbuntu is a combination XBMC/operating system for use on PCs that are mainly just running XBMC. It is an alternative to installing Windows or a larger (and sometimes more complicated) Linux-based OS.<section end="intro" /><br />
<br />
== Hardware requirements ==<br />
{{see also|Supported hardware}}<br />
<br />
XBMCbuntu should work with the general hardware requirements for Linux:<br />
{{Collapse top|<big>Click to show hardware requirements</big>-->}}<br />
<big>{{#lst:Supported hardware|Linux}}</big><br />
{{Collapse bottom}}<br />
<br />
== Installing ==<br />
<section begin="getandinstallxbmcbuntu" /><br />
{{How-to<br />
<br />
|Step1 =<br />
'''Download from:''' <code><big>http://xbmc.org/download/</big></code><br />
{{note|<br />
* Unlike XBMCbuntu '''v12''', '''v13''' has only one iso image file for all x86 computers, regardless of GPU.<br />
* Currently, only a '''64-bit''' version is available, but this should cover the vast majority of users.}}<br />
<br />
|Step1-number = 1<br />
|Step1-title = <big>Getting and downloading XBMCbuntu</big><br />
<br />
|Step2 = XBMCbuntu comes in an ISO form that can be burned to an optical disc. It can also be formatted to a USB drive, as mentioned in the next section.<br />
For complete instructions on how to acquire, create a bootable usb flash drive, boot or install to/from see:<br />
<br />
{{main|Create and install from/to a bootable USB flash drive}}<br />
|Step2-number = 2<br />
|Step2-title = <big>Creating a bootable USB drive from iso</big><br />
}}<section end="getandinstallxbmcbuntu" /><br />
<br />
=== Updating / Upgrading or Changing XBMC version===<br />
This page below contain all rounded up FAQ regarding upgrading/updating or changing XBMC packages via the Team XBMC ppas as well as useful information for those just starting out with Linux or XBMCbuntu/Kodibuntu<br />
<br />
{{main|Team XBMC PPA}}<br />
<br />
=== Upgrading XBMCBuntu OS ===<br />
<br />
Current XBMCbuntu is based on a LTS release (long term release) which is supported for 5 years, this means that you wont require to upgrade the OS base in order to obtain updated or upgrade application packages.<br />
<br />
See [https://wiki.ubuntu.com/Releases Current Ubuntu releases] if your current distro is listed under End of life table, you will need to upgrade your OS to a supported release.<br />
<br />
However should you need to upgrade the OS base a quick how-to follows.<br />
{{#lst:XBMCbuntu FAQ|upgradeOS}}<br />
<br />
=== XBMCbuntu F.A.Q. ===<br />
This area covers basic '''F'''requently '''A'''sked '''Q'''uestions and contains relevant information regarding XBMCbuntu that may be useful to users just starting out with Linux or XBMCbuntu.<br />
<br />
Subjects covered by XBMCbuntu F.A.Q. are, but not limited to:<br />
<br />
* Upgrading drivers<br />
* Handling backups<br />
* Troubleshooting<br />
<br /><br />
{{main|XBMCbuntu_FAQ}}<br />
<br />
== Login ==<br />
To login locally press {{keypress|Ctrl|Alt|F1 - F6 }} or via over [[SSH]]<br />
<br />
'''username:''' xbmc<br /><br />
'''password:''' none<br />
<br />
== Basic use ==<br />
XBMCbuntu can boot directly into XBMC or it can also boot into a desktop mode for using applications such as a web browser.<br />
{{note: If you last booted directly or switched to desktop and shutdown the HTPC while in desktop, on next reboot you will get the last used session by default.}} <br />
<br />
=== Media center ===<br />
XBMCbuntu contains [[XBMC for Linux]] compiled with the 'standalone' mode, this enabled certain functions that are not available in normal XBMC installations (Windows, Mac Linux), these functions include Power Management, and Network Management.<br />
<br />
=== Using desktop mode ===<br />
<br />
== Common Issues ==<br />
: {{main|common issues}}<br />
<br />
[[Category:Installation]]<br />
[[Category:Linux]]<br />
[[Category:XBMCbuntu|*]]<br />
[[Category:XBMC Manual]]<br />
{{Gotham updated}}</div>UNiversalhttps://kodi.wiki/index.php?title=Official_Ubuntu_PPA&diff=78909Official Ubuntu PPA2014-09-17T19:36:13Z<p>UNiversal: /* Package management F.A.Q. */</p>
<hr />
<div><section begin="intro" />[[w:Personal Package Archive|Personal Package Archive]]s, or '''PPA'''s are software repositories that hold compiled version of software, primarily for [[w:Ubuntu|Ubuntu]] and various Ubuntu derivatives (such as Lubuntu, non-Debian versions of Linux Mint, XBMCbuntu, and many others).<br />
<br />
The Team XBMC PPA provides the only officially supported pre-compiled binaries for Ubuntu and Ubuntu-based systems.<br />
<br />
{{redv|NOTICE|'''All users should use the Team XBMC PPA instead of the system repositories (or any build that uses external ffmpeg/libav) for proper support and best running operation.'''}}<section end="intro" /><br />
<br />
== Repositories ==<br />
<section begin="repos" /><br />
The XBMC repositories are as follows:<br />
<br />
{| class="prettytable" width="100%"<br />
| https://launchpad.net/~team-xbmc/+archive/ppa || <code>'''ppa:team-xbmc/ppa'''</code> || Final release builds<br />
|-<br />
| https://launchpad.net/~team-xbmc/+archive/unstable || <code>'''ppa:team-xbmc/unstable'''</code> || [[beta|Betas and release candidates]]<br />
|-<br />
| https://launchpad.net/~team-xbmc/+archive/xbmc-nightly || <code>'''ppa:team-xbmc/xbmc-nightly'''</code> || [[Nightly builds]]<br />
|}<section end="repos" /><br />
{| class="prettytable" width="100%"<br />
| colspan="3" | For the users looking for compile with the PPA build depends in addition to the nightly PPA:<br />
|-<br />
| https://launchpad.net/~team-xbmc/+archive/xbmc-ppa-build-depends || <code>'''ppa:team-xbmc/xbmc-ppa-build-depends'''</code> || Build Depends<br />
|}<br />
<br />
== Package management F.A.Q. ==<br />
Here we give detailed information on '''Advanced Packaging Tool''', a.k.a. '''APT'''. and the necessary commands to retrieve, install, update, upgrade and or remove the application also known as XBMC or Kodi on Ubuntu and variants such as XBMCbuntu/KodiBuntu. Such information is widespread on any Ubuntu documentation and is duplicated here for simplicity and general user base benefit.<br />
<br />
<section begin="package_maintenance" /><br />
{| width="100%"<br />
{{FAQ|1=Why_XBMC_ppa<br />
| BGcolor=whitesmoke<br />
| Question= Why are XBMC packages from Ubuntu repositories incorrect?<br />
| Answer=<br />
The simple answer is that, these packages derive from externally modified XBMC versions which are either '''outdated''' and '''broken''' or both, and are 100% officially '''unsupported''' at this time.<br />
<br />
The main thing you must understand is that if you looking for supported official builds, you simply should not use other repositories, unless otherwise indicated by a Team Member or a informed community member.<br />
}}<br />
<br />
{{FAQ|1=Dependencies<br />
| BGcolor=<br />
| Question=Are any dependencies required to manage repo's or ppa's?<br />
| Answer=<br />
Some dependencies are required to manage ppa's/repos within your distro, install these by typing:<br />
<source lang="bash" enclose="div"><br />
sudo apt-get install python-software-properties pkg-config<br />
</source><br />
}}<br />
<br />
{| width="100%"<br />
{{FAQ|1=What_ppa_do_I_have<br />
| BGcolor=whitesmoke<br />
| Question= How do I find out what repo/ppa I am currently using?<br />
| Answer=<br />
You can get a complete listing of what repositories are part of your sources list by typing:<br />
<source lang="bash" enclose="div"><br />
sudo apt-cache policy<br />
</source><br />
}}<br />
<br />
{{FAQ|1=Adding or removing ppas<br />
| BGcolor=<br />
| Question=How do I add or remove ppa's?<br />
| Answer=<br />
After you determined which ppa you would like to '''add''' or '''remove''' follow the instructions below.<br />
;You can remove a ppa from your distro's sources list via terminal, by typing:<br />
<source lang="bash" enclose="div"><br />
sudo add-apt-repository -r ppa:current_XBMC_providing_ppa<br />
</source><br />
<br />
;You can add a ppa to your distro's sources list via terminal, by typing:<br />
<br />
<source lang="bash" enclose="div"><br />
sudo add-apt-repository ppa:the_ppa_you_wish_to_use<br />
</source><br />
<br /><br />
}}<br />
{{note|<br />
* The process of adding and removing repositories is recommended when changing the repo's in use.<br />
* Changing the PPA repo for XBMC will change what type of install is used (stable, nightly, beta, etc).}}<br />
<br />
== Installing, updating or upgrading ==<br />
If applicable you can check what package versions are installed in your system, this is helpful when determining what procedures to choose.<br />
{{FAQ|1=check current version<br />
| BGcolor=whitesmoke<br />
| Question=How can check what current XBMC version is installed?<br />
| Answer=<br />
Check what XBMC versions you have access to:<br />
<source lang="bash"><br />
sudo apt-cache policy xbmc<br />
</source><br />
}}<br />
<br />
{{FAQ|1=Installing XBMC<br />
| BGcolor=<br />
| Question=How do I install XBMC?<br />
| Answer=<br />
After adding or removing any ppa you need to refresh your sources list and finally install XBMC, by typing:<br />
<syntaxhighlight lang="bash" enclose="div"><br />
sudo apt-get update<br />
sudo apt-get install xbmc xbmc-bin<br />
</syntaxhighlight><br />
}}<br />
<br />
{{FAQ|1=Updating XBMC<br />
| BGcolor=whitesmoke<br />
| Question=How do I update XBMC?<br />
| Answer=<br />
To update XBMC/Kodi when a new version is released, just do a general system/package or use the following commands in the terminal (or via [[SSH]]):<br />
<br />
<source lang="bash"><br />
sudo apt-get update<br />
sudo apt-get install xbmc xbmc-bin<br />
</source><br />
}}<br />
<br />
{{FAQ|1=Upgrading XBMC<br />
| BGcolor=<br />
| Question=How do I upgrade XBMC?<br />
| Answer=<br />
After adding or removing any ppa you need to refresh your sources list and finally upgrade xbmc, by typing:<br />
<syntaxhighlight lang="bash" enclose="div"><br />
sudo apt-get update<br />
sudo apt-get --only-upgrade install xbmc xbmc-bin<br />
</syntaxhighlight><br />
}}<br />
<section begin="whynoupgrade" /><br />
{{FAQ|1=XBMC wont upgrade<br />
| BGcolor=whitesmoke<br />
| Question=Why wont XBMC upgrade?<br />
| Answer=<br />
After following the above instructions, XBMC is still not upgraded, the main reason why this happens is because the distribution you are using, is no longer supported and has reached an '''''end of life status'''''.<br />
<br />
See [https://wiki.ubuntu.com/Releases Current Ubuntu releases] if your current distro is listed under End of life table, you will need to upgrade your OS to a supported release.<br />
<br />
LTS releases are better for long term install and forget, installing obviously the very latest LTS release available.<br />
{{#lst:XBMCbuntu FAQ|upgradeOS}}<br />
}}<section end="whynoupgrade" /><br />
<br />
{{FAQ|1=Specific package versions.<br />
| BGcolor=<br />
| Question=How to install a specific versions?<br />
| Answer=<br />
In the event you need to install either by upgrade or downgrade a specific XBMC version (a reason may be a bug or to test a specific version), the PPA providing said version active must be in your '''sources.list.d''' along with a updated list of the packages.<br />
If the packages you intend to install are on a different PPA, you should probably remove that PPA to avoid confusion.<br />
<code>apt-get install packagename=version</code> is one way to achieve this.<br />
<syntaxhighlight lang="bash" enclose="div"><br />
sudo apt-get update<br />
sudo apt-get install xbmc=2:13.1~git20140606.0917-gotham-0trusty xbmc-bin=2:13.1~git20140606.0917-gotham-0trusty <br />
</syntaxhighlight><br />
<br />
Hint: For e.g. You can use result of <code>apt-cache policy xbmc</code> to see the candidates <packagename><version> available to you.<br />
{{Note| Removing/purging any previous versions if they are greater version of the package you are looking to install is necessary.}}<br />
}}<br />
<br />
{{FAQ|1=beta_unstable<br />
| BGcolor=whitesmoke<br />
| Question=How can I install a beta/unstable version?<br />
| Answer=<br />
To install a beta/unstable version of XBMC you must first add the unstable repository, then install XBMC:<br />
<source lang="bash"><br />
sudo add-apt-repository ppa:team-xbmc/unstable<br />
sudo apt-get update<br />
sudo apt-get install xbmc xbmc-bin<br />
</source><br />
:;or:<br />
<source lang="bash"><br />
sudo add-apt-repository ppa:team-xbmc/nightly<br />
sudo apt-get update<br />
sudo apt-get install xbmc xbmc-bin<br />
</source><br />
Follow the prompts to add the repository, then to add the updates, and finally install the new version of XBMC.<br />
{{note|1=You may need to restart your computer for the newly installed version to be working.}}<br />
}}<br />
<br />
{{FAQ|1=beta_unstable_to_stable<br />
| BGcolor=<br />
| Question=How can I move from a beta/unstable to a stable version?<br />
| Answer=<br />
Check what XBMC versions you have access to by typing:<br />
<source lang="bash"><br />
sudo apt-cache policy xbmc<br />
</source><br />
<br />
The response in terminal should be something like:<br />
<source lang="xml"><br />
xbmc:<br />
Installed: 2:13.2~git20140719.0900-beta2-0trusty<br />
Candidate: 2:13.2~git20140719.0900-beta2-0trusty<br />
Version table:<br />
*** 2:13.2~git20140719.0900-beta2-0trusty 0<br />
500 http://ppa.launchpad.net/team-xbmc/unstable/ubuntu/ trusty/main amd64 Packages<br />
100 /var/lib/dpkg/status<br />
2:13.1~git20140606.0917-gotham-0trusty 0<br />
500 http://ppa.launchpad.net/team-xbmc/ppa/ubuntu/ trusty/main amd64 Packages<br />
2:12.3+dfsg1-3ubuntu1 0<br />
500 http://us.archive.ubuntu.com/ubuntu/ trusty/universe amd64 Packages<br />
</source><br />
{{note|1=In the above example we have an unstable ('''team-xbmc/unstable''') and the release versions ('''team-xbmc/ppa''') available. The version with the '''***''' is the currently installed version (unstable)}}<br />
<br />
To install the release version we need to install the team-xbmc/ppa version (in the above example: "2:13.1~git20140606.0917-gotham-0trusty"). This requires the install of both the [[Team_XBMC_PPA#Installing_XBMC |"'''xbmc'''" and the "'''xbmc-bin'''" package.]]<br />
<source lang="bash"><br />
sudo apt-get install xbmc=2:13.1~git20140606.0917-gotham-0trusty xbmc-bin=2:13.1~git20140606.0917-gotham-0trusty<br />
</source><br />
{{note|1=You will get a warning you are downgrading, hit Y when asked to continue}}<br />
<br />
Remove the beta/unstable repository from XBMC to clean up:<br />
<source lang="bash"><br />
sudo add-apt-repository -r ppa:team-xbmc/unstable<br />
</source><br />
}}<br />
<br />
== Uninstalling or Removing ==<br />
{{FAQ|1=Uninstalling XBMC<br />
| BGcolor=<br />
| Question=How do I uninstall XBMC?<br />
| Answer=<br />
If you need to remove and purge an application and finally removing/purging also the application configurations files, do so by typing:<br />
<syntaxhighlight lang="bash" enclose="div"><br />
sudo apt-get update<br />
sudo apt-get remove xbmc*<br />
sudo apt-get purge xbmc*<br />
</syntaxhighlight><br />
}}<section end="package_maintenance" /><br />
<br />
== Build Dependencies ==<br />
{{FAQ|1=PPA Build deps<br />
| BGcolor=whitesmoke<br />
| Question=What are PPA build dependencies?<br />
| Answer=<br />
These build dependencies are versions of a library pre-packaged by Team XBMC, because the distro provided versions are behind the current requirements of XBMC.<br />
Both [https://github.com/xbmc/xbmc/blob/master/docs/README.linux REAME.linux] and/or [https://github.com/xbmc/xbmc/blob/master/docs/README.ubuntu README.ubuntu] documents using XBMC ppa build dependencies refer to these dependencies in the Team XBMC PPA's used in conjunction, when compiling on Ubuntu or derivatives distros.<br />
}}<br />
|}<br />
<br />
== See also ==<br />
* [https://help.ubuntu.com/community/AptGet/Howto apt-get/How-to]</div>UNiversalhttps://kodi.wiki/index.php?title=Official_Ubuntu_PPA&diff=78904Official Ubuntu PPA2014-09-17T15:29:27Z<p>UNiversal: /* Installing, updating or upgrading */</p>
<hr />
<div><section begin="intro" />[[w:Personal Package Archive|Personal Package Archive]]s, or '''PPA'''s are software repositories that hold compiled version of software, primarily for [[w:Ubuntu|Ubuntu]] and various Ubuntu derivatives (such as Lubuntu, non-Debian versions of Linux Mint, XBMCbuntu, and many others).<br />
<br />
The Team XBMC PPA provides the only officially supported pre-compiled binaries for Ubuntu and Ubuntu-based systems.<br />
<br />
{{redv|NOTICE|'''All users should use the Team XBMC PPA instead of the system repositories (or any build that uses external ffmpeg/libav) for proper support and best running operation.'''}}<section end="intro" /><br />
<br />
== Repositories ==<br />
<section begin="repos" /><br />
The XBMC repositories are as follows:<br />
<br />
{| class="prettytable" width="100%"<br />
| https://launchpad.net/~team-xbmc/+archive/ppa || <code>'''ppa:team-xbmc/ppa'''</code> || Final release builds<br />
|-<br />
| https://launchpad.net/~team-xbmc/+archive/unstable || <code>'''ppa:team-xbmc/unstable'''</code> || [[beta|Betas and release candidates]]<br />
|-<br />
| https://launchpad.net/~team-xbmc/+archive/xbmc-nightly || <code>'''ppa:team-xbmc/xbmc-nightly'''</code> || [[Nightly builds]]<br />
|}<section end="repos" /><br />
{| class="prettytable" width="100%"<br />
| colspan="3" | For the users looking for compile with the PPA build depends in addition to the nightly PPA:<br />
|-<br />
| https://launchpad.net/~team-xbmc/+archive/xbmc-ppa-build-depends || <code>'''ppa:team-xbmc/xbmc-ppa-build-depends'''</code> || Build Depends<br />
|}<br />
<br />
== Package management F.A.Q. ==<br />
<section begin="package_maintenance" /><br />
{| width="100%"<br />
{{FAQ|1=Why_XBMC_ppa<br />
| BGcolor=whitesmoke<br />
| Question= Why are XBMC packages from Ubuntu repositories incorrect?<br />
| Answer=<br />
The simple answer is that, these packages derive from externally modified XBMC versions which are either '''outdated''' and '''broken''' or both, and are 100% officially '''unsupported''' at this time.<br />
<br />
The main thing you must understand is that if you looking for supported official builds, you simply should not use other repositories, unless otherwise indicated by a Team Member or a informed community member.<br />
}}<br />
<br />
{{FAQ|1=Dependencies<br />
| BGcolor=<br />
| Question=Are any dependencies required?<br />
| Answer=<br />
Some dependencies are required to manage ppa's/repositories within your distro, install these by typing:<br />
<syntaxhighlight lang="bash" enclose="div"><br />
sudo apt-get install python-software-properties pkg-config<br />
</syntaxhighlight><br />
}}<br />
<br />
{| width="100%"<br />
{{FAQ|1=What_ppa_do_I_have<br />
| BGcolor=whitesmoke<br />
| Question= How do I find out what repositories I am currently using?<br />
| Answer=<br />
You can get a complete listing of what repositories are part of your sources list by typing:<br />
<syntaxhighlight lang="bash" enclose="div"><br />
sudo apt-cache policy<br />
</syntaxhighlight><br />
}}<br />
<br />
{{FAQ|1=Adding or removing ppas<br />
| BGcolor=<br />
| Question=How do I add or remove ppas?<br />
| Answer=<br />
After you determined which ppa you would like to '''add''' or '''remove''' follow the instructions below.<br />
;You can remove a ppa from your distro's sources list via terminal, by typing:<br />
<syntaxhighlight lang="bash" enclose="div"><br />
sudo add-apt-repository -r ppa:current_XBMC_providing_ppa<br />
</syntaxhighlight><br />
<br />
;You can add a ppa to your distro's sources list via terminal, by typing:<br />
<syntaxhighlight lang="bash" enclose="div"><br />
sudo add-apt-repository ppa:the_ppa_you_wish_to_use<br />
</syntaxhighlight><br />
<br /><br />
{{note|<br />
* The process of adding and removing repositories is recommended when changing the repos in use.<br />
* Changing the PPA repo for XBMC will change what type of install is used (stable, nightly, beta, etc).}}<br />
}}<br />
<br />
== Installing, updating or upgrading ==<br />
If applicable you can check what package versions are installed in your system, this is helpful when determining what procedures to choose.<br />
{{FAQ|1=check current version<br />
| BGcolor=whitesmoke<br />
| Question=How can check what current XBMC version is installed?<br />
| Answer=<br />
Check what XBMC versions you have access to:<br />
<source lang="bash"><br />
sudo apt-cache policy xbmc<br />
</source><br />
}}<br />
<br />
{{FAQ|1=Installing XBMC<br />
| BGcolor=<br />
| Question=How do I install XBMC?<br />
| Answer=<br />
After adding or removing any ppa you need to refresh your sources list and finally install XBMC, by typing:<br />
<syntaxhighlight lang="bash" enclose="div"><br />
sudo apt-get update<br />
sudo apt-get install xbmc xbmc-bin<br />
</syntaxhighlight><br />
}}<br />
<br />
{{FAQ|1=Updating XBMC<br />
| BGcolor=whitesmoke<br />
| Question=How do I update XBMC?<br />
| Answer=<br />
To update XBMC/Kodi when a new version is released, just do a general system/package or use the following commands in the terminal (or via [[SSH]]):<br />
<br />
<source lang="bash"><br />
sudo apt-get update<br />
sudo apt-get install xbmc xbmc-bin<br />
</source><br />
}}<br />
<br />
{{FAQ|1=Upgrading XBMC<br />
| BGcolor=<br />
| Question=How do I upgrade XBMC?<br />
| Answer=<br />
After adding or removing any ppa you need to refresh your sources list and finally upgrade xbmc, by typing:<br />
<syntaxhighlight lang="bash" enclose="div"><br />
sudo apt-get update<br />
sudo apt-get --only-upgrade install xbmc xbmc-bin<br />
</syntaxhighlight><br />
}}<br />
<section begin="whynoupgrade" /><br />
{{FAQ|1=XBMC wont upgrade<br />
| BGcolor=whitesmoke<br />
| Question=Why wont XBMC upgrade?<br />
| Answer=<br />
After following the above instructions, XBMC is still not upgraded, the main reason why this happens is because the distribution you are using, is no longer supported and has reached an '''''end of life status'''''.<br />
<br />
See [https://wiki.ubuntu.com/Releases Current Ubuntu releases] if your current distro is listed under End of life table, you will need to upgrade your OS to a supported release.<br />
<br />
LTS releases are better for long term install and forget, installing obviously the very latest LTS release available.<br />
{{#lst:XBMCbuntu FAQ|upgradeOS}}<br />
}}<section end="whynoupgrade" /><br />
<br />
{{FAQ|1=Specific package versions.<br />
| BGcolor=<br />
| Question=How to install a specific versions?<br />
| Answer=<br />
In the event you need to install either by upgrade or downgrade a specific XBMC version (a reason may be a bug or to test a specific version), the PPA providing said version active must be in your '''sources.list.d''' along with a updated list of the packages.<br />
If the packages you intend to install are on a different PPA, you should probably remove that PPA to avoid confusion.<br />
<code>apt-get install packagename=version</code> is one way to achieve this.<br />
<syntaxhighlight lang="bash" enclose="div"><br />
sudo apt-get update<br />
sudo apt-get install xbmc=2:13.1~git20140606.0917-gotham-0trusty xbmc-bin=2:13.1~git20140606.0917-gotham-0trusty <br />
</syntaxhighlight><br />
<br />
Hint: For e.g. You can use result of <code>apt-cache policy xbmc</code> to see the candidates <packagename><version> available to you.<br />
{{Note| Removing/purging any previous versions if they are greater version of the package you are looking to install is necessary.}}<br />
}}<br />
<br />
{{FAQ|1=beta_unstable<br />
| BGcolor=whitesmoke<br />
| Question=How can I install a beta/unstable version?<br />
| Answer=<br />
To install a beta/unstable version of XBMC you must first add the unstable repository, then install XBMC:<br />
<source lang="bash"><br />
sudo add-apt-repository ppa:team-xbmc/unstable<br />
sudo apt-get update<br />
sudo apt-get install xbmc xbmc-bin<br />
</source><br />
:;or:<br />
<source lang="bash"><br />
sudo add-apt-repository ppa:team-xbmc/nightly<br />
sudo apt-get update<br />
sudo apt-get install xbmc xbmc-bin<br />
</source><br />
Follow the prompts to add the repository, then to add the updates, and finally install the new version of XBMC.<br />
{{note|1=You may need to restart your computer for the newly installed version to be working.}}<br />
}}<br />
<br />
{{FAQ|1=beta_unstable_to_stable<br />
| BGcolor=<br />
| Question=How can I move from a beta/unstable to a stable version?<br />
| Answer=<br />
Check what XBMC versions you have access to by typing:<br />
<source lang="bash"><br />
sudo apt-cache policy xbmc<br />
</source><br />
<br />
The response in terminal should be something like:<br />
<source lang="xml"><br />
xbmc:<br />
Installed: 2:13.2~git20140719.0900-beta2-0trusty<br />
Candidate: 2:13.2~git20140719.0900-beta2-0trusty<br />
Version table:<br />
*** 2:13.2~git20140719.0900-beta2-0trusty 0<br />
500 http://ppa.launchpad.net/team-xbmc/unstable/ubuntu/ trusty/main amd64 Packages<br />
100 /var/lib/dpkg/status<br />
2:13.1~git20140606.0917-gotham-0trusty 0<br />
500 http://ppa.launchpad.net/team-xbmc/ppa/ubuntu/ trusty/main amd64 Packages<br />
2:12.3+dfsg1-3ubuntu1 0<br />
500 http://us.archive.ubuntu.com/ubuntu/ trusty/universe amd64 Packages<br />
</source><br />
{{note|1=In the above example we have an unstable ('''team-xbmc/unstable''') and the release versions ('''team-xbmc/ppa''') available. The version with the '''***''' is the currently installed version (unstable)}}<br />
<br />
To install the release version we need to install the team-xbmc/ppa version (in the above example: "2:13.1~git20140606.0917-gotham-0trusty"). This requires the install of both the [[Team_XBMC_PPA#Installing_XBMC |"'''xbmc'''" and the "'''xbmc-bin'''" package.]]<br />
<source lang="bash"><br />
sudo apt-get install xbmc=2:13.1~git20140606.0917-gotham-0trusty xbmc-bin=2:13.1~git20140606.0917-gotham-0trusty<br />
</source><br />
{{note|1=You will get a warning you are downgrading, hit Y when asked to continue}}<br />
<br />
Remove the beta/unstable repository from XBMC to clean up:<br />
<source lang="bash"><br />
sudo add-apt-repository -r ppa:team-xbmc/unstable<br />
</source><br />
}}<br />
<br />
== Uninstalling or Removing ==<br />
{{FAQ|1=Uninstalling XBMC<br />
| BGcolor=<br />
| Question=How do I uninstall XBMC?<br />
| Answer=<br />
If you need to remove and purge an application and finally removing/purging also the application configurations files, do so by typing:<br />
<syntaxhighlight lang="bash" enclose="div"><br />
sudo apt-get update<br />
sudo apt-get remove xbmc*<br />
sudo apt-get purge xbmc*<br />
</syntaxhighlight><br />
}}<section end="package_maintenance" /><br />
<br />
== Build Dependencies ==<br />
{{FAQ|1=PPA Build deps<br />
| BGcolor=whitesmoke<br />
| Question=What are PPA build dependencies?<br />
| Answer=<br />
These build dependencies are versions of a library pre-packaged by Team XBMC, because the distro provided versions are behind the current requirements of XBMC.<br />
Both [https://github.com/xbmc/xbmc/blob/master/docs/README.linux REAME.linux] and/or [https://github.com/xbmc/xbmc/blob/master/docs/README.ubuntu README.ubuntu] documents using XBMC ppa build dependencies refer to these dependencies in the Team XBMC PPA's used in conjunction, when compiling on Ubuntu or derivatives distros.<br />
}}<br />
|}<br />
<br />
== See also ==<br />
* [https://help.ubuntu.com/community/AptGet/Howto apt-get/How-to]</div>UNiversalhttps://kodi.wiki/index.php?title=Official_Ubuntu_PPA&diff=78903Official Ubuntu PPA2014-09-17T15:26:51Z<p>UNiversal: /* Installing, updating or upgrading */</p>
<hr />
<div><section begin="intro" />[[w:Personal Package Archive|Personal Package Archive]]s, or '''PPA'''s are software repositories that hold compiled version of software, primarily for [[w:Ubuntu|Ubuntu]] and various Ubuntu derivatives (such as Lubuntu, non-Debian versions of Linux Mint, XBMCbuntu, and many others).<br />
<br />
The Team XBMC PPA provides the only officially supported pre-compiled binaries for Ubuntu and Ubuntu-based systems.<br />
<br />
{{redv|NOTICE|'''All users should use the Team XBMC PPA instead of the system repositories (or any build that uses external ffmpeg/libav) for proper support and best running operation.'''}}<section end="intro" /><br />
<br />
== Repositories ==<br />
<section begin="repos" /><br />
The XBMC repositories are as follows:<br />
<br />
{| class="prettytable" width="100%"<br />
| https://launchpad.net/~team-xbmc/+archive/ppa || <code>'''ppa:team-xbmc/ppa'''</code> || Final release builds<br />
|-<br />
| https://launchpad.net/~team-xbmc/+archive/unstable || <code>'''ppa:team-xbmc/unstable'''</code> || [[beta|Betas and release candidates]]<br />
|-<br />
| https://launchpad.net/~team-xbmc/+archive/xbmc-nightly || <code>'''ppa:team-xbmc/xbmc-nightly'''</code> || [[Nightly builds]]<br />
|}<section end="repos" /><br />
{| class="prettytable" width="100%"<br />
| colspan="3" | For the users looking for compile with the PPA build depends in addition to the nightly PPA:<br />
|-<br />
| https://launchpad.net/~team-xbmc/+archive/xbmc-ppa-build-depends || <code>'''ppa:team-xbmc/xbmc-ppa-build-depends'''</code> || Build Depends<br />
|}<br />
<br />
== Package management F.A.Q. ==<br />
<section begin="package_maintenance" /><br />
{| width="100%"<br />
{{FAQ|1=Why_XBMC_ppa<br />
| BGcolor=whitesmoke<br />
| Question= Why are XBMC packages from Ubuntu repositories incorrect?<br />
| Answer=<br />
The simple answer is that, these packages derive from externally modified XBMC versions which are either '''outdated''' and '''broken''' or both, and are 100% officially '''unsupported''' at this time.<br />
<br />
The main thing you must understand is that if you looking for supported official builds, you simply should not use other repositories, unless otherwise indicated by a Team Member or a informed community member.<br />
}}<br />
<br />
{{FAQ|1=Dependencies<br />
| BGcolor=<br />
| Question=Are any dependencies required?<br />
| Answer=<br />
Some dependencies are required to manage ppa's/repositories within your distro, install these by typing:<br />
<syntaxhighlight lang="bash" enclose="div"><br />
sudo apt-get install python-software-properties pkg-config<br />
</syntaxhighlight><br />
}}<br />
<br />
{| width="100%"<br />
{{FAQ|1=What_ppa_do_I_have<br />
| BGcolor=whitesmoke<br />
| Question= How do I find out what repositories I am currently using?<br />
| Answer=<br />
You can get a complete listing of what repositories are part of your sources list by typing:<br />
<syntaxhighlight lang="bash" enclose="div"><br />
sudo apt-cache policy<br />
</syntaxhighlight><br />
}}<br />
<br />
{{FAQ|1=Adding or removing ppas<br />
| BGcolor=<br />
| Question=How do I add or remove ppas?<br />
| Answer=<br />
After you determined which ppa you would like to '''add''' or '''remove''' follow the instructions below.<br />
;You can remove a ppa from your distro's sources list via terminal, by typing:<br />
<syntaxhighlight lang="bash" enclose="div"><br />
sudo add-apt-repository -r ppa:current_XBMC_providing_ppa<br />
</syntaxhighlight><br />
<br />
;You can add a ppa to your distro's sources list via terminal, by typing:<br />
<syntaxhighlight lang="bash" enclose="div"><br />
sudo add-apt-repository ppa:the_ppa_you_wish_to_use<br />
</syntaxhighlight><br />
<br /><br />
{{note|<br />
* The process of adding and removing repositories is recommended when changing the repos in use.<br />
* Changing the PPA repo for XBMC will change what type of install is used (stable, nightly, beta, etc).}}<br />
}}<br />
<br />
== Installing, updating or upgrading ==<br />
If applicable you can check what package versions are installed in your system, this is helpful when determining what procedures to choose.<br />
{{FAQ|1=check current version<br />
| BGcolor=whitesmoke<br />
| Question=How can check what current XBMC version is installed?<br />
| Answer=<br />
Check what XBMC versions you have access to:<br />
<source lang="bash"><br />
sudo apt-cache policy xbmc<br />
</source><br />
}}<br />
<br />
{{FAQ|1=Installing XBMC<br />
| BGcolor=<br />
| Question=How do I install XBMC?<br />
| Answer=<br />
After adding or removing any ppa you need to refresh your sources list and finally install XBMC, by typing:<br />
<syntaxhighlight lang="bash" enclose="div"><br />
sudo apt-get update<br />
sudo apt-get install xbmc xbmc-bin<br />
</syntaxhighlight><br />
}}<br />
<br />
{{FAQ|1=Updating XBMC<br />
| BGcolor=whitesmoke<br />
| Question=How do I update XBMC?<br />
| Answer=<br />
To update XBMC/Kodi when a new version is released, just do a general system/package or use the following commands in the terminal (or via [[SSH]]):<br />
<br />
<source lang="bash"><br />
sudo apt-get update<br />
sudo apt-get install xbmc xbmc-bin<br />
</source><br />
}}<br />
<br />
{{FAQ|1=Upgrading XBMC<br />
| BGcolor=<br />
| Question=How do I upgrade XBMC?<br />
| Answer=<br />
After adding or removing any ppa you need to refresh your sources list and finally upgrade xbmc, by typing:<br />
<syntaxhighlight lang="bash" enclose="div"><br />
sudo apt-get update<br />
sudo apt-get --only-upgrade install xbmc xbmc-bin<br />
</syntaxhighlight><br />
}}<br />
<section begin="whynoupgrade" /><br />
{{FAQ|1=XBMC wont upgrade<br />
| BGcolor=whitesmoke<br />
| Question=Why wont XBMC upgrade?<br />
| Answer=<br />
After following the above instructions, XBMC is still not upgraded, the main reason why this happens is because the distribution you are using, is no longer supported and has reached an '''''end of life status'''''.<br />
<br />
See [https://wiki.ubuntu.com/Releases Current Ubuntu releases] if your current distro is listed under End of life table, you will need to upgrade your OS to a supported release.<br />
<br />
LTS releases are better for long term install and forget, installing obviously the very latest LTS release available.<br />
{{#lst:XBMCbuntu FAQ|upgradeOS}}<br />
}}<section end="whynoupgrade" /><br />
<br />
{{FAQ|1=Specific package versions.<br />
| BGcolor=<br />
| Question=How to install a specific versions?<br />
| Answer=<br />
In the event you need to install either by upgrade or downgrade a specific XBMC version (a reason may be a bug or to test a specific version), the PPA providing said version active must be in your '''sources.list.d''' along with a updated list of the packages.<br />
If the packages you intend to install are on a different PPA, you should probably remove that PPA to avoid confusion.<br />
<code>apt-get install packagename=version</code> is one way to achieve this.<br />
<syntaxhighlight lang="bash" enclose="div"><br />
sudo apt-get update<br />
sudo apt-get install xbmc=2:13.1~git20140606.0917-gotham-0trusty xbmc-bin=2:13.1~git20140606.0917-gotham-0trusty <br />
</syntaxhighlight><br />
<br />
Hint: For e.g. You can use result of <code>apt-cache policy xbmc</code> to see the candidates <packagename><version> available to you.<br />
{{Note| Removing/purging any previous versions if they are greater version of the package you are looking to install is necessary.}}<br />
}}<br />
<br />
{{FAQ|1=beta_unstable<br />
| BGcolor=whitesmoke<br />
| Question=How can I install a beta/unstable version?<br />
| Answer=<br />
To install a beta/unstable version of XBMC you must first add the unstable repository, then install XBMC:<br />
<source lang="bash"><br />
sudo add-apt-repository ppa:team-xbmc/unstable<br />
sudo apt-get update<br />
sudo apt-get install xbmc xbmc-bin<br />
</source><br />
:;or:<br />
<source lang="bash"><br />
sudo add-apt-repository ppa:team-xbmc/nightly<br />
sudo apt-get update<br />
sudo apt-get install xbmc xbmc-bin<br />
</source><br />
Follow the prompts to add the repository, then to add the updates, and finally install the new version of XBMC.<br />
{{note|1=You may need to restart your computer for the newly installed version to be working.}}<br />
}}<br />
<br />
{{FAQ|1=beta_unstable_to_stable<br />
| BGcolor=<br />
| Question=How can I move from a beta/unstable to a stable version?<br />
| Answer=<br />
Check what XBMC versions you have access to by typing:<br />
<source lang="bash"><br />
sudo apt-cache policy xbmc<br />
</source><br />
<br />
The response in terminal should be something like:<br />
<source lang="xml"><br />
xbmc:<br />
Installed: 2:13.2~git20140719.0900-beta2-0trusty<br />
Candidate: 2:13.2~git20140719.0900-beta2-0trusty<br />
Version table:<br />
*** 2:13.2~git20140719.0900-beta2-0trusty 0<br />
500 http://ppa.launchpad.net/team-xbmc/unstable/ubuntu/ trusty/main amd64 Packages<br />
100 /var/lib/dpkg/status<br />
2:13.1~git20140606.0917-gotham-0trusty 0<br />
500 http://ppa.launchpad.net/team-xbmc/ppa/ubuntu/ trusty/main amd64 Packages<br />
2:12.3+dfsg1-3ubuntu1 0<br />
500 http://us.archive.ubuntu.com/ubuntu/ trusty/universe amd64 Packages<br />
</source><br />
{{note|1=In the above example we have an unstable ('''team-xbmc/unstable''') and the release versions ('''team-xbmc/ppa''') available. The version with the '''***''' is the currently installed version (unstable)}}<br />
<br />
To install the release version we need to install the team-xbmc/ppa version (in the above example: "2:13.1~git20140606.0917-gotham-0trusty"). This requires us to install both the "'''xbmc'''" and the "'''xbmc-bin'''" package.<br />
<source lang="bash"><br />
sudo apt-get install xbmc=2:13.1~git20140606.0917-gotham-0trusty xbmc-bin=2:13.1~git20140606.0917-gotham-0trusty<br />
</source><br />
{{note|1=You will get a warning you are downgrading, hit Y when asked to continue}}<br />
<br />
Remove the beta/unstable repository from XBMC to clean up:<br />
<source lang="bash"><br />
sudo add-apt-repository -r ppa:team-xbmc/unstable<br />
</source><br />
}}<br />
<br />
== Uninstalling or Removing ==<br />
{{FAQ|1=Uninstalling XBMC<br />
| BGcolor=<br />
| Question=How do I uninstall XBMC?<br />
| Answer=<br />
If you need to remove and purge an application and finally removing/purging also the application configurations files, do so by typing:<br />
<syntaxhighlight lang="bash" enclose="div"><br />
sudo apt-get update<br />
sudo apt-get remove xbmc*<br />
sudo apt-get purge xbmc*<br />
</syntaxhighlight><br />
}}<section end="package_maintenance" /><br />
<br />
== Build Dependencies ==<br />
{{FAQ|1=PPA Build deps<br />
| BGcolor=whitesmoke<br />
| Question=What are PPA build dependencies?<br />
| Answer=<br />
These build dependencies are versions of a library pre-packaged by Team XBMC, because the distro provided versions are behind the current requirements of XBMC.<br />
Both [https://github.com/xbmc/xbmc/blob/master/docs/README.linux REAME.linux] and/or [https://github.com/xbmc/xbmc/blob/master/docs/README.ubuntu README.ubuntu] documents using XBMC ppa build dependencies refer to these dependencies in the Team XBMC PPA's used in conjunction, when compiling on Ubuntu or derivatives distros.<br />
}}<br />
|}<br />
<br />
== See also ==<br />
* [https://help.ubuntu.com/community/AptGet/Howto apt-get/How-to]</div>UNiversalhttps://kodi.wiki/index.php?title=Official_Ubuntu_PPA&diff=78902Official Ubuntu PPA2014-09-17T15:19:46Z<p>UNiversal: /* Package management F.A.Q. */</p>
<hr />
<div><section begin="intro" />[[w:Personal Package Archive|Personal Package Archive]]s, or '''PPA'''s are software repositories that hold compiled version of software, primarily for [[w:Ubuntu|Ubuntu]] and various Ubuntu derivatives (such as Lubuntu, non-Debian versions of Linux Mint, XBMCbuntu, and many others).<br />
<br />
The Team XBMC PPA provides the only officially supported pre-compiled binaries for Ubuntu and Ubuntu-based systems.<br />
<br />
{{redv|NOTICE|'''All users should use the Team XBMC PPA instead of the system repositories (or any build that uses external ffmpeg/libav) for proper support and best running operation.'''}}<section end="intro" /><br />
<br />
== Repositories ==<br />
<section begin="repos" /><br />
The XBMC repositories are as follows:<br />
<br />
{| class="prettytable" width="100%"<br />
| https://launchpad.net/~team-xbmc/+archive/ppa || <code>'''ppa:team-xbmc/ppa'''</code> || Final release builds<br />
|-<br />
| https://launchpad.net/~team-xbmc/+archive/unstable || <code>'''ppa:team-xbmc/unstable'''</code> || [[beta|Betas and release candidates]]<br />
|-<br />
| https://launchpad.net/~team-xbmc/+archive/xbmc-nightly || <code>'''ppa:team-xbmc/xbmc-nightly'''</code> || [[Nightly builds]]<br />
|}<section end="repos" /><br />
{| class="prettytable" width="100%"<br />
| colspan="3" | For the users looking for compile with the PPA build depends in addition to the nightly PPA:<br />
|-<br />
| https://launchpad.net/~team-xbmc/+archive/xbmc-ppa-build-depends || <code>'''ppa:team-xbmc/xbmc-ppa-build-depends'''</code> || Build Depends<br />
|}<br />
<br />
== Package management F.A.Q. ==<br />
<section begin="package_maintenance" /><br />
{| width="100%"<br />
{{FAQ|1=Why_XBMC_ppa<br />
| BGcolor=whitesmoke<br />
| Question= Why are XBMC packages from Ubuntu repositories incorrect?<br />
| Answer=<br />
The simple answer is that, these packages derive from externally modified XBMC versions which are either '''outdated''' and '''broken''' or both, and are 100% officially '''unsupported''' at this time.<br />
<br />
The main thing you must understand is that if you looking for supported official builds, you simply should not use other repositories, unless otherwise indicated by a Team Member or a informed community member.<br />
}}<br />
<br />
{{FAQ|1=Dependencies<br />
| BGcolor=<br />
| Question=Are any dependencies required?<br />
| Answer=<br />
Some dependencies are required to manage ppa's/repositories within your distro, install these by typing:<br />
<syntaxhighlight lang="bash" enclose="div"><br />
sudo apt-get install python-software-properties pkg-config<br />
</syntaxhighlight><br />
}}<br />
<br />
{| width="100%"<br />
{{FAQ|1=What_ppa_do_I_have<br />
| BGcolor=whitesmoke<br />
| Question= How do I find out what repositories I am currently using?<br />
| Answer=<br />
You can get a complete listing of what repositories are part of your sources list by typing:<br />
<syntaxhighlight lang="bash" enclose="div"><br />
sudo apt-cache policy<br />
</syntaxhighlight><br />
}}<br />
<br />
{{FAQ|1=Adding or removing ppas<br />
| BGcolor=<br />
| Question=How do I add or remove ppas?<br />
| Answer=<br />
After you determined which ppa you would like to '''add''' or '''remove''' follow the instructions below.<br />
;You can remove a ppa from your distro's sources list via terminal, by typing:<br />
<syntaxhighlight lang="bash" enclose="div"><br />
sudo add-apt-repository -r ppa:current_XBMC_providing_ppa<br />
</syntaxhighlight><br />
<br />
;You can add a ppa to your distro's sources list via terminal, by typing:<br />
<syntaxhighlight lang="bash" enclose="div"><br />
sudo add-apt-repository ppa:the_ppa_you_wish_to_use<br />
</syntaxhighlight><br />
<br /><br />
{{note|<br />
* The process of adding and removing repositories is recommended when changing the repos in use.<br />
* Changing the PPA repo for XBMC will change what type of install is used (stable, nightly, beta, etc).}}<br />
}}<br />
<br />
== Installing, updating or upgrading ==<br />
{{FAQ|1=Installing XBMC<br />
| BGcolor=whitesmoke<br />
| Question=How do I install XBMC?<br />
| Answer=<br />
After adding or removing any ppa you need to refresh your sources list and finally install XBMC, by typing:<br />
<syntaxhighlight lang="bash" enclose="div"><br />
sudo apt-get update<br />
sudo apt-get install xbmc xbmc-bin<br />
</syntaxhighlight><br />
}}<br />
<br />
{{FAQ|1=Updating XBMC<br />
| BGcolor=<br />
| Question=How do I update XBMC?<br />
| Answer=<br />
To update XBMC/Kodi when a new version is released, just do a general system/package or use the following commands in the terminal (or via [[SSH]]):<br />
<br />
<source lang="bash"><br />
sudo apt-get update<br />
sudo apt-get install xbmc xbmc-bin<br />
</source><br />
}}<br />
<br />
{{FAQ|1=Upgrading XBMC<br />
| BGcolor=whitesmoke<br />
| Question=How do I upgrade XBMC?<br />
| Answer=<br />
After adding or removing any ppa you need to refresh your sources list and finally upgrade xbmc, by typing:<br />
<syntaxhighlight lang="bash" enclose="div"><br />
sudo apt-get update<br />
sudo apt-get --only-upgrade install xbmc xbmc-bin<br />
</syntaxhighlight><br />
}}<br />
<section begin="whynoupgrade" /><br />
{{FAQ|1=XBMC wont upgrade<br />
| BGcolor=<br />
| Question=Why wont XBMC upgrade?<br />
| Answer=<br />
After following the above instructions, XBMC is still not upgraded, the main reason why this happens is because the distribution you are using, is no longer supported and has reached an '''''end of life status'''''.<br />
<br />
See [https://wiki.ubuntu.com/Releases Current Ubuntu releases] if your current distro is listed under End of life table, you will need to upgrade your OS to a supported release.<br />
<br />
LTS releases are better for long term install and forget, installing obviously the very latest LTS release available.<br />
{{#lst:XBMCbuntu FAQ|upgradeOS}}<br />
}}<section end="whynoupgrade" /><br />
<br />
{{FAQ|1=Specific package versions.<br />
| BGcolor=whitesmoke<br />
| Question=How to install a specific versions?<br />
| Answer=<br />
In the event you need to install either by upgrade or downgrade a specific XBMC version (a reason may be a bug or to test a specific version), the PPA providing said version active must be in your '''sources.list.d''' along with a updated list of the packages.<br />
If the packages you intend to install are on a different PPA, you should probably remove that PPA to avoid confusion.<br />
<code>apt-get install packagename=version</code> is one way to achieve this.<br />
<syntaxhighlight lang="bash" enclose="div"><br />
sudo apt-get update<br />
sudo apt-get install xbmc=2:13.1~git20140606.0917-gotham-0trusty xbmc-bin=2:13.1~git20140606.0917-gotham-0trusty <br />
</syntaxhighlight><br />
<br />
Hint: For e.g. You can use result of <code>apt-cache policy xbmc</code> to see the candidates <packagename><version> available to you.<br />
{{Note| Removing/purging any previous versions if they are greater version of the package you are looking to install is necessary.}}<br />
}}<br />
<br />
{{FAQ|1=beta_unstable<br />
| BGcolor=<br />
| Question=How can I install a beta/unstable version?<br />
| Answer=<br />
To install a beta/unstable version of XBMC you must first add the unstable repository, then install XBMC:<br />
<source lang="bash"><br />
sudo add-apt-repository ppa:team-xbmc/unstable<br />
sudo apt-get update<br />
sudo apt-get install xbmc xbmc-bin<br />
</source><br />
:;or:<br />
<source lang="bash"><br />
sudo add-apt-repository ppa:team-xbmc/nightly<br />
sudo apt-get update<br />
sudo apt-get install xbmc xbmc-bin<br />
</source><br />
Follow the prompts to add the repository, then to add the updates, and finally install the new version of XBMC.<br />
{{note|1=You may need to restart your computer for the newly installed version to be working.}}<br />
}}<br />
<br />
{{FAQ|1=beta_unstable_to_stable<br />
| BGcolor=whitesmoke<br />
| Question=How can I move from a beta/unstable to a stable version?<br />
| Answer=<br />
Check what XBMC versions you have access to:<br />
<source lang="bash"><br />
sudo apt-cache policy xbmc<br />
xbmc:<br />
Installed: 2:13.2~git20140719.0900-beta2-0trusty<br />
Candidate: 2:13.2~git20140719.0900-beta2-0trusty<br />
Version table:<br />
*** 2:13.2~git20140719.0900-beta2-0trusty 0<br />
500 http://ppa.launchpad.net/team-xbmc/unstable/ubuntu/ trusty/main amd64 Packages<br />
100 /var/lib/dpkg/status<br />
2:13.1~git20140606.0917-gotham-0trusty 0<br />
500 http://ppa.launchpad.net/team-xbmc/ppa/ubuntu/ trusty/main amd64 Packages<br />
2:12.3+dfsg1-3ubuntu1 0<br />
500 http://us.archive.ubuntu.com/ubuntu/ trusty/universe amd64 Packages<br />
</source><br />
{{note|1=In the above example we have an unstable ('''team-xbmc/unstable''') and the release versions ('''team-xbmc/ppa''') available. The version with the '''***''' is the currently installed version (unstable)}}<br />
<br />
To install the release version we need to install the team-xbmc/ppa version (in the above example: "2:13.1~git20140606.0917-gotham-0trusty"). This requires us to install both the "'''xbmc'''" and the "'''xbmc-bin'''" package.<br />
<source lang="bash"><br />
sudo apt-get install xbmc=2:13.1~git20140606.0917-gotham-0trusty xbmc-bin=2:13.1~git20140606.0917-gotham-0trusty<br />
</source><br />
{{note|1=You will get a warning you are downgrading, hit Y when asked to continue}}<br />
<br />
Remove the beta/unstable repository from XBMC to clean up:<br />
<source lang="bash"><br />
sudo add-apt-repository -r ppa:team-xbmc/unstable<br />
</source><br />
}}<br />
<br />
== Uninstalling or Removing ==<br />
{{FAQ|1=Uninstalling XBMC<br />
| BGcolor=<br />
| Question=How do I uninstall XBMC?<br />
| Answer=<br />
If you need to remove and purge an application and finally removing/purging also the application configurations files, do so by typing:<br />
<syntaxhighlight lang="bash" enclose="div"><br />
sudo apt-get update<br />
sudo apt-get remove xbmc*<br />
sudo apt-get purge xbmc*<br />
</syntaxhighlight><br />
}}<section end="package_maintenance" /><br />
<br />
== Build Dependencies ==<br />
{{FAQ|1=PPA Build deps<br />
| BGcolor=whitesmoke<br />
| Question=What are PPA build dependencies?<br />
| Answer=<br />
These build dependencies are versions of a library pre-packaged by Team XBMC, because the distro provided versions are behind the current requirements of XBMC.<br />
Both [https://github.com/xbmc/xbmc/blob/master/docs/README.linux REAME.linux] and/or [https://github.com/xbmc/xbmc/blob/master/docs/README.ubuntu README.ubuntu] documents using XBMC ppa build dependencies refer to these dependencies in the Team XBMC PPA's used in conjunction, when compiling on Ubuntu or derivatives distros.<br />
}}<br />
|}<br />
<br />
== See also ==<br />
* [https://help.ubuntu.com/community/AptGet/Howto apt-get/How-to]</div>UNiversalhttps://kodi.wiki/index.php?title=Official_Ubuntu_PPA&diff=78901Official Ubuntu PPA2014-09-17T15:13:49Z<p>UNiversal: /* Installing, updating or upgrading */</p>
<hr />
<div><section begin="intro" />[[w:Personal Package Archive|Personal Package Archive]]s, or '''PPA'''s are software repositories that hold compiled version of software, primarily for [[w:Ubuntu|Ubuntu]] and various Ubuntu derivatives (such as Lubuntu, non-Debian versions of Linux Mint, XBMCbuntu, and many others).<br />
<br />
The Team XBMC PPA provides the only officially supported pre-compiled binaries for Ubuntu and Ubuntu-based systems.<br />
<br />
{{redv|NOTICE|'''All users should use the Team XBMC PPA instead of the system repositories (or any build that uses external ffmpeg/libav) for proper support and best running operation.'''}}<section end="intro" /><br />
<br />
== Repositories ==<br />
<section begin="repos" /><br />
The XBMC repositories are as follows:<br />
<br />
{| class="prettytable" width="100%"<br />
| https://launchpad.net/~team-xbmc/+archive/ppa || <code>'''ppa:team-xbmc/ppa'''</code> || Final release builds<br />
|-<br />
| https://launchpad.net/~team-xbmc/+archive/unstable || <code>'''ppa:team-xbmc/unstable'''</code> || [[beta|Betas and release candidates]]<br />
|-<br />
| https://launchpad.net/~team-xbmc/+archive/xbmc-nightly || <code>'''ppa:team-xbmc/xbmc-nightly'''</code> || [[Nightly builds]]<br />
|}<section end="repos" /><br />
{| class="prettytable" width="100%"<br />
| colspan="3" | For the users looking for compile with the PPA build depends in addition to the nightly PPA:<br />
|-<br />
| https://launchpad.net/~team-xbmc/+archive/xbmc-ppa-build-depends || <code>'''ppa:team-xbmc/xbmc-ppa-build-depends'''</code> || Build Depends<br />
|}<br />
<br />
== Package management F.A.Q. ==<br />
<section begin="package_maintenance" /><br />
{| width="100%"<br />
{{FAQ|1=Why_XBMC_ppa<br />
| BGcolor=whitesmoke<br />
| Question= Why are XBMC packages from Ubuntu repositories incorrect?<br />
| Answer=<br />
The simple answer is that, these packages derive from externally modified XBMC versions which are either '''outdated''' and '''broken''' or both, and are 100% officially '''unsupported''' at this time.<br />
<br />
The main thing you must understand is that if you looking for supported official builds, you simply should not use other repositories, unless otherwise indicated by a Team Member or a informed community member.<br />
}}<br />
<br />
{{FAQ|1=Dependencies<br />
| BGcolor=<br />
| Question=Are any dependencies required?<br />
| Answer=<br />
Some dependencies are required to manage ppas/repositories into your distro, install these by typing:<br />
<syntaxhighlight lang="bash" enclose="div"><br />
sudo apt-get install python-software-properties pkg-config<br />
</syntaxhighlight><br />
}}<br />
<br />
{| width="100%"<br />
{{FAQ|1=What_ppa_do_I_have<br />
| BGcolor=whitesmoke<br />
| Question= How do I find out what repositories I am currently using?<br />
| Answer=<br />
You can get a complete listing of what repositories are part of your sources list by typing:<br />
<syntaxhighlight lang="bash" enclose="div"><br />
sudo apt-cache policy<br />
</syntaxhighlight><br />
}}<br />
<br />
{{FAQ|1=Adding or removing ppas<br />
| BGcolor=<br />
| Question=How do I add or remove ppas?<br />
| Answer=<br />
After you determined which ppa you would like to '''add''' or '''remove''' follow the instructions below.<br />
;You can remove a ppa from your distro's sources list via terminal, by typing:<br />
<syntaxhighlight lang="bash" enclose="div"><br />
sudo add-apt-repository -r ppa:current_XBMC_providing_ppa<br />
</syntaxhighlight><br />
<br />
;You can add a ppa to your distro's sources list via terminal, by typing:<br />
<syntaxhighlight lang="bash" enclose="div"><br />
sudo add-apt-repository ppa:the_ppa_you_wish_to_use<br />
</syntaxhighlight><br />
<br /><br />
{{note|<br />
* The process of adding and removing repositories is recommended when changing the repos in use.<br />
* Changing the PPA repo for XBMC will change what type of install is used (stable, nightly, beta, etc).}}<br />
}}<br />
<br />
== Installing, updating or upgrading ==<br />
{{FAQ|1=Installing XBMC<br />
| BGcolor=whitesmoke<br />
| Question=How do I install XBMC?<br />
| Answer=<br />
After adding or removing any ppa you need to refresh your sources list and finally install XBMC, by typing:<br />
<syntaxhighlight lang="bash" enclose="div"><br />
sudo apt-get update<br />
sudo apt-get install xbmc xbmc-bin<br />
</syntaxhighlight><br />
}}<br />
<br />
{{FAQ|1=Updating XBMC<br />
| BGcolor=<br />
| Question=How do I update XBMC?<br />
| Answer=<br />
To update XBMC/Kodi when a new version is released, just do a general system/package or use the following commands in the terminal (or via [[SSH]]):<br />
<br />
<source lang="bash"><br />
sudo apt-get update<br />
sudo apt-get install xbmc xbmc-bin<br />
</source><br />
}}<br />
<br />
{{FAQ|1=Upgrading XBMC<br />
| BGcolor=whitesmoke<br />
| Question=How do I upgrade XBMC?<br />
| Answer=<br />
After adding or removing any ppa you need to refresh your sources list and finally upgrade xbmc, by typing:<br />
<syntaxhighlight lang="bash" enclose="div"><br />
sudo apt-get update<br />
sudo apt-get --only-upgrade install xbmc xbmc-bin<br />
</syntaxhighlight><br />
}}<br />
<section begin="whynoupgrade" /><br />
{{FAQ|1=XBMC wont upgrade<br />
| BGcolor=<br />
| Question=Why wont XBMC upgrade?<br />
| Answer=<br />
After following the above instructions, XBMC is still not upgraded, the main reason why this happens is because the distribution you are using, is no longer supported and has reached an '''''end of life status'''''.<br />
<br />
See [https://wiki.ubuntu.com/Releases Current Ubuntu releases] if your current distro is listed under End of life table, you will need to upgrade your OS to a supported release.<br />
<br />
LTS releases are better for long term install and forget, installing obviously the very latest LTS release available.<br />
{{#lst:XBMCbuntu FAQ|upgradeOS}}<br />
}}<section end="whynoupgrade" /><br />
<br />
{{FAQ|1=Specific package versions.<br />
| BGcolor=whitesmoke<br />
| Question=How to install a specific versions?<br />
| Answer=<br />
In the event you need to install either by upgrade or downgrade a specific XBMC version (a reason may be a bug or to test a specific version), the PPA providing said version active must be in your '''sources.list.d''' along with a updated list of the packages.<br />
If the packages you intend to install are on a different PPA, you should probably remove that PPA to avoid confusion.<br />
<code>apt-get install packagename=version</code> is one way to achieve this.<br />
<syntaxhighlight lang="bash" enclose="div"><br />
sudo apt-get update<br />
sudo apt-get install xbmc=2:13.1~git20140606.0917-gotham-0trusty xbmc-bin=2:13.1~git20140606.0917-gotham-0trusty <br />
</syntaxhighlight><br />
<br />
Hint: For e.g. You can use result of <code>apt-cache policy xbmc</code> to see the candidates <packagename><version> available to you.<br />
{{Note| Removing/purging any previous versions if they are greater version of the package you are looking to install is necessary.}}<br />
}}<br />
<br />
{{FAQ|1=beta_unstable<br />
| BGcolor=<br />
| Question=How can I install a beta/unstable version?<br />
| Answer=<br />
To install a beta/unstable version of XBMC you must first add the unstable repository, then install XBMC:<br />
<source lang="bash"><br />
sudo add-apt-repository ppa:team-xbmc/unstable<br />
sudo apt-get update<br />
sudo apt-get install xbmc xbmc-bin<br />
</source><br />
:;or:<br />
<source lang="bash"><br />
sudo add-apt-repository ppa:team-xbmc/nightly<br />
sudo apt-get update<br />
sudo apt-get install xbmc xbmc-bin<br />
</source><br />
Follow the prompts to add the repository, then to add the updates, and finally install the new version of XBMC.<br />
{{note|1=You may need to restart your computer for the newly installed version to be working.}}<br />
}}<br />
<br />
{{FAQ|1=beta_unstable_to_stable<br />
| BGcolor=whitesmoke<br />
| Question=How can I move from a beta/unstable to a stable version?<br />
| Answer=<br />
Check what XBMC versions you have access to:<br />
<source lang="bash"><br />
sudo apt-cache policy xbmc<br />
xbmc:<br />
Installed: 2:13.2~git20140719.0900-beta2-0trusty<br />
Candidate: 2:13.2~git20140719.0900-beta2-0trusty<br />
Version table:<br />
*** 2:13.2~git20140719.0900-beta2-0trusty 0<br />
500 http://ppa.launchpad.net/team-xbmc/unstable/ubuntu/ trusty/main amd64 Packages<br />
100 /var/lib/dpkg/status<br />
2:13.1~git20140606.0917-gotham-0trusty 0<br />
500 http://ppa.launchpad.net/team-xbmc/ppa/ubuntu/ trusty/main amd64 Packages<br />
2:12.3+dfsg1-3ubuntu1 0<br />
500 http://us.archive.ubuntu.com/ubuntu/ trusty/universe amd64 Packages<br />
</source><br />
{{note|1=In the above example we have an unstable ('''team-xbmc/unstable''') and the release versions ('''team-xbmc/ppa''') available. The version with the '''***''' is the currently installed version (unstable)}}<br />
<br />
To install the release version we need to install the team-xbmc/ppa version (in the above example: "2:13.1~git20140606.0917-gotham-0trusty"). This requires us to install both the "'''xbmc'''" and the "'''xbmc-bin'''" package.<br />
<source lang="bash"><br />
sudo apt-get install xbmc=2:13.1~git20140606.0917-gotham-0trusty xbmc-bin=2:13.1~git20140606.0917-gotham-0trusty<br />
</source><br />
{{note|1=You will get a warning you are downgrading, hit Y when asked to continue}}<br />
<br />
Remove the beta/unstable repository from XBMC to clean up:<br />
<source lang="bash"><br />
sudo add-apt-repository -r ppa:team-xbmc/unstable<br />
</source><br />
}}<br />
<br />
== Uninstalling or Removing ==<br />
{{FAQ|1=Uninstalling XBMC<br />
| BGcolor=<br />
| Question=How do I uninstall XBMC?<br />
| Answer=<br />
If you need to remove and purge an application and finally removing/purging also the application configurations files, do so by typing:<br />
<syntaxhighlight lang="bash" enclose="div"><br />
sudo apt-get update<br />
sudo apt-get remove xbmc*<br />
sudo apt-get purge xbmc*<br />
</syntaxhighlight><br />
}}<section end="package_maintenance" /><br />
<br />
== Build Dependencies ==<br />
{{FAQ|1=PPA Build deps<br />
| BGcolor=whitesmoke<br />
| Question=What are PPA build dependencies?<br />
| Answer=<br />
These build dependencies are versions of a library pre-packaged by Team XBMC, because the distro provided versions are behind the current requirements of XBMC.<br />
Both [https://github.com/xbmc/xbmc/blob/master/docs/README.linux REAME.linux] and/or [https://github.com/xbmc/xbmc/blob/master/docs/README.ubuntu README.ubuntu] documents using XBMC ppa build dependencies refer to these dependencies in the Team XBMC PPA's used in conjunction, when compiling on Ubuntu or derivatives distros.<br />
}}<br />
|}<br />
<br />
== See also ==<br />
* [https://help.ubuntu.com/community/AptGet/Howto apt-get/How-to]</div>UNiversalhttps://kodi.wiki/index.php?title=Official_Ubuntu_PPA&diff=78900Official Ubuntu PPA2014-09-17T15:09:06Z<p>UNiversal: /* Package management F.A.Q. */</p>
<hr />
<div><section begin="intro" />[[w:Personal Package Archive|Personal Package Archive]]s, or '''PPA'''s are software repositories that hold compiled version of software, primarily for [[w:Ubuntu|Ubuntu]] and various Ubuntu derivatives (such as Lubuntu, non-Debian versions of Linux Mint, XBMCbuntu, and many others).<br />
<br />
The Team XBMC PPA provides the only officially supported pre-compiled binaries for Ubuntu and Ubuntu-based systems.<br />
<br />
{{redv|NOTICE|'''All users should use the Team XBMC PPA instead of the system repositories (or any build that uses external ffmpeg/libav) for proper support and best running operation.'''}}<section end="intro" /><br />
<br />
== Repositories ==<br />
<section begin="repos" /><br />
The XBMC repositories are as follows:<br />
<br />
{| class="prettytable" width="100%"<br />
| https://launchpad.net/~team-xbmc/+archive/ppa || <code>'''ppa:team-xbmc/ppa'''</code> || Final release builds<br />
|-<br />
| https://launchpad.net/~team-xbmc/+archive/unstable || <code>'''ppa:team-xbmc/unstable'''</code> || [[beta|Betas and release candidates]]<br />
|-<br />
| https://launchpad.net/~team-xbmc/+archive/xbmc-nightly || <code>'''ppa:team-xbmc/xbmc-nightly'''</code> || [[Nightly builds]]<br />
|}<section end="repos" /><br />
{| class="prettytable" width="100%"<br />
| colspan="3" | For the users looking for compile with the PPA build depends in addition to the nightly PPA:<br />
|-<br />
| https://launchpad.net/~team-xbmc/+archive/xbmc-ppa-build-depends || <code>'''ppa:team-xbmc/xbmc-ppa-build-depends'''</code> || Build Depends<br />
|}<br />
<br />
== Package management F.A.Q. ==<br />
<section begin="package_maintenance" /><br />
{| width="100%"<br />
{{FAQ|1=Why_XBMC_ppa<br />
| BGcolor=whitesmoke<br />
| Question= Why are XBMC packages from Ubuntu repositories incorrect?<br />
| Answer=<br />
The simple answer is that, these packages derive from externally modified XBMC versions which are either '''outdated''' and '''broken''' or both, and are 100% officially '''unsupported''' at this time.<br />
<br />
The main thing you must understand is that if you looking for supported official builds, you simply should not use other repositories, unless otherwise indicated by a Team Member or a informed community member.<br />
}}<br />
<br />
{{FAQ|1=Dependencies<br />
| BGcolor=<br />
| Question=Are any dependencies required?<br />
| Answer=<br />
Some dependencies are required to manage ppas/repositories into your distro, install these by typing:<br />
<syntaxhighlight lang="bash" enclose="div"><br />
sudo apt-get install python-software-properties pkg-config<br />
</syntaxhighlight><br />
}}<br />
<br />
{| width="100%"<br />
{{FAQ|1=What_ppa_do_I_have<br />
| BGcolor=whitesmoke<br />
| Question= How do I find out what repositories I am currently using?<br />
| Answer=<br />
You can get a complete listing of what repositories are part of your sources list by typing:<br />
<syntaxhighlight lang="bash" enclose="div"><br />
sudo apt-cache policy<br />
</syntaxhighlight><br />
}}<br />
<br />
{{FAQ|1=Adding or removing ppas<br />
| BGcolor=<br />
| Question=How do I add or remove ppas?<br />
| Answer=<br />
After you determined which ppa you would like to '''add''' or '''remove''' follow the instructions below.<br />
;You can remove a ppa from your distro's sources list via terminal, by typing:<br />
<syntaxhighlight lang="bash" enclose="div"><br />
sudo add-apt-repository -r ppa:current_XBMC_providing_ppa<br />
</syntaxhighlight><br />
<br />
;You can add a ppa to your distro's sources list via terminal, by typing:<br />
<syntaxhighlight lang="bash" enclose="div"><br />
sudo add-apt-repository ppa:the_ppa_you_wish_to_use<br />
</syntaxhighlight><br />
<br /><br />
{{note|<br />
* The process of adding and removing repositories is recommended when changing the repos in use.<br />
* Changing the PPA repo for XBMC will change what type of install is used (stable, nightly, beta, etc).}}<br />
}}<br />
<br />
== Installing, updating or upgrading ==<br />
{{FAQ|1=Installing XBMC<br />
| BGcolor=whitesmoke<br />
| Question=How do I install XBMC?<br />
| Answer=<br />
After adding or removing any ppa you need to refresh your sources list and finally install XBMC, by typing:<br />
<syntaxhighlight lang="bash" enclose="div"><br />
sudo apt-get update<br />
sudo apt-get install xbmc xbmc-bin<br />
</syntaxhighlight><br />
}}<br />
<br />
{{FAQ|1=Updating XBMC<br />
| BGcolor=<br />
| Question=How do I update XBMC?<br />
| Answer=<br />
To update XBMC/Kodi when a new version is released, just do a general system/package or use the following commands in the terminal (or via [[SSH]]):<br />
<br />
<source lang="bash"><br />
sudo apt-get update<br />
sudo apt-get install xbmc xbmc-bin<br />
</source><br />
}}<br />
<br />
{{FAQ|1=Upgrading XBMC<br />
| BGcolor=whitesmoke<br />
| Question=How do I upgrade XBMC?<br />
| Answer=<br />
After adding or removing any ppa you need to refresh your sources list and finally upgrade xbmc, by typing:<br />
<syntaxhighlight lang="bash" enclose="div"><br />
sudo apt-get update<br />
sudo apt-get --only-upgrade install xbmc xbmc-bin<br />
</syntaxhighlight><br />
}}<br />
<section begin="whynoupgrade" /><br />
{{FAQ|1=XBMC wont upgrade<br />
| BGcolor=<br />
| Question=Why wont XBMC upgrade?<br />
| Answer=<br />
After following the above instructions, XBMC is still not upgraded, the main reason why this happens is because the distribution you are using, is no longer supported and has reached an '''''end of life status'''''.<br />
<br />
See [https://wiki.ubuntu.com/Releases Current Ubuntu releases] if your current distro is listed under End of life table, you will need to upgrade your OS to a supported release.<br />
<br />
LTS releases are better for long term install and forget, installing obviously the very latest LTS release available.<br />
{{#lst:XBMCbuntu FAQ|upgradeOS}}<br />
}}<section end="whynoupgrade" /><br />
<br />
{{FAQ|1=Specific package versions.<br />
| BGcolor=whitesmoke<br />
| Question=How to install a specific versions?<br />
| Answer=<br />
In the event you need to install either by upgrade or downgrade a specific XBMC version (a reason may be a bug or to test a specific version), the PPA providing said version active must be in your '''sources.list.d''' along with a updated list of the packages.<br />
If the packages you intend to install are on a different PPA, you should probably remove that PPA to avoid confusion.<br />
<code>apt-get install packagename=version</code> is one way to achieve this.<br />
<syntaxhighlight lang="bash" enclose="div"><br />
sudo apt-get update<br />
sudo apt-get install xbmc=2:13.1~git20140606.0917-gotham-0trusty xbmc-bin=2:13.1~git20140606.0917-gotham-0trusty <br />
</syntaxhighlight><br />
<br />
Hint: For e.g. You can use result of <code>apt-cache policy xbmc</code> to see the candidates <packagename><version> available to you.<br />
{{Note| Removing/purging any previous versions if they are greater version of the package you are looking to install is necessary.}}<br />
}}<br />
<br />
{{FAQ|1=beta_unstable<br />
| BGcolor=<br />
| Question=How can I install a beta/unstable version?<br />
| Answer=<br />
To install a beta/unstable version of XBMC you must first add the unstable repository, then install XBMC:<br />
<source lang="bash"><br />
sudo add-apt-repository ppa:team-xbmc/unstable<br />
sudo apt-get update<br />
sudo apt-get install xbmc<br />
</source><br />
Follow the prompts to add the repository, then to add the updates, and finally install the new version of XBMC.<br />
{{note|1=You may need to restart your computer for the newly installed version to be working.}}<br />
}}<br />
<br />
{{FAQ|1=beta_unstable_to_stable<br />
| BGcolor=whitesmoke<br />
| Question=How can I move from a beta/unstable to a stable version?<br />
| Answer=<br />
Check what XBMC versions you have access to:<br />
<source lang="bash"><br />
sudo apt-cache policy xbmc<br />
xbmc:<br />
Installed: 2:13.2~git20140719.0900-beta2-0trusty<br />
Candidate: 2:13.2~git20140719.0900-beta2-0trusty<br />
Version table:<br />
*** 2:13.2~git20140719.0900-beta2-0trusty 0<br />
500 http://ppa.launchpad.net/team-xbmc/unstable/ubuntu/ trusty/main amd64 Packages<br />
100 /var/lib/dpkg/status<br />
2:13.1~git20140606.0917-gotham-0trusty 0<br />
500 http://ppa.launchpad.net/team-xbmc/ppa/ubuntu/ trusty/main amd64 Packages<br />
2:12.3+dfsg1-3ubuntu1 0<br />
500 http://us.archive.ubuntu.com/ubuntu/ trusty/universe amd64 Packages<br />
</source><br />
{{note|1=In the above example we have an unstable ('''team-xbmc/unstable''') and the release versions ('''team-xbmc/ppa''') available. The version with the '''***''' is the currently installed version (unstable)}}<br />
<br />
To install the release version we need to install the team-xbmc/ppa version (in the above example: "2:13.1~git20140606.0917-gotham-0trusty"). This requires us to install both the "'''xbmc'''" and the "'''xbmc-bin'''" package.<br />
<source lang="bash"><br />
sudo apt-get install xbmc=2:13.1~git20140606.0917-gotham-0trusty xbmc-bin=2:13.1~git20140606.0917-gotham-0trusty<br />
</source><br />
{{note|1=You will get a warning you are downgrading, hit Y when asked to continue}}<br />
<br />
Remove the beta/unstable repository from XBMC to clean up:<br />
<source lang="bash"><br />
sudo add-apt-repository -r ppa:team-xbmc/unstable<br />
</source><br />
}}<br />
<br />
== Uninstalling or Removing ==<br />
{{FAQ|1=Uninstalling XBMC<br />
| BGcolor=<br />
| Question=How do I uninstall XBMC?<br />
| Answer=<br />
If you need to remove and purge an application and finally removing/purging also the application configurations files, do so by typing:<br />
<syntaxhighlight lang="bash" enclose="div"><br />
sudo apt-get update<br />
sudo apt-get remove xbmc*<br />
sudo apt-get purge xbmc*<br />
</syntaxhighlight><br />
}}<section end="package_maintenance" /><br />
<br />
== Build Dependencies ==<br />
{{FAQ|1=PPA Build deps<br />
| BGcolor=whitesmoke<br />
| Question=What are PPA build dependencies?<br />
| Answer=<br />
These build dependencies are versions of a library pre-packaged by Team XBMC, because the distro provided versions are behind the current requirements of XBMC.<br />
Both [https://github.com/xbmc/xbmc/blob/master/docs/README.linux REAME.linux] and/or [https://github.com/xbmc/xbmc/blob/master/docs/README.ubuntu README.ubuntu] documents using XBMC ppa build dependencies refer to these dependencies in the Team XBMC PPA's used in conjunction, when compiling on Ubuntu or derivatives distros.<br />
}}<br />
|}<br />
<br />
== See also ==<br />
* [https://help.ubuntu.com/community/AptGet/Howto apt-get/How-to]</div>UNiversalhttps://kodi.wiki/index.php?title=Official_Ubuntu_PPA&diff=78899Official Ubuntu PPA2014-09-17T15:03:42Z<p>UNiversal: /* Package management F.A.Q. */</p>
<hr />
<div><section begin="intro" />[[w:Personal Package Archive|Personal Package Archive]]s, or '''PPA'''s are software repositories that hold compiled version of software, primarily for [[w:Ubuntu|Ubuntu]] and various Ubuntu derivatives (such as Lubuntu, non-Debian versions of Linux Mint, XBMCbuntu, and many others).<br />
<br />
The Team XBMC PPA provides the only officially supported pre-compiled binaries for Ubuntu and Ubuntu-based systems.<br />
<br />
{{redv|NOTICE|'''All users should use the Team XBMC PPA instead of the system repositories (or any build that uses external ffmpeg/libav) for proper support and best running operation.'''}}<section end="intro" /><br />
<br />
== Repositories ==<br />
<section begin="repos" /><br />
The XBMC repositories are as follows:<br />
<br />
{| class="prettytable" width="100%"<br />
| https://launchpad.net/~team-xbmc/+archive/ppa || <code>'''ppa:team-xbmc/ppa'''</code> || Final release builds<br />
|-<br />
| https://launchpad.net/~team-xbmc/+archive/unstable || <code>'''ppa:team-xbmc/unstable'''</code> || [[beta|Betas and release candidates]]<br />
|-<br />
| https://launchpad.net/~team-xbmc/+archive/xbmc-nightly || <code>'''ppa:team-xbmc/xbmc-nightly'''</code> || [[Nightly builds]]<br />
|}<section end="repos" /><br />
{| class="prettytable" width="100%"<br />
| colspan="3" | For the users looking for compile with the PPA build depends in addition to the nightly PPA:<br />
|-<br />
| https://launchpad.net/~team-xbmc/+archive/xbmc-ppa-build-depends || <code>'''ppa:team-xbmc/xbmc-ppa-build-depends'''</code> || Build Depends<br />
|}<br />
<br />
== Package management F.A.Q. ==<br />
<section begin="package_maintenance" /><br />
{| width="100%"<br />
{{FAQ|1=Why_XBMC_ppa<br />
| BGcolor=whitesmoke<br />
| Question= Why are XBMC packages from Ubuntu repositories incorrect?<br />
| Answer=<br />
The simple answer is that, these packages derive from externally modified XBMC versions which are either '''outdated''' and '''broken''' or both, and are 100% officially '''unsupported''' at this time.<br />
<br />
The main thing you must understand is that if you looking for supported official builds, you simply should not use other repositories, unless otherwise indicated by a Team Member or a informed community member.<br />
}}<br />
<br />
{{FAQ|1=Dependencies<br />
| BGcolor=<br />
| Question=Are any dependencies required?<br />
| Answer=<br />
Some dependencies are required to manage ppas/repositories into your distro, install these by typing:<br />
<syntaxhighlight lang="bash" enclose="div"><br />
sudo apt-get install python-software-properties pkg-config<br />
</syntaxhighlight><br />
}}<br />
<br />
{| width="100%"<br />
{{FAQ|1=What_ppa_do_I_have<br />
| BGcolor=whitesmoke<br />
| Question= How do I find out what repositories I am currently using?<br />
| Answer=<br />
You can get a complete listing of what repositories are part of your sources list by typing:<br />
<syntaxhighlight lang="bash" enclose="div"><br />
sudo apt-cache policy<br />
</syntaxhighlight><br />
}}<br />
<br />
{{FAQ|1=Adding or removing ppas<br />
| BGcolor=<br />
| Question=How do I add or remove ppas?<br />
| Answer=<br />
After you determined which ppa you would like to '''add''' or '''remove''' follow the instructions below.<br />
;You can remove a ppa from your distro's sources list via terminal, by typing:<br />
<syntaxhighlight lang="bash" enclose="div"><br />
sudo add-apt-repository -r ppa:current_XBMC_providing_ppa<br />
</syntaxhighlight><br />
<br />
;You can add a ppa to your distro's sources list via terminal, by typing:<br />
<syntaxhighlight lang="bash" enclose="div"><br />
sudo add-apt-repository ppa:the_ppa_you_wish_to_use<br />
</syntaxhighlight><br />
}}<br />
<br />
== Installing, updating or upgrading ==<br />
{{FAQ|1=Installing XBMC<br />
| BGcolor=whitesmoke<br />
| Question=How do I install XBMC?<br />
| Answer=<br />
After adding or removing any ppa you need to refresh your sources list and finally install XBMC, by typing:<br />
<syntaxhighlight lang="bash" enclose="div"><br />
sudo apt-get update<br />
sudo apt-get install xbmc xbmc-bin<br />
</syntaxhighlight><br />
}}<br />
<br />
{{FAQ|1=Updating XBMC<br />
| BGcolor=<br />
| Question=How do I update XBMC?<br />
| Answer=<br />
To update XBMC/Kodi when a new version is released, just do a general system/package or use the following commands in the terminal (or via [[SSH]]):<br />
<br />
<source lang="bash"><br />
sudo apt-get update<br />
sudo apt-get install xbmc xbmc-bin<br />
</source><br />
}}<br />
<br />
{{FAQ|1=Upgrading XBMC<br />
| BGcolor=whitesmoke<br />
| Question=How do I upgrade XBMC?<br />
| Answer=<br />
After adding or removing any ppa you need to refresh your sources list and finally upgrade xbmc, by typing:<br />
<syntaxhighlight lang="bash" enclose="div"><br />
sudo apt-get update<br />
sudo apt-get --only-upgrade install xbmc xbmc-bin<br />
</syntaxhighlight><br />
}}<br />
<section begin="whynoupgrade" /><br />
{{FAQ|1=XBMC wont upgrade<br />
| BGcolor=<br />
| Question=Why wont XBMC upgrade?<br />
| Answer=<br />
After following the above instructions, XBMC is still not upgraded, the main reason why this happens is because the distribution you are using, is no longer supported and has reached an '''''end of life status'''''.<br />
<br />
See [https://wiki.ubuntu.com/Releases Current Ubuntu releases] if your current distro is listed under End of life table, you will need to upgrade your OS to a supported release.<br />
<br />
LTS releases are better for long term install and forget, installing obviously the very latest LTS release available.<br />
{{#lst:XBMCbuntu FAQ|upgradeOS}}<br />
}}<section end="whynoupgrade" /><br />
<br />
{{FAQ|1=Specific package versions.<br />
| BGcolor=whitesmoke<br />
| Question=How to install a specific versions?<br />
| Answer=<br />
In the event you need to install either by upgrade or downgrade a specific XBMC version (a reason may be a bug or to test a specific version), the PPA providing said version active must be in your '''sources.list.d''' along with a updated list of the packages.<br />
If the packages you intend to install are on a different PPA, you should probably remove that PPA to avoid confusion.<br />
<code>apt-get install packagename=version</code> is one way to achieve this.<br />
<syntaxhighlight lang="bash" enclose="div"><br />
sudo apt-get update<br />
sudo apt-get install xbmc=2:13.1~git20140606.0917-gotham-0trusty xbmc-bin=2:13.1~git20140606.0917-gotham-0trusty <br />
</syntaxhighlight><br />
<br />
Hint: For e.g. You can use result of <code>apt-cache policy xbmc</code> to see the candidates <packagename><version> available to you.<br />
{{Note| Removing/purging any previous versions if they are greater version of the package you are looking to install is necessary.}}<br />
}}<br />
<br />
{{FAQ|1=beta_unstable<br />
| BGcolor=<br />
| Question=How can I install a beta/unstable version?<br />
| Answer=<br />
To install a beta/unstable version of XBMC you must first add the unstable repository, then install XBMC:<br />
<source lang="bash"><br />
sudo add-apt-repository ppa:team-xbmc/unstable<br />
sudo apt-get update<br />
sudo apt-get install xbmc<br />
</source><br />
Follow the prompts to add the repository, then to add the updates, and finally install the new version of XBMC.<br />
{{note|1=You may need to restart your computer for the newly installed version to be working.}}<br />
}}<br />
<br />
{{FAQ|1=beta_unstable_to_stable<br />
| BGcolor=whitesmoke<br />
| Question=How can I move from a beta/unstable to a stable version?<br />
| Answer=<br />
Check what XBMC versions you have access to:<br />
<source lang="bash"><br />
sudo apt-cache policy xbmc<br />
xbmc:<br />
Installed: 2:13.2~git20140719.0900-beta2-0trusty<br />
Candidate: 2:13.2~git20140719.0900-beta2-0trusty<br />
Version table:<br />
*** 2:13.2~git20140719.0900-beta2-0trusty 0<br />
500 http://ppa.launchpad.net/team-xbmc/unstable/ubuntu/ trusty/main amd64 Packages<br />
100 /var/lib/dpkg/status<br />
2:13.1~git20140606.0917-gotham-0trusty 0<br />
500 http://ppa.launchpad.net/team-xbmc/ppa/ubuntu/ trusty/main amd64 Packages<br />
2:12.3+dfsg1-3ubuntu1 0<br />
500 http://us.archive.ubuntu.com/ubuntu/ trusty/universe amd64 Packages<br />
</source><br />
{{note|1=In the above example we have an unstable ('''team-xbmc/unstable''') and the release versions ('''team-xbmc/ppa''') available. The version with the '''***''' is the currently installed version (unstable)}}<br />
<br />
To install the release version we need to install the team-xbmc/ppa version (in the above example: "2:13.1~git20140606.0917-gotham-0trusty"). This requires us to install both the "'''xbmc'''" and the "'''xbmc-bin'''" package.<br />
<source lang="bash"><br />
sudo apt-get install xbmc=2:13.1~git20140606.0917-gotham-0trusty xbmc-bin=2:13.1~git20140606.0917-gotham-0trusty<br />
</source><br />
{{note|1=You will get a warning you are downgrading, hit Y when asked to continue}}<br />
<br />
Remove the beta/unstable repository from XBMC to clean up:<br />
<source lang="bash"><br />
sudo add-apt-repository -r ppa:team-xbmc/unstable<br />
</source><br />
}}<br />
<br />
== Uninstalling or Removing ==<br />
{{FAQ|1=Uninstalling XBMC<br />
| BGcolor=<br />
| Question=How do I uninstall XBMC?<br />
| Answer=<br />
If you need to remove and purge an application and finally removing/purging also the application configurations files, do so by typing:<br />
<syntaxhighlight lang="bash" enclose="div"><br />
sudo apt-get update<br />
sudo apt-get remove xbmc*<br />
sudo apt-get purge xbmc*<br />
</syntaxhighlight><br />
}}<section end="package_maintenance" /><br />
<br />
== Build Dependencies ==<br />
{{FAQ|1=PPA Build deps<br />
| BGcolor=whitesmoke<br />
| Question=What are PPA build dependencies?<br />
| Answer=<br />
These build dependencies are versions of a library pre-packaged by Team XBMC, because the distro provided versions are behind the current requirements of XBMC.<br />
Both [https://github.com/xbmc/xbmc/blob/master/docs/README.linux REAME.linux] and/or [https://github.com/xbmc/xbmc/blob/master/docs/README.ubuntu README.ubuntu] documents using XBMC ppa build dependencies refer to these dependencies in the Team XBMC PPA's used in conjunction, when compiling on Ubuntu or derivatives distros.<br />
}}<br />
|}<br />
<br />
== See also ==<br />
* [https://help.ubuntu.com/community/AptGet/Howto apt-get/How-to]</div>UNiversalhttps://kodi.wiki/index.php?title=Official_Ubuntu_PPA&diff=78898Official Ubuntu PPA2014-09-17T15:02:03Z<p>UNiversal: /* Package management F.A.Q. */</p>
<hr />
<div><section begin="intro" />[[w:Personal Package Archive|Personal Package Archive]]s, or '''PPA'''s are software repositories that hold compiled version of software, primarily for [[w:Ubuntu|Ubuntu]] and various Ubuntu derivatives (such as Lubuntu, non-Debian versions of Linux Mint, XBMCbuntu, and many others).<br />
<br />
The Team XBMC PPA provides the only officially supported pre-compiled binaries for Ubuntu and Ubuntu-based systems.<br />
<br />
{{redv|NOTICE|'''All users should use the Team XBMC PPA instead of the system repositories (or any build that uses external ffmpeg/libav) for proper support and best running operation.'''}}<section end="intro" /><br />
<br />
== Repositories ==<br />
<section begin="repos" /><br />
The XBMC repositories are as follows:<br />
<br />
{| class="prettytable" width="100%"<br />
| https://launchpad.net/~team-xbmc/+archive/ppa || <code>'''ppa:team-xbmc/ppa'''</code> || Final release builds<br />
|-<br />
| https://launchpad.net/~team-xbmc/+archive/unstable || <code>'''ppa:team-xbmc/unstable'''</code> || [[beta|Betas and release candidates]]<br />
|-<br />
| https://launchpad.net/~team-xbmc/+archive/xbmc-nightly || <code>'''ppa:team-xbmc/xbmc-nightly'''</code> || [[Nightly builds]]<br />
|}<section end="repos" /><br />
{| class="prettytable" width="100%"<br />
| colspan="3" | For the users looking for compile with the PPA build depends in addition to the nightly PPA:<br />
|-<br />
| https://launchpad.net/~team-xbmc/+archive/xbmc-ppa-build-depends || <code>'''ppa:team-xbmc/xbmc-ppa-build-depends'''</code> || Build Depends<br />
|}<br />
<br />
== Package management F.A.Q. ==<br />
<section begin="package_maintenance" /><br />
{| width="100%"<br />
{{FAQ|1=Why_XBMC_ppa<br />
| BGcolor=whitesmoke<br />
| Question= Why are XBMC packages from Ubuntu repositories incorrect?<br />
| Answer=<br />
The simple answer is that, these packages derive from externally modified XBMC versions which are either '''outdated''' and '''broken''' or both, and are 100% officially '''unsupported''' at this time.<br />
<br />
The main thing you must understand is that if you looking for supported official builds, you simply should not use other repositories, unless otherwise indicated by a Team Member or a informed community member.<br />
}}<br />
<br />
{{FAQ|1=Dependencies<br />
| BGcolor=<br />
| Question=Are any dependencies required?<br />
| Answer=<br />
Some dependencies are required to add ppas into your distro via terminal, by typing:<br />
<syntaxhighlight lang="bash" enclose="div"><br />
sudo apt-get install python-software-properties pkg-config<br />
</syntaxhighlight><br />
}}<br />
<br />
{| width="100%"<br />
{{FAQ|1=What_ppa_do_I_have<br />
| BGcolor=whitesmoke<br />
| Question= How do I find out what repositories I am currently using?<br />
| Answer=<br />
You can get a complete listing of what repositories are part of your sources list by typing:<br />
<syntaxhighlight lang="bash" enclose="div"><br />
sudo apt-cache policy<br />
</syntaxhighlight><br />
}}<br />
<br />
{{FAQ|1=Adding or removing ppas<br />
| BGcolor=<br />
| Question=How do I add or remove ppas?<br />
| Answer=<br />
After you determined which ppa you would like to '''add''' or '''remove''' follow the instructions below.<br />
;You can remove a ppa from your distro's sources list via terminal, by typing:<br />
<syntaxhighlight lang="bash" enclose="div"><br />
sudo add-apt-repository -r ppa:current_XBMC_providing_ppa<br />
</syntaxhighlight><br />
<br />
;You can add a ppa to your distro's sources list via terminal, by typing:<br />
<syntaxhighlight lang="bash" enclose="div"><br />
sudo add-apt-repository ppa:the_ppa_you_wish_to_use<br />
</syntaxhighlight><br />
Changing the PPA repo for XBMC will change what type of install is used (stable, nightly, beta, etc).<br />
}}<br />
<br />
== Installing, updating or upgrading ==<br />
{{FAQ|1=Installing XBMC<br />
| BGcolor=whitesmoke<br />
| Question=How do I install XBMC?<br />
| Answer=<br />
After adding or removing any ppa you need to refresh your sources list and finally install XBMC, by typing:<br />
<syntaxhighlight lang="bash" enclose="div"><br />
sudo apt-get update<br />
sudo apt-get install xbmc xbmc-bin<br />
</syntaxhighlight><br />
}}<br />
<br />
{{FAQ|1=Updating XBMC<br />
| BGcolor=<br />
| Question=How do I update XBMC?<br />
| Answer=<br />
To update XBMC/Kodi when a new version is released, just do a general system/package or use the following commands in the terminal (or via [[SSH]]):<br />
<br />
<source lang="bash"><br />
sudo apt-get update<br />
sudo apt-get install xbmc xbmc-bin<br />
</source><br />
}}<br />
<br />
{{FAQ|1=Upgrading XBMC<br />
| BGcolor=whitesmoke<br />
| Question=How do I upgrade XBMC?<br />
| Answer=<br />
After adding or removing any ppa you need to refresh your sources list and finally upgrade xbmc, by typing:<br />
<syntaxhighlight lang="bash" enclose="div"><br />
sudo apt-get update<br />
sudo apt-get --only-upgrade install xbmc xbmc-bin<br />
</syntaxhighlight><br />
}}<br />
<section begin="whynoupgrade" /><br />
{{FAQ|1=XBMC wont upgrade<br />
| BGcolor=<br />
| Question=Why wont XBMC upgrade?<br />
| Answer=<br />
After following the above instructions, XBMC is still not upgraded, the main reason why this happens is because the distribution you are using, is no longer supported and has reached an '''''end of life status'''''.<br />
<br />
See [https://wiki.ubuntu.com/Releases Current Ubuntu releases] if your current distro is listed under End of life table, you will need to upgrade your OS to a supported release.<br />
<br />
LTS releases are better for long term install and forget, installing obviously the very latest LTS release available.<br />
{{#lst:XBMCbuntu FAQ|upgradeOS}}<br />
}}<section end="whynoupgrade" /><br />
<br />
{{FAQ|1=Specific package versions.<br />
| BGcolor=whitesmoke<br />
| Question=How to install a specific versions?<br />
| Answer=<br />
In the event you need to install either by upgrade or downgrade a specific XBMC version (a reason may be a bug or to test a specific version), the PPA providing said version active must be in your '''sources.list.d''' along with a updated list of the packages.<br />
If the packages you intend to install are on a different PPA, you should probably remove that PPA to avoid confusion.<br />
<code>apt-get install packagename=version</code> is one way to achieve this.<br />
<syntaxhighlight lang="bash" enclose="div"><br />
sudo apt-get update<br />
sudo apt-get install xbmc=2:13.1~git20140606.0917-gotham-0trusty xbmc-bin=2:13.1~git20140606.0917-gotham-0trusty <br />
</syntaxhighlight><br />
<br />
Hint: For e.g. You can use result of <code>apt-cache policy xbmc</code> to see the candidates <packagename><version> available to you.<br />
{{Note| Removing/purging any previous versions if they are greater version of the package you are looking to install is necessary.}}<br />
}}<br />
<br />
{{FAQ|1=beta_unstable<br />
| BGcolor=<br />
| Question=How can I install a beta/unstable version?<br />
| Answer=<br />
To install a beta/unstable version of XBMC you must first add the unstable repository, then install XBMC:<br />
<source lang="bash"><br />
sudo add-apt-repository ppa:team-xbmc/unstable<br />
sudo apt-get update<br />
sudo apt-get install xbmc<br />
</source><br />
Follow the prompts to add the repository, then to add the updates, and finally install the new version of XBMC.<br />
{{note|1=You may need to restart your computer for the newly installed version to be working.}}<br />
}}<br />
<br />
{{FAQ|1=beta_unstable_to_stable<br />
| BGcolor=whitesmoke<br />
| Question=How can I move from a beta/unstable to a stable version?<br />
| Answer=<br />
Check what XBMC versions you have access to:<br />
<source lang="bash"><br />
sudo apt-cache policy xbmc<br />
xbmc:<br />
Installed: 2:13.2~git20140719.0900-beta2-0trusty<br />
Candidate: 2:13.2~git20140719.0900-beta2-0trusty<br />
Version table:<br />
*** 2:13.2~git20140719.0900-beta2-0trusty 0<br />
500 http://ppa.launchpad.net/team-xbmc/unstable/ubuntu/ trusty/main amd64 Packages<br />
100 /var/lib/dpkg/status<br />
2:13.1~git20140606.0917-gotham-0trusty 0<br />
500 http://ppa.launchpad.net/team-xbmc/ppa/ubuntu/ trusty/main amd64 Packages<br />
2:12.3+dfsg1-3ubuntu1 0<br />
500 http://us.archive.ubuntu.com/ubuntu/ trusty/universe amd64 Packages<br />
</source><br />
{{note|1=In the above example we have an unstable ('''team-xbmc/unstable''') and the release versions ('''team-xbmc/ppa''') available. The version with the '''***''' is the currently installed version (unstable)}}<br />
<br />
To install the release version we need to install the team-xbmc/ppa version (in the above example: "2:13.1~git20140606.0917-gotham-0trusty"). This requires us to install both the "'''xbmc'''" and the "'''xbmc-bin'''" package.<br />
<source lang="bash"><br />
sudo apt-get install xbmc=2:13.1~git20140606.0917-gotham-0trusty xbmc-bin=2:13.1~git20140606.0917-gotham-0trusty<br />
</source><br />
{{note|1=You will get a warning you are downgrading, hit Y when asked to continue}}<br />
<br />
Remove the beta/unstable repository from XBMC to clean up:<br />
<source lang="bash"><br />
sudo add-apt-repository -r ppa:team-xbmc/unstable<br />
</source><br />
}}<br />
<br />
== Uninstalling or Removing ==<br />
{{FAQ|1=Uninstalling XBMC<br />
| BGcolor=<br />
| Question=How do I uninstall XBMC?<br />
| Answer=<br />
If you need to remove and purge an application and finally removing/purging also the application configurations files, do so by typing:<br />
<syntaxhighlight lang="bash" enclose="div"><br />
sudo apt-get update<br />
sudo apt-get remove xbmc*<br />
sudo apt-get purge xbmc*<br />
</syntaxhighlight><br />
}}<section end="package_maintenance" /><br />
<br />
== Build Dependencies ==<br />
{{FAQ|1=PPA Build deps<br />
| BGcolor=whitesmoke<br />
| Question=What are PPA build dependencies?<br />
| Answer=<br />
These build dependencies are versions of a library pre-packaged by Team XBMC, because the distro provided versions are behind the current requirements of XBMC.<br />
Both [https://github.com/xbmc/xbmc/blob/master/docs/README.linux REAME.linux] and/or [https://github.com/xbmc/xbmc/blob/master/docs/README.ubuntu README.ubuntu] documents using XBMC ppa build dependencies refer to these dependencies in the Team XBMC PPA's used in conjunction, when compiling on Ubuntu or derivatives distros.<br />
}}<br />
|}<br />
<br />
== See also ==<br />
* [https://help.ubuntu.com/community/AptGet/Howto apt-get/How-to]</div>UNiversal