Duolingual - A Home Assistant integration for Duolingo

Home Assistant integration to track your Duolingo daily streak progress.

About

This integration is easy to set up (just enter your username) and it creates sensors to monitor your Duolingo streak activity:

• 🔥 Binary Sensor: Shows if you extended your streak today (on/off)
• 📅 Streak Sensor: Displays your current streak count in days
• ⭐ XP Sensor: Shows your total XP across all courses

Fork Notes

This is a fork of sphanley/Duolinguist, updated to work with current Duolingo APIs and modern Home Assistant versions.

⚠️ Important: This integration uses reverse-engineered Duolingo APIs since no official API documentation exists. It may break if Duolingo changes their endpoints.

Installation

Manual Installation

1. Download the latest release or clone this repository
2. Copy the custom_components/duolingo/ folder to your Home Assistant custom_components/ directory
3. Restart Home Assistant
4. Go to Settings → Devices & Services → Add Integration and search for "Duolingual"

HACS Installation

Add this repository as a custom repository in HACS:

1. Go to HACS → Integrations → ⋮ → Custom repositories
2. Add repository URL: https://github.com/TimCinel/duolingual
3. Category: Integration
4. Install and restart Home Assistant

Configuration

1. Go to Settings → Devices & Services → Add Integration
2. Search for "Duolingual"
3. Enter your Duolingo username (the one visible in your profile URL)
4. The integration will create two entities for tracking your streak

Contributions are welcome!

If you want to contribute to this please read the Contribution guidelines

---