rtorrent Sensor


The rtorrent platform allows you to monitor your downloads with rtorrent from within Home Assistant and setup automations based on the information.

To enable this sensor, add the following lines to your configuration.yaml:

# Example configuration.yaml entry
sensor:
  - platform: rtorrent
    url: 'http://<user>:<password>@<host>:<port>/RPC2'
    monitored_variables:
      - 'current_status'
      - 'download_speed'
      - 'upload_speed'

This sensor requires the rtorrent XMLRPC API exposed on an HTTP interface. Note that for security reasons, simply using the SCGI interface (default localhost:5000) of rtorrent won’t work. The official reference describes how to set up that HTTP interface.

Alternatively, the arch-rtorrentvpn container can be used with url set to http://admin:rutorrent@127.0.0.1:9080/RPC2.

Configuration Variables

url

(string)(Required)The URL to the HTTP endpoint of the rtorrent XMLRPC API.

name

(string)(Optional)The name to use when displaying this rtorrent instance.

monitored_variables

(list)(Required)Conditions to be monitored.

current_status

The status of your rtorrent daemon.

download_speed

The current download speed.

upload_speed

The current upload speed.