Skip to content

QUICK_START.md

Latest commit

 

History

History
209 lines (125 loc) · 5.84 KB

QUICK_START.md

File metadata and controls

209 lines (125 loc) · 5.84 KB

🚀 Quick Start Guide - 5 Minutes to Your Perfect Dashboard

Languages: English | Français

English

Get Linus Dashboard Running in 5 Minutes

Follow these simple steps to transform your Home Assistant with automatic organization.

Step 1: Install (2 minutes)

Via HACS (Recommended)

  1. Open HACS → Integrations
  2. Search for "Linus Dashboard"
  3. Click Install
  4. Restart Home Assistant

Manual Installation

  1. Download the latest release
  2. Extract to custom_components/linus_dashboard/
  3. Restart Home Assistant

Step 2: Configure (2 minutes)

  1. Go to Settings → Devices & Services
  2. Click "Add Integration" (bottom right)
  3. Search for "Linus Dashboard"
  4. Click on Linus Dashboard in the results
  5. (Optional) Select a weather entity
  6. (Optional) Select an alarm entity
  7. Click Submit

Step 3: Access Your Dashboard (1 minute)

  1. Look for the bowtie icon 🎀 in your left sidebar
  2. Click it to open Linus Dashboard
  3. Explore your auto-organized smart home!

All your devices are automatically organized by room and type. No configuration needed.

Step 4: Customize (Optional)

Want to go further? Here are popular customizations:

Embed Your Custom Dashboards

Keep your energy dashboard, camera views, or any custom view alongside Linus's automatic organization.

📖 Complete guide

Reorder Rooms (HA 2025.1+)

Drag & drop rooms in Home Assistant settings to prioritize your most-used spaces.

📖 Learn more

Upgrade to Linus Brain (Optional)

Add AI-powered activity detection and advanced automation.

🧠 Discover Linus Brain

Learn About Activity Detection

Understand room occupancy and activity with automatic sensor detection.

📊 Activity Detection Guide

Troubleshooting

The bowtie icon doesn't appear

  1. Restart Home Assistant (Settings → System → Restart)
  2. Clear your browser cache (Ctrl+F5 or Cmd+Shift+R)
  3. Check that the integration is configured (Settings → Devices & Services)

My devices aren't showing up

  • Ensure devices are assigned to an area (Settings → Areas)
  • Check excluded domains in Linus Dashboard configuration
  • Some entities are intentionally hidden (unavailable, configuration entities)

I see a timeout or red error

See full troubleshooting guide

What's Next?

Français

Linus Dashboard Opérationnel en 5 Minutes

Suivez ces étapes simples pour transformer votre Home Assistant avec l'organisation automatique.

Étape 1 : Installation (2 minutes)

Via HACS (Recommandé)

  1. Ouvrez HACS → Intégrations
  2. Recherchez "Linus Dashboard"
  3. Cliquez sur Installer
  4. Redémarrez Home Assistant

Installation Manuelle

  1. Téléchargez la dernière version
  2. Extrayez dans custom_components/linus_dashboard/
  3. Redémarrez Home Assistant

Étape 2 : Configuration (2 minutes)

  1. Allez dans Paramètres → Appareils et services
  2. Cliquez sur "Ajouter une intégration" (en bas à droite)
  3. Recherchez "Linus Dashboard"
  4. Cliquez sur Linus Dashboard dans les résultats
  5. (Optionnel) Sélectionnez une entité météo
  6. (Optionnel) Sélectionnez une entité alarme
  7. Cliquez sur Valider

Étape 3 : Accédez à Votre Tableau de Bord (1 minute)

  1. Cherchez l'icône nœud papillon 🎀 dans la barre latérale gauche
  2. Cliquez dessus pour ouvrir Linus Dashboard
  3. Explorez votre maison intelligente auto-organisée !

Tous vos appareils sont automatiquement organisés par pièce et type. Aucune configuration nécessaire.

Étape 4 : Personnaliser (Optionnel)

Vous voulez aller plus loin ? Voici les personnalisations populaires :

Intégrer Vos Tableaux de Bord Personnalisés

Gardez votre tableau de bord énergie, vues caméras, ou toute vue personnalisée aux côtés de l'organisation automatique de Linus.

📖 Guide complet

Réorganiser les Pièces (HA 2025.1+)

Glissez-déposez les pièces dans les paramètres Home Assistant pour prioriser vos espaces les plus utilisés.

📖 En savoir plus

Passer à Linus Brain (Optionnel)

Ajoutez la détection d'activité par IA et l'automatisation avancée.

🧠 Découvrir Linus Brain

Dépannage

L'icône nœud papillon n'apparaît pas

  1. Redémarrez Home Assistant (Paramètres → Système → Redémarrer)
  2. Videz le cache de votre navigateur (Ctrl+F5 ou Cmd+Shift+R)
  3. Vérifiez que l'intégration est configurée (Paramètres → Appareils et services)

Mes appareils ne s'affichent pas

  • Assurez-vous que les appareils sont assignés à une zone (Paramètres → Zones)
  • Vérifiez les domaines exclus dans la configuration Linus Dashboard
  • Certaines entités sont intentionnellement cachées (non disponibles, entités de configuration)

Je vois une erreur timeout ou rouge

Voir le guide de dépannage complet

Et Ensuite ?