Difference between revisions of "Channel icons"

From MythTV Official Wiki
Jump to: navigation, search
m (updated SVN link to point to new location within the trunk)
(Link to the correct ChannelIcons section)
(21 intermediate revisions by 12 users not shown)
Line 1: Line 1:
One of the best sources of channel icons is http://www.lyngsat-logo.com/ . There, you can browse the available icons and choose those appropriate for your system.  However, doing so can be a lot of work (requiring many page hits and a lot of time).
+
=Channel Icon Download System=
 +
As of 0.21, MythTV includes a channel icon download system in ''mythtv-setup'' which will attempt to automatically download icons for channels in your database from services.mythtv.org. If it cannot find an icon it will present you with a list of options, an the ability to define your own search parameters.
  
An easier approach is to use [[Channel_icons.pl | channel_icons.pl]] a new feature in the post-0.20-SVN trunk of MythTV to quickly look up the information.  Doing so requires the MythTV Perl bindings (which can be compiled/installed by passing the "--with-bindings=perl" argument to the MythTV configure script). However, the script requires Perl bindings from SVN trunk. So, if you're using 0.20-fixes, please see [http://mythtv.org/docs/mythtv-HOWTO-9.html#ss9.5 the MythTV HOWTO].
+
To configure icon downloading in mythtv-setup:
 +
* run "mythtv-setup"
 +
* select "Channel Editor"
 +
* click on "Icon Download"
 +
* select either "Download all icons.." or "Rescan for missing icons.."
  
If you have the appropriate MythTV Perl bindings, checkout the required scripts with:
 
  
<pre>
+
==Universal Location==
svn co http://svn.mythtv.org/svn/trunk/mythtv/contrib/icons/master_iconmap
+
Starting with version 0.27, a single location for channel icons can be
</pre>
+
created on the master backend. The only symlink required is for ''mythweb''.
 +
Remove it's ''.../data/tv_icons'' directory and link it to the chosen
 +
single directory. Make sure that the directory has read/write permissions for user ''mythtv''
 +
and choose the same group that is used by ''mythweb'', e.g. ''www-data''. Make the
 +
new single location directory's mode 775.
  
Doing so will create a directory called "master_iconmap" underneath the current directory.  The master_iconmap directory contains a file called "channel_icons.pl", which can be used to retrieve channel icon information.  See http://www.gossamer-threads.com/lists/mythtv/commits/255099#255099 and "./master_iconmap/channel_icons.pl --usage" for more information.
+
Symlinks added for prior versions (or old ''channels''/''ChannelIcons'' directories and
 +
their contents) can be removed. Obviously '''after''' copying icons to a new
 +
directory as required.
  
There is currently (as of 10/08/2007) a bug in either the channel_icon.pl script or the Myth.pm file.
+
If a ''ChannelIcons'' Storage Group doesn't already exist, follow the 1st 2 paragraphs
 +
in the [[Channel_icons#Storage_Group_Location|Storage Group Location]] below. Then restart the backend then frontends.
  
[http://svn.mythtv.org/trac/ticket/4047 MythTV Ticket #4047]
+
Note, the Services API <backend>:6544/Guide/GetChannelIcon endpoint does not work
 +
with this feature. There is a patch for the problem at {{ticket|11865}}.
  
Currently, the easiest work around is to edit the channel_icon.pl script and rename the one call to "load_channels" to "_load_channels".  
+
== Pre 0.27 Instructions==
 +
By default the icon will be downloaded to the ''/home/<user>/.mythtv/channels'' directory. This is not very friendly when you have multiple frontends and wish them all to share the icons. One method to get around this is to use a symlink for this directory that directs to a network located directory that all your frontends have access to, say ''/var/mythtv/channels'' for example.
  
=== Example ===
+
Before downloading the icons, do the following, or similar as per your distribution:
  
An example to get all icons installed on a brand new system would be:
+
<code><pre>
 +
rm ~/.mythtv/channels -rf
 +
sudo mkdir /var/mythtv/channels
 +
sudo chown <user>:<group> /var/mythtv/channels
 +
ln -s /var/mythtv/channels ~/.mythtv/channels
 +
</pre></code>
  
./channel_icons.pl --find-missing --rescan --icon-dir /path/to/store/icons
+
You will want to run
 +
<code><pre>
 +
rm ~/.mythtv/channels -rf
 +
ln -s /var/mythtv/channels ~/.mythtv/channels
 +
</pre></code>
 +
for all the users that can run MythTV as well.
  
=International Channel Logos=
+
==Storage Group Location==
[http://www.mythtv.org/wiki/index.php/Netherlands#Channel_logos Netherlands]
+
As of 0.25, there is support for using [[Storage Groups]] for access to the icons.
 +
 
 +
To use storage groups for channel icons, you will need to create a new storage group named ''ChannelIcons''.  Move your icons to that location.  You should then go into ''mythtv-setup'' and remove the absolute paths, leaving just the filenames.
 +
 
 +
It is important to understand that this support is not yet feature complete, as both ''mythfilldatabase'' and ''mythtv-setup'' still download icons to the ''~/.mythtv/channels/'' directory, and attempt to retrieve them from that location, but if you run the applications on the same machine as the storage group is located, you can create a link from ''~/.mythtv/channels/'' to the storage group location as a mitigation.  Also, ''mythweb'' does not use storage groups for accessing the icons.
 +
 
 +
=Channel Icon Sources=
 +
One of the best sources of channel icons is http://www.lyngsat-logo.com/ .  There, you can browse the available icons and choose those appropriate for your system.  However, doing so can be a lot of work (requiring many page hits and a lot of time).  Once downloaded you should put the resulting JPEG files into ''.mythtv/channels/'' for the user running the front-end.  To add them to a channel you will need to run ''mythtv-setup'' and go to the channel editor and specify the icon file name for each channel.
 +
 
 +
Another source of channel icons is http://www.iconharmony.com/ which is targeted for icons for the harmony remote.  Some of the available icons are more stylized than the official icon (the person running the site is a graphic artist).  As with the previous source, finding an appropriate icon can be a lot of work.
 +
 
 +
==International Channel Logos==
 +
* [https://ash.ms/projects/channels Australia]
 +
* [http://www.documentjes.nl/linux/mythtv/icons/ Netherlands]
 +
 
 +
[[Category:HOWTO]]

Revision as of 16:31, 28 September 2013

Channel Icon Download System

As of 0.21, MythTV includes a channel icon download system in mythtv-setup which will attempt to automatically download icons for channels in your database from services.mythtv.org. If it cannot find an icon it will present you with a list of options, an the ability to define your own search parameters.

To configure icon downloading in mythtv-setup:

  • run "mythtv-setup"
  • select "Channel Editor"
  • click on "Icon Download"
  • select either "Download all icons.." or "Rescan for missing icons.."


Universal Location

Starting with version 0.27, a single location for channel icons can be created on the master backend. The only symlink required is for mythweb. Remove it's .../data/tv_icons directory and link it to the chosen single directory. Make sure that the directory has read/write permissions for user mythtv and choose the same group that is used by mythweb, e.g. www-data. Make the new single location directory's mode 775.

Symlinks added for prior versions (or old channels/ChannelIcons directories and their contents) can be removed. Obviously after copying icons to a new directory as required.

If a ChannelIcons Storage Group doesn't already exist, follow the 1st 2 paragraphs in the Storage Group Location below. Then restart the backend then frontends.

Note, the Services API <backend>:6544/Guide/GetChannelIcon endpoint does not work with this feature. There is a patch for the problem at #11865.

Pre 0.27 Instructions

By default the icon will be downloaded to the /home/<user>/.mythtv/channels directory. This is not very friendly when you have multiple frontends and wish them all to share the icons. One method to get around this is to use a symlink for this directory that directs to a network located directory that all your frontends have access to, say /var/mythtv/channels for example.

Before downloading the icons, do the following, or similar as per your distribution:

rm ~/.mythtv/channels -rf
sudo mkdir /var/mythtv/channels
sudo chown <user>:<group> /var/mythtv/channels
ln -s /var/mythtv/channels ~/.mythtv/channels

You will want to run

rm ~/.mythtv/channels -rf
ln -s /var/mythtv/channels ~/.mythtv/channels

for all the users that can run MythTV as well.

Storage Group Location

As of 0.25, there is support for using Storage Groups for access to the icons.

To use storage groups for channel icons, you will need to create a new storage group named ChannelIcons. Move your icons to that location. You should then go into mythtv-setup and remove the absolute paths, leaving just the filenames.

It is important to understand that this support is not yet feature complete, as both mythfilldatabase and mythtv-setup still download icons to the ~/.mythtv/channels/ directory, and attempt to retrieve them from that location, but if you run the applications on the same machine as the storage group is located, you can create a link from ~/.mythtv/channels/ to the storage group location as a mitigation. Also, mythweb does not use storage groups for accessing the icons.

Channel Icon Sources

One of the best sources of channel icons is http://www.lyngsat-logo.com/ . There, you can browse the available icons and choose those appropriate for your system. However, doing so can be a lot of work (requiring many page hits and a lot of time). Once downloaded you should put the resulting JPEG files into .mythtv/channels/ for the user running the front-end. To add them to a channel you will need to run mythtv-setup and go to the channel editor and specify the icon file name for each channel.

Another source of channel icons is http://www.iconharmony.com/ which is targeted for icons for the harmony remote. Some of the available icons are more stylized than the official icon (the person running the site is a graphic artist). As with the previous source, finding an appropriate icon can be a lot of work.

International Channel Logos