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.
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
2. Unpack the downloaded tarball using tar
tar xvzf iptvx-0.41.tar.gz
3. Of course, move into the unpacked directory
4. Execute make to build the binary
5. Execute the make installation command
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.