Home Assistant Community Add-ons: Delta Chat Bots by Gluek
  • Shell 73.9%
  • Python 18.9%
  • Dockerfile 7.2%
Find a file
github-actions[bot] 6601deeb39 chore: auto-sync bot versions with upstream repositories
Updated: bouncer [images prebuilt]
2026-11-20 22:37:41 +00:00
.github fix(ci): checkout live tip of main in sync workflow after concurrency queue 2026-11-05 12:14:26 +00:00
addons chore: auto-sync bot versions with upstream repositories 2026-11-20 22:37:41 +00:00
tests test: reject url/email schema on options with an empty default 2026-10-16 14:09:09 +01:00
.gitignore Initial commit: Home Assistant Add-ons repository for Delta Chat bots 2026-09-04 21:50:13 +01:00
check_versions.py Sync all intermediate upstream changelog sections 2026-10-16 13:37:38 +01:00
icon.png Update repository icon: transparent background and standard 512x512 resolution 2026-09-04 22:19:40 +01:00
LICENSE docs(addons): document recent bot features; switch license to MIT 2026-10-16 13:07:11 +01:00
README.md docs(addons): document recent bot features; switch license to MIT 2026-10-16 13:07:11 +01:00
repository.yaml Initial commit: Home Assistant Add-ons repository for Delta Chat bots 2026-09-04 21:50:13 +01:00

Delta Chat Bots for Home Assistant

Delta Chat Bots Logo

A curated collection of production-ready Delta Chat bots packaged as official Home Assistant Add-ons.

Open your Home Assistant instance and show the add-on store with a specific repository URL.

Home Assistant Add-on Architectures MIT License


📦 Available Add-ons

Add-on Slug Description Web UI / Sidebar
Uptime Bot deltachat_uptime Monitors websites, ports & SSL expiry with instant Delta Chat alerts and web status dashboard Ingress / Port 8081
Telegram Bridge deltachat_telegram_bridge Bidirectional message, edit, deletion, and media bridge between Telegram and Delta Chat No
Web Preview deltachat_webpreview Saves web pages as offline HTML (monolith), reader mode views, WebXDC apps & Gemini AI summaries No
Bouncer deltachat_bouncer Monitors group inactivity, purges stale members, manages group/channel catalogs, and tests relays (cmping) No
ntfy Notifications deltachat_ntfy Emulates ntfy.sh backend to broadcast HTTP webhooks to Delta Chat topics with a web dashboard Ingress / Port 8082
YT Downloader deltachat_yt Downloads media & music (Yandex Music, SoundCloud, VK), slices tracks, and integrates with Navidrome No
Username & Short Links deltachat_username Registers custom usernames and short invite redirect links (HTTP 307) with OpenGraph preview cards Ingress / Port 8084
Publish Bot deltachat_publish Publishes blog posts and images to Astro blogs via Forgejo / Gitea REST API with single-commit publishing No

🚀 Installation

One-Click Install

Click the My Home Assistant badge above, or use this button:

Open your Home Assistant instance and show the add-on store with a specific repository URL.

Manual Install

  1. In Home Assistant, go to Settings → Add-ons → Add-on Store (bottom-right button).
  2. Click the three dots (top-right menu) → Repositories.
  3. Add the following repository URL:
    https://github.com/mrgluek/hass-addons-deltachat
    
  4. Click Add and then close the dialog.
  5. Refresh the page or click Check for updates. The Delta Chat Bots section will appear in the Add-on Store!

⚙️ Configuration & Quick Start

Each bot includes a built-in setup wizard in its Configuration tab in Home Assistant:

  1. Install the Bot: Choose the desired bot and click Install.
  2. Configure Credentials: Open the Configuration tab. This step is optional: with auto_server enabled (default) and the fields below left empty, the Delta Chat core picks the closest available Chatmail server by itself (it probes its built-in server list over TCP and later adds more relays). To choose a server yourself, use either:
    • Chatmail QR / URI: Paste a DCACCOUNT:... invite string or QR text from any Chatmail server into the chatmail_qr field.
    • Standard E-mail: Enter email and password (and optional IMAP/SMTP server/port if using custom domains).
  3. Set Admin & Profile:
    • admin_email: Your personal Delta Chat email address.
    • display_name: Friendly name displayed in chats (e.g. Home Uptime Bot).
    • status_text: Bio text shown in the bot profile.
  4. Sidebar & Web UI: For bots with a web interface (Uptime, ntfy, Username), enable the Show in sidebar toggle to access the web UI directly from Home Assistant's left navigation menu via Home Assistant Ingress without port conflicts!
  5. Start the Add-on: Click Start.
  6. Connect via Delta Chat:
    • Open the Log tab of the add-on.
    • You will see the bot's invitation link and an ASCII QR Code directly in the logs!
    • Open Delta Chat on your phone or desktop, scan the QR code (or paste the invite link), and you are connected!

🛡️ Architecture & Deployment

  • Home Assistant Ingress: Web UIs are securely embedded into the Home Assistant frontend and sidebar without requiring open host ports or router port forwarding.
  • Pre-built Multi-Arch Containers: Images are built for linux/amd64 and linux/arm64 (aarch64) and hosted on ghcr.io/mrgluek/.
  • Automatic Fallback: If ghcr.io images are not available, Home Assistant builds from the local Dockerfile by pulling from GitHub with an automatic fallback to the self-hosted Forgejo mirror at https://git.gluek.info/gluek/.
  • Mail Relays: The Delta Chat core (2.61+) chooses the relay: it sends through the one that last worked and switches to the next only if it cannot connect. /transports shows the relay actually used for sending, the send queue and per-relay status; /addtransport / /rmtransport add or remove relays (admin only).
  • Persistent Data: All account keys, SQLite databases, and configurations are safely stored in /data, persisting across container restarts and add-on updates.

📄 License

This project is licensed under the MIT License. The bots themselves are separate projects; see each bot's repository for its license.