JVC Projector Remote

This is a package to control JVC Projectors over IP.

References

This library is used by following software:

• JVC projector remote for Homeassistant (add-on for Home Assistant).
• homebridge-jvc-projector(plugin for Homebridge)

It can also be used standalone or in a Python script.

Command Format

Read State

To get a status a specific command is sent with the JVCProjector.command(<command>) method.

Examples:

• To read power state, send command power and receive standby, lamp_on, cooling, reserved or emergency
• To read signal state, send command signal and receive no_signal or active_signal

Write State

To control the projector, a command together with a certain state is sent with the JVCProjector.command(<command>-<state>) method.

Examples:

• Power ON: power-on
• Change picture mode to film: picture_mode-film
• Switch lamp to high: lamp-high

Supported Commands

NOTE: Not all commands or states are supported by all models. You can easily tell by testing them on your JVC projector.

Installation

$ python3 -m pip install jvc_projector_remote

Usage

For usage with Home Assistant, see here.

Below is an example for using this module standalone (see command format section for command strings):

>>> from jvc_projector_remote import JVCProjector

 # replace with your projector's local IP
>>> host = "192.168.1.12"

# initialise (for models older than the NZ series)
>>> projector = JVCProjector(host, port=20554, delay_ms=600, connect_timeout=10, max_retries=10)

# initialise (alternate, with network password)
>>> projector = JVCProjector(host, password="MYPASSWORD", port=20554, delay_ms=600, connect_timeout=10, max_retries=10)

# power on, power off
>>> projector.power_on()
# check status once it's on
>>> projector.is_on()
True

>>> projector.power_off()
# check if it's off
>>> projector.is_on()
False

# Send arbitrary command
# see the command format section above
>>> projector.command("input-hdmi2")

Confirmed Models

• DLA-X5900
• NX5
• NZ8/RS3100
• DLA-RS440

Let me know if it works with your projector and I will add it to the list above.

Error ConnectionRefusedError

The main issue one might face is receiving ConnectionRefusedError when making a request too soon after another. If this is the case, we will retry up to max_retries. It is important to set delay_ms to a reasonable value. For example, my X5900 will hang for 0.8-1 second after the power-off command is sent.

Adding New Commands

If you are not familiar with Python at all, raise an issue with a request to add a new command. Otherwise, follow the documentation for the Command base class and be sure to look at the examples in the Commands class.