home-assistant.io/source/_integrations/lg_netcast.markdown
c0ffeeca7 7115a66b27
h-l integrations: apply sentence-style caps in categories (#29903)
* h-l integrations: apply sentence-style caps in categories

* Apply suggestions from code review

Co-authored-by: Joakim Sørensen <joasoe@gmail.com>

---------

Co-authored-by: Joakim Sørensen <joasoe@gmail.com>
2023-11-20 09:02:30 +01:00

86 lines
2.5 KiB
Markdown

---
title: LG Netcast
description: Instructions on how to integrate a LG TV (Netcast 3.0 & 4.0) within Home Assistant.
ha_category:
- Media player
ha_iot_class: Local Polling
ha_release: '0.20'
ha_domain: lg_netcast
ha_platforms:
- media_player
ha_codeowners:
- '@Drafteed'
ha_integration_type: integration
---
The `lg_netcast` platform allows you to control a LG Smart TV running NetCast 3.0 (LG Smart TV models released in 2012) and NetCast 4.0 (LG Smart TV models released in 2013). For the new LG WebOS TV's use the [webostv](/integrations/webostv#media-player) platform.
To add a LG TV to your installation, add the following to your `configuration.yaml` file:
```yaml
# Example configuration.yaml entry
media_player:
- platform: lg_netcast
host: IP_ADDRESS
```
{% configuration %}
host:
description: The IP address of the LG Smart TV, e.g., 192.168.0.20.
required: true
type: string
access_token:
description: The access token needed to connect.
required: false
type: string
name:
description: The name you would like to give to the LG Smart TV.
required: false
default: LG TV Remote
type: string
turn_on_action:
description: Defines an [action](/docs/automation/action/) to turn the TV on.
required: false
type: string
{% endconfiguration %}
To get the access token for your TV configure the `lg_netcast` platform in Home Assistant without the `access_token`.
After starting Home Assistant the TV will display the access token on screen.
Just add the token to your configuration and restart Home Assistant and the media player integration for your LG TV will show up.
<div class='note'>
The access token will not change until you factory reset your TV.
</div>
## Advanced configuration
The example below shows how you can use the `turn_on_action` the [`wake_on_lan` integration](/integrations/wake_on_lan/).
```yaml
wake_on_lan: # enables `wake_on_lan` integration
# Enables the `lg_netcast` media player
media_player:
- platform: lg_netcast
host: 192.168.0.20
turn_on_action:
service: wake_on_lan.send_magic_packet
data:
mac: AA-BB-CC-DD-EE-FF
broadcast_address: 11.22.33.44
```
## Change channel through play_media service
The `play_media` service can be used in a script to switch to the specified TV channel. It selects the major channel number according to the `media_content_id` parameter:
```yaml
# Example action entry in script to switch to channel number 15
service: media_player.play_media
target:
entity_id: media_player.lg_tv
data:
media_content_id: 15
media_content_type: channel
```