[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"project-80382":3},{"id":4,"name":5,"fullName":6,"owner":7,"repo":5,"description":8,"homepage":9,"htmlUrl":10,"language":11,"languages":10,"totalLinesOfCode":10,"stars":12,"forks":13,"watchers":14,"openIssues":15,"contributorsCount":16,"subscribersCount":16,"size":16,"stars1d":17,"stars7d":18,"stars30d":19,"stars90d":16,"forks30d":16,"starsTrendScore":15,"compositeScore":20,"rankGlobal":10,"rankLanguage":10,"license":21,"archived":22,"fork":22,"defaultBranch":23,"hasWiki":22,"hasPages":22,"topics":24,"createdAt":10,"pushedAt":10,"updatedAt":35,"readmeContent":36,"aiSummary":37,"trendingCount":16,"starSnapshotCount":16,"syncStatus":17,"lastSyncTime":38,"discoverSource":39},80382,"homelable-hacs","Pouzor\u002Fhomelable-hacs","Pouzor","Home Assistant integration for Homelable — interactive homelab network topology, scanning and live status checks, distributed via HACS","",null,"TypeScript",84,9,59,6,0,2,8,22,3,"MIT License",false,"main",[25,26,27,28,29,30,31,32,33,34],"canvas","hacs","home-assistant","home-assistant-integration","homelab","homelable","network","nmap","topology","zigbee","2026-06-12 02:04:01","# Homelable for Home Assistant\n\n## WIP ##\n\u002F!\\ Attention \u002F!\\ \nThis is a WIP project. If you are interested to test it and give feedback, you are very welcome.\nNeed feedbacks !\n\n---\n\nVisualize and monitor your homelab network as an interactive topology — inside\nHome Assistant.\n\n[![hacs_badge](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FHACS-Custom-41BDF5.svg)](https:\u002F\u002Fhacs.xyz\u002F)\n[![License: MIT](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FLicense-MIT-green.svg)](LICENSE)\n\nThis is the Home Assistant integration for\n[Homelable](https:\u002F\u002Fgithub.com\u002FPouzor\u002Fhomelable), packaged as a custom\nrepository for [HACS](https:\u002F\u002Fhacs.xyz\u002F). \n\nNeed the standalone (Docker \u002F LXC \u002F\nWeb) version instead? See [Pouzor\u002Fhomelable](https:\u002F\u002Fgithub.com\u002FPouzor\u002Fhomelable).\n\n---\n\n## Features\n\n- **Interactive topology** as a full Lovelace panel — pan, zoom, drag, group.\n- **Network discovery** with nmap, with optional ARP \u002F OS fingerprinting.\n- **Live status checks** via ping, HTTP, TCP, or SSH.\n- **Rich modeling**: 11 node types (router, switch, server, Proxmox, VM, LXC,\n  NAS, IoT, access point, …) and 5 edge types (ethernet, Wi-Fi, IoT, VLAN,\n  virtual).\n- **Zigbee2MQTT import**: fetch your Zigbee mesh through HA's MQTT integration\n  and add coordinator \u002F routers \u002F end devices to the canvas. No extra broker\n  config — uses the broker HA already talks to.\n\n---\n\n## Screenshots\n\n\u003Cimg width=\"2627\" height=\"1466\" alt=\"homelable-canvas (8)\" src=\"https:\u002F\u002Fgithub.com\u002Fuser-attachments\u002Fassets\u002Fb20c06c8-c042-408c-9fa5-455eb346d00a\" \u002F>\n\n\n---\n\n## Installation\n\n### HACS (recommended)\n\n1. **HACS → Integrations → ⋮ → Custom repositories**\n2. Add `https:\u002F\u002Fgithub.com\u002FPouzor\u002Fhomelable-hacs` as **Integration**.\n3. Install **Homelable**.\n4. Restart Home Assistant.\n5. **Settings → Devices & Services → Add Integration** → search \"Homelable\".\n\n### Manual\n\n1. Copy `custom_components\u002Fhomelable\u002F` into your HA `config\u002Fcustom_components\u002F`.\n2. Restart Home Assistant.\n3. Add the integration from the UI as above.\n\n### Requirements\n\n- Home Assistant **2024.1** or newer.\n- `nmap` available on the host. (HAOS bundles it; Container \u002F Core users may\n  need to install it — see [Scanner privileges](#scanner-privileges).)\n\n---\n\n## Configuration\n\nSetup is fully UI-driven (config flow). You'll be prompted for:\n\n| Field | Default | Description |\n|---|---|---|\n| Network ranges | `192.168.1.0\u002F24` | Comma-separated CIDR blocks to scan |\n| Scan interval | 60 min | How often to look for new devices |\n| Status check interval | 60 s | How often to refresh node status |\n\nAll values can be changed later from the integration's **Configure** menu.\n\n---\n\n## Usage\n\nAfter setup, a **Homelable** entry appears in the sidebar. From there:\n\n1. **Run a scan** to discover devices on the configured ranges.\n2. **Approve** a discovered device to drop it on the canvas as a node.\n3. **Connect** nodes by drawing edges; pick the appropriate edge type.\n4. **Save** the canvas (explicit — no autosave).\n\nScan history, hidden devices, and scan configuration live in the side panel.\n\n---\n\n## Scanner privileges\n\nFull discovery features (ARP, OS detection, SYN scans) need raw socket access.\nIf raw access is unavailable, the scanner falls back to TCP connect scans —\nstill useful, but slower and without MAC addresses or OS fingerprints.\n\n| Install type | Notes |\n|---|---|\n| **HAOS \u002F Supervised** | Companion add-on with full privileges is planned. |\n| **Container** | Run the HA container with `CAP_NET_RAW`, or `setcap cap_net_raw+ep $(which nmap)` inside the container. |\n| **Core** | `setcap cap_net_raw+ep $(which nmap)` on the host. |\n\n---\n\n## Roadmap\n\n- HA entities per canvas node (`sensor.homelable_\u003Cid>`, `binary_sensor.homelable_\u003Cid>_online`).\n- Device registry: one HA device per canvas node.\n- Services: `homelable.scan_now`, `homelable.approve_device`, `homelable.refresh_status`.\n- Events: `homelable_node_offline`, `homelable_node_online`, `homelable_device_discovered`.\n- HACS default-listing submission once stable with real users.\n\nSee the [issue tracker](https:\u002F\u002Fgithub.com\u002FPouzor\u002Fhomelable-hacs\u002Fissues) for\nthe live list.\n\n---\n\n## Contributing\n\nIssues and pull requests are welcome. Please:\n\n- Open an issue first for non-trivial changes so we can align on scope.\n- Keep PRs focused and include tests for behavior changes.\n- Use [Conventional Commits](https:\u002F\u002Fwww.conventionalcommits.org\u002F) (`feat:`,\n  `fix:`, `chore:`, `docs:`, `test:`, `refactor:`).\n\n---\n\n## License\n\n[MIT](LICENSE) © Pouzor\n","Homelable-hacs 是一个为 Home Assistant 提供的家庭实验室网络拓扑可视化和监控集成。它通过 HACS 分发，使用 TypeScript 开发。该项目支持交互式拓扑图，用户可以进行平移、缩放、拖动和分组操作；利用 nmap 进行网络发现，并提供实时状态检查功能，支持 ping、HTTP、TCP 或 SSH 协议。此外，它还支持丰富的模型定义，包括 11 种节点类型和 5 种边类型，以及 Zigbee2MQTT 导入功能，自动将 Zigbee 网络中的设备添加到拓扑图中。适用于需要直观管理家庭或小型办公网络环境的用户，帮助他们更好地理解网络结构并监测设备状态。","2026-06-11 04:00:32","CREATED_QUERY"]