{"id":1522,"date":"2020-10-06T14:01:27","date_gmt":"2020-10-06T11:01:27","guid":{"rendered":"https:\/\/microimpuls.com\/docs\/smarty\/configuring-and-management\/%d0%b8%d0%bc%d0%bf%d0%be%d1%80%d1%82-epg-%d0%b8-%d0%bc%d0%b5%d1%82%d0%b0%d0%b4%d0%b0%d0%bd%d0%bd%d1%8b%d1%85-%d0%ba%d0%be%d0%bd%d1%82%d0%b5%d0%bd%d1%82%d0%b0"},"modified":"2026-02-06T09:16:17","modified_gmt":"2026-02-06T06:16:17","slug":"epg","status":"publish","type":"docs","link":"https:\/\/microimpuls.com\/en\/docs\/smarty\/configuring-and-management\/epg","title":{"rendered":"Import of EPG and Content Metadata"},"content":{"rendered":"

Basic concepts<\/h1>\n\n\n\n

Transmission program in Smarty is provided using an entity EPGChannel<\/code> \u2014 this is an object to which the channel icon is tied (there may be several icons of different sizes), as well as a program of programs with inherent properties (transmission name, its description, preview images, start time and end time, genres, categories, etc.).
We can say that EPGChannel is a kind of \u00abChannel\u00bb to which the subscriber has indirect access \u2014 with the correct configuration, the subscriber can see the icon EPGChannel\u2019 a; the name of its current, past or future transfer; a description of these programs, their advertising images, etc., but the subscriber does not know about the existence of such an entity. This entity is necessary for the connection between the list of specific transmissions and channel icons with the channel that the user will observe in his portal.<\/p>\n\n\n\n

\n
\n
\"\"
This is the EPGChannel list (invisible to the user)<\/figcaption><\/figure>\n<\/div><\/div>\n\n\n\n
\n
\"\"
This is a list of channels (what the user will see in the portal)<\/figcaption><\/figure>\n<\/div><\/div>\n<\/div>\n\n\n\n

EPGSource<\/code> \u2014 source of the program. As a rule, it is an xmltv file with a list of channels and transmissions (or a link to the transmission program of a channel). <\/p>\n\n\n\n

EPGChannelsSource<\/code> \u2014 source of TV channels. Can be used to import channels or icons to them.<\/p>\n\n\n\n

EpgProgram<\/code> \u2014 the program itself, associated with a specific EPGChannel<\/code>to which this program belongs. Everyone EpgProgram<\/code> stores information about the name of the transfer and about the beginning and end of the transfer (the minimum set of parameters for the program to appear in the portal), as well as its description, belonging to the category, age rating, preview images and other information that can be displayed in the portal.<\/p>\n\n\n\n

\n
\n
\"\"
<\/figcaption><\/figure>\n<\/div><\/div>\n\n\n\n
\n
\"\"<\/figure>\n<\/div><\/div>\n<\/div>\n\n\n\n

So the program is stored in Smarty<\/sup><\/em><\/p>\n\n\n

\n
\"\"
And so the user will see it in the portal<\/figcaption><\/figure>\n<\/div>\n\n\n

Canal<\/code> \u2014 an entity to which the user will have consistent access in the portal. It is a set of channel configuration in the Smarty admin panel (streaming services, tariff configuration, LCN, parental control, etc.) and the associated channel EPGChannel<\/code> (in the framework of which access to the program of programs of this channel is provided). <\/p>\n\n\n\n

Minimum Smarty settings before importing a transmission program (EPG)<\/h1>\n\n\n\n

The configuration process can be described by the following algorithm:<\/p>\n\n\n\n

    \n
  1. Create or edit an existing one EPGSource<\/code>;<\/li>\n\n\n\n
  2. Create the required amount EPGChannel<\/code>tying them together id<\/code> broadcast EPGSource<\/code> (or import all transmission channels at the source of the program);<\/li>\n\n\n\n
  3. Import the transmission program;<\/li>\n\n\n\n
  4. Tie up EPGChannel<\/code> with available channels;<\/li>\n\n\n\n
  5. Add the task of updating the transfer program to the task scheduler. <\/li>\n<\/ol>\n\n\n\n

    Most operations EPG<\/code> carried out django-adminke<\/code> (to get into it, you need a certain level of access, opens when added) \/admin<\/code> at the end of the Smarty address.<\/p>\n\n\n\n

    Below, each of these items will be discussed in more detail.<\/p>\n\n\n\n

    Creating a transmission source (EPGSource)<\/h2>\n\n\n\n
      \n
    1. Go to section Tvmiddleware<\/code>;<\/li>\n\n\n\n
    2. Open subsection EPG Sources<\/code>;<\/li>\n\n\n\n
    3. Press the Add button EPG Source<\/code>;<\/li>\n\n\n\n
    4. Specify name EPGSource<\/code> (necessary for ease of administration);<\/li>\n\n\n\n
    5. Specify the type of parser EPG<\/code> (for the correct interpretation of the data stored in the selected source) <\/li>\n\n\n\n
    6. Indicate source address EPG<\/code> (Can be absolute \u2014 in the case of a specific source reference, or relative \u2014 if the file with the transmission program is stored on the same server as Smarty);<\/li>\n\n\n\n
    7. In order to save free storage space of media files (as well as for faster loading and reducing the load on user devices), you can turn on the option \u00abConvert pictures\u00bb \u2014 if this checkbox is enabled, then all imported preview images of transmissions will be compressed to the dimensions specified in the Smarty configuration (the corresponding options are described in the documentation) \u00abSystem parameters \u00bb<\/a>); if the checkbox is turned off, the preview images will be downloaded at the original resolution.<\/li>\n<\/ol>\n\n\n\n

      The type of EPG parser should be selected based on the EPG source used. In most cases, the parser name intuitively matches the EPG source name, with rare exceptions such as:
      Dummy_source<\/code> \u2014 this is an automatic source that creates the same programs with the name corresponding to the name EPGChannel<\/code> and broken down once an hour. It can be useful for filling out the camera transmission program (in case the cameras write an archive, a transmission program is required to view it and you can fill it in through the camera) Dummy_source<\/code>).
      Xmltv_common<\/code> \u2014 universal parser xmltv.
      Xmltv_from_file<\/code> \u2014 parser based on xmltv_common<\/code>, but able to read a file that is on a server with Smarty.<\/p>\n\n\n

      \n
      \"\"
      EPG Source Creation Page<\/figcaption><\/figure>\n<\/div>\n\n\n

      EPGChannelsSource and Channel Import<\/h2>\n\n\n\n

      The process of creating a TV source is not much different from the process of creating a TV source, with some exceptions:<\/p>\n\n\n\n

        \n
      1. Go to section Tvmiddleware<\/code>;<\/li>\n\n\n\n
      2. Open subsection EPG channels sources<\/code>;<\/li>\n\n\n\n
      3. Press the Add button EPG Channels Source<\/code>;<\/li>\n\n\n\n
      4. Link the source EPGChannels<\/code> on EPGSource<\/code>; <\/li>\n\n\n\n
      5. Indicate the address of the channel source (works by analogy with EPGSource<\/code>);<\/li>\n<\/ol>\n\n\n
        \n
        \"\"
        Page of creation of source of TV channels<\/figcaption><\/figure>\n<\/div>\n\n\n

        Import of TV channels and icons for TV channels from an existing source is carried out with the help of an official team epg_channel_import<\/a><\/code>. <\/p>\n\n\n\n

        Creation of EPGChannel<\/h2>\n\n\n\n

        If for some reason it was not possible to import channels from the source automatically, they can be created manually using Django-admin.<\/p>\n\n\n\n

        \n
        \n
        \"\"<\/figure>\n<\/div>\n\n\n\n
        \n
        \"\"<\/figure>\n<\/div>\n<\/div>\n\n\n\n

        Example of EPGChannel configuration screen with already filled fields<\/em><\/sup><\/p>\n\n\n\n

          \n
        1. Go to section Tvmiddleware<\/code>;<\/li>\n\n\n\n
        2. Open subsection EPG channels<\/code>;<\/li>\n\n\n\n
        3. Press the Add button EPG Channel<\/code>;<\/li>\n\n\n\n
        4. Specify name EPGChannel<\/code>;<\/li>\n\n\n\n
        5. Specify channel ID at source EPG<\/code> (if the source of the channel transmission program \u00abFirst\u00bb id=000000004 is specified, then when creating EPGChannel, you need to specify the channel id in the source 000000004);<\/li>\n\n\n\n
        6. Specify the transfer category (these categories will be used in the portal to filter content by category) and, if necessary, select additional categories for the channel;<\/li>\n\n\n\n
        7. If you have already downloaded the channel icon, you can specify its URL, in the field \u00abURL icons\u00bb Or, it can be downloaded using the channel icon download buttons (if necessary, you can download different icons under different permissions).<\/li>\n<\/ol>\n\n\n
          \n
          \"\"
          Categories in the Futuristic template. The list of categories is on the left side of the screen<\/figcaption><\/figure>\n<\/div>\n\n\n

          Different interface templates may use different icon sizes (e.g., template) futuristic<\/code> requires a size of 120\u00d790 and the template sibseti<\/code> \u2014 176x104). The size of the icons can be set through the system parameters Smarty using the parameter SMARTY_DEFAULT_ICON_SIZES<\/code> (more information about this and other parameters is available in the relevant documentation<\/a>).<\/p>\n\n\n\n

          In addition to aesthetic problems, incorrect dimensions of icons can cause problems with the speed of the interface & # 8212; compression \/ enlargement of images by means of the subscriber device can lead to an understated navigation speed in the channel list.<\/p>\n\n\n\n

          When Importing Channel Icons with a Team epg_channel_import<\/a><\/code> the icons are automatically adapted to the specified size configuration.<\/p>\n\n\n\n

          Television Program (EPGPrograms)<\/h2>\n\n\n\n

          After creation EPGSource<\/code>, EPGChannels<\/code> they can be connected to each other by importing a transmission program.
          Import of the program is carried out by the service team           epg_import<\/a><\/code> (The team has a large number of parameters, one of which allows you to create gear sets for the section \u00abArchive\u00bb).<\/p>\n\n\n\n

          You can automate the import of the transmission program by adding a task to the task scheduler. In this case, the import of the transfer will be carried out automatically on schedule.<\/p>\n\n\n

          \n
          \"\"
          An example of a gear import command in a task scheduler. Crontab is used as a planner. The import team is highlighted in red.<\/figcaption><\/figure>\n<\/div>\n\n\n

          At the end of the import, you can see the list of transfers in the section Tvmiddleware<\/code>subsection EPG programs<\/code>.<\/p>\n\n\n

          \n
          \"\"
          EPG programs, part of the screen with the transmission list<\/figcaption><\/figure>\n<\/div>\n\n\n

          If you wish, you can open one of the transmissions and edit any data of a particular transmission, or create your own (it should be remembered that the start time of a new transmission should coincide with the end time of the previous transmission, otherwise the logic of the continuity of the broadcast breaks).<\/p>\n\n\n\n

          \n
          \n
          \"\"<\/figure>\n<\/div>\n\n\n\n
          \n
          \"\"<\/figure>\n<\/div>\n<\/div>\n\n\n
          \n
          \"\"
          Example of a completed EPG Program<\/figcaption><\/figure>\n<\/div>\n\n\n

          Attention!<\/strong> Some templates (e.g, Redmax<\/code>) use several preview images of different formats (on the example of the same template) Redmax<\/code>It uses both 16:9 and 2:3 images. For such a situation, programs in the field Meta<\/code> there is an additional list of preview images called extra_previews<\/code> \u2014 an object that stores lists of additional images, broken down by appropriate proportions.<\/p>\n\n\n\n

          Also, the list of transmissions can be viewed in the Smarty admin panel by configuring the desired filters on the screen \u00ab Content settings\u00bb \u2014 \u00ab TV program\u00bb (for this, the channel in Smarty must be associated with the corresponding EPGChannel\u2019om).<\/p>\n\n\n

          \n
          \"\"
          Transmission program in Smarty<\/figcaption><\/figure>\n<\/div>\n\n\n

          In the event that the transmission program for the specified parameters is not found, you can press the button \u00ab Forced import EPG\u00bb \u2014 in this case, Smarty will send a command to import the transmission program for the selected filtering channel.<\/p>\n\n\n\n

          Examples of EPG application in templates<\/h2>\n\n\n\n

          Futuristic<\/h3>\n\n\n\n

          For a template Futuristic<\/code> it is recommended to use the following tv icon sizes:<\/p>\n\n\n\n