Repository navigation
Description
Plugin Name
homebridge-samsung-local
Link To GitHub Repo
https://github.com/Abdulazizruh/homebridge-samsung-local
Plugin Icon (Optional)
No response
The plugin does not offer the same nor less functionality than that of any existing verified plugin.
🟢 Yes
The plugin successfully installs and does not start unless it is configured.
🟢 Yes
The plugin does not require the user to run Homebridge in a TTY or with non-standard startup parameters, even for initial configuration.
🟢 Yes
The plugin does not contain any analytics or calls that enable you to track the user.
🟢 Yes
If the plugin needs to write files to disk (cache, keys, etc.), it stores them inside the Homebridge storage directory.
🟢 Yes
The plugin does not throw unhandled exceptions, the plugin must catch and log its own errors.
🟢 Yes
More Information
What it does
Local, cloud-free control of Samsung SmartThings-compatible appliances over the LAN (OCF, CoAP over DTLS). No SmartThings API token or subscription, no Home Assistant, no MQTT.
How it differs from the verified SmartThings plugins
The verified homebridge-smartthings-oauth talks to the SmartThings cloud API. This plugin talks to the appliance directly on the local network and keeps working without internet access. The HomeKit layout for air conditioners (thermostat, fan, optional-mode switches, display light, humidity) deliberately follows the same idea, and the two plugins run side by side.
Things reviewers will want to know
- The protocol layer is the MIT-licensed Python library
smartthings-local, used unmodified. The plugin starts a small Python helper as a child process and stops it on shutdown. - There is no post-install script. On first start (or from the settings page) the plugin creates a private virtual environment at
<homebridge storage>/samsung-local/venvand installs pinned packages from PyPI into it. No root, nothing installed system-wide. It needs Python 3.11+ withvenv, which the official Homebridge Docker image (Ubuntu 24.04) already includes. If Python is missing or too old, the plugin logs a clear message and does nothing else. - Everything it writes (virtual environment, client certificate, cached readings) is under
<homebridge storage>/samsung-local. The settings page has a confirmed "delete data" action limited to that folder. - No analytics or tracking. The only outbound connection is the one-time package download from PyPI.
- Custom settings UI (
@homebridge/plugin-ui-utils), English and Arabic: add an appliance by IP address, test and discover, choose what appears in HomeKit, download redacted diagnostics. - CI runs the test suite on Node 22, 24 and 26.
Current scope, stated plainly
- Air conditioners get a full HomeKit accessory. So far this is confirmed on one real unit (
ARTIK051_PRAC_20K, Homebridge in Docker on a Raspberry Pi); the resource map is ported from the MIT-licensed LocalThings project. - Other appliance types connect for diagnostics only and create no accessories yet. Samsung TVs are not supported.
- 64-bit ARM and x86-64 only (prebuilt Python wheels).
The plugin is not affiliated with Samsung.
Activity
github-actions commentedon Nov 21, 2026
🔴 Failed Checks
keywordsmust include at least one of'supports-hap'or'supports-matter'— see Declaring Supported Transportsrequiredshould not be a boolean property on individual fields. In JSON Schema,requiredmust be an array at the object level listing required property names. Remove"required": true/falsefrom individual properties and use"required": ["property1", "property2"]at the object level instead.🟢 Passed Checks
homepageexistsbugs.urlexists and seems a valid URLkeywordsexist and contain'homebridge-plugin''preinstall'inscriptsis not present'install'inscriptsis not present'postinstall'inscriptsis not presentengines.nodeproperty is compatible with Node 22engines.nodeproperty is compatible with Node 24engines.homebridgeproperty is compatible with Homebridge 2.5.0pluginAliaspluginAliasmatches the platform/accessory registered in codepluginTypeis set to'platform'nameschema propertyhomebridgeis not declared as a runtime/peer/bundled dependencyhap-nodejsis not declared as a runtime/peer/bundled dependency🔍 For Manual Review
The following items were detected and require manual review. We understand that these items may be false positives.
ℹ️ Check Details
v0.1.0-beta.3of the plugin.📋 Next Steps
/checkon this issue to run the checks again — your request will not move forward until the checks are re-run.package.jsonandconfig.schema.jsonfiles, don't forget to publish a new version to NPM.Abdulazizruh commentedon Nov 22, 2026
All three failed checks are fixed in v1.0.8, which is now on npm and matches the GitHub
package.json: (1)supports-hapadded tokeywords; (2) inconfig.schema.json,requiredmoved to object-level arrays; (3) npm and GitHub versions are in sync.On the manual-review item:
src/runtime/helperClient.jsdoes not read any environment file. It passesprocess.envplus one variable (the plugin's own credentials folder inside the Homebridge storage directory) to the Python helper it spawns.Plugin icon (512x512 PNG): https://raw.githubusercontent.com/Abdulazizruh/homebridge-samsung-local/main/assets/icon.png
Abdulazizruh commentedon Nov 22, 2026
/check
github-actions commentedon Nov 22, 2026
🟢 Passed Checks
homepageexistsbugs.urlexists and seems a valid URLkeywordsexist and contain'homebridge-plugin'keywordsdeclare the supported transports ('supports-hap'and/or'supports-matter')'preinstall'inscriptsis not present'install'inscriptsis not present'postinstall'inscriptsis not presentengines.nodeproperty is compatible with Node 22engines.nodeproperty is compatible with Node 24engines.homebridgeproperty is compatible with Homebridge 2.5.0typepropertypropertiesfor object typepluginAliaspluginAliasmatches the platform/accessory registered in codepluginTypeis set to'platform'nameschema propertyhomebridgeis not declared as a runtime/peer/bundled dependencyhap-nodejsis not declared as a runtime/peer/bundled dependency🔍 For Manual Review
The following items were detected and require manual review. We understand that these items may be false positives.
ℹ️ Check Details
v1.0.8of the plugin.📋 Next Steps
All checks passed successfully, nice work! Your plugin and/or icon will now be manually reviewed by the Homebridge team.