https://github.com/makhuta/homeassistant-duolingo
HomeAssistant Duolingo scraper
https://github.com/makhuta/homeassistant-duolingo
duolingo homeassistant parser scrapper
Last synced: about 1 month ago
JSON representation
HomeAssistant Duolingo scraper
- Host: GitHub
- URL: https://github.com/makhuta/homeassistant-duolingo
- Owner: Makhuta
- Created: 2024-06-24T20:07:29.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2025-03-25T22:32:31.000Z (6 months ago)
- Last Synced: 2025-03-25T23:28:46.286Z (6 months ago)
- Topics: duolingo, homeassistant, parser, scrapper
- Language: Python
- Homepage:
- Size: 63.5 KB
- Stars: 14
- Watchers: 2
- Forks: 2
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
[![HACS badge][hacs-badge-shield]][hacs-badge-url]
[![Contributors][contributors-shield]][contributors-url]
[![Release][release-shield]][release-url]
[![Release date][release-date-shield]][release-date-url]
[![Forks][forks-shield]][forks-url]
[![Stargazers][stars-shield]][stars-url]
[![Downloads][downloads-shield]][downloads-url]
[![Issues][issues-shield]][issues-url]
# Data scraper for Duolingo
Adds multiple sensors with information/statistics grabbed from Duolingo account
## Installation
### Requirements:
1. Install this component by copying [these files](https://github.com/Makhuta/homeassistant-duolingo/tree/main/custom_components/duolingo) to `custom_components/duolingo/`.
2. **You will need to restart after installation for the component to start working.**
### Adding new device
To add the **Duolingo Scraper** integration to your Home Assistant, use this My button:
Manual configuration steps
If the above My button doesn’t work, you can also perform the following steps manually:
- Browse to your Home Assistant instance.
- Go to [Settings > Devices & Services](https://my.home-assistant.io/redirect/integrations/).
- In the bottom right corner, select the [Add Integration button.](https://my.home-assistant.io/redirect/config_flow_start?domain=duolingo)
- From the list, select **Duolingo Scraper**.
- Follow the instructions on screen to complete the setup.
## Note
The users will be viewed from the JWT token point of view meaning that you might not see some datas when parsing other users with the same token.
### How to get the JWT token?
The JWT token is unique per user and will be different based on for whom you will be logged as in your browser. You can get the JWT token by opening following:
Developer tools -> Go to the Console -> Insert the following command
```javascript
document.cookie.match(new RegExp('(^| )jwt_token=([^;]+)'))[0].slice(11)
```
Inside the Console is your unique JWT token, you can copy it and use it in HomeAssistant.
### Possible problems
1. If your JWT token don't work make sure to not copy the brackets \" or \' from Console (they are there only to define the type of the return value which is in this case string)
| Wrong | Right |
| - | - |
| 'YOUR_TOKEN' | YOUR_TOKEN |
2. If you are unable to paste into your browser console (the command for getting the Duolingo token) type allow pasting into the console and press Enter, after that you should be able to paste the command.
### Top contributors:
[hacs-badge-shield]: https://img.shields.io/badge/HACS-Default-41BDF5.svg?style=for-the-badge
[hacs-badge-url]: https://github.com/hacs/integration
[contributors-shield]: https://img.shields.io/github/contributors/Makhuta/homeassistant-duolingo.svg?style=for-the-badge
[contributors-url]: https://github.com/Makhuta/homeassistant-duolingo/graphs/contributors
[release-shield]: https://img.shields.io/github/release/Makhuta/homeassistant-duolingo.svg?style=for-the-badge
[release-url]: https://github.com/Makhuta/homeassistant-duolingo/releases/latest
[release-date-shield]: https://img.shields.io/github/release-date/Makhuta/homeassistant-duolingo.svg?style=for-the-badge
[release-date-url]: https://github.com/Makhuta/homeassistant-duolingo/releases/latest
[downloads-shield]: https://img.shields.io/github/downloads/Makhuta/homeassistant-duolingo/total.svg?style=for-the-badge
[downloads-url]: https://github.com/Makhuta/homeassistant-duolingo/releases/latest
[forks-shield]: https://img.shields.io/github/forks/Makhuta/homeassistant-duolingo.svg?style=for-the-badge
[forks-url]: https://github.com/Makhuta/homeassistant-duolingo/network/members
[stars-shield]: https://img.shields.io/github/stars/Makhuta/homeassistant-duolingo.svg?style=for-the-badge
[stars-url]: https://github.com/Makhuta/homeassistant-duolingo/stargazers
[issues-shield]: https://img.shields.io/github/issues/Makhuta/homeassistant-duolingo.svg?style=for-the-badge
[issues-url]: https://github.com/Makhuta/homeassistant-duolingo/issues