Installation

From iptvx
Jump to: navigation, search

Generally iptvx will work on all platforms and architectures supporting the required external libraries. All Unix-like systems capable of running VLC should also be able to run iptvx. The License page gives an overview of the required packages and libraries that iptvx needs to build and operate. There are three ways of installing iptvx on your local system.

  • Obtain a package and install in your system
  • Clone the git repository and compile yourself
  • Download a released tarball and compile yourself

It is generally recommended to use a pre-built package for your operating system. You should only consider compiling yourself when there is no pre-built package available for your distribution or you are planning to deploy on rare or individual architectures.

Installing a package

Pre-built packages can be found on the Packages page and the installation should be relatively straight forward. Packages are being built automatically. Although the master branch is always considered stable and built automatically it is recommended to use a stable version instead.

Installing an RPM package (OpenSUSE)

For RPM-based systems like SUSE the installation is done with the following line.

rpm -i iptvx-1512331642.6d24ffc-79.1.x86_64.rpm

Installing a DEB package (Ubuntu or Debian)

On Ubuntu systems you can use apt to install the downloaded DEB file with the following command.

apt install iptvx_0.5_amd64.deb

If you download an RPM- oder Deb-package with your browser, it may already provide your systems package manager as a suggestion to use for the installation of the package.

Compiling yourself

You can find all released source-code tarballs in the [releases](/jankammerath/iptvx/releases) section. Alternatively you can also clone the git repository's master branch as it is always considered stable. However stability of the master branch cannot be guaranteed and it is recommended to use a released tarball. The following instructions allow you to compile the tar ball. You can find all source codes at the Releases on GitHub.

1. Download the desired tarball with the source

wget https://github.com/jankammerath/iptvx/archive/v0.41.tar.gz

2. Unpack the downloaded tarball using tar

tar xvzf iptvx-0.41.tar.gz

3. Of course, move into the unpacked directory

cd iptvx-0.41

4. Execute make to build the binary

make

5. Execute the make installation command

make install

It is a very rare occasion that source code you compile from other people like me does so free of errors at the first try. The most common problem are missing libraries and their development versions that you need during build time. The License page gives an overview of all external libraries used, just in case you might have missed to install one. You of course will also need the compiler gcc as well as pkg-config and make installed.

Compiling yourself with a cloned git

People cloning git repositories should be well aware of the fundamentals of _git_ as well as compiling with _gcc_. Just to ensure the documentation fully covers all possible methods, it is covered here. Compiling the master branch off the cloned git repository is only recommended for advanced or expert users. It follows the same instructions as above, but besides the tarball, its unpacking you clone the git repository.