Skip to content

README.md

Latest commit

 

History

History
110 lines (70 loc) · 9.11 KB

README.md

File metadata and controls

110 lines (70 loc) · 9.11 KB
Raw

justETF live Integration for Home Assistant [Realtime ETF stock data via WebSocket]

hacs_badge hainstall Wero wise Revolut PayPal github BuyMeCoffee

Disclaimer

Please be aware that we are developing this integration to the best of our knowledge and belief, but can't give a guarantee. Therefore, use this integration at your own risk.

Step I: Install the integration

Option 1: via HACS

Open your Home Assistant instance and adding repository to HACS.

or  you need to add this custom repository to HACS via:

  1. Open HACS
  2. Go to Integrations
  3. Click ⋮ → Custom repositories
  4. Add:
    - Repository: https://github.com/marq24/ha-justetf-live
    - Type: Integration
  1. Use the search bar and start typing justETF live ...
  2. Use the 3-dots at the right of the list entry (not at the top bar!) to download/install the custom integration — the latest release version is automatically selected. Only select a different version if you have specific reasons.
  3. After you press download and the process has completed, you must Restart Home Assistant to install all dependencies
  4. Setup the evcc custom integration as described below (see Step II: Adding or enabling the integration)

Option 2: manual steps

  1. Using the tool of choice, open the directory (folder) for your HA configuration (where you find configuration.yaml).
  2. If you do not have a custom_components directory (folder) there, you need to create it.
  3. In the custom_components directory (folder) create a new folder called justetf_live.
  4. Download all the files from the custom_components/justetf_live/ directory (folder) in this repository.
  5. Place the files you downloaded in the new directory (folder) you created.
  6. Restart Home Assistant
  7. Setup the justETF live integration as described below (see Step II: Adding or enabling the integration)

Step II: Adding or enabling the integration

You must have installed the integration (manually or via HACS before)!

Option 1: My Home Assistant (2021.3+)

Just click the following Button to start the configuration automatically (for the rest see Option 2: Manually step by step):

Open your Home Assistant instance and start setting up a new integration.

Option 2: Manually — step by step

Use the following steps for a manual configuration by adding the custom integration using the web interface and follow instruction on screen:

  • Go to Configuration -> Integrations and add "justETF live - Realtime ETF stock data via WebSocket" integration

Common further steps

To track a new ETF, you need to specify the ISIN of the ETF. Use the https://justetf.com/ website to find the ISIN of the ETF you want to track.

Please note that some of the available sensors are not enabled by default.

Enjoying this integration? ⭐ Star the repo!