Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/amaximus/mnb_rates

Home Assistant custom integration for MNB echange rates
https://github.com/amaximus/mnb_rates

home-assistant homeassistant homeassistant-custom-component hungary

Last synced: about 1 month ago
JSON representation

Home Assistant custom integration for MNB echange rates

Host: GitHub
URL: https://github.com/amaximus/mnb_rates
Owner: amaximus
License: mit
Created: 2024-06-26T12:16:43.000Z (5 months ago)
Default Branch: main
Last Pushed: 2024-06-26T19:35:59.000Z (5 months ago)
Last Synced: 2024-09-30T19:04:29.764Z (about 2 months ago)
Topics: home-assistant, homeassistant, homeassistant-custom-component, hungary
Language: Python
Homepage:
Size: 32.2 KB
Stars: 1
Watchers: 1
Forks: 0
Open Issues: 0
Metadata Files:
- Readme: README.md
- License: LICENSE

Awesome Lists containing this project

README

        [![hacs_badge](https://img.shields.io/badge/HACS-Default-orange.svg)](https://github.com/hacs/integration)



# Home Assistant custom component for MNB (Hungarian National Bank) rates

This custom component fetches MNB (Hungarian National Bank) daily exchange rates from mnb.hu.

This custom component requires [https://github.com/belidzs/mnb](https://github.com/belidzs/mnb) package available on PyPI but also set as a python requirement.

The state of the sensor will be:

* `0` for successful data fetch OR

* `1` for unsuccessful data fetch

Currency names, rates and units are added into the `rates` attribute.

#### Installation

The easiest way to install it is through [HACS (Home Assistant Community Store)](https://github.com/hacs/integration),

search for MNB rates in the Integrations.


Sensor of this platform should be configured as per below information.

#### Configuration:

Define sensor with the following configuration parameters:


---

| Name | Optional | `Default` | Description |

| :---- | :---- | :------- | :----------- |

| name | **Y** | `mnb_rates` | name of the sensor |

| currencies | **Y** | `` | list of currency trigrams to filter on. |

---

#### Example

```

platform: mnb_rates

name: 'MNB árfolyamok'

currencies:

  - EUR

  - USD

```

![MNB rates filtered](https://raw.githubusercontent.com/amaximus/mnb_rates/main/mnb_rates2.png)

## Thanks

Thanks to all the people who have contributed!

[![contributors](https://contributors-img.web.app/image?repo=amaximus/mnb_rates)](https://github.com/amaximus/mnb_rates/graphs/contributors)