bscpylgtv

Name	bscpylgtv JSON
Version	0.4.6 JSON
	download
home_page	https://github.com/chros73/bscpylgtv
Summary	Library to control webOS based LG TV devices.
upload_time	2024-01-20 19:42:54
maintainer
docs_url	None
author	chros
requires_python	>=3.8
license
keywords	webos tv
VCS
bugtrack_url
requirements	No requirements were recorded.
Travis-CI	No Travis.
coveralls test coverage	No coveralls.

            # bscpylgtv
Library to control webOS based LG TV devices. Enhanced and faster version of
 [aiopylgtv](https://github.com/bendavid/aiopylgtv), it can be installed without calibration functionality,
 optimized for command line usage (it looks for the same `.aiopylgtv.sqlite` key config file).

## Requirements
- Python >= 3.8

### Install from package
```bash
# Install lite package without calibration functionality
pip install bscpylgtv
# Instal full package with calibration functionality (requires numpy package)
pip install bscpylgtv[with_calibration]
```

### Install from Source
Run the following command inside this folder:
```bash
# Install lite package without calibration functionality
pip install --upgrade .
# Instal full package with calibration functionality (requires numpy package)
pip install --upgrade .[with_calibration]
```

### Windows binaries
Portable Windows binaries can be found under [releases](https://github.com/chros73/bscpylgtv/releases), along with [First use](https://github.com/chros73/bscpylgtv/tree/master/docs/guides/first_use.md) guide.

## Examples
Available settings can be found in [docs](https://github.com/chros73/bscpylgtv/tree/master/docs) directory, also available [buttons](https://github.com/chros73/bscpylgtv/tree/master/bscpylgtv/buttons.py).
```bash
# Get list of apps (including hidden ones as well)
bscpylgtvcommand 192.168.1.18 get_apps_all true
# Push info button
bscpylgtvcommand 192.168.1.18 button INFO
# Switch to HDMI2 input
bscpylgtvcommand 192.168.1.18 set_input HDMI_2
# Get values of backlight and contrast of the current picture preset (using list)
bscpylgtvcommand 192.168.1.18 get_picture_settings "[\"backlight\", \"contrast\"]" true
# Swtich to SDR ISF Expert Dark picture preset
bscpylgtvcommand 192.168.1.18 set_current_picture_mode expert2
# Set values of backlight and contrast of the current picture preset (using JSON)
bscpylgtvcommand 192.168.1.18 set_current_picture_settings "{\"backlight\": 0, \"contrast\": 85}"
# Turn hdrDynamicToneMapping on in the current HDR10 picture preset (using JSON)
bscpylgtvcommand 192.168.1.18 set_current_picture_settings "{\"hdrDynamicToneMapping\": \"on\"}"
# Set colorGamut to "auto" in the current picture preset (using JSON)
bscpylgtvcommand 192.168.1.18 set_current_picture_settings "{\"colorGamut\": \"auto\"}"
# Set mpegNoiseReduction off in the current picture preset (using JSON)
bscpylgtvcommand 192.168.1.18 set_current_picture_settings "{\"mpegNoiseReduction\": \"off\"}"
# Turn AI Picture Pro on in the current picture preset (using JSON)
bscpylgtvcommand 192.168.1.18 set_current_picture_settings "{\"ai_Picture\": \"on\"}" aiPicture
# Setting EOTF in HDMI Signal Override menu, values: auto, sdrGamma, hdrGamma, st2084, hlg (using JSON)
bscpylgtvcommand 192.168.1.18 set_other_settings "{\"eotf\": \"hlg\"}"
# Turn PC Mode on/off for HDMI2
bscpylgtvcommand 192.168.1.18 set_device_info HDMI_2 pc PC
bscpylgtvcommand 192.168.1.18 set_device_info HDMI_2 hometheater "Home Theatre"
# Launch and close screensaver
bscpylgtvcommand 192.168.1.18 launch_app com.webos.app.screensaver
bscpylgtvcommand 192.168.1.18 close_app com.webos.app.screensaver
# Turn screen off/on: turn_screen_off [webos_version] (e.g. for older WebOS: turn_screen_off 4)
bscpylgtvcommand 192.168.1.18 turn_screen_off
bscpylgtvcommand 192.168.1.18 turn_screen_on
# Display current picture mode settings
bscpylgtvcommand 192.168.1.18 launch_app_with_params com.palm.app.settings "{\"target\": \"PictureMode\"}"
# Launch installation app hidden menu (Hotel Mode, Password change, USB Cloning, Set ID setup, IP Control)
bscpylgtvcommand 192.168.1.18 launch_app com.webos.app.installation
# Display 3x MUTE button hidden menu (AVReset, Customer Support, etc)
bscpylgtvcommand 192.168.1.18 launch_app_with_params com.webos.app.tvhotkey "{\"activateType\": \"mute-hidden-action\"}"
# Display 7x GREEN button hidden Freesync info
bscpylgtvcommand 192.168.1.18 launch_app_with_params com.webos.app.tvhotkey "{\"activateType\": \"freesync-info\"}"
# NOTE: this does not work anymore on some models since end of 2021. Launch hidden software updater on older firmwares
bscpylgtvcommand 192.168.1.18 launch_app com.webos.app.softwareupdate
# NOTE: this does not work anymore on some models since end of 2021. Launch hidden software updater on newer firmwares, useful to downgrade (using JSON)
bscpylgtvcommand 192.168.1.18 launch_app_with_params com.webos.app.softwareupdate "{\"mode\": \"user\", \"flagUpdate\": true}"
# Toggle TPC or GSR in In-Start Service Menu (on 2020 and newer models), values of algo: tpc, gsr
bscpylgtvcommand 192.168.1.18 enable_tpc_or_gsr tpc false
# Set White Balance in Ez-Adjust Service Menu (on 2020 and newer models), values of color_temp: cool, medium, warm
bscpylgtvcommand 192.168.1.18 set_sm_white_balance warm 192 169 111
# Launch In-Start Service Menu (code: 0413) (using JSON)
bscpylgtvcommand 192.168.1.18 launch_app_with_params com.webos.app.factorywin "{\"id\":\"executeFactory\", \"irKey\":\"inStart\"}"
# Launch Ez-Adjust Service Menu (code: 0413) (using JSON)
bscpylgtvcommand 192.168.1.18 launch_app_with_params com.webos.app.factorywin "{\"id\":\"executeFactory\", \"irKey\":\"ezAdjust\"}"
# Enable full Service Menu on newer models
bscpylgtvcommand 192.168.1.18 set_other_settings "{\"svcMenuFlag\": false}"
# Get config values of "tv.model" category (using list)
bscpylgtvcommand 192.168.1.18 get_configs "[\"tv.model.*\"]" true
# Activate "OLED Motion Pro" on C9 (using JSON)
bscpylgtvcommand 192.168.1.18 set_configs "{\"tv.model.motionProMode\": \"OLED Motion Pro\"}"
# Display Total Power On Time under TV Information on EU models where it's hidden (using JSON)
bscpylgtvcommand 192.168.1.18 set_configs "{\"tv.conti.supportUsedTime\": true}"
# Take screenshot
bscpylgtvcommand 192.168.1.18 take_screenshot
# Soft reboot the TV in case it is malfunctioning: reboot_soft [webos_version] (e.g. for older WebOS: reboot_soft 4)
bscpylgtvcommand 192.168.1.18 reboot_soft
# Turn the TV off (standby)
bscpylgtvcommand 192.168.1.18 power_off
```

### Optional command line switches

```bash
# -s "[\"<state1>\", "\<state2>\"]" : set states ("software_info" static state is required by some of the calibration commands)
#    values: ["system_info", "software_info", "power", "current_app", "muted", "volume", "apps", "inputs", "sound_output", "picture_settings"]
bscpylgtvcommand 192.168.1.18 upload_3d_lut_bt2020_from_file expert1 "test3d-2.cube" -s
bscpylgtvcommand -s "[\"software_info\"]" 192.168.1.18 upload_3d_lut_bt2020_from_file expert1 "test3d-2.cube"
# -c "{\"lut3d\": \"33pt\", \"dovi\": \"2019\"}" : set calibration_info for unsupported chip types (be careful!)
#    values for "lut3d": "17pt", "33pt"
#    values for "dovi": "2018", "2019"
bscpylgtvcommand -c "{\"lut3d\": \"33pt\", \"dovi\": \"2019\"}" 192.168.1.18 upload_3d_lut_bt2020_from_file expert1 "test3d-2.cube"
# -o : getting hello info (e.g. to get unique deviceUUID)
bscpylgtvcommand -o 192.168.1.18 get_hello_info true
# -w : connecting without SSL
bscpylgtvcommand -w 192.168.1.18 button INFO
# -k <client_key> : specifying a client key
bscpylgtvcommand -k ef6858b2133d68854612831e3df8e495 192.168.1.18 button INFO
# -p <path_to_key_file> : specifying path to key file
bscpylgtvcommand -p "D:\config\.aiopylgtv.sqlite" 192.168.1.18 button INFO
# -l : get list of all saved client keys per ip (otionally from a specified key file)
bscpylgtvcommand -l
bscpylgtvcommand -l -p "D:\config\.aiopylgtv.sqlite"
# -v : display version number
bscpylgtvcommand -v
```

## Basic Scripting Example

```python
import asyncio
from bscpylgtv import WebOsClient

async def runloop():
    client = await WebOsClient.create('192.168.1.18', ping_interval=None, states=[])
    await client.connect()
    apps = await client.get_apps_all()
    for app in apps:
        print(app)

    await client.disconnect()

asyncio.run(runloop())
```

### Subscribed State Updates Example

```python
import asyncio
from bscpylgtv import WebOsClient

async def on_state_change(client):
    print("State changed:")
    print(client.apps)
    print(client.inputs)
    print(client.power_state)
    print(client.current_appId)
    print(client.channels)
    print(client.current_channel)
    print(client.channel_info)
    print(client.muted)
    print(client.volume)
    print(client.sound_output)
    print(client.picture_settings)
    print(client.system_info)
    print(client.software_info)
    print(client.hello_info)

async def runloop():
    client = await WebOsClient.create('192.168.1.18', get_hello_info=True)
    await client.register_state_update_callback(on_state_change)
    await client.connect()

    ret = await client.volume_up()
    print(ret)
    await asyncio.sleep(30)

    await client.disconnect()

asyncio.run(runloop())
```

### Using external storage class via scripting

Replacing built-in `StorageSqliteDict` key storage with custom `StorageMy` class that implements [methods](https://github.com/chros73/bscpylgtv/tree/master/bscpylgtv/storage_proto.py) of `StorageProto` class:
```python
import asyncio
from bscpylgtv import WebOsClient
from storage_my import StorageMy

async def runloop():
    storage = await StorageMy.create("file_path")
    client = await WebOsClient.create('192.168.1.18', ping_interval=None, states=[], storage=storage)
    await client.connect()
    info = await client.get_software_info()
    print(info)

    await client.disconnect()

asyncio.run(runloop())
```

More useful examples can be found in [docs/scripts](https://github.com/chros73/bscpylgtv/tree/master/docs/scripts) directory.

## Calibration functionality (in full version)
**WARNING:** *Messing with the calibration data COULD brick your TV in some circumstances, requiring a mainboard replacement. All of the currently implemented functions SHOULD be safe (although they have only been extensively tested for the 2018 Alpha 7/9, 2019/2021/2022 Alpha 9 models), but no guarantees.*

On LG WebOS TVs with Alpha 7 and Alpha 9 chipsets, upload to internal 1D/3D LUTs, resetting factory calibration data uploaded via calibration API, uploading custom tone mapping parameters (>=2019 models), using internal test pattern generator (iTPG, >=2019 models), writing Dolby Vision config file and other calibration commands are supported.

### Calibration commands

Here is a simplified version of the [image processing pipeline](https://displaycalibrations.com/images/LG_OLED_Video_Signal_Chain_Diagram_Picture.png) (there may be other not fully known/understood changes).

Calibration commands can only be run while in calibration mode (controlled by `start_calibration` and `end_calibration`).
Some of the calibration commands aren't used (question mark behind the name of the method) depending on the model/firmware.
Most of the commands can be run in any mode, except for `set_tonemap_params` that is only for HDR10+HLG and `set_dolby_vision_config_data` that is only for Dolby Vision.
Only 3D LUT and Dolby Vision config related commands require `-s` (states) command line switch (or the use of `-c` (calibration_info) instead for unsuppported chip types if other calibration commands work fine, but be very careful!).
In general, `set_1d_en_*` (de-gamma, re-gamma) and `set_3by3_gamut_data_*` (3x3 color matrices) commands should only be used with unity/custom 3D LUT.

The following commands are supported via calibration API:
```
start_calibration, end_calibration,
set_oled_light, set_contrast, set_brightness, set_color
upload_1d_lut, upload_1d_lut_from_file, set_1d_lut_en (?),
upload_3d_lut_bt709, upload_3d_lut_bt709_from_file, upload_3d_lut_bt2020, upload_3d_lut_bt2020_from_file, 
set_1d_en_2_2, set_1d_en_0_45,
set_3by3_gamut_data_bt709, set_3by3_gamut_data_bt2020, set_3by3_gamut_data_hdr (only used in 2019 models), set_3by3_gamut_data_from_file, set_3by3_gamut_en (?),
set_tonemap_params (for HDR10 picture modes),
set_dolby_vision_config_data (not recommended on >=2020 models!)
```

Combined commands for setting bypass modes and resetting factory data:
```
set_bypass_modes_sdr, set_bypass_modes_hdr10, set_bypass_modes_dovi,
reset_factory_data_sdr, reset_factory_data_hdr10, reset_factory_data_dovi
```

Calibration data is specific to each picture mode, and picture modes are independent for SDR, HDR10+HLG, and Dolby Vision.
Picture modes from each of the three groups are only accessible when the TV is in the appropriate mode. Ie to upload calibration data for HDR10 picture modes, one has to send the TV an HDR10 signal or play an HDR10 file, and similarly for Dolby Vision.

Known supported `picture_mode` strings are:
```
SDR: cinema, expert1, expert2, game, technicolorExpert, filmMaker
HDR10(+HLG): hdr_cinema, hdr_game, hdr_technicolorExpert, hdr_filmMaker
DV: dolby_cinema_bright, dolby_cinema_dark, dolby_game
```

For SDR and HDR10 modes there are two 3D LUTs which will be automatically selected depending on the colorspace flags of the signal or content. In principle almost all SDR content should be BT709 and HDR10 content should be BT2020 but there could be nonstandard cases where this is not true.
For Dolby Vision the BT709 3D LUT seems to be active and the only one used.

The supported input formats for LUTs are IRIDAS `.cube` format for both 1D and 3D LUTs, and ArgyllCMS `.cal` files for 1D LUTs.
Models with Alpha 9 use 33 point 3D LUTs, while those with Alpha 7 use 17 points.

When uploading any 1D LUT data, service menu white balance settings are ignored, and gamma, colorspace, and white balance settings in the user menu are greyed out and inaccessible. From 2019 models white balance 2pt values can be set.
While in calibration mode for HDR10 tone mapping is bypassed.

#### Calibration examples

Modifying expert1 SDR preset (ISF Expert Bright Room):
```bash
# Switch to HDMI2 input
bscpylgtvcommand 192.168.1.18 set_input HDMI_2
# Start calibration mode
bscpylgtvcommand 192.168.1.18 start_calibration expert1
# Set oled light to 39, contrast to 85, brightness and color to 50
bscpylgtvcommand 192.168.1.18 set_oled_light 39
bscpylgtvcommand 192.168.1.18 set_contrast
bscpylgtvcommand 192.168.1.18 set_brightness
bscpylgtvcommand 192.168.1.18 set_color
# Set SDR bypass mode (also known as DDC reset) including uploading unity 1DLUT
bscpylgtvcommand 192.168.1.18 set_bypass_modes_sdr true -s
# Upload custom 1DLUT from file
bscpylgtvcommand 192.168.1.18 upload_1d_lut_from_file "test.cal"
# Upload custom 3DLUT from file into BT709 slot
bscpylgtvcommand 192.168.1.18 upload_3d_lut_bt709_from_file "test3d-1.cube" -s
# Upload custom 3DLUT from file into bt2020 slot
bscpylgtvcommand 192.168.1.18 upload_3d_lut_bt2020_from_file "test3d-2.cube" -s
# End calibration mode
bscpylgtvcommand 192.168.1.18 end_calibration
```

Same calibration session via scripting:
```python
import asyncio
from bscpylgtv import WebOsClient

async def runloop():
    client = await WebOsClient.create('192.168.1.18', states=["software_info"])
    await client.connect()

    await client.set_input("HDMI_2")
    await client.start_calibration(picture_mode="expert1")
    await client.set_oled_light(value=39)
    await client.set_contrast()
    await client.set_brightness()
    await client.set_color()
    await client.set_bypass_modes_sdr(unity_1d_lut=True)
    await client.upload_1d_lut_from_file(filename="test.cal")
    await client.upload_3d_lut_bt709_from_file(filename="test3d-1.cube")
    await client.upload_3d_lut_bt2020_from_file(filename="test3d-2.cube")
    await client.end_calibration()

    await client.disconnect()

asyncio.run(runloop())
```

#### Uploading bypass values (also known as DDC reset)

The following commands are supported via calibration API beside of the the combined `set_bypass_modes_*` commands:
```
upload_1d_lut,
upload_3d_lut_bt709, upload_3d_lut_bt2020,
set_1d_en_2_2, set_1d_en_0_45, set_1d_lut_en (?),
set_3by3_gamut_data_bt709, set_3by3_gamut_data_bt2020, set_3by3_gamut_data_hdr (only used in 2019 models), set_3by3_gamut_en (?),
```

Example usage (all the supported commands have the same syntax):
```bash
# Start calibration mode
bscpylgtvcommand 192.168.1.18 start_calibration hdr_game
# Upload unity 1DLUT (no extra parameter is required)
bscpylgtvcommand 192.168.1.18 upload_1d_lut
# End calibration mode
bscpylgtvcommand 192.168.1.18 end_calibration
```

#### Resetting factory calibration data uploaded via calibration API

It's possible to reset individual factory calibration data (previously a picture preset reset or factory reset was required for this)
or reset all/most of them with the combined `reset_factory_data_*` commands.
The following commands are supported via calibration API:
```
upload_1d_lut,
upload_3d_lut_bt709, upload_3d_lut_bt2020,
set_1d_en_2_2, set_1d_en_0_45, set_1d_lut_en (?),
set_3by3_gamut_data_bt709, set_3by3_gamut_data_bt2020, set_3by3_gamut_data_hdr (only used in 2019 models), set_3by3_gamut_en (?),
set_tonemap_params (for HDR10 picture modes),
set_dolby_vision_config_data (not recommended on >=2020 models!)
```

Example usage (all the supported commands have the same syntax except for those that require a `picture_mode`):
```bash
# Start calibration mode
bscpylgtvcommand 192.168.1.18 start_calibration hdr_game
# Restore factory 1DLUT after custom 1DLUT was uploaded (by specifying empty list)
bscpylgtvcommand 192.168.1.18 upload_1d_lut []
# Restore factory tonemapping parameters after custom ones were uploaded (by specifying empty list)
bscpylgtvcommand 192.168.1.18 set_tonemap_params hdr_game []
# End calibration mode
bscpylgtvcommand 192.168.1.18 end_calibration
```

#### Get calibration commands

- NOTE: they can be partially or completely broken (depending on firmware version, picture preset, etc)
- they can be used inside or outside of calibration mode as well
- they return the data of the currently active picture mode
- in case of factory LUTs (sometimes even with custom LUTs as well), they return the post-processed LUTs with all customizations factored in (including customizations via the user settings menu or service menu)

The following commands are supported via calibration API:
```
get_1d_en_2_2, get_1d_en_0_45,
get_3by3_gamut_data, get_3by3_gamut_data_hdr,
get_1d_lut, get_3d_lut
```

Example usage (all the supported commands have the same syntax):
```bash
# Get 3x3 color matrix (no extra parameter is required)
bscpylgtvcommand 192.168.1.18 get_3by3_gamut_data
```

##### Backup and restore 1D/3D LUTs and 3x3 color matrices

It's possible to backup and resture 1D/3D LUTs and 3x3 color matrices (if the getter interface of the calibration API works fine).

Example usage for backuping:
```bash
# Backup 3x3 color matrix
bscpylgtvcommand 192.168.1.18 get_3by3_gamut_data "hdr_cinema_3x3.matrix"
# Backup 1D LUT
bscpylgtvcommand 192.168.1.18 get_1d_lut "hdr_cinema.1dlut"
# Backup 3D LUT
bscpylgtvcommand 192.168.1.18 get_3d_lut "hdr_cinema.3dlut" -s
```

Example usage for restoring:
```bash
# Start calibration mode
bscpylgtvcommand 192.168.1.18 start_calibration hdr_cinema
# Restore 3x3 color matrix
bscpylgtvcommand 192.168.1.18 set_3by3_gamut_data_from_file "bt2020" "hdr_cinema_3x3.matrix"
# Restore 1D LUT
bscpylgtvcommand 192.168.1.18 upload_1d_lut_from_file "hdr_cinema.1dlut"
# Restore 3D LUT
bscpylgtvcommand 192.168.1.18 upload_3d_lut_bt2020_from_file "hdr_cinema.3dlut" -s
# End calibration mode
bscpylgtvcommand 192.168.1.18 end_calibration
```

##### Converting 1D LUT files to ArgyllCMS `cal` files and vica versa

It's also possible to convert 1D LUT files to ArgyllCMS `cal` files and vica versa. 
Note that the conversion is lossy due to rounding errors and misalignment of points in 1D LUT and I values in cal file.

Example usage for converting:
```bash
# Convert 1DLUT file to ArgyllCMS cal file
bscpylgtvcommand 192.168.1.18 convert_1dlut_to_cal "dovi_cinema.1dlut" "dovi_cinema.cal"
# Convert ArgyllCMS cal file to 1DLUT file
bscpylgtvcommand 192.168.1.18 convert_cal_to_1dlut "dovi_cinema.cal" "dovi_cinema.1dlut"
```

#### Uploading custom tonemapping parameters for HDR10 presets

- available only on supported models (>=2019)
- parameters (in this order): picture_mode, peak luminance, mastering_peak_1, rolloff_point_1, mastering_peak_2, rolloff_point_2, mastering_peak_3, rolloff_point_3 

```bash
# Start calibration mode
bscpylgtvcommand 192.168.1.18 start_calibration hdr_cinema
# Upload custom tonemapping parameters for HDR10 Cinema preset
bscpylgtvcommand 192.168.1.18 set_tonemap_params hdr_cinema 760 1000 75 4000 60 10000 50
# Or upload custom tonemapping parameters to disable internal tonemapping entirely
bscpylgtvcommand 192.168.1.18 set_tonemap_params hdr_cinema 760 1000 100 4000 100 10000 100
# End calibration mode
bscpylgtvcommand 192.168.1.18 end_calibration
```

### Writing Dolby Vision config file for USB upload

Copy the generated config `DolbyVision_UserDisplayConfiguration.txt` file into the root of a thumbdrive, plug it into the TV, then play a DoVi content (e.g. with a built-in app), the DoVi config update popup will appear.

Note: the DoVi config update popup is disabled via USB if any data (e.g. custom 1D LUT) is uploaded via the calibration API to a given DoVi preset. Either you have to update the config beforehand or reset the preset on the UI (or via calibration API), update DoVi config via USB, then upload the data (e.g. custom 1D LUT) again if necessary.

- picture modes: dolby_cinema_bright - 1 (DoVi Cinema Home), dolby_cinema_dark - 2 (DoVi Cinema), dolby_game - 4 (DoVi Game)
- primaries (in this order): xr, yr, xg, yg, xb, yb
- default value of black_level: 0.0001
- config of 2018 models is different from newer models (>=2019)

```bash
# Writing DoVi config for one preset (DoVi Cinema)
bscpylgtvcommand 192.168.1.18 write_dolby_vision_config_file "[{\"picture_mode\": \"dolby_cinema_dark\", \"white_level\": 750, \"primaries\": [0.6796, 0.3187, 0.2595, 0.6849, 0.1448, 0.0494]}]" -s
# Writing DoVi config for all the presets (DoVi Cinema Home, Cinema, Game) based on one set of data
bscpylgtvcommand 192.168.1.18 write_dolby_vision_config_file "[{\"white_level\": 750, \"primaries\": [0.6796, 0.3187, 0.2595, 0.6849, 0.1448, 0.0494]}]" true D:\temp -s
# Writing DoVi config for all the presets (DoVi Cinema Home, Cinema, Game) by specifying them separately
bscpylgtvcommand 192.168.1.18 write_dolby_vision_config_file "[{\"picture_mode\": \"dolby_cinema_bright\", \"white_level\": 710, \"primaries\": [0.6796, 0.3187, 0.2595, 0.6849, 0.1448, 0.0494]}, {\"picture_mode\": \"dolby_cinema_dark\", \"white_level\": 750, \"primaries\": [0.6796, 0.3187, 0.2595, 0.6849, 0.1448, 0.0494]}, {\"picture_mode\": \"dolby_game\", \"white_level\": 680, \"primaries\": [0.6796, 0.3187, 0.2595, 0.6849, 0.1448, 0.0494]}]" -s
```

### Using the internal Test Pattern Generator (iTPG)

- it can be used inside or outside of calibration mode as well
- it can be broken in many defferent ways in a given firmware version / picture mode / etc
- available only on supported (>=2019) models
- 2019 models require Full Range 10 bit values (0-1023) using HDR10, while >=2020 models Limited Range 10 bit values (64-940)
- all suported models require Full Range 10 bit values (0-1023) using DoVi
- more useful example can be found in [docs/scripts](https://github.com/chros73/bscpylgtv/tree/master/docs/scripts/lg-itpg-manual-measure-from-csv.py) directory.

```bash
# Set full screen black window in the background
bscpylgtvcommand 192.168.1.18 set_itpg_patch_window 0 0 0 0 3840 2160 0 0
# Set 5% window green patch on top of the background
bscpylgtvcommand 192.168.1.18 set_itpg_patch_window 0 1023 0 1
# Display the 2 set patches
bscpylgtvcommand 192.168.1.18 toggle_itpg true 2
# Disable the 2 set patches
bscpylgtvcommand 192.168.1.18 toggle_itpg false 0

# Or using "overlay" 5% window green patch on top of the content
bscpylgtvcommand 192.168.1.18 set_itpg_patch_window 0 1023 0 0
# Display the set patch
bscpylgtvcommand 192.168.1.18 toggle_itpg true 1
# Disable the set patch
bscpylgtvcommand 192.168.1.18 toggle_itpg false 0
```

Displaying gradation window:
```bash
# Set black to white gradation window for vertical type
bscpylgtvcommand 192.168.1.18 set_itpg_gradation_window 0 3 0 0 0 1 1 1
# Display vertical gradation bars
bscpylgtvcommand 192.168.1.18 toggle_itpg true 1 1
# Set black to white gradation window for horizontal type
bscpylgtvcommand 192.168.1.18 set_itpg_gradation_window 0 1 0 0 0 1 1 1
# Display horizontal gradation bars
bscpylgtvcommand 192.168.1.18 toggle_itpg true 1 2
# Display 2 colored vertical gradation bars at the same time
bscpylgtvcommand 192.168.1.18 set_itpg_gradation_window 0 3 610 520 230 1 1 1
bscpylgtvcommand 192.168.1.18 set_itpg_gradation_window 1 3 610 50 23 1 1 1
bscpylgtvcommand 192.168.1.18 toggle_itpg true 2 1
# Disable gradation window
bscpylgtvcommand 192.168.1.18 toggle_itpg false 0
```

### Calibration guides

A collection of calibration guides can be found under [docs directory](https://github.com/chros73/bscpylgtv/tree/master/docs/guides/).


## Development of `bscpylgtv`

### Adding available settings for newer models

A collection of useful commands and scripts are available under [docs/utils](https://github.com/chros73/bscpylgtv/tree/master/docs/utils) directory to add support for new firmwares in the future and make PRs easier to do.

### Adding new chip type

Only 3D LUT and Dolby Vision config related calibration commands require chip type to be present to work properly, utilising `calibration_support_info` method.
The `model_name` field of the response of `get_software_info` method contains the chip type:
```bash
bscpylgtvcommand 192.168.1.18 get_software_info true
```

### Unit testing

Required extra packages:
```bash
pip install numpy pytest pytest-asyncio pytest-mock
```

Running unit tests against the installed package:
```bash
# Run all the tests in all files in tests/ directory
pytest tests
# Run all the tests in one file
pytest tests/test_webos_client_lite.py
# Run a specific test in one file
pytest tests/test_webos_client_calibration.py -k test_set_ui_data_methods
```


## Forum

Forum [topic](https://forum.doom9.org/showthread.php?t=175007).


## Acknowledgement

Thanks to the following people:
- [TheRealLink](https://github.com/TheRealLink/pylgtv) for the original implementation
- [bendavid](https://github.com/bendavid/aiopylgtv) for lot of modification, especially with calibration functionality
- [Maassoft](https://github.com/Maassoft/ColorControl) for useful ideas
- Hifi4Vision for his invaluable calibration knowledge




            

Raw data

            {
    "_id": null,
    "home_page": "https://github.com/chros73/bscpylgtv",
    "name": "bscpylgtv",
    "maintainer": "",
    "docs_url": null,
    "requires_python": ">=3.8",
    "maintainer_email": "",
    "keywords": "webos,tv",
    "author": "chros",
    "author_email": "chros73@gmail.com",
    "download_url": "https://files.pythonhosted.org/packages/db/64/de08019a537807cd8c88066f8c1f49d9d12edf24e5f17312c03d6f967907/bscpylgtv-0.4.6.tar.gz",
    "platform": null,
    "description": "# bscpylgtv\nLibrary to control webOS based LG TV devices. Enhanced and faster version of\n [aiopylgtv](https://github.com/bendavid/aiopylgtv), it can be installed without calibration functionality,\n optimized for command line usage (it looks for the same `.aiopylgtv.sqlite` key config file).\n\n## Requirements\n- Python >= 3.8\n\n### Install from package\n```bash\n# Install lite package without calibration functionality\npip install bscpylgtv\n# Instal full package with calibration functionality (requires numpy package)\npip install bscpylgtv[with_calibration]\n```\n\n### Install from Source\nRun the following command inside this folder:\n```bash\n# Install lite package without calibration functionality\npip install --upgrade .\n# Instal full package with calibration functionality (requires numpy package)\npip install --upgrade .[with_calibration]\n```\n\n### Windows binaries\nPortable Windows binaries can be found under [releases](https://github.com/chros73/bscpylgtv/releases), along with [First use](https://github.com/chros73/bscpylgtv/tree/master/docs/guides/first_use.md) guide.\n\n## Examples\nAvailable settings can be found in [docs](https://github.com/chros73/bscpylgtv/tree/master/docs) directory, also available [buttons](https://github.com/chros73/bscpylgtv/tree/master/bscpylgtv/buttons.py).\n```bash\n# Get list of apps (including hidden ones as well)\nbscpylgtvcommand 192.168.1.18 get_apps_all true\n# Push info button\nbscpylgtvcommand 192.168.1.18 button INFO\n# Switch to HDMI2 input\nbscpylgtvcommand 192.168.1.18 set_input HDMI_2\n# Get values of backlight and contrast of the current picture preset (using list)\nbscpylgtvcommand 192.168.1.18 get_picture_settings \"[\\\"backlight\\\", \\\"contrast\\\"]\" true\n# Swtich to SDR ISF Expert Dark picture preset\nbscpylgtvcommand 192.168.1.18 set_current_picture_mode expert2\n# Set values of backlight and contrast of the current picture preset (using JSON)\nbscpylgtvcommand 192.168.1.18 set_current_picture_settings \"{\\\"backlight\\\": 0, \\\"contrast\\\": 85}\"\n# Turn hdrDynamicToneMapping on in the current HDR10 picture preset (using JSON)\nbscpylgtvcommand 192.168.1.18 set_current_picture_settings \"{\\\"hdrDynamicToneMapping\\\": \\\"on\\\"}\"\n# Set colorGamut to \"auto\" in the current picture preset (using JSON)\nbscpylgtvcommand 192.168.1.18 set_current_picture_settings \"{\\\"colorGamut\\\": \\\"auto\\\"}\"\n# Set mpegNoiseReduction off in the current picture preset (using JSON)\nbscpylgtvcommand 192.168.1.18 set_current_picture_settings \"{\\\"mpegNoiseReduction\\\": \\\"off\\\"}\"\n# Turn AI Picture Pro on in the current picture preset (using JSON)\nbscpylgtvcommand 192.168.1.18 set_current_picture_settings \"{\\\"ai_Picture\\\": \\\"on\\\"}\" aiPicture\n# Setting EOTF in HDMI Signal Override menu, values: auto, sdrGamma, hdrGamma, st2084, hlg (using JSON)\nbscpylgtvcommand 192.168.1.18 set_other_settings \"{\\\"eotf\\\": \\\"hlg\\\"}\"\n# Turn PC Mode on/off for HDMI2\nbscpylgtvcommand 192.168.1.18 set_device_info HDMI_2 pc PC\nbscpylgtvcommand 192.168.1.18 set_device_info HDMI_2 hometheater \"Home Theatre\"\n# Launch and close screensaver\nbscpylgtvcommand 192.168.1.18 launch_app com.webos.app.screensaver\nbscpylgtvcommand 192.168.1.18 close_app com.webos.app.screensaver\n# Turn screen off/on: turn_screen_off [webos_version] (e.g. for older WebOS: turn_screen_off 4)\nbscpylgtvcommand 192.168.1.18 turn_screen_off\nbscpylgtvcommand 192.168.1.18 turn_screen_on\n# Display current picture mode settings\nbscpylgtvcommand 192.168.1.18 launch_app_with_params com.palm.app.settings \"{\\\"target\\\": \\\"PictureMode\\\"}\"\n# Launch installation app hidden menu (Hotel Mode, Password change, USB Cloning, Set ID setup, IP Control)\nbscpylgtvcommand 192.168.1.18 launch_app com.webos.app.installation\n# Display 3x MUTE button hidden menu (AVReset, Customer Support, etc)\nbscpylgtvcommand 192.168.1.18 launch_app_with_params com.webos.app.tvhotkey \"{\\\"activateType\\\": \\\"mute-hidden-action\\\"}\"\n# Display 7x GREEN button hidden Freesync info\nbscpylgtvcommand 192.168.1.18 launch_app_with_params com.webos.app.tvhotkey \"{\\\"activateType\\\": \\\"freesync-info\\\"}\"\n# NOTE: this does not work anymore on some models since end of 2021. Launch hidden software updater on older firmwares\nbscpylgtvcommand 192.168.1.18 launch_app com.webos.app.softwareupdate\n# NOTE: this does not work anymore on some models since end of 2021. Launch hidden software updater on newer firmwares, useful to downgrade (using JSON)\nbscpylgtvcommand 192.168.1.18 launch_app_with_params com.webos.app.softwareupdate \"{\\\"mode\\\": \\\"user\\\", \\\"flagUpdate\\\": true}\"\n# Toggle TPC or GSR in In-Start Service Menu (on 2020 and newer models), values of algo: tpc, gsr\nbscpylgtvcommand 192.168.1.18 enable_tpc_or_gsr tpc false\n# Set White Balance in Ez-Adjust Service Menu (on 2020 and newer models), values of color_temp: cool, medium, warm\nbscpylgtvcommand 192.168.1.18 set_sm_white_balance warm 192 169 111\n# Launch In-Start Service Menu (code: 0413) (using JSON)\nbscpylgtvcommand 192.168.1.18 launch_app_with_params com.webos.app.factorywin \"{\\\"id\\\":\\\"executeFactory\\\", \\\"irKey\\\":\\\"inStart\\\"}\"\n# Launch Ez-Adjust Service Menu (code: 0413) (using JSON)\nbscpylgtvcommand 192.168.1.18 launch_app_with_params com.webos.app.factorywin \"{\\\"id\\\":\\\"executeFactory\\\", \\\"irKey\\\":\\\"ezAdjust\\\"}\"\n# Enable full Service Menu on newer models\nbscpylgtvcommand 192.168.1.18 set_other_settings \"{\\\"svcMenuFlag\\\": false}\"\n# Get config values of \"tv.model\" category (using list)\nbscpylgtvcommand 192.168.1.18 get_configs \"[\\\"tv.model.*\\\"]\" true\n# Activate \"OLED Motion Pro\" on C9 (using JSON)\nbscpylgtvcommand 192.168.1.18 set_configs \"{\\\"tv.model.motionProMode\\\": \\\"OLED Motion Pro\\\"}\"\n# Display Total Power On Time under TV Information on EU models where it's hidden (using JSON)\nbscpylgtvcommand 192.168.1.18 set_configs \"{\\\"tv.conti.supportUsedTime\\\": true}\"\n# Take screenshot\nbscpylgtvcommand 192.168.1.18 take_screenshot\n# Soft reboot the TV in case it is malfunctioning: reboot_soft [webos_version] (e.g. for older WebOS: reboot_soft 4)\nbscpylgtvcommand 192.168.1.18 reboot_soft\n# Turn the TV off (standby)\nbscpylgtvcommand 192.168.1.18 power_off\n```\n\n### Optional command line switches\n\n```bash\n# -s \"[\\\"<state1>\\\", \"\\<state2>\\\"]\" : set states (\"software_info\" static state is required by some of the calibration commands)\n#    values: [\"system_info\", \"software_info\", \"power\", \"current_app\", \"muted\", \"volume\", \"apps\", \"inputs\", \"sound_output\", \"picture_settings\"]\nbscpylgtvcommand 192.168.1.18 upload_3d_lut_bt2020_from_file expert1 \"test3d-2.cube\" -s\nbscpylgtvcommand -s \"[\\\"software_info\\\"]\" 192.168.1.18 upload_3d_lut_bt2020_from_file expert1 \"test3d-2.cube\"\n# -c \"{\\\"lut3d\\\": \\\"33pt\\\", \\\"dovi\\\": \\\"2019\\\"}\" : set calibration_info for unsupported chip types (be careful!)\n#    values for \"lut3d\": \"17pt\", \"33pt\"\n#    values for \"dovi\": \"2018\", \"2019\"\nbscpylgtvcommand -c \"{\\\"lut3d\\\": \\\"33pt\\\", \\\"dovi\\\": \\\"2019\\\"}\" 192.168.1.18 upload_3d_lut_bt2020_from_file expert1 \"test3d-2.cube\"\n# -o : getting hello info (e.g. to get unique deviceUUID)\nbscpylgtvcommand -o 192.168.1.18 get_hello_info true\n# -w : connecting without SSL\nbscpylgtvcommand -w 192.168.1.18 button INFO\n# -k <client_key> : specifying a client key\nbscpylgtvcommand -k ef6858b2133d68854612831e3df8e495 192.168.1.18 button INFO\n# -p <path_to_key_file> : specifying path to key file\nbscpylgtvcommand -p \"D:\\config\\.aiopylgtv.sqlite\" 192.168.1.18 button INFO\n# -l : get list of all saved client keys per ip (otionally from a specified key file)\nbscpylgtvcommand -l\nbscpylgtvcommand -l -p \"D:\\config\\.aiopylgtv.sqlite\"\n# -v : display version number\nbscpylgtvcommand -v\n```\n\n## Basic Scripting Example\n\n```python\nimport asyncio\nfrom bscpylgtv import WebOsClient\n\nasync def runloop():\n    client = await WebOsClient.create('192.168.1.18', ping_interval=None, states=[])\n    await client.connect()\n    apps = await client.get_apps_all()\n    for app in apps:\n        print(app)\n\n    await client.disconnect()\n\nasyncio.run(runloop())\n```\n\n### Subscribed State Updates Example\n\n```python\nimport asyncio\nfrom bscpylgtv import WebOsClient\n\nasync def on_state_change(client):\n    print(\"State changed:\")\n    print(client.apps)\n    print(client.inputs)\n    print(client.power_state)\n    print(client.current_appId)\n    print(client.channels)\n    print(client.current_channel)\n    print(client.channel_info)\n    print(client.muted)\n    print(client.volume)\n    print(client.sound_output)\n    print(client.picture_settings)\n    print(client.system_info)\n    print(client.software_info)\n    print(client.hello_info)\n\nasync def runloop():\n    client = await WebOsClient.create('192.168.1.18', get_hello_info=True)\n    await client.register_state_update_callback(on_state_change)\n    await client.connect()\n\n    ret = await client.volume_up()\n    print(ret)\n    await asyncio.sleep(30)\n\n    await client.disconnect()\n\nasyncio.run(runloop())\n```\n\n### Using external storage class via scripting\n\nReplacing built-in `StorageSqliteDict` key storage with custom `StorageMy` class that implements [methods](https://github.com/chros73/bscpylgtv/tree/master/bscpylgtv/storage_proto.py) of `StorageProto` class:\n```python\nimport asyncio\nfrom bscpylgtv import WebOsClient\nfrom storage_my import StorageMy\n\nasync def runloop():\n    storage = await StorageMy.create(\"file_path\")\n    client = await WebOsClient.create('192.168.1.18', ping_interval=None, states=[], storage=storage)\n    await client.connect()\n    info = await client.get_software_info()\n    print(info)\n\n    await client.disconnect()\n\nasyncio.run(runloop())\n```\n\nMore useful examples can be found in [docs/scripts](https://github.com/chros73/bscpylgtv/tree/master/docs/scripts) directory.\n\n## Calibration functionality (in full version)\n**WARNING:** *Messing with the calibration data COULD brick your TV in some circumstances, requiring a mainboard replacement. All of the currently implemented functions SHOULD be safe (although they have only been extensively tested for the 2018 Alpha 7/9, 2019/2021/2022 Alpha 9 models), but no guarantees.*\n\nOn LG WebOS TVs with Alpha 7 and Alpha 9 chipsets, upload to internal 1D/3D LUTs, resetting factory calibration data uploaded via calibration API, uploading custom tone mapping parameters (>=2019 models), using internal test pattern generator (iTPG, >=2019 models), writing Dolby Vision config file and other calibration commands are supported.\n\n### Calibration commands\n\nHere is a simplified version of the [image processing pipeline](https://displaycalibrations.com/images/LG_OLED_Video_Signal_Chain_Diagram_Picture.png) (there may be other not fully known/understood changes).\n\nCalibration commands can only be run while in calibration mode (controlled by `start_calibration` and `end_calibration`).\nSome of the calibration commands aren't used (question mark behind the name of the method) depending on the model/firmware.\nMost of the commands can be run in any mode, except for `set_tonemap_params` that is only for HDR10+HLG and `set_dolby_vision_config_data` that is only for Dolby Vision.\nOnly 3D LUT and Dolby Vision config related commands require `-s` (states) command line switch (or the use of `-c` (calibration_info) instead for unsuppported chip types if other calibration commands work fine, but be very careful!).\nIn general, `set_1d_en_*` (de-gamma, re-gamma) and `set_3by3_gamut_data_*` (3x3 color matrices) commands should only be used with unity/custom 3D LUT.\n\nThe following commands are supported via calibration API:\n```\nstart_calibration, end_calibration,\nset_oled_light, set_contrast, set_brightness, set_color\nupload_1d_lut, upload_1d_lut_from_file, set_1d_lut_en (?),\nupload_3d_lut_bt709, upload_3d_lut_bt709_from_file, upload_3d_lut_bt2020, upload_3d_lut_bt2020_from_file, \nset_1d_en_2_2, set_1d_en_0_45,\nset_3by3_gamut_data_bt709, set_3by3_gamut_data_bt2020, set_3by3_gamut_data_hdr (only used in 2019 models), set_3by3_gamut_data_from_file, set_3by3_gamut_en (?),\nset_tonemap_params (for HDR10 picture modes),\nset_dolby_vision_config_data (not recommended on >=2020 models!)\n```\n\nCombined commands for setting bypass modes and resetting factory data:\n```\nset_bypass_modes_sdr, set_bypass_modes_hdr10, set_bypass_modes_dovi,\nreset_factory_data_sdr, reset_factory_data_hdr10, reset_factory_data_dovi\n```\n\nCalibration data is specific to each picture mode, and picture modes are independent for SDR, HDR10+HLG, and Dolby Vision.\nPicture modes from each of the three groups are only accessible when the TV is in the appropriate mode. Ie to upload calibration data for HDR10 picture modes, one has to send the TV an HDR10 signal or play an HDR10 file, and similarly for Dolby Vision.\n\nKnown supported `picture_mode` strings are:\n```\nSDR: cinema, expert1, expert2, game, technicolorExpert, filmMaker\nHDR10(+HLG): hdr_cinema, hdr_game, hdr_technicolorExpert, hdr_filmMaker\nDV: dolby_cinema_bright, dolby_cinema_dark, dolby_game\n```\n\nFor SDR and HDR10 modes there are two 3D LUTs which will be automatically selected depending on the colorspace flags of the signal or content. In principle almost all SDR content should be BT709 and HDR10 content should be BT2020 but there could be nonstandard cases where this is not true.\nFor Dolby Vision the BT709 3D LUT seems to be active and the only one used.\n\nThe supported input formats for LUTs are IRIDAS `.cube` format for both 1D and 3D LUTs, and ArgyllCMS `.cal` files for 1D LUTs.\nModels with Alpha 9 use 33 point 3D LUTs, while those with Alpha 7 use 17 points.\n\nWhen uploading any 1D LUT data, service menu white balance settings are ignored, and gamma, colorspace, and white balance settings in the user menu are greyed out and inaccessible. From 2019 models white balance 2pt values can be set.\nWhile in calibration mode for HDR10 tone mapping is bypassed.\n\n#### Calibration examples\n\nModifying expert1 SDR preset (ISF Expert Bright Room):\n```bash\n# Switch to HDMI2 input\nbscpylgtvcommand 192.168.1.18 set_input HDMI_2\n# Start calibration mode\nbscpylgtvcommand 192.168.1.18 start_calibration expert1\n# Set oled light to 39, contrast to 85, brightness and color to 50\nbscpylgtvcommand 192.168.1.18 set_oled_light 39\nbscpylgtvcommand 192.168.1.18 set_contrast\nbscpylgtvcommand 192.168.1.18 set_brightness\nbscpylgtvcommand 192.168.1.18 set_color\n# Set SDR bypass mode (also known as DDC reset) including uploading unity 1DLUT\nbscpylgtvcommand 192.168.1.18 set_bypass_modes_sdr true -s\n# Upload custom 1DLUT from file\nbscpylgtvcommand 192.168.1.18 upload_1d_lut_from_file \"test.cal\"\n# Upload custom 3DLUT from file into BT709 slot\nbscpylgtvcommand 192.168.1.18 upload_3d_lut_bt709_from_file \"test3d-1.cube\" -s\n# Upload custom 3DLUT from file into bt2020 slot\nbscpylgtvcommand 192.168.1.18 upload_3d_lut_bt2020_from_file \"test3d-2.cube\" -s\n# End calibration mode\nbscpylgtvcommand 192.168.1.18 end_calibration\n```\n\nSame calibration session via scripting:\n```python\nimport asyncio\nfrom bscpylgtv import WebOsClient\n\nasync def runloop():\n    client = await WebOsClient.create('192.168.1.18', states=[\"software_info\"])\n    await client.connect()\n\n    await client.set_input(\"HDMI_2\")\n    await client.start_calibration(picture_mode=\"expert1\")\n    await client.set_oled_light(value=39)\n    await client.set_contrast()\n    await client.set_brightness()\n    await client.set_color()\n    await client.set_bypass_modes_sdr(unity_1d_lut=True)\n    await client.upload_1d_lut_from_file(filename=\"test.cal\")\n    await client.upload_3d_lut_bt709_from_file(filename=\"test3d-1.cube\")\n    await client.upload_3d_lut_bt2020_from_file(filename=\"test3d-2.cube\")\n    await client.end_calibration()\n\n    await client.disconnect()\n\nasyncio.run(runloop())\n```\n\n#### Uploading bypass values (also known as DDC reset)\n\nThe following commands are supported via calibration API beside of the the combined `set_bypass_modes_*` commands:\n```\nupload_1d_lut,\nupload_3d_lut_bt709, upload_3d_lut_bt2020,\nset_1d_en_2_2, set_1d_en_0_45, set_1d_lut_en (?),\nset_3by3_gamut_data_bt709, set_3by3_gamut_data_bt2020, set_3by3_gamut_data_hdr (only used in 2019 models), set_3by3_gamut_en (?),\n```\n\nExample usage (all the supported commands have the same syntax):\n```bash\n# Start calibration mode\nbscpylgtvcommand 192.168.1.18 start_calibration hdr_game\n# Upload unity 1DLUT (no extra parameter is required)\nbscpylgtvcommand 192.168.1.18 upload_1d_lut\n# End calibration mode\nbscpylgtvcommand 192.168.1.18 end_calibration\n```\n\n#### Resetting factory calibration data uploaded via calibration API\n\nIt's possible to reset individual factory calibration data (previously a picture preset reset or factory reset was required for this)\nor reset all/most of them with the combined `reset_factory_data_*` commands.\nThe following commands are supported via calibration API:\n```\nupload_1d_lut,\nupload_3d_lut_bt709, upload_3d_lut_bt2020,\nset_1d_en_2_2, set_1d_en_0_45, set_1d_lut_en (?),\nset_3by3_gamut_data_bt709, set_3by3_gamut_data_bt2020, set_3by3_gamut_data_hdr (only used in 2019 models), set_3by3_gamut_en (?),\nset_tonemap_params (for HDR10 picture modes),\nset_dolby_vision_config_data (not recommended on >=2020 models!)\n```\n\nExample usage (all the supported commands have the same syntax except for those that require a `picture_mode`):\n```bash\n# Start calibration mode\nbscpylgtvcommand 192.168.1.18 start_calibration hdr_game\n# Restore factory 1DLUT after custom 1DLUT was uploaded (by specifying empty list)\nbscpylgtvcommand 192.168.1.18 upload_1d_lut []\n# Restore factory tonemapping parameters after custom ones were uploaded (by specifying empty list)\nbscpylgtvcommand 192.168.1.18 set_tonemap_params hdr_game []\n# End calibration mode\nbscpylgtvcommand 192.168.1.18 end_calibration\n```\n\n#### Get calibration commands\n\n- NOTE: they can be partially or completely broken (depending on firmware version, picture preset, etc)\n- they can be used inside or outside of calibration mode as well\n- they return the data of the currently active picture mode\n- in case of factory LUTs (sometimes even with custom LUTs as well), they return the post-processed LUTs with all customizations factored in (including customizations via the user settings menu or service menu)\n\nThe following commands are supported via calibration API:\n```\nget_1d_en_2_2, get_1d_en_0_45,\nget_3by3_gamut_data, get_3by3_gamut_data_hdr,\nget_1d_lut, get_3d_lut\n```\n\nExample usage (all the supported commands have the same syntax):\n```bash\n# Get 3x3 color matrix (no extra parameter is required)\nbscpylgtvcommand 192.168.1.18 get_3by3_gamut_data\n```\n\n##### Backup and restore 1D/3D LUTs and 3x3 color matrices\n\nIt's possible to backup and resture 1D/3D LUTs and 3x3 color matrices (if the getter interface of the calibration API works fine).\n\nExample usage for backuping:\n```bash\n# Backup 3x3 color matrix\nbscpylgtvcommand 192.168.1.18 get_3by3_gamut_data \"hdr_cinema_3x3.matrix\"\n# Backup 1D LUT\nbscpylgtvcommand 192.168.1.18 get_1d_lut \"hdr_cinema.1dlut\"\n# Backup 3D LUT\nbscpylgtvcommand 192.168.1.18 get_3d_lut \"hdr_cinema.3dlut\" -s\n```\n\nExample usage for restoring:\n```bash\n# Start calibration mode\nbscpylgtvcommand 192.168.1.18 start_calibration hdr_cinema\n# Restore 3x3 color matrix\nbscpylgtvcommand 192.168.1.18 set_3by3_gamut_data_from_file \"bt2020\" \"hdr_cinema_3x3.matrix\"\n# Restore 1D LUT\nbscpylgtvcommand 192.168.1.18 upload_1d_lut_from_file \"hdr_cinema.1dlut\"\n# Restore 3D LUT\nbscpylgtvcommand 192.168.1.18 upload_3d_lut_bt2020_from_file \"hdr_cinema.3dlut\" -s\n# End calibration mode\nbscpylgtvcommand 192.168.1.18 end_calibration\n```\n\n##### Converting 1D LUT files to ArgyllCMS `cal` files and vica versa\n\nIt's also possible to convert 1D LUT files to ArgyllCMS `cal` files and vica versa. \nNote that the conversion is lossy due to rounding errors and misalignment of points in 1D LUT and I values in cal file.\n\nExample usage for converting:\n```bash\n# Convert 1DLUT file to ArgyllCMS cal file\nbscpylgtvcommand 192.168.1.18 convert_1dlut_to_cal \"dovi_cinema.1dlut\" \"dovi_cinema.cal\"\n# Convert ArgyllCMS cal file to 1DLUT file\nbscpylgtvcommand 192.168.1.18 convert_cal_to_1dlut \"dovi_cinema.cal\" \"dovi_cinema.1dlut\"\n```\n\n#### Uploading custom tonemapping parameters for HDR10 presets\n\n- available only on supported models (>=2019)\n- parameters (in this order): picture_mode, peak luminance, mastering_peak_1, rolloff_point_1, mastering_peak_2, rolloff_point_2, mastering_peak_3, rolloff_point_3 \n\n```bash\n# Start calibration mode\nbscpylgtvcommand 192.168.1.18 start_calibration hdr_cinema\n# Upload custom tonemapping parameters for HDR10 Cinema preset\nbscpylgtvcommand 192.168.1.18 set_tonemap_params hdr_cinema 760 1000 75 4000 60 10000 50\n# Or upload custom tonemapping parameters to disable internal tonemapping entirely\nbscpylgtvcommand 192.168.1.18 set_tonemap_params hdr_cinema 760 1000 100 4000 100 10000 100\n# End calibration mode\nbscpylgtvcommand 192.168.1.18 end_calibration\n```\n\n### Writing Dolby Vision config file for USB upload\n\nCopy the generated config `DolbyVision_UserDisplayConfiguration.txt` file into the root of a thumbdrive, plug it into the TV, then play a DoVi content (e.g. with a built-in app), the DoVi config update popup will appear.\n\nNote: the DoVi config update popup is disabled via USB if any data (e.g. custom 1D LUT) is uploaded via the calibration API to a given DoVi preset. Either you have to update the config beforehand or reset the preset on the UI (or via calibration API), update DoVi config via USB, then upload the data (e.g. custom 1D LUT) again if necessary.\n\n- picture modes: dolby_cinema_bright - 1 (DoVi Cinema Home), dolby_cinema_dark - 2 (DoVi Cinema), dolby_game - 4 (DoVi Game)\n- primaries (in this order): xr, yr, xg, yg, xb, yb\n- default value of black_level: 0.0001\n- config of 2018 models is different from newer models (>=2019)\n\n```bash\n# Writing DoVi config for one preset (DoVi Cinema)\nbscpylgtvcommand 192.168.1.18 write_dolby_vision_config_file \"[{\\\"picture_mode\\\": \\\"dolby_cinema_dark\\\", \\\"white_level\\\": 750, \\\"primaries\\\": [0.6796, 0.3187, 0.2595, 0.6849, 0.1448, 0.0494]}]\" -s\n# Writing DoVi config for all the presets (DoVi Cinema Home, Cinema, Game) based on one set of data\nbscpylgtvcommand 192.168.1.18 write_dolby_vision_config_file \"[{\\\"white_level\\\": 750, \\\"primaries\\\": [0.6796, 0.3187, 0.2595, 0.6849, 0.1448, 0.0494]}]\" true D:\\temp -s\n# Writing DoVi config for all the presets (DoVi Cinema Home, Cinema, Game) by specifying them separately\nbscpylgtvcommand 192.168.1.18 write_dolby_vision_config_file \"[{\\\"picture_mode\\\": \\\"dolby_cinema_bright\\\", \\\"white_level\\\": 710, \\\"primaries\\\": [0.6796, 0.3187, 0.2595, 0.6849, 0.1448, 0.0494]}, {\\\"picture_mode\\\": \\\"dolby_cinema_dark\\\", \\\"white_level\\\": 750, \\\"primaries\\\": [0.6796, 0.3187, 0.2595, 0.6849, 0.1448, 0.0494]}, {\\\"picture_mode\\\": \\\"dolby_game\\\", \\\"white_level\\\": 680, \\\"primaries\\\": [0.6796, 0.3187, 0.2595, 0.6849, 0.1448, 0.0494]}]\" -s\n```\n\n### Using the internal Test Pattern Generator (iTPG)\n\n- it can be used inside or outside of calibration mode as well\n- it can be broken in many defferent ways in a given firmware version / picture mode / etc\n- available only on supported (>=2019) models\n- 2019 models require Full Range 10 bit values (0-1023) using HDR10, while >=2020 models Limited Range 10 bit values (64-940)\n- all suported models require Full Range 10 bit values (0-1023) using DoVi\n- more useful example can be found in [docs/scripts](https://github.com/chros73/bscpylgtv/tree/master/docs/scripts/lg-itpg-manual-measure-from-csv.py) directory.\n\n```bash\n# Set full screen black window in the background\nbscpylgtvcommand 192.168.1.18 set_itpg_patch_window 0 0 0 0 3840 2160 0 0\n# Set 5% window green patch on top of the background\nbscpylgtvcommand 192.168.1.18 set_itpg_patch_window 0 1023 0 1\n# Display the 2 set patches\nbscpylgtvcommand 192.168.1.18 toggle_itpg true 2\n# Disable the 2 set patches\nbscpylgtvcommand 192.168.1.18 toggle_itpg false 0\n\n# Or using \"overlay\" 5% window green patch on top of the content\nbscpylgtvcommand 192.168.1.18 set_itpg_patch_window 0 1023 0 0\n# Display the set patch\nbscpylgtvcommand 192.168.1.18 toggle_itpg true 1\n# Disable the set patch\nbscpylgtvcommand 192.168.1.18 toggle_itpg false 0\n```\n\nDisplaying gradation window:\n```bash\n# Set black to white gradation window for vertical type\nbscpylgtvcommand 192.168.1.18 set_itpg_gradation_window 0 3 0 0 0 1 1 1\n# Display vertical gradation bars\nbscpylgtvcommand 192.168.1.18 toggle_itpg true 1 1\n# Set black to white gradation window for horizontal type\nbscpylgtvcommand 192.168.1.18 set_itpg_gradation_window 0 1 0 0 0 1 1 1\n# Display horizontal gradation bars\nbscpylgtvcommand 192.168.1.18 toggle_itpg true 1 2\n# Display 2 colored vertical gradation bars at the same time\nbscpylgtvcommand 192.168.1.18 set_itpg_gradation_window 0 3 610 520 230 1 1 1\nbscpylgtvcommand 192.168.1.18 set_itpg_gradation_window 1 3 610 50 23 1 1 1\nbscpylgtvcommand 192.168.1.18 toggle_itpg true 2 1\n# Disable gradation window\nbscpylgtvcommand 192.168.1.18 toggle_itpg false 0\n```\n\n### Calibration guides\n\nA collection of calibration guides can be found under [docs directory](https://github.com/chros73/bscpylgtv/tree/master/docs/guides/).\n\n\n## Development of `bscpylgtv`\n\n### Adding available settings for newer models\n\nA collection of useful commands and scripts are available under [docs/utils](https://github.com/chros73/bscpylgtv/tree/master/docs/utils) directory to add support for new firmwares in the future and make PRs easier to do.\n\n### Adding new chip type\n\nOnly 3D LUT and Dolby Vision config related calibration commands require chip type to be present to work properly, utilising `calibration_support_info` method.\nThe `model_name` field of the response of `get_software_info` method contains the chip type:\n```bash\nbscpylgtvcommand 192.168.1.18 get_software_info true\n```\n\n### Unit testing\n\nRequired extra packages:\n```bash\npip install numpy pytest pytest-asyncio pytest-mock\n```\n\nRunning unit tests against the installed package:\n```bash\n# Run all the tests in all files in tests/ directory\npytest tests\n# Run all the tests in one file\npytest tests/test_webos_client_lite.py\n# Run a specific test in one file\npytest tests/test_webos_client_calibration.py -k test_set_ui_data_methods\n```\n\n\n## Forum\n\nForum [topic](https://forum.doom9.org/showthread.php?t=175007).\n\n\n## Acknowledgement\n\nThanks to the following people:\n- [TheRealLink](https://github.com/TheRealLink/pylgtv) for the original implementation\n- [bendavid](https://github.com/bendavid/aiopylgtv) for lot of modification, especially with calibration functionality\n- [Maassoft](https://github.com/Maassoft/ColorControl) for useful ideas\n- Hifi4Vision for his invaluable calibration knowledge\n\n\n\n",
    "bugtrack_url": null,
    "license": "",
    "summary": "Library to control webOS based LG TV devices.",
    "version": "0.4.6",
    "project_urls": {
        "Homepage": "https://github.com/chros73/bscpylgtv"
    },
    "split_keywords": [
        "webos",
        "tv"
    ],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "2336f313471a6b927c912976e4be5d979c93bc891172030bcf27d6828d4ed0ee",
                "md5": "fe5e1c00b0a760fbed0ff1498232dd26",
                "sha256": "cb9dc7693e9f024adf3b437ff84eaf628659e2266baa3b05f47a0af6a6363d74"
            },
            "downloads": -1,
            "filename": "bscpylgtv-0.4.6-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "fe5e1c00b0a760fbed0ff1498232dd26",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">=3.8",
            "size": 44392,
            "upload_time": "2024-01-20T19:42:52",
            "upload_time_iso_8601": "2024-01-20T19:42:52.618111Z",
            "url": "https://files.pythonhosted.org/packages/23/36/f313471a6b927c912976e4be5d979c93bc891172030bcf27d6828d4ed0ee/bscpylgtv-0.4.6-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "db64de08019a537807cd8c88066f8c1f49d9d12edf24e5f17312c03d6f967907",
                "md5": "a0768137b6574bf68a1df812781c3e07",
                "sha256": "9e2a8bf416b920d578096228b64b4a3e8d25741954eb402e5065cdb6af232e89"
            },
            "downloads": -1,
            "filename": "bscpylgtv-0.4.6.tar.gz",
            "has_sig": false,
            "md5_digest": "a0768137b6574bf68a1df812781c3e07",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.8",
            "size": 54006,
            "upload_time": "2024-01-20T19:42:54",
            "upload_time_iso_8601": "2024-01-20T19:42:54.131895Z",
            "url": "https://files.pythonhosted.org/packages/db/64/de08019a537807cd8c88066f8c1f49d9d12edf24e5f17312c03d6f967907/bscpylgtv-0.4.6.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2024-01-20 19:42:54",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "chros73",
    "github_project": "bscpylgtv",
    "travis_ci": false,
    "coveralls": false,
    "github_actions": false,
    "lcname": "bscpylgtv"
}