Difference between revisions of "Channel icons"

From MythTV Official Wiki
Jump to: navigation, search
(rm some old mythweb information)
(46 intermediate revisions by 19 users not shown)
Line 1: Line 1:
{{stub}}
+
=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.
  
On 9/18/06, Michael T. Dean <mtdean@thirdcontact.com> wrote:
+
To configure icon downloading in mythtv-setup:
<div style="margin: 1em; padding: 1em; background-color: lightblue; width: 42em;">
+
* run "mythtv-setup"
http://www.lyngsat-logo.com/ and, feel free to update the SVN version of
+
* select "Channel Editor"
the master_iconmap data to link to the appropriate icons so others may
+
* click on "Icon Download"
benefit from your efforts. ;)
+
* select either "Download all icons.." or "Rescan for missing icons.."
  
See http://svn.mythtv.org/trac/ticket/2365 for an example (the new patch
 
is post 0.20).  You can do this even if you don't run SVN.  Just do a
 
checkout with:
 
  
svn co http://svn.mythtv.org/svn/trunk/mythtv/contrib/master_iconmap
+
==Universal Location==
 +
Starting with version 0.27, a single location for channel icons is used.
 +
By default, it will be in the ''.mythtv/channels'' directory of the user
 +
that runs ''mythbackend''. Typically, ''mythtv''. The location is defined
 +
in the built-in ChannelIcons Storage Group (it's not necessary to create
 +
or change the ChannelIcons Storage Group.)
  
Then edit data/{baseurl,callsigntonetwork,networktourl}.txt and test it
+
Run ''mythtv-setup'' and get a new set of channel icons. They'll be stored
with:
+
in the directory above.
  
./build_map.pl
+
As of {{gitcommit|6d10afe|mythweb}} ''mythweb'' will retrieve its icons
 +
from the same common directory.
  
(in the master_iconmap directory)
+
The Services API (e.g. <backend>:6544/Guide/GetChannelIcon?ChanId=1021) endpoint works with this
 +
feature as of {{gitcommit|85462fb}}.
  
Then, run:
+
Symlinks added for prior MythTV versions, duplicate ''channels'' directories and
 +
any ''ChannelIcons'' directories and their contents can be removed.
  
mythfilldatabase --reset-icon-map all
+
== Pre 0.27 Instructions==
mythfilldatabase --import-icon-map master_iconmap.xml --update-icon-map
+
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.
  
'''as the user who runs the mythfrontend program''' from the master_iconmap
+
Before downloading the icons, do the following, or similar as per your distribution:
directory to test.  (Verify all your channels have icons.  If you test
 
with MythWeb, you'll have to delete MythWeb's icon cache with "rm
 
/var/www/htdocs/mythtv/data/tv_icons/*" (change path as appropriate)).
 
  
And, finally, run
+
<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>
  
svn diff > ~/master_iconmap-sky.patch
+
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.
  
from the master_iconmap directory to create a patch for Trac.
+
=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.
  
Mike
+
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.
</div>
+
 
 +
==International Channel Logos==
 +
* [https://ash.ms/projects/channels Australia]
 +
* [http://www.documentjes.nl/linux/mythtv/icons/ Netherlands]
 +
 
 +
[[Category:HOWTO]]

Revision as of 23:59, 17 November 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 is used. By default, it will be in the .mythtv/channels directory of the user that runs mythbackend. Typically, mythtv. The location is defined in the built-in ChannelIcons Storage Group (it's not necessary to create or change the ChannelIcons Storage Group.)

Run mythtv-setup and get a new set of channel icons. They'll be stored in the directory above.

As of [6d10afe] mythweb will retrieve its icons from the same common directory.

The Services API (e.g. <backend>:6544/Guide/GetChannelIcon?ChanId=1021) endpoint works with this feature as of [85462fb].

Symlinks added for prior MythTV versions, duplicate channels directories and any ChannelIcons directories and their contents can be removed.

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.

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