homeassistant-meinvodafone

KO | EN

gitlite — search

#javascript #hacktoberfest #golang #rust #deep-learning #macos #windows #awesome #vue #awesome-list #security #mcp #openai #open-source

homeassistant-meinvodafone

(★ 19)

This project enables the monitoring of your Vodafone DE mobile phone contract's Minutes/SMS/Data usage through Home Assistant.

homeassistant-meinvodafone Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

![Version](https://img.shields.io/github/v/release/stickpin/homeassistant-meinvodafone)
![Downloads](https://img.shields.io/github/downloads/stickpin/homeassistant-meinvodafone/total)
![CodeStyle](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json)
[![CodeQL](https://github.com/stickpin/homeassistant-meinvodafone/actions/workflows/codeql.yml/badge.svg)](https://github.com/stickpin/homeassistant-meinvodafone/actions/workflows/codeql.yml)

# MeinVodafone - Home Assistant Integration

## About this repo
I've developed this integration to monitor my children's data usage, ensuring they don't exceed their allotted limits.

This project enables the monitoring of your Vodafone DE mobile phone contract's Minutes/SMS/Data usage through Home Assistant.

I hope this integration will be helpful for you as well.

[![ko-fi](https://ko-fi.com/img/githubbutton_sm.svg)](https://ko-fi.com/stickpin)

[![buy me a coffee](https://www.buymeacoffee.com/assets/img/custom_images/yellow_img.png)](https://www.buymeacoffee.com/stickpin)

---

## Installation
I recommend installing it via [HACS](https://github.com/hacs/integration)

Currently, integration is not part of the HACS, so you will have to add the repository manually:
1. Go to HACS -> Integrations
2. Add this repo to your HACS custom repositories
3. Search for MeinVodafone and Download it
4. Restart your HomeAssistant

---

### Setup the Integration

1. Go to Settings -> Devices & Services
2. Shift reload your browser
3. Click Add Integration

4. Search for MeinVodafone<br />
![find_integration](https://raw.githubusercontent.com/stickpin/homeassistant-meinvodafone/main/images/find_integration.png)

5. Enter your username and password, press submit<br />
![enter_user_pass](https://raw.githubusercontent.com/stickpin/homeassistant-meinvodafone/main/images/enter_user_pass.png)

6. Select contract and press submit<br />
![select_contract](https://raw.githubusercontent.com/stickpin/homeassistant-meinvodafone/main/images/select_contract.png)

7. If you see this screen, your configuration is successful<br />
![config_success](https://raw.githubusercontent.com/stickpin/homeassistant-meinvodafone/main/images/config_success.png)

---

## IMPORTANT
- The retry mechanism has intentionally been omitted due to the sensitivity of the Vodafone servers.
- Multiple retries could result in a 24-hour block. 
- The data usage retrieval period is configured for every 15 minutes.
- Support for 2FA (two-factor authentication) is currently unavailable.
- If you're on a flat tariff, both your Total and Remaining sensors will display as 0.

---

## Functionality
- Minutes Used/Remaining/Total
- SMS Used/Remaining/Total
- Data Used/Remaining/Total
- Support for multiple plans.
- Billing Summary Current/Previous.
- Billing Cycle (days left)

![sensors_screenshot](https://raw.githubusercontent.com/stickpin/homeassistant-meinvodafone/main/images/sensors_screenshot.png)

homeassistant-meinvodafone

homeassistant-meinvodafone Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

homeassistant-meinvodafone

homeassistant-meinvodafone Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README