Franz646

Franz646 / orphan-cleaner

Public

Delete orphan entities

19
2
100% credibility
Found Apr 24, 2026 at 19 stars -- GitGems finds repos before they trend. Get early access to the next one.
Sign Up Free
AI Analysis
Python
AI Summary

Custom integration for Home Assistant that scans for and removes orphan entities lingering after integrations are uninstalled.

How It Works

1
🏠 Notice clutter in your smart home

You realize your home control system has leftover items from old gadgets that were removed but still linger around.

2
đź“Ą Add the cleaning tool

Using your system's easy add-on store, you grab the orphan cleaner and let it settle in.

3
🔄 Refresh and connect

Give your system a quick refresh, then link up the cleaner so it's ready to help.

4
🧹 Open the broom panel

Spot the friendly broom icon in your sidebar and click it to reveal a simple dashboard for cleaning.

5
🔍 Scan for leftovers

Hit the scan button to automatically hunt down all those stray items hiding in your system.

6
âś… Pick and sweep away

Review the list of strays, choose what to remove, confirm, and watch them disappear safely.

✨ Enjoy a tidy system

Your smart home feels fresh and organized, running smoother without any forgotten clutter.

Sign up to see the full architecture

5 more

Sign Up Free

Star Growth

See how this repo grew from 19 to 19 stars Sign Up Free
Repurpose This Repo

Repurpose is a Pro feature

Generate ready-to-use prompts for X threads, LinkedIn posts, blog posts, YouTube scripts, and more -- with full repo context baked in.

Unlock Repurpose
AI-Generated Review

What is orphan-cleaner?

Orphan-cleaner is a Python custom integration for Home Assistant that detects and deletes orphaned entities—ghost entries lingering in the registry after integrations like Shelly or BLE monitors are removed. It adds a sidebar web panel for one-click scans, filtering by entity ID or platform, bulk selection, and confirmed deletions with real-time logs. You also get services like `orphan_cleaner.scan` (fires an event with results) and `orphan_cleaner.delete_orphans` (supports dry runs and specific entity lists), perfect for cleaning up like deleting orphan files or orphaned entities in Home Assistant.

Why is it gaining traction?

It stands out with multiple detection methods—official `orphaned_timestamp`, dead config entries, long-unavailable states, and optional heuristics—while configurable via min age (1-720 hours) and aggressive mode to avoid false positives on manual platforms. HACS installation is dead simple, the panel feels native with live updates, and event integration lets automations notify on orphans, unlike manual registry dives or generic purge tools. Developers dig the dry-run safety and service YAML docs for quick scripting.

Who should use this?

Home Assistant power users swapping integrations often, dealing with "no longer provided by the integration" warnings on sensors or binary_sensors. Ideal for tinkerers maintaining 100+ entities who want to delete orphaned entities without YAML edits or database purges, or automation scripters reacting to scans.

Verdict

Grab it via HACS if you're battling entity bloat—solid docs and MIT license make it low-risk, but with 19 stars and 1.0% credibility score, it's early-stage; always backup and test dry-run first. Practical win for HA cleanup, worth watching.

(178 words)

Sign up to read the full AI review Sign Up Free

Similar repos coming soon.