mirror of
https://github.com/home-assistant/home-assistant.io.git
synced 2025-07-09 18:36:51 +00:00
Update transmission.markdown (#14907)
This commit is contained in:
parent
c879b70a20
commit
5678e95ad2
@ -14,27 +14,17 @@ ha_codeowners:
|
||||
ha_domain: transmission
|
||||
---
|
||||
|
||||
The `transmission` integration allows you to monitor your downloads with [Transmission](https://www.transmissionbt.com/) from within Home Assistant and setup automation based on the information.
|
||||
The Transmission integration allows you to monitor your [Transmission](https://www.transmissionbt.com/) BitTorrent downloads from within Home Assistant and set up automations based on that information.
|
||||
|
||||
## Setup
|
||||
|
||||
To use the monitoring, your transmission client needs to allow remote access. If you are running the graphical transmission client (transmission-gtk) go to **Edit** -> **Preferences** and choose the tab **Remote**. Check **Allow remote access**, enter your username and your password, and uncheck the network restriction as needed.
|
||||
|
||||
<p class='img'>
|
||||
<img src='/images/integrations/transmission/transmission_perf.png' />
|
||||
</p>
|
||||
|
||||
If everything is set up correctly, the details will show up in the frontend.
|
||||
|
||||
<p class='img'>
|
||||
<img src='/images/integrations/transmission/transmission.png' />
|
||||
</p>
|
||||
Your Transmission client must first be configured to allow remote access. In your Transmission client navigate to **Preferences** -> **Remote** tab and then click the **Allow remote access** checkbox.
|
||||
|
||||
## Configuration
|
||||
|
||||
Set up the integration through **Configuration** -> **Integrations** -> **Transmission**. For legacy support old transmission configuration is imported and set up as new integration. Make sure to remove `monitored_condiditions` as they are now automatically added to Home Assistant
|
||||
In Home Assistant, navigate to **Configuration** -> **Integrations** and click the plus button to add a new integration and search for **Transmission**. For legacy support old Transmission configuration is imported and set up as a new integration. Make sure to remove `monitored_conditions` as they are now automatically added to Home Assistant.
|
||||
|
||||
To enable this sensor, add the following lines to your `configuration.yaml`:
|
||||
Alternatively, the integration can be set up via YAML by adding the following lines to your `configuration.yaml`:
|
||||
|
||||
```yaml
|
||||
transmission:
|
||||
@ -71,21 +61,21 @@ scan_interval:
|
||||
|
||||
## Integration Entities
|
||||
|
||||
The Transmission Integration will add the following sensors and switches.
|
||||
The Transmission integration will add the following sensors and switches.
|
||||
|
||||
Sensors:
|
||||
- transmission_current_status: The status of your Transmission daemon.
|
||||
- transmission_download_speed: The current download speed [MB/s].
|
||||
- transmission_upload_speed: The current upload speed [MB/s].
|
||||
- transmission_active_torrents: The current number of active torrents.
|
||||
- transmission_paused_torrents: The current number of paused torrents.
|
||||
- transmission_total_torrents: The total number of torrents present in the client.
|
||||
- transmission_started_torrents: The current number of started torrents (downloading).
|
||||
- transmission_completed_torrents: The current number of completed torrents (seeding)
|
||||
**Sensors**:
|
||||
- `sensor.transmission_current_status`: The status of your Transmission daemon.
|
||||
- `sensor.transmission_download_speed`: The current download speed [MB/s].
|
||||
- `sensor.transmission_upload_speed`: The current upload speed [MB/s].
|
||||
- `sensor.transmission_active_torrents`: The current number of active torrents.
|
||||
- `sensor.transmission_paused_torrents`: The current number of paused torrents.
|
||||
- `sensor.transmission_total_torrents`: The total number of torrents present in the client.
|
||||
- `sensor.transmission_started_torrents`: The current number of started torrents (downloading).
|
||||
- `sensor.transmission_completed_torrents`: The current number of completed torrents (seeding).
|
||||
|
||||
Switches:
|
||||
- transmission_switch: A switch to start/stop all torrents
|
||||
- transmission_turtle_mode: A switch to enable turtle mode.
|
||||
**Switches**:
|
||||
- `switch.transmission_switch`: A switch to start/stop all torrents.
|
||||
- `switch.transmission_turtle_mode`: A switch to enable turtle mode (a.k.a. alternative speed limits).
|
||||
|
||||
|
||||
## Event Automation
|
||||
@ -94,9 +84,9 @@ The Transmission integration is continuously monitoring the status of torrents i
|
||||
|
||||
Possible events are:
|
||||
|
||||
- transmission_downloaded_torrent
|
||||
- transmission_started_torrent
|
||||
- transmission_removed_torrent
|
||||
- `transmission_downloaded_torrent`
|
||||
- `transmission_started_torrent`
|
||||
- `transmission_removed_torrent`
|
||||
|
||||
Inside of the event, there is the name of the torrent that is started or completed, as it is seen in the Transmission User Interface.
|
||||
|
||||
@ -142,7 +132,7 @@ Removes a torrent from the client.
|
||||
|
||||
### Attribute `torrent_info`
|
||||
|
||||
All `*_torrents` sensors e.g. `sensor.transmission_total_torrents` or `sensor.transmission_started_torrents` have a state attribute `torrent_info` that contains information about the torrents that are currently in a corresponding state. You can see this information in **Developer Tools** -> **States** -> `sensor.transmission_total_torrents` -> **Attributes**, or by adding a Markdown Card to Lovelace.
|
||||
All `*_torrents` sensors e.g. `sensor.transmission_total_torrents` or `sensor.transmission_started_torrents` have a state attribute `torrent_info` that contains information about the torrents that are currently in a corresponding state. You can see this information in **Developer Tools** -> **States** -> `sensor.transmission_total_torrents` -> **Attributes**, or by adding a [Markdown card](/lovelace/markdown/) to Lovelace with the following code:
|
||||
|
||||
{% raw %}
|
||||
```yaml
|
||||
|
Loading…
x
Reference in New Issue
Block a user