PICONS

All the full resolution channel logos and their link to the actual channel (=serviceref) are kept up2date in this repository. The end result are picons for Enigma2 tuners and Kodi mediacenter in combination with a compatible PVR backend.

SUPPORT ON BEERPAY

Hey dude! Help us out for a couple of 🍻!

BUILDING THE PICONS

Ubuntu and Bash on Ubuntu on Windows are tested and supported platforms for building the picons.

When using Bash on Ubuntu on Windows, clone to /mnt/c, which is your C:\ drive on Windows. That way you can manipulate your files from within Windows, going to %localappdata%\lxss\rootfs directly inside Windows and modifying files, is not recommended.

Download the repository by using one of the following commands:

# Ubuntu, Bash on Ubuntu on Windows
sudo apt-get install git binutils pngquant imagemagick librsvg2-bin jq

# Ubuntu
git clone https://github.com/picons/picons.git ~/picons

# Bash on Ubuntu on Windows
git clone https://github.com/picons/picons.git /mnt/c/picons

Next, copy the required files to the folder build-input.

We will start the creation of the servicelist and the picons with the following commands:

# Ubuntu
cd ~/picons

# Bash on Ubuntu on Windows
cd /mnt/c/picons

# Ubuntu, Bash on Ubuntu on Windows
./1-build-servicelist.sh
./2-build-picons.sh

Take a look at the folder build-output for the results.

TIP: To automate the building process, you can also use some of the following commands:

./1-build-servicelist.sh snp
./1-build-servicelist.sh srp
./2-build-picons.sh snp
./2-build-picons.sh srp
./2-build-picons.sh snp-full
./2-build-picons.sh srp-full

SNP - SERVICE NAME PICONS

The idea behind SNP is that a simplified name derived from the channel name is used to lookup a channel logo. The idea and code was first implemented by OpenVIX for the Enigma2 tuners. Any developer currently using the serviceref method as a way to lookup a logo and would like to implement this alternative, can find the code used to generate the simplified name at the OpenVIX github repository.

FOLDER OVERVIEW

~/picons/build-input

Enigma2 servicelist creation

Copy your enigma2 folder, probably located in /etc on your box into this folder.

TvHeadend servicelist creation

Use the servers API and directly ask the server about all channels by creating a file called tvheadend.serverconf. The file can contain the following values:

# hostname or ip address of tvheadend server (default: "localhost")
TVH_HOST="localhost"
# port of tvheadend API (default: 9981)
TVH_PORT="9981"
# tvheadend user name
TVH_USER=""
# tvheadend password of above user
TVH_PASS=""
# tvheadend http_root setting
TVH_HTTP_ROOT=""

Only the values which are different from the default values are required. For most people this will be a file with a single host name or host IP address.

TVH_HOST="my.tvheadend.server"

If you're running TvHeadend on the same machine, even an empty file (defaulting to localhost) should be sufficient.

Note: In order to make the generator work with TvHeadend, you'll need to enable picons first by defining a path to the future picon folder under Configuration -> General -> Base.

VDR servicelist creation

If you're using VDR together with the Kodi addon xvdr, copy your channels.conf file to this folder.

Configuring which backgrounds to build

A file backgrounds.conf should be placed in this folder. If no file is found, the default file will be used.

Syntax:

<resolution>;<resolution-padding>;<logotype>;<background>

Example:

# My own awesome settings
100x60;86x46;dark;reflection
100x60;100x60;default;transparent
100x60;100x60;light;transparent

# My commented settings
# 800x450;800x450;light;transparent

~/picons/build-output

This folder will contain the output from the build. Similar to the files servicelist-enigma2-snp.txt and servicelist-enigma2-srp.txt. The picon binaries are also saved in this folder.

Possible output files and folders:

binaries-snp/
binaries-srp/
servicelist-enigma2-snp.txt
servicelist-enigma2-srp.txt
servicelist-tvheadend-filemode-snp.txt
servicelist-tvheadend-filemode-srp.txt
servicelist-tvheadend-servermode-snp.txt
servicelist-tvheadend-servermode-srp.txt
servicelist-vdr-snp.txt
servicelist-vdr-srp.txt

~/picons/build-source

This is where all the channel logos go and how they are linked to the serviceref or a simplified version of the name. Backgrounds and the default backgrounds.conf file can also be found in this directory.

~/picons/resources

Some additional files.