A package to control JVC projectors over IP
Project description
JVC Projector Remote Improved
This implements new features, improvements, and optimizations based on work in 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=60, 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 keywords and options:
Command: low_latency
Option: off
code: jvc.exec_command("low_latency, off")
Command: picture_mode
Option: 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
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 user presets for each mode for example
Gaming: user1, low latency on, HDR mode to HDR10, etc Film: user2, low latency off, HDR mode to Frame Adapt, etc
Then use the commands to switch between user 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,$mode
example: "anamorphic,off"
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
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
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
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
. 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
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for jvc_projector_remote_improved2-2.4.0.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | 5385cc5abb4ed0916de6f68fe475e0b09268891bd1daca28f78c9984cf30b7cb |
|
MD5 | d8a661032abf889dd1b42fbf734c32b6 |
|
BLAKE2b-256 | 43cf1a9f870ed42fb5819bdda3638da9303a854db2dc58a9bfe92c617a8ea3f4 |
Hashes for jvc_projector_remote_improved2-2.4.0-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | c895e70e695c2219764b2df94f0a8b0a9f8f74aabb5b36247ca63a0d3ebbd750 |
|
MD5 | 4866450fdc0ad3b7e88c83ae329151a3 |
|
BLAKE2b-256 | f46d452f333c1cd4d4a8e4f648b4d6f5bd3b276f91648e1e07c8009fb1cbb8e8 |