Skip to content

A Simple DeepLink forwarding when reading customized QR Code aimed at Home Assistant Companion Android app.

Notifications You must be signed in to change notification settings

diyoyo/HAQRHelper

Repository files navigation

Logo

HA QR Helper

This is a very small Android application that performs a simple string substitution when scanning QR Code.

Instead of generating new QR Codes dedicated to your new **Home Assistant** instance, you can reuse previously generated codes with a different prefix.

How to use it

  1. Go to app/build.gradle.kts and edit the following strings:

    • baseUrl : your personal url prefix that already populates your QR codes
    • tag : the suffix that is appended after BASE_URL and before the tag ID
    • haUrl: the deeplink prefix used by Home Assistant Companion app on Android.

    The templating makes this the only region in the app folder where you need to modify things.

  2. Build and run in Android Studio

  3. Once installed on your phone, you may need to go to the app settings and switch on the baseURL in the default definitions.

  4. Important note: the only rule here is that the TAG_ID of a given QRCode should match the one in Home Assistant.

    Don't leave the TAG ID field blank in the Home Assistant Companion app if you want this to work reliably!

  5. As of 2023-11-25, you can now click on the logo (or the QuickSettings tile) to launch an integrated ZXing QR Code reader that will trigger the HA event.

Credits

I used ChatGPT4 to generate most of the code, as well as drafts of the logo.

This is my solution to avoid touching at the Home-Assistant code while answering the needs described on the Home-Assistant forum

About

A Simple DeepLink forwarding when reading customized QR Code aimed at Home Assistant Companion Android app.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages