# Timeline Card

{% hint style="info" %}
Requires LLM Vision v1.4.0 or later.
{% endhint %}

<figure><img src="/files/0unjkR0POzs69krPnC6e" alt="" width="563"><figcaption></figcaption></figure>

## Installation

The dashboard card can be installed via HACS:

[![Open your Home Assistant instance and open a repository inside the Home Assistant Community Store.](https://my.home-assistant.io/badges/hacs_repository.svg)](https://my.home-assistant.io/redirect/hacs_repository/?owner=valentinfrlch\&repository=llmvision-card\&category=Dashboard)

You can also add the repositories url to HACS custom repositories manually:

```url
https://github.com/valentinfrlch/llmvision-card
```

Paste this link in *HACS > ... > Custom repositories* and select `Dashboard` as type.

## Setup

1. Install the card via HACS
2. Reload Home Assistant page
3. Add the card to your dashboard

## Configuration Reference

| Parameter          | Description                                                                                                    | Default                        |
| ------------------ | -------------------------------------------------------------------------------------------------------------- | ------------------------------ |
| `entity`           | LLM Vision Timeline Entity (needs to be set up in LLM Vision Settings first)                                   | `calendar.llm_vision_timeline` |
| `number_of_hours`  | Show events that occurred within the past specified number of hours.                                           | 24                             |
| `number_of_events` | How many events to show. Maximum is 10.                                                                        | 5                              |
| `category_filters` | Only show events matching one of the specified categories.                                                     | `[]`                           |
| `custom_colors`    | Custom colors for categories. Colors must be specified as a list of RGB values. See example for details.       | `[]`                           |
| `language`         | Language used for UI and generate icons (supports: `de`, `en`, `es`, `fr`, `it`, `nl`, `pl`, `pt`, `sv`, `sk`) | `en`                           |


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://llmvision.gitbook.io/getting-started/setup/timeline-card.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.