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
| Property | Description |
|---|---|
title | Title |
label (or text) | Second, smaller line |
titleHeader | Strip at the top of the item |
titleFooter | Strip at the bottom of the item (with an image, title becomes the footer) |
icon | Icon in the center (below) |
image | Image filling the item (URL) |
imageFiller | How the image fills it (below) |
color | Background color (below) |
badge | Orange badge in the corner (e.g. "NEW", "4K") |
tag | Discreet label in the corner |
progress | Progress bar, from 0 to 1 (e.g. “continue watching”) |
action | What happens on OK. See Actions |
focus: true | Starts with focus on this item |
enable: false | Visible item, but without an action (dimmed) |
display: false | Hides 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:
| Value | Color |
|---|---|
movie | CF media orange (default) |
cf-white:movie | White |
cf-white-soft:movie | Soft white (60%) |
cf-black:movie | Black |
cf-yellow:, cf-red:, cf-green:, cf-blue:, cf-orange:, cf-grey: | Colors. Add -soft for the soft version |
Background colors
| Value | Result |
|---|---|
cf-glass | Dark glass (a good default for almost everything) |
cf-black / cf-dark | Solid dark |
cf-white | Light |
transparent | No background |
#2d3a6b, rgb(…) | Any CSS color |
Images: imageFiller
| Value | How the image fills the item |
|---|---|
default | Stretches to fill everything |
fit | Whole, without cropping (there may be a border) |
cover | Fills everything, cropping the excess (the most used for photos and posters) |
smart | Whole; if the aspect ratio is nearly the same, it fills |
width-top · width-center · width-bottom | Fills by width, aligned at the top, middle or bottom |
height-left · height-center · height-right | Fills by height, aligned left, center or right |