Screen time cards for your Home Assistant dashboard

Life Dashboard Screen Time is one install from the Marketplace (HACS before Home Assistant 2026.11) with three open-source dashboard cards: today on one phone, the week, and the whole family, each against a daily limit you set. They read the Life Dashboard app on Android, Google Family Link, Microsoft Family Safety, or any sensor that counts the day.

Get it on HACS

Screen time guide · Source on GitHub

The three Life Dashboard Screen Time cards on a dark theme with sample data. Today: a ring with 3h 16m of a 3h 30m limit, 14 minutes left, and five apps with their minutes. The week: a bar per day against a dashed limit line, two days over it. The family: Sam, Mila and Noah with their totals against their limits

What it does

Three cards, one install

Today, the week and the family are all in the card picker after one download, each with a visual editor.

  • A daily limit

    Set it per card or per person. The ring and the bars show on track, nearly there from 80% of the limit, and over, in the colors of your theme.

  • Apps that look like the apps

    A built-in list of 126 popular Android apps with their name, brand color and icon. Any other app gets its first letter on a color of its own.

  • Any source

    The Life Dashboard app on Android, Google Family Link, Microsoft Family Safety, or a sensor of your own such as history_stats.

  • Eleven languages

    English, Arabic, Chinese, Dutch, French, German, Hindi, Italian, Japanese, Portuguese and Spanish, with durations written the way your language does.

  • Light and dark

    The cards take the colors of your Home Assistant theme, and the three status colors are CSS variables.

  • Nothing leaves your browser

    The cards read the sensors and statistics Home Assistant already gives your browser. No requests of their own, no telemetry and no analytics.

The screen time card for today at phone width with sample data: a ring with 3h 16m of a 3h 30m limit, 14 minutes left, 23 minutes more than yesterday, and YouTube, WhatsApp, Chrome, Instagram and Maps with their minutes

Sample data from made-up phones

Today

Today on one phone, against the limit

A ring fills against the daily limit and says how much is left or how far over the day is. Beside it: the difference with yesterday and with the last seven days, and the number of apps used.

  • The apps with their minutes Five by default, most used first. + more shows the rest.
  • Without a limit The ring fills against the average of the last seven days instead.
  • The last sync With Life Dashboard, the card finds the phone's other sensors on its own and says when the phone last sent.
The week card with sample data: 3h 21m a day on average, a bar per day against a dashed limit line at 3h 30m, two of seven days over it, and today's apps as one stacked bar

Sample data from made-up phones

The week

The week, a bar per day

A bar per day with the limit as a dashed line, the days over it marked, and the average per day. Three to fourteen days, seven by default.

  • Tap a day Its apps show as one stacked bar, each with its minutes.
  • From the statistics The week comes from the long-term statistics Home Assistant already keeps for the sensor, so there is no helper to set up.
  • The apps of earlier days With Life Dashboard they come from the app sensors you switch on, on the phone's device page.
The family card with sample data: Sam, Mila and Noah with their totals against their limits and their top three apps, Sam with 14 minutes left and Noah over by 59 minutes

Sample data from made-up phones

The family

The whole family in one card

Everyone in one card, each against their own limit, with their three biggest apps. Tap a person for all their apps.

  • A row per phone or tablet Each row is one screen time sensor, with a name and a limit of its own.
  • The person's picture Give a row a person and that person's picture and name show.
  • Left, or over Every row says how much time is left, or by how much the day went over.
Dashboard YAML
type: custom:life-dashboard-screen-time-card
entity: sensor.your_phone_screen_time_today
limit: "3:30"

# the week: custom:life-dashboard-screen-time-week-card

type: custom:life-dashboard-screen-time-family-card
people:
  - entity: sensor.sams_pixel_screen_time_today
    person: person.sam
    limit: "3:30"
  - entity: sensor.milas_tablet_screen_time_today
    name: Mila
    limit: "2:00"

A visual editor, or a few lines of YAML

All three are in the card picker, with an editor for the phone, the limit, the title and the apps. In YAML, a card needs its type and the sensor with today's screen time.

  • limit "3:30", "2h", "45m" or a number of minutes.
  • apps Per package name: a name of your own, a color, an icon such as mdi:gamepad-variant, or hidden: true.
  • people For the family card. Per phone an entity, and optionally a name, a person and its own limit.
Every option in the README

Where the screen time comes from

The cards work with any sensor that holds today's screen time. What they can show depends on what the source knows.

FeatureToday's appsThe weekThe limit
Life Dashboard app, AndroidEvery app of the day, from integration 1.2.0From the integration's statisticsThe one you give the card
Google Family Link, through HAFamilyLinkYes, with the child's Daily Screen Time sensorFrom the sensor's statisticsThe one set in Family Link, or your own
Microsoft Family Safety, through HAFamilySafetyYes, from the account's Applications sensorFrom the sensor's statisticsFrom its time remaining sensor, or your own
Any other sensor, such as history_statsOnly with an apps attributeFrom the sensor's statisticsThe one you give the card
iPhoneNo: iOS has no API for screen timeNoNo

From the README of the cards, as of version 0.2.0. A sensor of your own has to hold today's total in hours or minutes and start at zero each day. HAFamilyLink and HAFamilySafety are community integrations and not part of Life Dashboard.

Install the screen time cards

Life Dashboard Screen Time cards

Today, the week and the family, against a daily limit

Get it on HACS

In Settings > Marketplace (HACS before Home Assistant 2026.11), search for Life Dashboard Screen Time and download it. All three cards are then in the card picker.

  • Screen time guide AvailableScreen time per app from an Android phone into Home Assistant, step by step.
  • Source on GitHub AvailableRelease notes, every option and the install by hand.

What you need

Home Assistant 2026.3 or newer. From 2026.11 the Marketplace is built in; older versions need HACS, where the cards are in the default list. And a sensor with today's screen time. For every app's minutes on an Android phone that is Life Dashboard for Android with the integration, 1.2.0 or newer. An iPhone has no screen time for apps to read.

Reads the Life Dashboard integration with the Android app, Google Family Link, Microsoft Family Safety or a sensor of your own.

Dashboards in YAML mode
lovelace:
  resources:
    - url: /hacsfiles/life-dashboard-screen-time-card/life-dashboard-screen-time-card.js
      type: module

Only for dashboards in YAML mode. On storage mode dashboards the resource is registered for you. Without the Marketplace, the README has the install by hand.

Questions about the screen time cards

Does it work with an iPhone?

No. iOS has no API that lets an app read screen time, so there is nothing to send to Home Assistant. The cards show Android phones and tablets, and what Google Family Link or Microsoft Family Safety report for a child.

Do I need the Life Dashboard app?

Not for the cards themselves: they also read Family Link, Family Safety and any sensor with today's total. For the minutes of every app on your own Android phone you do, because the official Companion app has no minutes per app. Get the Android app.

Can I use it with Google Family Link?

Yes, through HAFamilyLink, a community integration. Pick a child's Daily Screen Time sensor. Its apps come along, the week comes from the sensor's statistics, and the daily limit set in Family Link is used unless you give the card your own. Microsoft Family Safety works the same way through HAFamilySafety.

Does the limit lock the phone?

No. The limit is something to compare against: the cards show how much is left or how far over the day is, and they block nothing. For an action, write a Home Assistant automation on the screen time sensor, such as a notification at the limit. Screen time in Home Assistant has examples.

Why does an app show a letter instead of its icon?

The built-in list covers 126 popular Android apps, with icons from Home Assistant's own icon set. Any other app gets its first letter on a color of its own. Under apps you give an app a name, a color and an icon yourself, or hide it.

Do the cards send my data anywhere?

No. They only read what Home Assistant already gives your browser: the sensors' state and, for the week, the recorder's statistics. They make no requests of their own and have no telemetry or analytics.

Step by step: Screen time in Home Assistant