Skip to content
CF MEDIA

Items

Each block in the grid is an item. It can have text, an icon, an image, badges and an action.

item
{
  "layout": "0,0,3,3",
  "title": "Beach holiday",
  "label": "July 2025",
  "titleHeader": "NEW",
  "titleFooter": "12 min",
  "icon": "beach_access",
  "color": "#0f4c5c",
  "badge": "4K",
  "progress": 0.35,
  "action": "video:http://{SERVER}/media/holiday.mp4"
}

Properties

PropertyDescription
titleTitle
label (or text)Second, smaller line
titleHeaderStrip at the top of the item
titleFooterStrip at the bottom of the item (with an image, title becomes the footer)
iconIcon in the center (below)
imageImage filling the item (URL)
imageFillerHow the image fills it (below)
colorBackground color (below)
badgeOrange badge in the corner (e.g. "NEW", "4K")
tagDiscreet label in the corner
progressProgress bar, from 0 to 1 (e.g. “continue watching”)
actionWhat happens on OK. See Actions
focus: trueStarts with focus on this item
enable: falseVisible item, but without an action (dimmed)
display: falseHides the item
type: "space"Empty space in the grid, without focus

Icons

Use the names from Material Icons: movie, music_note, image, live_tv, school… The hyphenated name also works (music-note).

To change the icon color, use color:name:

ValueColor
movieCF media orange (default)
cf-white:movieWhite
cf-white-soft:movieSoft white (60%)
cf-black:movieBlack
cf-yellow:, cf-red:, cf-green:, cf-blue:, cf-orange:, cf-grey:Colors. Add -soft for the soft version

Background colors

ValueResult
cf-glassDark glass (a good default for almost everything)
cf-black / cf-darkSolid dark
cf-whiteLight
transparentNo background
#2d3a6b, rgb(…)Any CSS color

Images: imageFiller

ValueHow the image fills the item
defaultStretches to fill everything
fitWhole, without cropping (there may be a border)
coverFills everything, cropping the excess (the most used for photos and posters)
smartWhole; if the aspect ratio is nearly the same, it fills
width-top · width-center · width-bottomFills by width, aligned at the top, middle or bottom
height-left · height-center · height-rightFills by height, aligned left, center or right