Automatizar procesos en casa no solo hace la vida más cómoda, sino también más eficiente. En este tutorial aprenderás a integrar las descargas de torrents con Home Assistant para recibir notificaciones automáticas cuando tus archivos hayan terminado de descargarse. Esto es especialmente útil si utilizas clientes torrent en un servidor o dispositivo sin monitor, y quieres mantenerte informado en tiempo real sin necesidad de estar revisando manualmente.

Exploraremos cómo conectar Transmission con Home Assistant mediante su integración, configuraremos notificaciones y, finalmente, personalizaremos los avisos para que se adapten a tus necesidades. Ya sea que prefieras recibir mensajes en tu móvil, correos electrónicos o notificaciones emergentes, este tutorial te guiará paso a paso para lograrlo. ¡Comencemos!

Instalación de un cliente Torrent

Lo primero que necesitaremos será tener un cliente de torrent. Para este tutorial, utilizaremos Transmission, ya que tiene integración con Home Assistant y la configuración es muy sencillo.

Si no tienes instalado Transmission en tu servidor doméstico te dejo este tutorial para hacerlo:

Instalar Transmission en GNU/Linux para no tener que ir al VideoClub -guiñoguiño-.

Transmission es un cliente de torrent libre disponible para GNU/Linux. Utiliza muy pocos recursos en comparación con otros clientes y además ofrece la opción de tener una versión web.

_ voidNullDon T3rr0rZ0n3

Y si usas Proxmox, recuerda que puedes usar los Proxmox Scripts para desplegar un contenedor:

Utiliza Helper-Scripts para desplegar contenedores y máquinas virtuales de casi cualquier cosa

Los Helper-Scripts para Proxmox son scripts o programas de utilidad diseñados para facilitar o automatizar ciertas tareas de administración y configuración en sistemas que utilizan Proxmox VE

_ voidNullDon T3rr0rZ0n3

Instalación de la Integración de Transmission

Para la instalación de esta integración deberemos de seguir este otro tutorial que explica como instalar integraciones en Home Assistant:

Añadir una integración en Home Assistant

En Home Assistant, una integración es un módulo o componente que permite a la plataforma interactuar con dispositivos, servicios, plataformas o APIs de terceros.

_ voidNullDon T3rr0rZ0n3

En el modal que se nos abre, tendremos que buscar transmission e instalar la integración que nos aparece.

Tras seleccionarla, deberemos de configurar los siguientes datos:

• Utiliza un certificado SSL: Marcaremos esta opción si tenemos configurado HTTP en nuestro Transmission.
• Host: Nombre de dominio o IP donde tenemos configurado Transmission.
• Ruta: Si en la configuración no lo hemos modificado, lo dejaremos tal y como está.
• Nombre de usuario: El nombre de usuario para acceder a Transmission.
• Contraseña: La contraseña seleccionada.
• Puerto: Si usamos IP deberemos de poner el puerto de acceso. Si hemos configurado dominio con SSL, tendremos que poner 443.

Tras rellenar todos estos datos, obtendremos la integración con nuestro Transmission:

Crear automatización para notificar descarga de Torrent

Para crear esta automatización para que nos notifique la descarga de un Torrent, lo que usaremos para desencadenante será un evento. Cuando se instala la integración de Transmission, se añaden unos eventos disponibles para usar.

En este caso usaremos el evento "transmission_downloaded_torrent":

Con la integración, tenemos un sensor llamado sensor.transmission_torrents_completados que muestra el total de torrents descargados en Transmission y además da una respuesta en JSON con los torrents descargados:

torrent_info:
  Ubuntu 24.04 - Desktop:
    added_date: "2024-12-08T11:05:16+00:00"
    percent_done: "100.00"
    status: seeding
    id: 3
    eta: None

Con esta información, podemos utilizarla para crear un mensaje personalizado para enviarnos. Por ejemplo con Telegram:

En este apartado, tenéis la posibilidad de utilizar diversas acciones para enviar notificaciones, ya sea a través de XMPP, Telegram o incluso Mastodon. Esto os permite adaptar el sistema a vuestras necesidades y preferencias, asegurando una integración fluida con las plataformas que utilicéis habitualmente.

Configurar notificaciones de Home Assistant a XMPP

Actualmente Home Assistant tiene soporte para Jabber (XMPP) y podemos configurar una cuenta que será utilizada para notificar todo lo que queramos con nuestras automatizaciones.

_ voidNullDon T3rr0rZ0n3

Configurar notificaciones de Home Assistant a Telegram

Dentro de todas las posibilidades de enviar notificaciones de cosas que suceden en Home Assistant, una muy interesantes es poder enviar avisos directamente a tu cuenta de Telegram.

_ voidNullDon T3rr0rZ0n3

Configurar notificaciones de Home Assistant a Mastodon

Dentro de todas las posibilidades de enviar notificaciones de cosas que suceden en Home Assistant, una muy interesante es poder enviar avisos directamente a tu cuenta de Mastodon. Actualmente Home Assistant tiene soporte para Mastodon y podemos configurar una cuenta que será utilizada para notificar todo lo que queramos con

_ voidNullDon T3rr0rZ0n3

Si preferís trabajar directamente con la configuración en formato YAML, aquí os la comparto para vuestra comodidad. Este formato puede resultar útil si os sentís más cómodos editando archivos manualmente o si queréis aprovechar las ventajas de personalización que ofrece el YAML en Home Assistant.

alias: "[TORRENT] Aviso de descarga completada"
description: ""
triggers:
  - trigger: event
    event_type: transmission_downloaded_torrent
    context: {}
conditions: []
actions:
  - action: notify.message_telegram
    data:
      title: 🎉 Nuevo torrent descargado
      message: "\"{{trigger.event.data.name}}\""
mode: single

Y éste es el resultado:

Más sobre ./voidNull

• 📖 Aprende todos sobre los comandos de GNU/Linux en nuestro Diccionario "De la A a la Z: Los comandos de GNU/Linux"
• 💪 ¡Forma parte de la Comunidad de ./voidNull!
• 🤖 Disfruta de todos nuestros Cursos sobre Ansible, Proxmox, Home Assistant entre otros.
• 📩 Mantente actualizado con lo último en GNU/Linux y Software Libre. Recibe nuestra Newsletter mensual.