Skip to content

Commit

Permalink
Merge pull request #119 from pachi81/readme
Browse files Browse the repository at this point in the history
Update README.md
  • Loading branch information
pachi81 committed Feb 21, 2024
2 parents 46b5b0d + 5b0a188 commit 42f63f5
Show file tree
Hide file tree
Showing 15 changed files with 165 additions and 281 deletions.
53 changes: 1 addition & 52 deletions GlucoDataAuto.md
Original file line number Diff line number Diff line change
@@ -1,52 +1 @@
[<img src='images/de.png' height=10> Deutsche Version](GlucoDataAuto_DE.md)
[<img src='images/pl.png' height=10> Wersja polska](GlucoDataAuto_PL.md)

# Android Auto

As the Android Auto part of GlucoDataHandler does not fullfill Google PlayStore policies, this part has been moved to an extra app called GlucoDataAuto, which receives its settings and values from GlucoDataHandler.

It can also be used as standalone application for Juggluco or xDrip+.

Install last GlucoDataAuto_X.X.X.apk from [Releases](https://github.com/pachi81/GlucoDataHandler/releases)

## Option #1: Using dummy media player
If you are not using any Android Auto media player for listen music, you can use GlucoDataHandler to display its values in the media tap:

<img src='images/AA_media.png' width=300>

IMPORTANT: it is recommended to disable all other media apps in the Android Auto launcher, to get this to work.

## Option #2: Using notifications

You can also use notifications:

<img src='images/AA_notification.png' width=300> <img src='images/AA_notification_view.png' width=300>

## Option #3: Using the app

<img src='images/AA_App.png' width=300>

# Setup Android Auto

To activate GlucoDataHandler for Android Auto, you have to do the following steps:

## 1. Activate developer mode

* open Android Auto app
* scroll down to the Version
* tap several times on the Version until a popup appears to "Allow development settings"
* press "OK"

## 2. Activate "Unknwon sources"

* open Android Auto app
* open in the 3-dot menu the "Developer settings"
* scroll down to "Unknown source"
* enable it

## 3. Set Notifications settings

* open Android Auto app
* scroll down to "Notifications"
* enable "Show conversations"
* enable "Show first line of conversations"
Content has moved to [GlucoDataAuto-repository](https://github.com/pachi81/GlucoDataAuto/blob/main/README.md)
55 changes: 1 addition & 54 deletions GlucoDataAuto_DE.md
Original file line number Diff line number Diff line change
@@ -1,54 +1 @@
[<img src='images/en.png' height=10> English version](GlucoDataAuto.md)
[<img src='images/pl.png' height=10> Wersja polska](GlucoDataAuto_PL.md)

# Android Auto

Nachdem der Android Auto Teil gegen die Richtlinien von Google Play verstosen hat, wurde dieser Teil in eine extra App namens GlucoDataAuto ausgelagert.
Diese App empfäng sowohl die Glukosewerte, als auch die Einstellungen von GlucoDataHandler.

Alternativ kann sie auch als eigenständige App für Juggluco oder xDrip+ verwendet werden.

Installiere die letzte GlucoDataAuto_X.X.X.apk von [hier](https://github.com/pachi81/GlucoDataHandler/releases)

## Option #1: Dummy Media Player
Wenn sie nicht über Android Auto Musik hören, können sie die Media Player Unterstützung verwenden:

<img src='images/AA_media.png' width=300>

WICHTIG: da die App selber keine Musik abspielt, sollte man alle anderen Media Player aus dem Launcher entfernen, damit diese App entsprechend angezeigt wird.

## Option #2: Benachrichtigungen verwenden

Alternativ zum Media Player kann die Android Auto Benachrichtigung verwendet werden:

<img src='images/AA_notification.png' width=300> <img src='images/AA_notification_view.png' width=300>

INFO: das Benachrichtigungs Popup erscheint bei jedem neuen Wert.

## Option #3: APP verwenden

<img src='images/AA_App.png' width=300>

# Android Auto Installieren

Um GlucoDataHandler in Android Auto zu verwenden, müssen die folgende Schritte durchgeführt werden:

## 1. Entwicklereinstellungen aktivieren

* Android Auto App öffnen
* bis zu Version scrollen
* mehrfach auf Version drücken bis ein Popup mit "Entwicklereinstellungen zulassen" kommt
* "OK" drücken

## 2. "Unbekannte Quellen" aktivieren

* Android Auto App öffnen
* in den 3-Punkt Menü "Entwicklereinstellungen auswählen"
* bis zu "Unbekannte Quellen" scrollen und aktivieren

## 3. Benachrichtigungen aktivieren

* Android Auto App öffnen
* bis zu "Benachrichtigungen" scrollen
* "Unterhaltungen anzeigen" aktivieren
* "Erste Zeile einer Unterhaltung anzeigen" aktivieren
Inhalt ist in eigenes [GlucoDataAuto-Repository](https://github.com/pachi81/GlucoDataAuto/blob/main/README_DE.md) umgezogen...
53 changes: 1 addition & 52 deletions GlucoDataAuto_PL.md
Original file line number Diff line number Diff line change
@@ -1,52 +1 @@
[<img src='images/en.png' height=10> English version](GlucoDataAuto.md)
[<img src='images/de.png' height=10> Deutsche Version](GlucoDataAuto_DE.md)

# Android Auto

Ze względu na to, że część aplikacji GlucodataHandler dotycząca Android Auto nie spełnia wymagań polityk sklepu Google Play, została ona przeniesiona do dodatkowej aplikacji pod nazwą GlucoDataAuto, która odbiera ustawienia i wartości glukozy z GlucoDataHandler.

Może ona być też używana jako samodzielna aplikacja w połączeniu z Juggluco lub xDrip+.

Zainstaluj ostatnią wersję GlucoDataAuto_X.X.X.apk, którą znaleźć można w zakładce [Releases](https://github.com/pachi81/GlucoDataHandler/releases)

## Opcja nr 1: Korzystanie z fikcyjnego odtwarzacza multimediów
Jeśli nie używasz żadnego odtwarzacza multimedialnego w Android Auto do słuchania muzyki, możesz użyć aplikacji GlucoDataHandler, aby wyświetlić jego wartości w wiadomościach dotyczących multimediów:

<img src='images/AA_media.png' width=300>

WAŻNE: aby to działało, zaleca się wyłączenie wszystkich innych aplikacji multimedialnych w programie uruchamiającym Android Auto.

## Opcja nr 2: Użycie powiadomień

Można również korzystać z powiadomień:

<img src='images/AA_notification.png' width=300> <img src='images/AA_notification_view.png' width=300>

## Opcja nr 3: Korzystanie z aplikacji

<img src='images/AA_App.png' width=300>

# Konfiguracja Android Auto

Aby aktywować GlucoDataHandler dla Android Auto, należy wykonać następujące kroki:

## 1. Aktywacja trybu programisty

- otwórz aplikację Android Auto
- przewiń w dół do pozycji Wersja
- dotknij kilkakrotnie pozycji Wersja, aż pojawi się wyskakujące okienko „Zezwalaj na ustawienia programistyczne"
- naciśnij "OK"

## 2. Aktywuj „Nieznane źródła"

- otwórz aplikację Android Auto
- otwórz w menu (3 kropki) „Ustawienia programisty"
- przewiń w dół do pozycji „Nieznane źródło"
- włącz ją

## 3. Ustawienia powiadomień

- otwórz aplikację Android Auto
- przewiń w dół do pozycji „Powiadomienia"
- włącz „Pokazuj rozmowy"
- włącz „Pokazuj pierwszy wiersz rozmów"
Treść przeniesiono do [GlucoDataAuto-repository](https://github.com/pachi81/GlucoDataAuto/blob/main/README_PL.md)
18 changes: 0 additions & 18 deletions INSTALLATION.md
Original file line number Diff line number Diff line change
Expand Up @@ -13,24 +13,6 @@ Download and install `GlucoDataHandler.apk` (allow install from unknown source i

<img src='images/download.png' width=350>

### Configure Juggluco
If you are using Juggluco to receive glucose values, open Juggluco and enable `Glucodata broadcast` and select `de.michelinside.glucodatahandler` in Settings. Save and Ok.

<img src='images/broadcast.png' width=700>

### Configure xDrip+
If you are using xDrip+ to receive glucose values, open xDrip+, go to setting and select Inter-app settings
* Enable "Broadcast locally"
* Enable "Compatible Broadcast"
* Check "Identify receiver" to be empty or if there is already an entry, add a new line with `de.michelinside.glucodatahandler`

<img src='images/xDrip_InterAppSettings.png' width=340>

### Check mobile app
Open the app and wait for a glucose value to be displayed in the GlucoDataHandler app.

<img src='images/installed.png' width=400>

## 2 - Install GlucoDataHandler on your watch

Now download `GlucoDataHandler-Wear.apk` on your phone but **do not install it**.
Expand Down
19 changes: 0 additions & 19 deletions INSTALLATION_DE.md
Original file line number Diff line number Diff line change
Expand Up @@ -14,25 +14,6 @@ Lade die letzte Version von `GlucoDataHandler.apk` von [hier](https://github.com

<img src='images/download.png' width=350>

### Juggluco konfigurieren
Für die Benuzer von Juggluco, nach der Installation des GlucoDataHandler in den Juggluco Einstellungen den Punkt `Glucodata broadcast` aktivieren und `de.michelinside.glucodatahandler` auswählen.
Anschließend speichern und mit OK beenden.

<img src='images/broadcast.png' width=700>

### xDrip+ konfigurieren
Für die Benutzer von xDrip+, in den Einstellung den Eintrag Inter-App Einstellungen öffnen und wie folgt konfigurieren:
* "Lokaler Broadcast" aktivieren
* "Kompatible Broadcast" aktivieren
* prüfen, ob "Identifiziere Empfänger" leer ist; ist bereits ein Eintrag vorhanden, dann eine neue Zeile mit `de.michelinside.glucodatahandler` hinzufügen

<img src='images/de/xDrip_InterAppSettings.png' width=340>

### Installation prüfen
Nun die GlucoDataHandler App öffnen und warten, bis ein neue Werte empfangen wurde.

<img src='images/de/installed.png' width=400>

## 2 - Installation GlucoDataHandler auf dem Smartwatch

Die Datei `GlucoDataHandler-Wear.apk` auf das Telefon laden, aber **nicht installieren.**.
Expand Down
22 changes: 0 additions & 22 deletions INSTALLATION_PL.md
Original file line number Diff line number Diff line change
Expand Up @@ -14,28 +14,6 @@ Pobierz i zainstaluj `GlucoDataHandler.apk` (w razie potrzeby zezwól na instala

<img src='images/download.png' width=350>

### Konfiguracja Juggluco

Jeśli używasz Juggluco do odbierania wartości glukozy, otwórz Juggluco i włącz w Ustawieniach opcję `Glucodata broadcast` i wybierz `de.michelinside.glucodatahandler`. Zapisz i OK.

<img src='images/broadcast.png' width=700>

### Konfiguracja xDrip+

Jeśli używasz xDrip+ do odbierania wartości glukozy, otwórz xDrip+, przejdź do ustawień i wybierz Ustawienia innych aplikacji

- Włącz opcję „Nadawaj lokalnie"
- Włącz opcję „Kompatybilny Broadcast"
- Sprawdź czy opcja „Identyfikuj odbiornik" jest pusta

<img src='images/xDrip_InterAppSettings.png' width=340>

### Sprawdź aplikację na telefonie

Otwórz aplikację i poczekaj na wyświetlenie wartości glukozy w aplikacji GlucoDataHandler.

<img src='images/installed.png' width=400>

## 2 – Zainstaluj GlucoDataHandler na swoim zegarku

Pobierz teraz aplikację `GlucoDataHandler-Wear.apk` na swój telefon, ale nie instaluj jej.
Expand Down
39 changes: 18 additions & 21 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,14 +4,15 @@
# Glucose Data Handler
## Features

* receives glucose values as **[LibreLink follower](#librelink)**
* receives glucose values from Nightscout
* receives glucose values from Juggluco
* receives glucose values from xDrip+
* receives glucose values as **[LibreLink follower](./SOURCES.md#librelink)**
* receives glucose, IOB and COB values from Nightscout (pebble interface)
* receives glucose, IOB and COB values from [AndroidAPS](./SOURCES.md#androidaps)
* receives glucose values and IOB from [Juggluco](./SOURCES.md#juggluco)
* receives glucose values from [xDrip+](./SOURCES.md#xdrip)
* provides several **[widgets](#widgets)** and a floating widget for the phone
* provides optional **[notifications](#notifications)** with different icons for the phone
* provides several **[complications](#complications)** for Wear OS
* provides **[Android Auto](./GlucoDataAuto.md)** support using GlucoDataAuto.apk
* provides **[Android Auto](https://github.com/pachi81/GlucoDataAuto/blob/main/README.md)** support using [GlucoDataAuto app](https://github.com/pachi81/GlucoDataAuto/releases)
* **[Tasker](#tasker)** integration
* sends glucodata broadcasts to other apps (which supports this broadcast)

Expand All @@ -22,7 +23,11 @@ You can download the current version [here](https://github.com/pachi81/GlucoData

## Installation

-> [Installation instruction](./INSTALLATION.md)
-> [Manual installation instruction](./INSTALLATION.md)

## Sources

-> [Source configuration instruction](./SOURCES.md)

## Settings

Expand All @@ -39,21 +44,6 @@ You can download the current version [here](https://github.com/pachi81/GlucoData

The settings for the phone are described in the app itself. The settings from the phone will be send to the wear, if it is connected.

## Sources

### LibreLink

To set up LibreLink as follower, you need the account data from LibreLinkUp.
If you have not set up your LibreLinkUp account yet, follow this [instruction](https://librelinkup.com/articles/getting-started).

Here is a quick summary of the steps to do:
* open your FreeStyle Libre App and select in the menu `Share` or `Connected Apps`
* activate LibreLinkUp connection
* install LibreLinkUp from [PlayStore](https://play.google.com/store/apps/details?id=org.nativescript.LibreLinkUp)
* setup your accout and wait for the invitation
* after accept the invitation you do not need the LibreLinkUp App "anymore"
* now you can add your LibreLinkUp account to GlucoDataHandler and activate this source

## Widgets
There are several types of widgets and a floating widget for the phone:

Expand Down Expand Up @@ -98,6 +88,13 @@ Also the RANGE_VALUE complication is handled different in each watchface.

-> [Tasker support](./TASKER.md)

# Special thanks
@[lostboy86](https://github.com/lostboy86) for testing, motivation and feedback

@[froter82](https://github.com/froster82) for Polish translation, testing and feedback

@nevergiveup for testing and feedback

# Support my work
[🍺 Buy me a beer](https://www.buymeacoffee.com/pachi81)

Expand Down
34 changes: 14 additions & 20 deletions README_DE.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,14 +4,15 @@
# Glucose Data Handler
## Features

* empfängt Glukose Werte als **[LibreLink Follower](#librelink)**
* empfängt Glukose Werte von Nightscout
* empfängt Glukose Werte von Juggluco
* empfängt Glukose Werte von xDrip+
* empfängt Glukose Werte als **[LibreLink Follower](./SOURCES_DE.md#librelink)**
* empfängt Glukose, IOB und COB Werte von Nightscout (Pebble Schnittstelle)
* empfängt Glukose, IOB und COB Werte von **[AndroidAPS](./SOURCES_DE.md#androidaps)**
* empfängt Glukose Werte und IOB von **[Juggluco](./SOURCES_DE.md#juggluco)**
* empfängt Glukose Werte von **[xDrip+](./SOURCES_DE.md#xdrip)**
* stellt mehrere **[Widgets](#widgets)** für Android zur Verfügung
* optionale **[Benachrichtigungen](#benachrichtigungen)** um weitere Statusbar-Icons zur Verfügung zu haben
* stellt mehrere **[Complications](#complications)** für Wear OS zur Verfügung
* unterstützt **[Android Auto](./GlucoDataAuto_DE.md)** über die GlucoDataAuto APP
* unterstützt **[Android Auto](https://github.com/pachi81/GlucoDataAuto/blob/main/README_DE.md)** über die [GlucoDataAuto App](https://github.com/pachi81/GlucoDataAuto/releases)
* **[Tasker Ereignisse](#tasker)** Integration
* sendet Glucodata Broadcasts an andere Apps (die dies unterstützen)

Expand All @@ -24,6 +25,10 @@ Die neuste Version kann [hier](https://github.com/pachi81/GlucoDataHandler/relea

-> [Installationsanleitung](./INSTALLATION_DE.md)

## Quellen

-> [Konfiguration der Quellen](./SOURCES_DE.md)

## Einstellungen

### Smartwatch
Expand All @@ -40,21 +45,6 @@ Die neuste Version kann [hier](https://github.com/pachi81/GlucoDataHandler/relea

Die einzelnen Einstellungen sind in der App entsprechend beschrieben. Sobald die Smartwatch verbunden ist, werden die Einstellungen übermittelt.

## Quellen

### LibreLink

Um LibreLink zu verwenden wird ein LibreLinkUp Konto benötigt.
Wenn noch keines erstellt wurde, folgen Sie bitte dieser [Anleitung](https://librelinkup.com/articles/getting-started).

Eine kleiner Zusammenfassung der Schritte, welche zu erledigen sind:
* FreeStyle Libre App öffnen und unter `Verbinden` auf `Teilen` oder `Verbundene Anwendungen` klicken
* hier muss der LibreLinkUp eingerichtet werden
* danach die LibreLinkUp App aus dem [PlayStore](https://play.google.com/store/apps/details?id=org.nativescript.LibreLinkUp) installieren
* in der LibreLinkUp App einloggen und die Einladung annehmen
* danach wird die LibreLinkUp App nicht mehr zwingend benötigt und kann wieder deinstalliert werden
* jetzt können die LibreLinkUp Kontodaten in GlucoDataHandler hinterlegt und die Quelle aktiviert werden

## Widgets
Es gibt verschiedene Arten von Widgets und ein schwebendes Widget:

Expand Down Expand Up @@ -98,6 +88,10 @@ Die Wear OS version stellt mehrere Complications zur Verfügung:

-> [Tasker Integration](./TASKER.md)

# Danksagung
@[lostboy86](https://github.com/lostboy86) fürs Testen, Motivieren und dein Feeback

@[froter82](https://github.com/froster82) für die polnische Übersetzung, fürs Testen und dein Feeback

# Unterstützt meine Arbeit
[🍺 Buy me a beer](https://www.buymeacoffee.com/pachi81)
Expand Down
Loading

0 comments on commit 42f63f5

Please sign in to comment.