bscpylgtv

To configure SDR-specific presets, run one of the lg-set-SDR-presets.* scripts. The TV must be in SDR mode for these settings to apply correctly.

# Example command pattern
python lg-set-SDR-presets.py

Once calibration is complete, you can upload custom tonemapping parameters using the set_tonemap_params command. The command requires the picture mode and a series of numeric parameters.

bscpylgtvcommand 192.168.1.18 set_tonemap_params hdr_cinema 880 1000 75 4000 60 10000 50

To prepare the TV for SDR profiling, you must start the calibration session for a specific preset and enable bypass modes.

Warning: The start_calibration command automatically sets the color temperature to Warm (50). If your target preset requires Cold (50), you must manually change it back after starting calibration.

Use the following command sequence (replacing 192.168.1.18 with your TV's IP and cinema with your preset name):

bscpylgtvcommand 192.168.1.18 start_calibration cinema
bscpylgtvcommand 192.168.1.18 set_bypass_modes_sdr -s
bscpylgtvcommand 192.168.1.18 end_calibration

To update Tmax and Tprimaries in the DolbyVision_UserDisplayConfiguration.txt file:

1. Copy the config file to the root of a USB thumbdrive.
2. Plug the drive into the TV while in SDR mode.
3. Play any Dolby Vision content (e.g., via an internal app).
4. A DoVi popup will appear allowing you to update or reset the configuration.

Warning: If a 1D LUT has already been uploaded via the calibration API to a specific DoVi preset, the USB configuration update popup is disabled. To fix this, you must either update the config before uploading the LUT, or reset the preset via the UI/API, update the config via USB, and then re-upload the 1D LUT.

When working with webOS26 or later versions, you can use the manifest-comp.json manifest file with the -m switch. This manifest provides limited functionality to ensure compatibility with newer webOS versions.

# Example usage with the -m switch
# (Note: exact command structure depends on the CLI implementation)
python -m bscpylgtv -m manifest-comp.json

To update or generate the API documentation, install pdoc and run it against the bscpylgtv package, specifying the output directory as docs/api.

pip install pdoc
pdoc -o docs/api bscpylgtv

HDR10 calibration in bscpylgtv focuses on modifying the white balance rather than the 3D LUT. You can achieve this by either adjusting the 22pt white balance controls via the TV's UI using calibration software (to correct white balance or gamma 2.2) or by uploading a custom 1D LUT.

Important Note: The start_calibration command automatically sets the color temperature to Warm (50). If your calibration workflow requires the Cool preset, you must manually change it back to Cold (50) before executing the get_1d_lut command.

To retrieve the factory 1D LUT from the TV, use the start_calibration command with the dolby_cinema_dark parameter.

Important Note on Color Temperature: The start_calibration command automatically sets the color temperature to Warm (50). If your current preset is set to Cool, you must manually change it back to Cold (50) before running the get_1d_lut command.

To ensure a clean state, it is recommended to upload an empty LUT [] before fetching the factory file.

bscpylgtvcommand 192.168.1.18 start_calibration dolby_cinema_dark
# Reset any uploaded 1dlut, just in case
bscpylgtvcommand 192.168.1.18 upload_1d_lut []
bscpylgtvcommand 192.168.1.18 get_1d_lut "dovi_cinema_factory.1dlut"

To generate a new settings documentation file for a specific model, use the merge_settings.py script. This helps identify available Inputs, Presets, Dynamic ranges, and category settings.

1. Create a new directory named after the model (e.g., C2).
2. Copy the following files into that directory:
   • etc/palm/defaultSettings.json
   • etc/palm/description.json
   • usr/palm/services/com.webos.service.apiadapter/adapters/settings/valid-settings.js
3. Run the script passing the directory name as an argument.

The script will output a merged Markdown file, such as C2/available_settings_C2.md.

merge_settings.py C2

To configure HDR10-specific presets, run one of the lg-set-HDR10-presets.* scripts. The TV must be in HDR10 mode for these settings to apply correctly.

# Example command pattern
python lg-set-HDR10-presets.py