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.

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.