Archive talk:Install Kodi on Fedora 26 using RPMFusion packages

2016-01-15T19:46:52Z

Slashnull: /* Guide rewrite */

==Guide rewrite==
I am going to be revising a few sections soon.
#Firewall: You can leave it enabled and just open the following ports: TCP: 1151, 8080, and UDP: 1900, 9777
#Pulseaudio: Kodi is fully functional with pulseaudio installed and enabled.
#Systemd service: If you have GDM installed (and autologin enabled) you do not need any of the service script or other changes so it makes this guide much more simple. As the old saying goes: Keep It Simple Stupid.
:[[User:Mooninite|Mooninite]] ([[User talk:Mooninite|talk]]) 09:05, 8 April 2015 (EDT)

#Thanks for the firewall-related tips. I believe the port-list that should be opened will depend on individual circumstances. For example on my standalone setup the kodi.bin process is listening on ports TCP (8080, 1147) and UDP (9777, 1900). Were I to utilize miniDLNA I would have to add TCP port 8200. Airplay can potentially require TCP (80, 443, 554, 3689, 5297, 5289) and UDP (554, 5289, 5353). Given that this is a standalone environment and making custom adjustments to the firewall as services are enabled/disabled is an advanced topic, it seems much simpler to leave the firewall disabled - with the caveats already mentioned in the wiki.
#Pulseaudio still has some deficiencies, such has lacking support for TrueHD or DTS-MA, preventing use of Dolby Pro Logic II, etc. Refer to [[PulseAudio ]]for some further explanation. Actually, the only real advantage Pulseaudio offers is non-exclusive use of the audio subsystem, in cases where you'd like (for example) desktop sounds or other apps to co-exist with Kodi. Since this guide is strongly focused on creating a standalone Kodi environment, Pulseaudio makes little sense to utilize. Given its deficiencies and lack of countervailing advantages, there's no reason to utilize PulseAudio.
#Why would you want GDM to be installed? It's just an unnecessary layer of functionality that introduces complexity but offers little/no benefit. At the very least you'd then have to set up GDM-based auto-login, which is not only extra complexity but a potential security risk. The spirit of this guide is to create a standalone, lightweight installation of Kodi with minimal additional requirements. You are exactly right re: KISS, and introducing a dependency on an unnecessary software layer would seem to contravene this.
You made some earlier edits that removed the section on disabling SELinux. Kodi may have evolved to the point where it can properly function in an SELinux-Enforcing environment, but it used to have issues. I will test in an enforcing environment and update the wiki accordingly. However until I've tested it I will revert your changes to restore the SELinux section.

Thanks again for the tips!
:[[User:Wirerydr|Wirerydr]] ([[User talk:Wirerydr|talk]]) 12:03, 24 April 2015 (EDT)

Hope you don't mind that I added a section for CEC, it was a feature I needed and I thought it may be useful until libcec>=3.0.0 is put into the fedora repos and the rpm in rpmfusion is rebuilt.

:[[User:Slashnull|Slashnull]] ([[User talk:Slashnull|talk]]) 13:46, 15 January 2016 (EDT)

Archive:Install Kodi on Fedora 26 using RPMFusion packages

2016-01-15T13:14:18Z

Slashnull: /* Installing Kodi And Configuring It To Run Automatically */

{{mininav| [[Installing]] | [[Linux]] }}
{{see also|Linux FAQ}}
<section begin="intro" />This page presents an approach to turning a minimal installation of Fedora 23 into a standalone Kodi 15.x installation, with minimal additional software / overhead. The Kodi packages available from RPMFusion are used as the basis for this setup. At the end of this guide you will have a set-top box style of system that, when powered up, will quickly boot and then start Kodi automatically without intervention (''e.g.'' no need to first log in).<section end="intro" />
 
 
 
== Current State of This Guide ==
This guide is ready for general use, and has been tested on the following hardware/software:
<section begin="Testing" />
{| class="prettytable" style="background-color:#FFFFFF;"
! OS
| [https://getfedora.org/en/server Fedora 23 Server (x86_64)]
|-
! Kodi
| [http://download1.rpmfusion.org/free/fedora/updates/testing/23/x86_64/repoview/kodi.html Kodi v15.2] (testing) from the [http://download1.rpmfusion.org/free/fedora/updates/testing/23/x86_64/repoview/index.html rpmfusion-free-updates] repository
|-
! Motherboard
| [http://www.gigabyte.com/products/product-page.aspx?pid=4716 Gigabyte GA-F2A88XM-D3H (rev 3.0)]
|-
! CPU
| [http://www.amd.com/en-us/products/processors/desktop/a-series-apu#2 AMD A6-5400K dual-core 3.8GHz 65W]
|-
! Memory
| [http://www.corsair.com/en-us/vengeance-8gb-dual-channel-ddr3-memory-kit-cmz8gx3m2a1600c9 Corsair Vengeance 8GB (2x4GB) DDR3 1600MHz PC12800]
|-
! Graphics
| [http://www.asus.com/Graphics_Cards/ENGT240_SILENTDI1GD3/ Asus ENGT240 Silent GT240 fanless PCI-E 2.0 card]
|-
! Disk
| [http://www.wdc.com/global/products/specs/?driveID=792&language=1 Western Digital 1TB 7200RPM Black HDD]
|-
! Case
| [http://www.antec.com/pdf/manuals/Fusion%20Remote%20&%20Fusion%20Remote%20Black_EN%20manual.pdf Antec Fusion Remote Black HTPC Case]
|-
! Receiver
| [http://usa.denon.com/us/product/HomeTheater/AVReceiversHT/AVR3808CI Denon AVR-3808ci]
|-
! TV
| [http://shop.panasonic.com/shop/model/TH-50PZ800U# Panasonic 50" VIERA TH-50PZ800U Plasma]
|}<section end="Testing" />

 
 
== Assumptions ==
# This guide assumes you have at least a slight familiarity with Linux in general. If you know what a Bash shell is, can cut-and-paste commands, and are comfortable editing files with VI or Emacs, then you should be fine.
# It is assumed that Kodi will be installed into a freshly-installed Fedora 23 Server (x86_64) environment that was set up with no additional software specified. If you already have such an environment then you can skip the steps showing how to do a fresh-install of Fedora.
# This guide was written with the use of an Nvidia-based graphics card in-mind, (tested with an [http://www.asus.com/Graphics_Cards/ENGT240_SILENTDI1GD3/ Asus ENGT240 Silent GT240 fanless PCI-E 2.0 card]). If you have an AMD, Intel or other graphics solution, then either skip the Nvidia-specific steps or substitute your own. Also, this guide covers replacing the stock Nouveau (open-source) video drivers with proprietary Nvidia drivers (as obtained from Negativo17's Nvidia repository) for improved performance. You can skip this if you'd prefer, although your performance mileage may vary.
# It is assumed that audio will be passed via the HDMI port on your video card / motherboard to your TV / sound-system. Kodi can certainly handle other methods of passing audio, however those are beyond the scope of this article.
# Everything is done with the goal of minimizing how many software packages / dependencies are required. For example, since Kodi will be run as a fullcreen application, there is no need for heavyweight desktop environments such as Gnome and KDE, and all the apps/clutter they introduce.
# In order to make things simpler, this guide disables both SELinux and the local firewalld daemon. Ensure that the system is adequately protected by things like your internet router's firewall, and encrypted/passworded WiFi (you DO have your WiFi protected, right?...)
# As of release 23, Fedora comes in three flavours: [https://getfedora.org/en/workstation Workstation], [https://getfedora.org/en/server Server], and [https://getfedora.org/en/cloud Cloud]. This guide installs the Server edition (with no additional software specified) in order to get the leanest, most minimal install possible. At the time of writing, when tested this installation consumed approximately 410MB of memory (excluding buffers / cache) when playing a 1080p 5.1-channel video. The full installation including Fedora, Kodi and a modest library of thumbnails/artwork consumed about 9GB of disk space. For the purposes of testing, a 20GB partition was used.
 
== Installing Fedora 23 ==

=== Obtaining the Fedora 23 Server (x86_64) Installation Image ===
Visit the Fedora 23 (Server) download page at https://getfedora.org/en/server/download/ . You will almost certainly want the 64-bit version (and that's what this guide supports), and can therefore just click the '''download''' button to start your download. If you instead need a 32-bit version, there will be a link to it on the right-hand side of the page.
Once your download has completed, burn the '''.iso''' image you just downloaded to a DVD. It's also possible to create an installable USB flash drive with this ISO and install from it, or even to perform a network install without having any local DVD media, but these are outside the scope of this guide.
 
 
[[File:Fedora 23 Kodi 15 Install 001 - Main Screen.png|right|500px|Fedora Installation Main Installation Screen]]
=== Configure How Fedora will be Installed ===
Boot from the DVD you just created. If necessary, bring up your BIOS's boot-menu by pressing <F12> (or whatever your BIOS uses) to select booting from your optical drive. When the DVD boots you will be shown a text-menu with several options. Select "Install", and proceed. The system will then boot up into Fedora's graphical installer (Anaconda). Choose your desired keyboard layout and language, and proceed. You will then be shown Anaconda's main installation screen, similar to this:
 
 
You can make whatever choices you like for everything in the '''LOCALIZATION''' and '''SYSTEM''' sections.
 
 
Ensure that the '''INSTALLATION SOURCE''' section is set to ''Local Media''. If not then click to enter it, and change it accordingly.
{{-}}
 
 
[[File:Fedora 23 Kodi 15 Install 002 - Software Selection.png|right|500px|Fedora Installation Software Selection Screen]]
Within the '''SOFTWARE SELECTION''' section:
# Ensure that '''Base Environment''' in the left-pane is set to ''Minimal Install''.
# Ensure that ''none'' of the add-ons in the right-hand pane are selected.
When correctly set, this screen should look as follows:
{{-}}
 
 
[[File:Fedora 23 Kodi 15 Install 003 - User Creation.png|right|500px|Fedora User-Creation Screen]]
=== Starting the Installation and Creating a Kodi User ===
When finished setting up all desired installation options, Begin the install.

During installation, set the password for user '''root''' by clicking '''''ROOT PASSWORD'''''). You should also create the non-privileged user that Kodi will run as - click '''''USER CREATION'''''. You can choose whatever full-name / username / password you'd like; this guide assumes a username of 'kodi'. When creating this account, check '''''Make this user administrator'''''. (Note: This user isn't granted superuser rights directly; rather it can run privileged commands via tools such as '''''sudo'''''.)
 
The User Creation screen should looks as follows:
{{-}}
 
 
[[File:Fedora 23 Kodi 15 Install 004 - Install In Progress.png|right|500px|Fedora Installation In-Progress]]
Once you've finished with these two settings, installation will continue. The installation screen should look similiar to:
{{-}}
 
 
[[File:Fedora 23 Kodi 15 Install 005 - Console Login.png|right|500px|Fedora Console Login]]
=== Rebooting into Fedora ===

When the installation has completed, remove the installation DVD and click '''''REBOOT''''' to restart the system. The system should reboot and reach a textmode console login screen, as shown below. If you reach this point then you've successfully finished a minimal install of Fedora 23.
{{-}}

== Configuring Fedora / Installing Dependencies ==

Now that Fedora is installed, some configuration needs to be performed, and some dependencies need to be installed and configured.

{{redv|'''IMPORTANT:'''|Unless otherwise mentioned, all following commands should be run as user '''''kodi'''''. Elevated privileges will be obtained via '''''sudo''''' if required.}}

=== A Quick Note About DNF vs YUM, Updating Packages To Latest Versions, and Rebooting ===
{{bluev|'''NOTE:'''|Back in Fedora 22, the YUM package-manager was replaced by DNF. DNF is highly backward-compatible, and uses a nearly (but not completely) identical command syntax. In practice you may choose to either continue typing in 'yum' commands (which are passed off transparently to DNF), or use 'dnf' commands directly. This HOWTO standardizes on using 'dnf', but you may choose 'yum' instead if you prefer.}}

Perform a full update of all installed packages (including the kernel if necessary).
<syntaxhighlight lang="bash">
sudo dnf update
</syntaxhighlight>
When you're ready, reboot the system after these steps have completed for changes to take effect (especially any Kernel updates that may have happened).
<syntaxhighlight lang="bash">
sudo systemctl reboot
</syntaxhighlight>

=== Disabling SELinux and Firewalld ===
'''SELinux''' is a part of the kernel that enforces access control over many parts of the system, including filesystems, processes, sockets, etc. Although Kodi can be made to operate with SELinux active, this is beyond the scope of this guide.

'''Firewalld''' is the local firewall daemon that is included by-default with recent Fedora releases. Because it can interfere with things such as uPnP, file-sharing, remote-control apps, etc., firewalld is disabled in this guide.
{{redv|'''WARNING:'''|If your system is in any way exposed to the internet or other untrusted zones, then it is recommended to ensure those zones are adequately protected by their own firewalls before disabling the system's local firewalld.}}

Terminate firewalld if it is running, and then remove it from the system permanently. This will also trigger removal of some additional, dependent packages, which are not necessary to the operation of Kodi.
<syntaxhighlight lang="bash">
sudo systemctl stop firewalld
sudo dnf remove firewalld
</syntaxhighlight>

Next, reconfigure SELinux to change its policy from ''enforcing'' to ''disabled''.
<syntaxhighlight lang="bash">
sudo sed --in-place=.bak 's/^SELINUX\=enforcing/SELINUX\=disabled/g' /etc/selinux/config
</syntaxhighlight>

'''''You will need to reboot afterwards for these two changes to completely take effect'''''.
<syntaxhighlight lang="bash">
sudo systemctl reboot
</syntaxhighlight>

=== Enable Use Of the RPMFusion Repository ===
[http://rpmfusion.org/ RPMFusion] is a 3rd-party repository that provides legally redistributable software which, for one reason or another, is not included in Fedora distributions. This includes Kodi. The following commands will install both the free and non-free RPMFusion repos for release 23 of Fedora.
<syntaxhighlight lang="bash">
dnf install --nogpgcheck \
http://download1.rpmfusion.org/free/fedora/rpmfusion-free-release-$(rpm -E %fedora).noarch.rpm \
http://download1.rpmfusion.org/nonfree/fedora/rpmfusion-nonfree-release-$(rpm -E %fedora).noarch.rpm
</syntaxhighlight>

=== Install Basic X-Windows Support ===
Kodi requires a functioning X-Windows server to be present on the system it runs on. However, since it typically runs in fullscreen mode without any X-Windows decorations, it does not require any display managers or desktop environments such as Gnome or KDE. The following commands install a basic X-Windows setup.
{{bluev|'''NOTE:'''|This will '''''not''''' cause your system to actually boot up into multi-user graphical mode (X-Windows) automatically. That will be done when the system starts up Kodi as a standalone application.}}
<syntaxhighlight lang="bash">
sudo dnf groupinstall "base-x"
</syntaxhighlight>

=== Replace Open-Source Nouveau Video Drivers with Proprietary Nvidia Drivers ===
Although the open-source Nouveau video drivers that are included in Fedora distributions have come a long way recently, the binary drivers from Nvidia are still superior. There are a variety of places to obtain these drivers, including RPMFusion, however this guide shows how to install them from the [http://negativo17.org/nvidia-driver/ Negativo17 Nvidia repository].

{{note|Depending on what generation your Nvidia card/chipset is, you may need to use the 340 series of driver. After the 340 series Nvidia dropped support for many older cards/chipsets. Refer to information Nvidia has provided [http://www.nvidia.com/object/IO_32667.html here] to see if you need to stick with 340 series drivers, or if you can use the latest driver release. Negativo17 provides separate repositories for each, and this guide shows how to install either.}}

==== Enabling the 340 Series Nvidia Driver Repository ====
{{redv|'''IMPORTANT:'''|Only perform this step if you want the '''340 series''' Nvidia driver (cannot mix with the latest series).}}
<syntaxhighlight lang="bash">
sudo dnf config-manager --add-repo http://negativo17.org/repos/fedora-nvidia-340.repo
</syntaxhighlight>

==== Enabling the Latest Series Nvidia Driver Repository ====
{{redv|'''IMPORTANT:'''|Only perform this step if you want the '''latest series''' Nvidia driver (cannot mix with the 340 series).}}
<syntaxhighlight lang="bash">
sudo dnf config-manager --add-repo http://negativo17.org/repos/fedora-nvidia.repo
</syntaxhighlight>

==== Installing the Selected Nvidia Driver ====
The following will install your selected Nvidia drivers along with VDPAU (hardware-accelerated video decoding and postprocessing) support.
<syntaxhighlight lang="bash">
sudo dnf install \
kernel-devel \
libva-utils \
libva-vdpau-driver \
nvidia-driver \
vdpauinfo
</syntaxhighlight>

==== Removing the Nouveau Driver ====
Next, remove the open-source Nouveau driver.
<syntaxhighlight lang="bash">
sudo dnf remove xorg-x11-drv-nouveau
</syntaxhighlight>

=== Enabling Kodi Audio Within X-Windows ===
==== Enabling Kodi Audio Within X-Windows ====
In order for the Kodi user-account to be able to produce audio within the X-Windows system, it must be added to the '''''audio''''' user-group.
<syntaxhighlight lang="bash">
sudo usermod kodi -a -G audio
</syntaxhighlight>

== Installing Kodi And Configuring It To Run Automatically ==

=== Installing Kodi from the RPMFusion repository ===
The following command actually installs Kodi from the RPMFusion repository. Any dependencies that Kodi requires but are not yet installed will also be included automatically.
<syntaxhighlight lang="bash">
sudo dnf install kodi
</syntaxhighlight>

=== Building Kodi with HDMI-CEC (libcec) support from the SRPM ===
{{redv|'''IMPORTANT:'''|This section is not required if you do not need [http://kodi.wiki/view/CEC CEC] support.}}
Kodi 15.2 requires libcec >= 3.0.0 which is not available in the standard repositories. For this reason, the packaged RPM in from RPMFusion does not have it enabled. Follow the steps in this section to build a new rpm from the kodi source rpm whith CEC support enabled.

==== Install the necessary tools for building RPMs ====
For more complete instructions on setting up a rpm build environment see the guide on the [https://fedoraproject.org/wiki/How_to_create_an_RPM_package Fedora Wiki]. On most systems you should only really require the following tools.
<syntaxhighlight lang="bash">
sudo dnf install rpm-build yum-utils
</syntaxhighlight>

==== Installing a compatible version of libcec >= 3.0.0 ====
You will need two packages currently found in the fedora testing repostories in order to build Kodi with libcec support, ''libcec'' and ''libcec-devel''.
<syntaxhighlight lang="bash">
sudo dnf install libcec libcec-devel --enablerepo=updates-testing
</syntaxhighlight>

==== Install the Kodi source RPM (SRPM) from the RPMFusion Repo ====
Download the kodi source RPM and install it using the rpm command. You may receive some warnings about mockbuild not existing, these can be safely ignored. Once these commands are run there will be a ~/rpmbuild directory created containing the kodi source code and other things associated with creating an rpm.
<syntaxhighlight lang="bash">
yumdownloader --source kodi
rpm -i kodi-15.2-2.fc23.src.rpm
</syntaxhighlight>

==== Modify the spec file to enable libcec ====
Since the package doesn't expect to find a ''libcec>=3.0.0'' in any of the standard repositories, the author was forced to disable it. To re-enable it in the spec file simply change the ''_with_libcec'' global variable in the spec file with the following command.
<syntaxhighlight lang="bash">
sed -i 's/_with_libcec 0/_with_libcec 1/' ~/rpmbuild/SPECS/kodi.spec
</syntaxhighlight>

==== Build the RPM from source ====
Change into the SPEC directory and initiate the build. If there are any failed dependencies simply use ''dnf'' to install them.
<syntaxhighlight lang="bash">
cd ~/rpmbuild/SPECS
rpmbuild -ba kodi.spec
</syntaxhighlight>

==== Install the RPM ====
You should now have a rpm built with libcec support in it, you can install it with the following command.
<syntaxhighlight lang="bash">
sudo dnf install ~/rpmbuild/RPMS/x86_64/kodi-15.2-2.fc23.x86_64.rpm
</syntaxhighlight>

=== Create Systemd Service File For X-Windows / Kodi ===
By default Fedora uses Systemd to manage services and daemons. The following creates a Systemd service file that, once enabled, will cause the system to autostart X-Windows as well as Kodi as a standalone, fullscreen application whenever the system is booted. Because it was manually created and not installed as part of any package, it gets placed in '''''"/etc/systemd/system"''''' instead of '''''"/lib/systemd/systemd"'''''.
<syntaxhighlight lang="bash">
sudo bash -c 'cat <<"ENDcat" >/etc/systemd/system/kodi.service
[Unit]
Description = kodi-standalone using xinit
After = remote-fs.target

[Service]
User = kodi
Group = kodi
PAMName = login
Type = simple
ExecStart = /usr/bin/xinit /usr/bin/dbus-launch /usr/bin/kodi-standalone -- :0 -nolisten tcp
Restart = on-abort

[Install]
WantedBy = multi-user.target
ENDcat'
</syntaxhighlight>

=== Install DBUS addon for X-Windows ===
X-Windows requires that an addon be installed in order to become DBUS-aware, which in-turn is required in order for Kodi to be properly started at boot-time. This step provides the ''/usr/bin/dbus-launch'' tool within in the Systemd service file from the previous step.
<syntaxhighlight lang="bash">
sudo dnf install dbus-x11
</syntaxhighlight>

=== Load and Enable New Systemd Service File ===
Now that the new Systemd service file has been created, Systemd needs to rescan its configuration to pick up the new file. Afterwards, the service is enabled for future reboots.
<syntaxhighlight lang="bash">
sudo systemctl daemon-reload
sudo systemctl enable kodi
</syntaxhighlight>

=== Reconfigure PolicyKit To Enable Poweroff, Suspend and Similiar Functions ===
In order for Kodi to be able to poweroff the system, enter suspend-mode or initiate hibernation, a PolicyKit Local Authority configuration file needs to be created.
<syntaxhighlight lang="bash">
sudo bash -c 'cat <<"ENDcat" >/etc/polkit-1/localauthority/50-local.d/kodi_shutdown.pkla
[Actions for kodi user]
Identity=unix-user:kodi
Action=org.freedesktop.devicekit.power.*;org.freedesktop.upower.*;org.freedesktop.consolekit.system.*;org.freedesktop.login1.*
ResultAny=yes
ENDcat'
</syntaxhighlight>

=== Install UPower ===
UPower (formerly DeviceKit-power) facilitates managing power devices attached to the system. It is what allows Kodi to actually manipulate power-related functions such as shutting everything down.
<syntaxhighlight lang="bash">
sudo dnf install upower
</syntaxhighlight>

=== Configure Xwrapper To Allow Non-Console Users To Start X-Server ===
In order for the X-Windows server to be started by a non-console user such as the Kodi account, a new Xwrapper configuration must be created. Also set the appropriate file permissions on the new configuration.
<syntaxhighlight lang="bash">
sudo bash -c 'cat <<"ENDcat" >/etc/X11/Xwrapper.config
allowed_users = anybody
ENDcat'
sudo chmod 644 /etc/X11/Xwrapper.config
</syntaxhighlight>

== All Finished, and Last Tips ==
If all has gone well thus far, then the next time you restart the system it should boot all the way into Kodi (fullscreen standalone) without needing to log in first, or perform any other intervention. At this point you should be able to commence configuring your minimal Kodi install as desired. Enjoy!

# As previously mentioned, this method of installing Kodi avoids the need to log into the system for normal operation. However you may still reach the system remotely via '''''SSH''''', whether or not Kodi is running at the time.
# If you have remotely accessed the system, then Kodi can be easily started / stopped with the following two commands (run as user '''''kodi'''''):

<syntaxhighlight lang="bash">
sudo systemctl start kodi
</syntaxhighlight>

<syntaxhighlight lang="bash">
sudo systemctl stop kodi
</syntaxhighlight>

{{Isengard updated}}

[[Category:Linux]]
[[Category:How-to]]
[[Category:Installation|Linux]]

Official Kodi Wiki - User contributions [en]

Archive talk:Install Kodi on Fedora 26 using RPMFusion packages

Archive:Install Kodi on Fedora 26 using RPMFusion packages