VOD artwork and title logos

Summary

The catalogue now carries, per show and per language, a transparent title logo (logoTitle), two landscape pictures (artwork.landscape with the logo burned in, artwork.landscape_no_logo without it), and, on What's New items, the show's cover (seriesImage) and a hasTrailer flag. The TV app uses them as follows:

• The hero of every VOD page shows the title logo instead of the text title when the show has one for the current language. Without a logo, the text title is set in a heavy, logo-like style.
• Cards show the picture with the logo; the hero background shows the clean picture without it.
• What's New episode items show the show's cover on the card and the episode frame in the hero, carry the show's logo, and do not show the genre / year line. What's New movies keep it.
• Description: 4 lines on the Series and Movies pages (What's New included), 3 on Telenovelas, Docu and Kids. The duration stays on its own last line.
• Trailers are requested only when the item says hasTrailer: true.
• No extra requests: everything above comes from the list and What's New answers the apps already make.

API fields

Base: https://apps-api.ipt.to. Catalogue calls send locale and no session id.

Field reference

Language

The API localises logoTitle. With locale=he it returns the Hebrew logo; with locale=en it returns the English logo only when one exists, otherwise null. The apps therefore never choose a logo themselves: request the catalogue in the UI's language and use what comes back. A Hebrew logo must not appear in the English UI; when logoTitle is null, show the text title.

Any cache of catalogue data that includes logos must be keyed by language as well as by id.

Card and hero images

The rule in words, and it is the same for series and movies alike (and for telenovelas, docu and kids, which are series or movies underneath): every title has two landscape pictures. The one with the logo burned in (artwork.landscape) is for the card in a row, where there is no room for a separate title. The one without the logo (artwork.landscape_no_logo) is for the hero behind the focused show and for the series page background, because there the title is drawn separately, as the logoTitle image or as text, and a second logo inside the picture would double it.

Fallbacks, in order, when a field is missing or null:

1. Card: artwork.landscape → showpic (the picture the catalogue always had).
2. Hero: artwork.landscape_no_logo → artwork.landscape → showpic. A show without the clean picture simply shows its card picture in the hero, as before.
3. Title: logoTitle → the text title in the logo style (see Text fallback).

Nothing is left empty: the pre-existing showpic is always the last fallback for both pictures, so a show with none of the new fields looks exactly as it did before.

What's New row

• Title: the show's name, from upper[upper.length − 2] (the show); the episode's own name is shown as a second line under it.
• Logo: vod.logoTitle (the show's logo for the current language).
• Genre / year line: hidden for episode items (vod.type === "episode"). Shown for movie items.
• Trailer: only when vod.hasTrailer === true, called with the show id (upper[upper.length − 2].id) and type series; movies use their own id and type movie.
• No per-show requests: the row is built from the single What's New answer.

Title slot

The hero reserves a fixed box at the top for the title, so the rows below start at the same height for every show, whatever the logo's shape.

Logo sizing formula

The logos come in every shape, from portrait 0.44:1 to 13:1. Scaling them to fit a box makes wide logos enormous and tall ones tiny, so each logo is sized by its visual area and then capped. All lengths below are fractions of the screen width W, which keeps the result identical on every 16:9 screen.

// natural size of the PNG: naturalW × naturalH
r = naturalW / naturalH                // aspect ratio (default 2 when unknown)

AREA  = 0.0114 · W²                    // target visual area  (42 000 px² at 1920)
H_MAX = 0.082 · W                      // tallest allowed     (157 px at 1920)
W_MAX = 0.29  · W                      // widest allowed      (557 px at 1920)
H_MIN = 0.049 · W                      // shortest, if width allows (94 px at 1920)

h = sqrt(AREA / r)
h = min(h, H_MAX, W_MAX / r)           // caps
h = max(h, min(H_MIN, W_MAX / r))      // floor, unless the width cap forbids it
w = h · r

render the PNG at w × h (object-fit: contain), anchored bottom / start of the slot

Results at 1920 × 1080, measured over the catalogue:

Text fallback (no logo)

When logoTitle is null the title is set as text in the same slot. Keep the font and size your app already uses for the title — there is no need to change them. The only requirements are that the text sits in the title slot (bottom of the box, start side, same headroom) and keeps the fallback image rules above.

For reference only, this is how the trial build styles it (not required):

Trailers

• Request a trailer only when the item's hasTrailer is true. Never call the endpoint blindly.
• The TV app fetches the trailer URL 0.5 s after a card gets focus and starts playback 3 s after focus; moving the focus before that cancels the request.
• Endpoint: GET /v2/play/trailer/{series|movie}/{id}?sid=… → streams[0]. The call needs a session; it is a play call, so no bursts.

Series page

The page a show opens to (season list on the start side, episode list in the middle). What changed:

• Top start corner (top right in Hebrew, top left in English): the title logo (category.logoTitle from GET /v2/vod/categories/{seriesId}/list) in a box 8 % of the screen height by 20 % of the screen width, object-fit: contain, or the text title when there is no logo. Under it the genre | year line. Both are aligned with the season names below them, on the start side (right in Hebrew, left in English). Nothing else goes in that corner.
• Background: always prefer the clean picture, category.artwork.landscape_no_logo, when the show has one; fall back to category.artwork.landscape, then category.showpic.
• Header buttons (top end corner): info ⓘ, favourite ♡, sort ⇅, in that order from the start side. The info button appears only when the show has a category.description. Up from the first episode lands on the info button.
• About the series dialog (info button or Enter on it): the page has no room for the description, so it opens in a modal over the page: the title logo (or text title), the genre | year line, the full description, and one Close button, centred, in the login button's focused style (solid action blue #00A2C4, pill shape). Enter, Back and Escape close it; Up / Down scroll a long description; Left / Right do nothing. While it is open the page behind must not react to keys, and Back must not leave the page.

See the two series page pictures in Screenshots: the page as opened and the dialog.

Screenshots

Reference captures from the TV build at 1920 × 1080, Hebrew UI, taken on 23 October 2026. Click a picture for the full size. They show how each case should look; the exact shows change with the catalogue.

Series page (2 pictures)

Series landing - What's New row

Series landing - broadcaster rows (the logo sized by the area formula, whatever its shape)

Four description lines (Series and Movies pages)

Implementation checklist