0.0.12 • Public • Published

An EPSON Projector plugin for


This creates a Light Switch in homekit for the power status of the projector.

This is a fork from Jackie Yang's homebridge-epson-projector, modified to work with Axios.

This was tested to work with the EPSON HomeCinema 2150. It should work with any other EPSON projector with EPSON iProjection support.


Run these commands:

% sudo npm install -g homebridge
% sudo npm install -g @ecoen66/homebridge-epson-projector

NOTE: If you install homebridge like this:

sudo npm install -g --unsafe-perm homebridge

Then all subsequent installations must be like this:

sudo npm install -g --unsafe-perm @ecoen66/homebridge-epson-projector


Example accessory config (needs to be added to the homebridge config.json): ...

	"accessories": [
			"name": "Projector",
			"ipAddress": "",
			"model": "2150",
			"serial": "myserialno",
			"timeout": 10000,
			"refreshInterval": 15,
			"debug": false,
			"accessory": "Epson Projector"


Config Explanation:

Field Description
accessory (required) Must always be "Epson Projector".
name (required) The name you want to use for for the light switch widget.
ipAddress (required) The IP address of the projector (should be static, not DHCP).
model (optional) This shows up in the homekit accessory Characteristics.
serial (optional) This shows up in the homekit accessory Characteristics.
timeout (optional) The timeout duration for the web API calls.
refreshInterval (optional) The number of minutes between power status polls and updates. Default is 15
debug (optional) Enables additional logging.

To make your projector work with the plugin:

  1. Connect your projector to your home network.
  2. Write down the IP address of the projector.
  3. Create your config file according to the above example (or using the Homebridge UI).

This plugin is still very experimental. Please create an issue or a pull request for any problem you encountered.

The fact that it is slow to recognize the power status change after turning the projector on or off is a known issue - but it works...

Package Sidebar


npm i @ecoen66/homebridge-epson-projector

Weekly Downloads






Unpacked Size

8.12 kB

Total Files


Last publish


  • ecoen66