SmartHomeNG Items for VS Code

Deutsch

Shows the items of a SmartHomeNG installation the way SmartHomeNG sees them after loading: all items/*.yaml files merged and structs (structs/, etc/struct*.yaml, plugins/<plugin>/plugin.yaml) resolved. Adds search, filters, autocomplete and KNX group addresses from your ETS project.

The user interface is in German, as is most of the SmartHomeNG community.

Features

• Item tree (activity bar → SmartHomeNG): all items with type, KNX group addresses (→ send, ← listen, ⇐ init), Hue ID, ƒ for eval, ⏲ for UZSU and the struct used. Items that exist only through a struct are purple, attributes from structs grey. Clicking an item opens its definition in items/.
• Tooltip with all attributes (including their struct origin) and links to the definitions.
• Filters: one chip per configured plugin (read from etc/plugin.yaml and the plugins' item_attributes), extra categories (eval, timers, cache) and item types (bool, num, …). Plugins/categories are combined with AND, types with OR. Applies to the search and the item tree.
• Search (Ctrl+Shift+Alt+I): live results over path, name and attributes; pattern matching such as baddim → eg.bad.licht.spiegel.dimmen; ranked by fewest fragments and word starts; hits hidden by the filter are listed below a separator; items that exist only through a struct come last.
• Autocomplete in items/*.yaml, structs/*.yaml and logics/*.py:
  • child items (from items with the same name or at the same depth, struct children to extend)
  • attributes (SmartHomeNG core and item_attributes of the configured plugins, including @instance)
  • values (type, struct names, plugin valid_list, values used elsewhere)
  • item paths for eval_trigger, hysteresis_input, the target of on_change/on_update and sh. in expressions – absolute and relative (..sibling, .child, ...uncle, .self)
  • ranked by what occurs together in your existing items (e.g. type: bool → knx_dpt → 1)
• KNX / ETS (setting shngItems.knxProject): knx_send, knx_listen, … suggest matching group addresses from the ETS project (name and groups ↔ item path, DPT ↔ type/knx_dpt, status addresses for knx_listen) plus the next free address in the group; knx_dpt takes the DPT from the ETS; hovering a group address shows its ETS name, groups, DPT and all items using it.
• Item overview (table icon): sortable and filterable table of all items.
• Hover & Go to Definition (F12) for item paths in YAML, Python (logics) and HTML (smartVISU).
• Diagnostics: unknown structs, eval_trigger pointing to missing items, unknown sh.* references in eval/on_change/on_update.
• Context menu: copy item path, find usages; in the editor: "Item im Baum anzeigen" (reveal item in tree).

Requirements

A SmartHomeNG installation (a folder containing items/) in the workspace, or the setting shngItems.basePath, e.g. for a network share \\smarthomeng\SmartHomeNG. For KNX suggestions, an ETS project (.knxproj) exported without a password.

Settings

License

MIT