Skip to content

Repository files navigation

HA-Commander hero image

HA-Commander

Search and control your Home Assistant entities from Flow Launcher.

CI Release Downloads

Buy Me a Coffee Sponsor

Features

  • Search everything. Find any entity by name or entity_id.
  • Smart default actions. Enter toggles lights and switches, runs scripts and scenes, presses buttons and cycles thermostat modes.
  • Rich context menu. Services, light colors and effects, media sources and every attribute, one Shift+Enter away.
  • Brightness from the search bar. ha kitchen 40 sets the kitchen lights to 40%.
  • Browse by domain. ha # lists your domains, ha light. lists your lights.
  • Logbook and error log. ha @ shows what just changed, ha ! shows what went wrong.
  • Theme-aware icons. Material Design icons that follow your Flow Launcher theme.

Usage

Type ha followed by an entity name or entity_id, then press Enter to run its default action:

ha living

HA-Commander search results in Flow LauncherHA-Commander search results in Flow Launcher

Query Result
ha <name> Entities whose name or entity_id matches
ha <domain>. Only entities in that domain, e.g. ha light.
ha # Every domain. Select one to browse its entities
ha <light> <0-100> Set a light's brightness
ha @ Recently changed entities from the logbook
ha ! The Home Assistant error log, newest first

Browse by domain

Type # to list your domains. Selecting one fills in the domain filter:

Domains listed in Flow LauncherDomains listed in Flow Launcher

Light entities in Flow LauncherLight entities in Flow Launcher

Set light brightness

Add a number between 0 and 100 after a light:

Setting a light's brightness from Flow LauncherSetting a light's brightness from Flow Launcher

Logbook

ha @ lists recently changed entities, newest first. Select one to jump to it:

Home Assistant logbook in Flow LauncherHome Assistant logbook in Flow Launcher

Context menu

Open the context menu (Shift+Enter or right-click) for the entity's services, light colors and effects, media player sources and select options, and its attributes. Select an attribute to copy it:

Context menu with light services and effectsContext menu with light services and effects

Hide entities

Choose Hide Entity at the bottom of the context menu to remove noisy entities from the results:

Hide Entity in the context menuHide Entity in the context menu

Installation

Flow Launcher

In Flow Launcher, type:

pm install ha-commander

Flow Launcher plugin manager installing HA-CommanderFlow Launcher plugin manager installing HA-Commander

Manual installation

Download HA-Commander-<version>.zip from the latest release and unzip it into %appdata%\FlowLauncher\Plugins, then restart Flow Launcher.

Pre-releases of the next version are published from the open release PR on the releases page for testing. Flow Launcher won't offer them as updates.

Configuration

Open Settings → Plugins → HA-Commander in Flow Launcher:

Setting Default Description
URL http://localhost:8123 Your Home Assistant URL, including the port
Token A long-lived access token. Create one under Profile → Security in Home Assistant
Verify SSL true Reject invalid or self-signed certificates
Max results 50 The most results to show. Lower is faster

Requirements

  • Flow Launcher 1.17.0 or newer
  • Python 3.8 or newer, which Flow Launcher can install for you

Changelog

6.0.0 (2026-10-03)

⚠ BREAKING CHANGES

  • port the plugin to pyflowlauncher on Flow Launcher's python_v2 runtime

Features

  • port the plugin to pyflowlauncher on Flow Launcher's python_v2 runtime (d430dcc)
  • update icons to MDI 7.4.47 and Home Assistant's entity icons (d430dcc)

Bug Fixes

  • honour the Max results setting again (d430dcc)
  • resolve custom mdi: entity icons (d430dcc)
  • save hidden entities to the plugin settings (d430dcc)

Performance Improvements

  • reply to Flow Launcher before Home Assistant responds (0b5504f)
  • reply to Flow Launcher before Home Assistant responds (7513391)

5.2.1 - 2025-01-09

  • fix: mediaplayer attribute error by @Gh0stExp10it in #68

5.2.0 - 2024-06-27

  • Update flox lib from 0.18.1 to 0.20.1 by @Garulf in #59
  • Fix select options by @Garulf in #62
  • Added button entity class by @Hobbit44 in #60
  • Handle lights with no effects attribute by @Garulf in #63

Special Thanks

I would like to thank the following for their contributions and support @robertoleonardo and @Hobbit44 and anyone who has reported bugs and helped. Thank you

See CHANGELOG.md for the full history.

About

Search, and interact with Home Assistant from Wox/Flow Launcher

Topics

Resources

Stars

31 stars

Watchers

2 watching

Forks

Releases

Sponsor this project

Used by

Contributors

Languages