homebridge-ezframe-samsungframetv-artmode
v1.0.3
Published
Homebridge plugin to control Samsung Frame TV Art Mode via Apple Home, Shortcuts, and Siri.
Maintainers
Readme
EzFrame – Samsung Frame TV Art Mode (Homebridge)
Control Samsung Frame TV Art Mode from Apple Home, Shortcuts, and Siri via Homebridge.
You get one simple switch for Art Mode — no SmartThings, no extra features. Setting up Art Mode via SmartThings is much more involved; here you only need your TV’s IP address and one tap on Allow on the TV when prompted.
One switch per TV in the Home app — tap it or say “Hey Siri” to turn Art Mode on or off.
EzFrame Desktop App
This plugin works alongside EzFrame — a free desktop app (macOS, Windows, Linux) to manage art on your Samsung The Frame TV from your computer: upload images, browse and set art, and control the TV with hotkeys. If you use a Samsung Frame TV, check it out: ezframe.viet241.com.
Requirements
- Node.js
^20.18.0or later - Homebridge
^1.8.0or later - Samsung The Frame TV 2024 or newer with Art Mode is recommended (older devices have not been tested)
Installation
Via Homebridge UI (easiest)
If you use Homebridge Config UI X (web interface):
- Open the Homebridge UI (e.g. http://homebridge.local:8581).
- Go to Plugins → Search (or Plugins → Discover).
- Search for homebridge-ezframe-samsungframetv-artmode.
- Click Install, then restart Homebridge when prompted.
From npm (command line)
The plugin is published on npm. One command installs it — no .tgz file needed:
npm install -g homebridge-ezframe-samsungframetv-artmodeFrom packed file (.tgz) — optional
Only if you can’t use the npm registry (e.g. offline, or you want a specific build from GitHub Releases):
npm install -g ./homebridge-ezframe-samsungframetv-artmode-1.0.1.tgzConfiguration (platform, TVs, optional switch name) can be done via the Homebridge UI or by editing config.json. You must press Allow on the TV when prompted, and using a static IP for the TV is recommended. See install-guide.md for configuration steps and first-time pairing.
Usage
- Each TV gets one Art Mode switch in the Home app.
- Use the Home app, Siri, or Shortcuts to turn Art Mode on or off.
Troubleshooting
| Issue | What to do |
|-------|------------|
| “No plugin was found for the platform” | Reinstall the plugin where Homebridge runs (e.g. npm install -g homebridge-ezframe-samsungframetv-artmode or install the .tgz in the same environment). Restart Homebridge. |
| Broken bridge icon | Check Homebridge logs for errors (plugin crash or load failure). |
| TV not responding | Ensure the TV is on the same network, IP is correct, and you’ve accepted Allow on the TV. |
Support
This project is completely free to use. If you find this plugin useful for your The Frame TV, consider supporting my efforts:
Links
- npm: homebridge-ezframe-samsungframetv-artmode
- Repository: viet241/homebridge-samsungframetv-artmode
- Issues: GitHub Issues
License
Apache-2.0
