jvc-projector-remote-improved2 3.1.0

A package to control JVC projectors over IP

JVC Projector Remote Improved

This implements new features, improvements, and optimizations inspired by https://github.com/bezmi/jvc_projector. This was made with NZ models in mind. Almost every function will work with NX models but I do not guarantee operability for them.

This is designed to work with my Home Assistant plugin: https://github.com/iloveicedgreentea/jvc_homeassistant

Installation

# Assuming you have a venv with >=python3.10
pip install jvc-projector-remote-improved2

Quick Start

Set your network password if you have an NZ model first.

jvc = JVCProjector(host="ipaddr", connect_timeout=10, password="password")

# Commands are passed as a single string delimited by a comma
# Everything executes async in the background. Sync interfaces are provided
# open menu
cmd = jvc.exec_command("menu, menu")
# press left button
cmd = jvc.exec_command("menu, left")
# set picture mode to frame adapt HDR
cmd = jvc.exec_command("picture_mode, frame_adapt_hdr")
# turn on
cmd = jvc.power_on()

You can also use the async versions

async def test():
    jvc = JVCProjector(host=host, connect_timeout=10, password=password)
    jvc.async_exec_command("power,on")

if __name__ == "__main__":
    loop = asyncio.get_event_loop()
    loop.run_until_complete(test())

Usage

See quick-start for importing

The commands are structured to use simple command keywords and parameters. This makes it simple to remember commands. All names with spaces will have an underscore instead.

Command: low_latency
Parameter: off
code: jvc.exec_command("low_latency, off")

Command: picture_mode
Parameter: hdr_plus
code: jvc.exec_command("picture_mode, hdr_plus")

You can also run multiple commands in a row by just giving it a list of commands

jvc.exec_command(["picture_mode, hdr_plus", "motion_enhance, off"])

Use print_commands() to get all the latest support commands. This is dynamically generated at runtime so it is always up to date.

Currently Supported Commands

• Power on/off
• Lens Memory/Installation Modes
• Input HDMI 1 or 2
• Power and Low Latency Status
• Low Latency Mode on/off
• Menu and arrow buttons (Menu, LRUD, back)
• Masking
• Laser power low/med/high
• Laser Dimming off/auto1/auto2
• E-shift on/off
• Aperture off/auto1/auto2
• Anamorphic modes
• And many others

Gaming/Film Modes

I recommend setting up picture mode presets for each mode. Low latency toggle annoyingly will not work unless certain things are disabled first. It will not disable things for you.

SDR Gaming: user1||natural, low latency on, etc HDR Gaming: hdr10, low latency on, etc SDR Film: natural||user1, low latency off, laser mode 3, motion enhance high HDR Film: frame adapt HDR, low latency off, laser mode 3, hdr quantization to auto(wide)

Then use the commands to switch between picture modes.

Supported Models

• NZ7/NZ8/NZ9 (Network password is required)
• NX5/NX7/NX9
• Most likely any other D-ILA projector, and possibly older models with ethernet cables.

Home Assistant

# configuration.yaml
remote:
  - platform: jvc_projectors
    name: nz7
    password: password
    host: 192.168.1.2
    scan_interval: 30

Development

# Create venv
python3 -m venv .venv
source .venv/bin/activate

# Edit env
cp .env.template .env
# edit .env with values

Supported Commands

$command,$parameter example: "anamorphic,off" example: "anamorphic,d" example: "laser_dim,auto3"

Currently Supported Commands:
        anamorphic
        aperture
        enhance
        eshift
        graphic_mode
        input
        installation_mode
        laser_dim
        laser_power
        low_latency
        mask
        menu
        motion_enhance
        picture_mode
        power


Currently Supported Parameters:
AnamorphicModes
        off
        a
        b
        c
        d
ApertureModes
        off
        auto1
        auto2
EnhanceModes
        zero
        one
        two
        three
        four
        five
        six
        seven
        eight
        nine
        ten
EshiftModes
        off
        on
GraphicModeModes
        standard
        hires1
        hires2
InputModes
        hdmi1
        hdmi2
InstallationModes
        mode1
        mode2
        mode3
        mode4
        mode5
        mode6
        mode7
        mode8
        mode9
        mode10
LaserDimModes
        off
        auto1
        auto2
        auto3
LaserPowerModes
        low
        med
        high
LowLatencyModes
        off
        on
MaskModes
        on
        off
MenuModes
        menu
        up
        down
        back
        left
        right
        ok
MotionEnhanceModes
        off
        low
        high
PictureModes
        film
        cinema
        natural
        hdr
        THX
        frame_adapt_hdr
        frame_adapt_hdr2
        frame_adapt_hdr3
        filmmaker
        user1
        user2
        user3
        user4
        user5
        user6
        hlg
        hdr_plus
        pana_pq
PowerModes
        off
        on
PowerStates
        standby
        on
        cooling
        reserved
        emergency

Adding new commands

All commands are stored in Enums within commands.py so simply adding them to that file in the proper Enum will automatically propagate to code. Add them using this guide as a reference.

Testing

JVC_TEST_POWER: true/false to test power functions JVC_TEST_FUNCTIONS: true/false to test various button functions

You can run the test at the local device or run a mock server I made (WIP) to test commands

# Venv in one window
python mock/mochrie.py

# Run tests in other window
source .env
export JVC_HOST=127.0.0.1
make test