Add go2rtc (#34998)

* Add go2rtc

* fix finding

* fix

* formatting

* fix

* Update source/_integrations/go2rtc.markdown

Co-authored-by: Martin Hjelmare <marhje52@gmail.com>

* Update docs

* Move it to config

* Add warning for debug_ui

* Apply suggestions from code review

Co-authored-by: Martin Hjelmare <marhje52@gmail.com>

* Style tweaks

Co-authored-by: Martin Hjelmare <marhje52@gmail.com>

* Update source/_integrations/go2rtc.markdown

* Add more context

Co-authored-by: c0ffeeca7 <38767475+c0ffeeca7@users.noreply.github.com>

* Fix grammar

---------

Co-authored-by: Martin Hjelmare <marhje52@gmail.com>
Co-authored-by: c0ffeeca7 <38767475+c0ffeeca7@users.noreply.github.com>
This commit is contained in:
Robert Resch 2024-11-05 10:53:00 +01:00 committed by Franck Nijhof
parent 22afa3b871
commit 11e3e8a277
No known key found for this signature in database
GPG Key ID: D62583BA8AB11CA3
2 changed files with 59 additions and 0 deletions

View File

@ -20,6 +20,7 @@ This {% term integration %} is a meta-component and configures a default set of
- [Conversation](/integrations/conversation/) (`conversation`)
- [DHCP discovery](/integrations/dhcp/) (`dhcp`)
- [Energy](/integrations/energy/) (`energy`)
- [Go2rtc](/integrations/go2rtc/) (`go2rtc`)
- [History](/integrations/history/) (`history`)
- [Home Assistant Alerts](/integrations/homeassistant_alerts) (`homeassistant_alerts`)
- [Home Assistant Cloud](/integrations/cloud/) (`cloud`)

View File

@ -0,0 +1,58 @@
---
title: go2rtc
description: Instructions on how to setup go2rtc in Home Assistant.
ha_category:
- Camera
ha_release: 2024.11
ha_iot_class: Local Polling
ha_codeowners:
- '@home-assistant/core'
ha_domain: go2rtc
ha_integration_type: system
related:
- docs: /installation/
---
go2rtc is an open source project providing a camera streaming application that supports formats such as RTSP, WebRTC, HomeKit, FFmpeg, RTMP. The **go2rtc** {% term integration %} connects to a go2rtc instance and provides a WebRTC proxy for all your cameras. To learn more about go2rtc, refer to the [project's GitHub page](https://github.com/AlexxIT/go2rtc/).
If you are using the [`default_config`](/integrations/default_config/) and run Home Assistant using one of the following installation methods, the go2rtc integration will be set up automatically and you don't need to do anything:
- {% term "Home Assistant Operating System" %}
- {% term "Home Assistant Supervised" %}
- {% term "Home Assistant Container" %}
## Configuration
This integration is part of the [`default_config`](/integrations/default_config/).
The following YAML options are available:
{% configuration %}
debug_ui:
required: false
description: Enables the UI of the go2rtc, which helps debugging WebRTC issues. The `debug_ui` should only be enabled during debugging as it will expose port 1984 without any authentication!
default: false
type: boolean
url:
required: false
description: The URL to the self-hosted [go2rtc](https://github.com/AlexxIT/go2rtc/) server
type: string
{% endconfiguration %}
{% warning %}
The `debug_ui` should only be enabled during debugging as it will expose port 1984 without any authentication!
Please disable the `debug_ui` immediately after debugging.
{% endwarning %}
### Examples
Use a self-hosted instance:
```yaml
go2rtc:
url: http://my-go2rtc-instance:1984
```