Jokes for Home Assistant (Marketplace integration)

Installs: 102 sharing analytics
GitHub stars: 7
Connection: Uses the vendor's cloud
Upkeep: Updated in the last 6 months
Version: v1.7.0, October 22, 2026
Category: Productivity and information
Kind: Marketplace integration
Needs: Needs the Marketplace (HACS on 2026.10 and older)
Domain: ha_jokes
Source: github.com/loryanstrant/ha-jokes
Issues: Report an issue

Independent directory, made by the developer of Vulpo. Not affiliated with Home Assistant or the Open Home Foundation.

Screenshots From the README of loryanstrant/ha-jokes.

Jokes setup dialog — choosing joke providers, with Geek Jokes and Yo Mama marked not family-friendly and off by default

custom:ha-jokes-card showing a joke, its source, Explain it and New joke buttons, and an explanation panel

About

Jokes is a Home Assistant integration that fetches random jokes from several online providers and shows them in a sensor. The sensor reports a status as its state and keeps the joke text, an identifier, the source and the last update time as attributes, so long jokes are not cut off by the state length limit. If one provider fails, the integration tries another enabled one, and the refresh interval in minutes can be changed. Two of the five sources serve unfiltered adult content and are switched off by default, while the settings let providers be turned on or off later. A language choice applies only to JokeAPI, since the other sources are English-only. It relies on the vendors' cloud services and is set up in the UI.

Automatic summary of the README and code of loryanstrant/ha-jokes. Something wrong, or are you the maintainer and want your own text here? Get in touch

Supports

Uses the vendor's cloud Needs an internet connection and an account with the vendor.
From the Marketplace Installed through the Marketplace, formerly HACS.
Actively maintained Its author released or pushed a change in the last six months.

Provides

Sensors

Setting it up

Install it from the Marketplace and restart Home Assistant, then add it under Settings, Devices and services.

Jokes Setup

Refresh interval (minutes)
Joke providersSelect which joke sources to use. Note: "Geek Jokes" (mostly Chuck Norris / crude) and "Yo Mama Jokes" (roast humour) serve unfiltered adult content and are not family-friendly — both are off by default.
JokeAPI languageChoose the language to request from JokeAPI when that provider is enabled.

After setup

Refresh interval (minutes)
Joke providersSelect which joke sources to use. Note: "Geek Jokes" (mostly Chuck Norris / crude) and "Yo Mama Jokes" (roast humour) serve unfiltered adult content and are not family-friendly — both are off by default.
JokeAPI languageChoose the language to request from JokeAPI when that provider is enabled.

Texts from the code of loryanstrant/ha-jokes.

From the README

A custom Home Assistant integration that fetches random jokes from multiple sources and provides them as a sensor entity.
🎭 Fetches random jokes from 5 built-in sources — 3 family-friendly (on by default) plus 2 opt-in sources clearly marked ⚠️ not family-friendly
🔀 Random provider selection for variety
🛡️ Fault tolerance - automatically tries alternative providers if one fails
📊 Creates a sensor entity with state "OK" when successful
🏷️ Stores joke text, ID, and source as attributes (no 255 character state limitation)
⏰ Configurable refresh interval (1-1440 minutes, default: 5 minutes)
🌍 Pick the language JokeAPI answers in — Czech, German, English or Spanish (default: English)
🤖 AI-powered joke explanations using Home Assistant's AI integration
⚙️ Easy configuration through Home Assistant UI
🔄 Supports options flow for changing settings
🛡️ Robust error handling and logging
📱 HACS compliant for easy installation