Difference between revisions of "Channel icons"

From MythTV Official Wiki
Jump to: navigation, search
(0.27 Channel Icon Instructions)
m (Channel Icon Download System: Typo)
(15 intermediate revisions by 5 users not shown)
Line 1: Line 1:
 
=Channel Icon Download System=
 
=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.
+
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, and the ability to define your own search parameters.
  
 
To configure icon downloading in mythtv-setup:
 
To configure icon downloading in mythtv-setup:
Line 10: Line 10:
  
 
==Universal Location==
 
==Universal Location==
Starting with version 0.27, a single location for channel icons can be
+
Starting with version 0.27, a single location for channel icons is used.
created on the master backend. The only symlink required is for ''mythweb''.
+
It may be in the ''.mythtv/channels'' directory of the user
Remove it's ''.../data/tv_icons'' directory and link it to the chosen
+
that runs ''mythbackend''. Typically, ''mythtv''. The location is defined
single directory. Make that directory read/write for user ''mythtv''
+
in the built-in ChannelIcons Storage Group (it's not necessary to create
and choose the same group that is used by ''mythweb'', e.g. ''www-data''
+
a ChannelIcons Storage Group.)
(mode 775.)
 
  
Symlinks added for prior versions (or old ''channels''/''ChannelIcons'' directories and
+
Note that users that set MYTHCONFDIR before starting MythTV programs
their contents) can be removed. Obviously '''after''' copying icons to a new
+
override the HOME directory of the user running the backend.
directory if required.
 
  
If a ''ChannelIcons'' Storage Group doesn't already exist, follow the 1st 2 paragraphs
+
Run ''mythtv-setup'' as the same user that runs ''mythbackend'' and
in the section below. Then restart the backend then frontends.
+
get a new set of channel icons. They'll be stored
 +
in the directory above.
  
 +
A Services API endpoint (<backend>:6544/Guide/GetChannelIcon?ChanId=<chanid>) works with this
 +
feature.
 +
 +
Symlinks added for prior MythTV versions, duplicate ''channels'' directories and
 +
any ''ChannelIcons'' directories and their contents can be removed.
 +
 +
A Note of Caution: Some Myth distributions run ''mythtv-setup'' as the frontend user you created on install, where as the backend is frequently run as ''mythtv'', even if the frontend and backend are on same machine. This requires you to symlink (ln -s /home/myuser/.mythtv/channels /home/mythtv/.mythtv/channels) or copy files. Once fixed the icons will auto appear on mythweb and other frontends as describe above.
  
 
== Pre 0.27 Instructions==
 
== Pre 0.27 Instructions==
Line 43: Line 49:
 
</pre></code>
 
</pre></code>
 
for all the users that can run MythTV as well.
 
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=
 
=Channel Icon Sources=

Revision as of 13:48, 3 October 2014

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, and 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. It may 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 a ChannelIcons Storage Group.)

Note that users that set MYTHCONFDIR before starting MythTV programs override the HOME directory of the user running the backend.

Run mythtv-setup as the same user that runs mythbackend and get a new set of channel icons. They'll be stored in the directory above.

A Services API endpoint (<backend>:6544/Guide/GetChannelIcon?ChanId=<chanid>) works with this feature.

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

A Note of Caution: Some Myth distributions run mythtv-setup as the frontend user you created on install, where as the backend is frequently run as mythtv, even if the frontend and backend are on same machine. This requires you to symlink (ln -s /home/myuser/.mythtv/channels /home/mythtv/.mythtv/channels) or copy files. Once fixed the icons will auto appear on mythweb and other frontends as describe above.

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