Dashboards

Fonts and icons

The fonts a dashboard uses: the library, Google Fonts, your own font files, weights, icons beside numbers, and what goes to the board when you save.

Every text on a dashboard — a widget’s value or its caption — names a font and a size. The board draws any size from one installed font file, so only the fonts take room on the board, never the sizes.

The font library

The configurator keeps a font library on your computer, shared by every dashboard you open. A font goes to the board only when a dashboard that uses it is saved.

One font is one weight. The board holds one file per family, so Roboto and Roboto Bold are two fonts, and each counts towards the 8 a dashboard can use.

The Fonts tab: the budget, Import font, Erase on board, the fonts this dashboard uses and the library
The Fonts tab of a dashboard that uses four fonts, with the board connected.
  1. 1Erase on board: see Remove a font.
  2. 2fixed-width means every digit is equally wide, so a changing number does not shift sideways.

Add a font from Google Fonts

The configurator downloads a font only when you pick it, so the computer needs the internet at that moment. Italics are not in the list: import those as files.

Orbitron found in the Google Fonts list with its six weights open
Orbitron found in the Google Fonts list, with its weights open.

Import your own font

The dashboard refers to a font by its id, which the configurator makes from the file name: lower case, with anything other than letters and digits turned into dashes, so MyFont-Bold.ttf becomes myfont-bold. An id has at most 31 characters, and a longer name is shortened. When the library already has a font with that id, the import is refused: rename the file and import it again.

Choose a font for a widget

The Choose a font dialog: search, In this dashboard, Library, Google Fonts and Import font
Choose a font, opened from a Text widget.
  1. 1In this dashboard: picking one of these costs nothing.
  2. 2Library: a greyed-out font would not fit on the board; hold the pointer over it to read why.
  3. 3Google Fonts: a weight you pick downloads and goes straight onto the widget.

New widgets start with the font set in New widgets.

Icons beside numbers

Icons come from Material Icons. In the inspector, the smiley button beside the Text of a Title, and beside the Prefix and Suffix of a value, opens them.

An icon draws only in Material Icons, so set the text up one of two ways:

  • For an icon on its own, make Material Icons the font of that text.
  • For an icon beside a number, keep a text font and add Material Icons as its fallback: press + Fallback family under the font and choose Material Icons. The board draws each character from the font when the font has it, and from the fallback when it does not, at the same size.
The Font row of a value: Roboto Bold at size 34 with Material Icons as its fallback
The Font row of a value with Material Icons as its fallback.

The fallback counts as one more of the 8 fonts. Without one, an icon in a text font draws as an empty box.

The icon picker: a search box and groups of car and timing and weather icons
The icons, opened from the smiley button beside Suffix: a few groups to start with, and Search all icons over every icon in Material Icons.

What happens when you save

Save to board brings the fonts along by itself and restarts the board for them: see What a save does, in order. Fonts travel only with a change to the dashboard: a save that changes only the LEDs or the link leaves the board’s fonts alone.

A font the library does not have

A dashboard made on another computer can name a font your library lacks. The Fonts tab marks it Not in library, the inspector shows Unresolved: with its id, and a save stops with this window. Nothing is written to the board until every font is found, or you choose another font for those widgets.

The Fonts this dashboard needs dialog: one font found, one with a Choose button, and Close and Save again
Fonts this dashboard needs.
  1. 1Choose .ttf/.otf… imports a file under exactly that id.

Remove a font

  • From the board: stop using it and save. The next package holds only the fonts the dashboard uses.
  • Erase on board erases every font on the board, after asking. After its next restart the board cannot build its dashboard until fonts are installed again, and Save to board stays greyed out while the draft matches the board: change something in the dashboard, then save.

Good to know

  • A dashboard with more than 8 fonts — from a pasted widget or a file — cannot be saved until you bring it down: Configuration references more than 8 font families.
  • Two messages still speak of 2 MiB: Adding this face would push the font package past 2 MiB. and That face is larger than the whole 2 MiB font partition. The limit both check is 3 MiB.
  • The library belongs to this computer. On another computer the same dashboard may need its fonts downloaded or imported again.

Limits

WhatLimit
Fonts per dashboard, fallbacks included8
All fonts of a dashboard together3 MiB
Font size1 to 255 pixels
One font file.ttf or .otf, 128 bytes to 3 MiB
Font idUp to 31 characters: a–z, 0–9, - and _
Fonts you import256 in the library, counting the ones downloaded from Google Fonts