---
title: "pyLoad"
description: "pyLoad is a built-in integration for Home Assistant. It has 23 installs sharing analytics and works locally."
canonical: "https://vulpo.app/integrations/core/pyload"
url: "https://vulpo.app/integrations/core/pyload.md"
last-updated: "2026-10-22"
version: "1.4"
---

# pyLoad

> pyLoad is a built-in integration for Home Assistant. It has 23 installs sharing analytics and works locally.

pyLoad is a built-in integration that connects Home Assistant to a pyLoad download manager over the local network. It adds sensors for active downloads, downloads in queue, total downloads, speed and free space. Buttons can abort all running downloads, delete finished files and packages, restart failed files and restart the pyLoad core. Two switches pause or resume the queue and toggle auto-reconnect. Setup is done in the UI with an API key, and a URL and an option to verify the SSL certificate; username and password are deprecated for newer pyLoad versions. Connection settings can be changed later without removing the integration, and a diagnostics file can be downloaded for bug reports.

Automatic summary of Home Assistant's source code. Something wrong? [Get in touch](https://vulpo.app/contact)

[Open in My Home Assistant](https://my.home-assistant.io/redirect/config_flow_start/?domain=pyload)

## Supports

- **Works locally**: Talks to your devices on your own network. No vendor cloud in between.
- **Set up in the UI**: Add it in Settings, Devices and services. Nothing to download.
- **Change settings later**: Its connection settings can change without removing it.
- **Platinum quality**: Home Assistant's own rating of its code and setup experience.
- **Updated with Home Assistant**: Ships and updates with every Home Assistant release.

## Setting it up

It is added under Settings, Devices and services, with Add integration.

### Connect

- **API key**: The API key to authenticate with pyLoad. To create a new API key, navigate to Settings \> Users \> Actions \> Manage API Keys and select Generate.
- **Password**: The password associated with the pyLoad account. Deprecated: No longer supported in pyLoad 0.5.0b3.dev97 or later.
- **URL**
- **Username**: The username used to access the pyLoad instance. Deprecated: No longer supported in pyLoad 0.5.0b3.dev97 or later.
- **Verify SSL certificate**: If checked, the SSL certificate will be validated to ensure a secure connection.

Also asked when changing the connection.

### pyLoad via Home Assistant app

- **API key**: The API key to authenticate with pyLoad. To create a new API key, navigate to Settings \> Users \> Actions \> Manage API Keys and select Generate.
- **Password**: The password associated with the pyLoad account. Deprecated: No longer supported in pyLoad 0.5.0b3.dev97 or later.
- **Username**: The username used to access the pyLoad instance. Deprecated: No longer supported in pyLoad 0.5.0b3.dev97 or later.

Also asked when signing in again.

Texts from Home Assistant's source code, [Apache License 2.0](https://www.apache.org/licenses/LICENSE-2.0).

## Entities

- **Buttons**: Abort all running downloads, Delete finished files/packages, Restart pyload core, Restart all failed files
- **Sensors**: Active downloads, Free space, Downloads in queue, Speed, Total downloads
- **Switches**: Pause/Resume queue, Auto-Reconnect

## Troubleshooting

- **Diagnostics**: Downloads a diagnostics file to attach to a bug report.

## At a glance

- Kind: Built-in integration
- Category: [Computers and network](https://vulpo.app/integrations/category/computers-and-network.md)
- Number: 23 installs sharing analytics
- Connection: Works locally
- Upkeep: Part of Home Assistant
- Needs: Built into Home Assistant
- Quality scale: Platinum quality scale
- Domain: `pyload`
- Source: <https://www.home-assistant.io/integrations/pyload/>

In Vulpo: Quick Toggle card, Button card, Chart card, Apple Watch, Control Center

Independent directory, made by the developer of Vulpo. Not affiliated with Home Assistant or the Open Home Foundation. [About these numbers](https://vulpo.app/integrations/about)

Last updated 2026-10-22. Source: https://vulpo.app/integrations/core/pyload

---

- HTML version of this page: https://vulpo.app/integrations/core/pyload
- Site index for agents: https://vulpo.app/llms.txt
- Everything in one document: https://vulpo.app/llms-full.txt
- All pages: https://vulpo.app/sitemap.xml