VollaHub - Android App für Support und die Volla-Community

Aus Volla Wiki
Zur Navigation springen Zur Suche springen

VollaHub

VollaHub ist eine Community-App für das Volla Phone, entwickelt von tux4us. Sie bündelt mehrere nützliche Funktionen rund um das Gerät, die Community und Standortfunktionen in einer einzigen Anwendung. Der Quellcode ist öffentlich auf GitHub verfügbar.

Übersicht

VollaHub besteht aus sechs Hauptbereichen, die über die Startseite der App erreichbar sind:

  1. Geräte-Report – Erstellt detaillierte Berichte zur Hardware und zum Systemstatus für zielgerichtete Supportanfragen
  2. Ortung – Gegenseitige Standortfreigabe zwischen Geräten via eigenem WebDAV-Server - 100% Privatsphäre
  3. HelpBot – Intelligente Suchfunktion über Wiki, Forum und Online-Quellen
  4. Volla Blog – Aktuelle Beiträge vom offiziellen Volla-Blog
  5. Volla Wiki – Direktzugang zum Community-Wiki
  6. Volla Forum – Direktzugang zum offiziellen Forum

Daneben gibt es schnelle Links zu YouTube, GitHub sowie den Volla-Social-Media-Kanälen (Telegram, X, Facebook, Instagram, Mastodon).

---

Funktionen im Detail

Geräte-Report

Der Geräte-Report erfasst automatisch umfangreiche Systeminformationen des Volla Phones und bereitet sie als strukturierten Bericht auf. Die Funktion ist besonders nützlich für die Fehlersuche oder die Weitergabe von Systeminformationen an den Support.

Erfasste Daten

Der Report beinhaltet folgende Informationen:

  • Basisdaten: Hersteller, Modell, Gerätename, Board, Hardware, Android-Version, SDK-Version, Build-ID
  • Energie: Aktueller Ladestand in Prozent, Akkuzustand (Gut / Überhitzt / Defekt)
  • Arbeitsspeicher (RAM): Gesamtgröße, verfügbarer Speicher, Low-Memory-Status, Schwellenwert
  • System: Build-Fingerprint, aktiver Launcher mit Paketname und Version
  • Statusindikatoren:
    • Shelter / Arbeitsprofil aktiv (wird automatisch erkannt)
    • Sicherheitsmodus aktiv (manuell setzbar)
    • VPN aktiv (wird automatisch erkannt)

RAM-Verlaufschart

Die App zeigt ein Echtzeit-Diagramm der RAM-Auslastung, das alle 5 Sekunden aktualisiert wird. Die letzten 5 Minuten werden als Kurve dargestellt und können als Seite in den PDF-Export eingebettet werden.

Fotos anhängen

Über den Button Foto hinzufügen können beliebig viele Bilder aus der Galerie ausgewählt und dem Bericht beigefügt werden. Jedes Bild erscheint als eigene Seite im PDF.

Export und Weitergabe

Aktion Beschreibung
Teilen Öffnet den Android-Teilen-Dialog mit dem Berichtstext als Klartext (z. B. per E-Mail, Signal, Telegram)
Als PDF speichern Erstellt eine mehrseitige PDF-Datei unter Dokumente/Volla/VollaReport_[Zeitstempel].pdf
Spezifikationen kopieren Kopiert nur den technischen Datenblock in die Zwischenablage

Bericht-Historie

Alle gespeicherten Berichte werden lokal auf dem Gerät archiviert und sind über Bericht-Historie jederzeit abrufbar. Ältere Berichte können einzeln gelöscht oder erneut geöffnet und geteilt werden.

---

Ortung

Die Ortungsfunktion ermöglicht die gegenseitige Standortfreigabe zwischen mehreren Geräten über einen gemeinsamen WebDAV-Server. Alle Geräte, die denselben WebDAV-Zugang verwenden, sehen sich gegenseitig auf einer interaktiven Karte.

Funktionsprinzip

Jedes Gerät lädt seinen aktuellen GPS-Standort alle 60 Sekunden als JSON-Datei auf den WebDAV-Server hoch. Die Datei wird im Verzeichnis VollaHub/ abgelegt und trägt den Gerätenamen als Teil des Dateinamens. Beim Schließen der Freigabe wird die eigene Datei automatisch gelöscht.

Die JSON-Datei enthält folgende Felder: 


 "deviceId": "Volla_X23_a1b2c3d4",
 "label": "Mein Volla",
 "lat": 53.550341,
 "lon": 10.000654,
 "accuracy": 12.5,
 "timestamp": 1750000000000,
 "batteryLevel": 78

Kartenansicht

Die Karte basiert auf OSMDroid mit OpenStreetMap-Kartenmaterial. Sie zeigt:

  • Den eigenen Standort (blauer Punkt, folgt automatisch bei aktiver Freigabe)
  • Andere Geräte als farbige Marker mit Namensschild
    • Roter Marker = zuletzt aktiv (innerhalb der letzten 10 Minuten)
    • Grauer Marker = inaktiv / veraltet (länger als 10 Minuten kein Update)
  • Eine Maßstabsleiste

Die Karte aktualisiert sich automatisch alle 60 Sekunden. Über den Button 🔄 Karte kann manuell sofort aktualisiert werden.

Geräteliste

Unterhalb der Karte erscheint eine Liste aller gefundenen Geräte mit:

  • Anzeigename und Aktivitätsstatus
  • Zeit seit dem letzten Standort-Update
  • Entfernung zum eigenen Standort
  • GPS-Koordinaten (Latitude / Longitude)
  • Akkustand in Prozent (farbig: grün > 50 %, gelb > 20 %, rot ≤ 20 %)

Über die Buttons je Gerät:

Button Funktion
🧭 Route Berechnet eine Route zum gewählten Gerät und zeichnet sie auf der Karte ein
🔗 Teilen Teilt den Standort als OSM-Link und Geo-URI über den Android-Teilen-Dialog

Wenn eine Route aktiv ist, zeigt die App Entfernung und geschätzte Gehzeit in einer Leiste am unteren Kartenrand an. Die Route wird automatisch neu berechnet, wenn man sich mehr als 40 Meter von der geplanten Strecke entfernt. Über 🧭 Stopp wird die Navigation beendet.

Für die Routenberechnung stehen zwei Profile zur Auswahl:

  • 🥾 Zu Fuß (Standard)
  • 🚲 Fahrrad

Ist kein Routing-Server erreichbar, wird stattdessen eine gestrichelte gerade Linie zum Ziel gezeichnet.

Hintergrunddienst

Die Standortfreigabe läuft als Android-Foreground-Service und bleibt auch aktiv, wenn die App geschlossen wird. In der Benachrichtigungsleiste erscheint eine dauerhafte Benachrichtigung 📍 Ortung aktiv mit Zeitstempel des letzten Uploads. Ein Tap auf die Benachrichtigung öffnet die Ortungsansicht direkt.

Anzeigename

Im Feld Anzeigename kann ein frei wählbarer Name eingegeben werden, der anderen Geräten auf der Karte angezeigt wird. Der Name wird lokal gespeichert und beim nächsten Start der App automatisch wiederhergestellt.

---

HelpBot

Der HelpBot ist eine integrierte Suchfunktion, die Anfragen gleichzeitig in drei Quellen auswertet:

  • Volla Wiki (wiki.volla.online)
  • Volla Forum (forum.volla.online)
  • Online-Suche (volla.online)

Die Ergebnisse werden als anklickbare Karten zurückgegeben. Ein Tap auf ein Ergebnis öffnet den entsprechenden Artikel oder Forenbeitrag direkt in der App.

---

Blog

Der Blog-Bereich zeigt die aktuellen Beiträge vom offiziellen Volla-Blog. Auf der Startseite von VollaHub wird zusätzlich automatisch der neueste Blogartikel mit Titel und Kurztext eingeblendet.

Die App prüft im Hintergrund regelmäßig auf neue Beiträge. Erscheint ein neuer Artikel, wird eine Android-Benachrichtigung angezeigt.

---

Wiki

Direktzugang zu wiki.volla.online innerhalb der App, ohne Browser-Wechsel.

---

Forum

Direktzugang zum offiziellen Volla-Community-Forum innerhalb der App.

---

WebDAV-Einrichtung

Die WebDAV-Verbindung ist Voraussetzung für die Ortungsfunktion. Sie muss einmalig eingerichtet werden und wird anschließend dauerhaft gespeichert.

Was ist WebDAV?

WebDAV (Web Distributed Authoring and Versioning) ist ein erweitertes HTTP-Protokoll, das den Zugriff auf Dateien auf einem Server ermöglicht. VollaHub nutzt es als einfachen, datenschutzfreundlichen Kanal, um Standortdateien zwischen Geräten auszutauschen – ohne Cloud-Konto und ohne Drittanbieter.

Voraussetzungen

Für die Nutzung der Ortungsfunktion wird benötigt:

  • Ein WebDAV-fähiger Server (selbst gehostet oder bei einem Anbieter)
  • Server-URL (z. B. https://mein.server.de/remote.php/dav/files/nutzername)
  • Benutzername
  • Passwort

Alle Geräte, die sich gegenseitig sehen sollen, müssen dieselben WebDAV-Zugangsdaten verwenden.

Geeignete Server

Anbieter / Software Hinweise
Nextcloud Empfohlen. Selbst zu hosten oder bei einem Anbieter. WebDAV-Pfad: /remote.php/dav/files/[Benutzername]/
ownCloud Kompatibel. WebDAV-Pfad: /remote.php/webdav/
Hetzner Storage Box Kompatibel. Einfache, günstige Option für Selbsthosting
Apache / Nginx mit WebDAV-Modul Fortgeschritten. Vollständige Kontrolle über den Server
IONOS HiDrive Kompatibel. Kommerzielle Option mit WebDAV-Unterstützung

Hinweis: Es wird empfohlen, ausschließlich HTTPS-Verbindungen zu verwenden. HTTP-Verbindungen übertragen Zugangsdaten und Standortdaten unverschlüsselt.

Einrichtungsschritte in der App

Schritt 1: Ortung öffnen

Tippe auf der Startseite auf den Button Ortung. Falls noch keine WebDAV-Daten hinterlegt sind, erscheint ein Hinweisfeld:

⚠️ WebDAV nicht eingerichtet. Bitte Zugangsdaten hinterlegen.

Tippe auf WebDAV einrichten.

Schritt 2: Zugangsdaten eingeben

Es öffnet sich ein Dialog mit drei Feldern:

Feld Beispiel Pflicht
Server-URL https://cloud.meinserver.de/remote.php/dav/files/alice/ Ja
Benutzername alice Ja
Passwort •••••••• Nein (bei öffentlichen Ordnern)

Wichtig: Die Server-URL muss auf das WebDAV-Wurzelverzeichnis des Nutzers zeigen. VollaHub legt darunter automatisch den Unterordner VollaHub/ an.

Schritt 3: Verbindung testen

Über den Button Verbindung testen prüft die App sofort, ob der Server erreichbar ist und die Zugangsdaten korrekt sind. Das Ergebnis wird direkt im Dialog angezeigt:

  • ✅ Verbindung erfolgreich! – Alles in Ordnung, weiter mit Speichern
  • ❌ Verbindung fehlgeschlagen – URL, Benutzername oder Passwort überprüfen

Schritt 4: Speichern

Tippe auf Speichern. Die Zugangsdaten werden lokal im internen Speicher des Geräts gespeichert (Android SharedPreferences, App-privat).

Nach dem Speichern ist der Schalter Standort teilen aktiv und kann eingeschaltet werden.

Zugangsdaten ändern oder löschen

Die WebDAV-Einstellungen sind jederzeit über das Menü ⋮ in der Ortungsansicht erreichbar (Menüpunkt WebDAV-Einstellungen). Dort kann:

  • Die Verbindung erneut getestet werden
  • Die URL, der Benutzername oder das Passwort geändert werden
  • Alle Zugangsdaten über Zugangsdaten löschen entfernt werden (nach Bestätigungsdialog)

Technisches Hintergrundwissen

Verwendete WebDAV-Methoden

VollaHub verwendet folgende Standard-HTTP/WebDAV-Methoden:

Methode Verwendung
PUT Eigenen Standort hochladen (alle 60 Sekunden)
GET Standortdateien anderer Geräte herunterladen
DELETE Eigene Standortdatei beim Beenden der Freigabe löschen
PROPFIND (Depth: 1) Verzeichnisinhalt auflesen (welche Geräte sind aktiv?)
MKCOL Ordner VollaHub/ anlegen, falls noch nicht vorhanden

Dateistruktur auf dem Server

[WebDAV-Root]/
└── VollaHub/
    ├── location_VollaX23_a1b2c3d4.json   ← Gerät 1
    ├── location_VollaX_ff001122.json      ← Gerät 2
    └── location_Pixel7_deadbeef.json      ← Gerät 3

Jedes Gerät legt genau eine JSON-Datei an. Der Dateiname setzt sich zusammen aus dem Gerätemodell (max. 20 Zeichen, Leerzeichen durch Unterstriche ersetzt) und den ersten 8 Zeichen der Android-ID.

Netzwerkbibliothek

VollaHub verwendet OkHttp 5 für alle WebDAV-Anfragen. Die Verbindung verwendet:

  • TLS/HTTPS (empfohlen und Standard)
  • HTTP Basic Authentication (Base64-kodiert)
  • Timeouts: 15 Sekunden für Verbindungsaufbau, Lesen und Schreiben

Häufige Fehlerursachen

Fehlerbild Mögliche Ursache Lösung
❌ Verbindung fehlgeschlagen Falsche URL (kein https://, Tippfehler) URL genau prüfen, inkl. Protokoll
❌ Verbindung fehlgeschlagen Falsches Passwort Passwort in Nextcloud/ownCloud zurücksetzen
Keine anderen Geräte sichtbar Unterschiedliche WebDAV-Zugangsdaten Alle Geräte müssen identische Server-URL + Benutzername + Passwort verwenden
Standort veraltet (grauer Marker) GPS auf dem sendenden Gerät inaktiv Standortdienste auf dem betroffenen Gerät aktivieren
Kein Upload trotz aktiver Freigabe Netzwerkverbindung unterbrochen WLAN oder mobiles Datennetz prüfen
Ordner VollaHub/ nicht vorhanden Erster Start Wird automatisch beim ersten Upload angelegt

Datenschutz-Hinweise

  • Standortdaten liegen ausschließlich auf dem selbst gewählten Server – keine Drittanbieter, keine Cloud
  • Zugangsdaten werden nur lokal auf dem Gerät gespeichert, nie übertragen
  • Die eigene Standortdatei wird beim Deaktivieren der Freigabe automatisch vom Server gelöscht
  • Es empfiehlt sich, einen dedizierten WebDAV-Benutzer mit eingeschränkten Rechten (nur Lesen/Schreiben im VollaHub/-Verzeichnis) anzulegen

---

Installation

Die App ist nicht im Google Play Store verfügbar. Sie kann über folgende Wege installiert werden:

  • APK direkt: Releases auf GitHub Releases
  • Aus dem Quellcode bauen: Android Studio, Gradle, Kotlin erforderlich

Benötigte Android-Berechtigungen

Berechtigung Grund
INTERNET WebDAV-Verbindung, Blog, Wiki, Forum
ACCESS_FINE_LOCATION GPS-Standort für die Ortungsfunktion
ACCESS_COARSE_LOCATION Netzwerkbasierte Standortbestimmung als Fallback
FOREGROUND_SERVICE Hintergrunddienst für die Standortfreigabe
FOREGROUND_SERVICE_LOCATION Standortzugriff im Hintergrund (Android 10+)
POST_NOTIFICATIONS Blog-Benachrichtigungen bei neuen Artikeln

---

Technische Details

Komponente Bibliothek / Version
HTTP / WebDAV OkHttp 5.3.2
Kartendarstellung OSMDroid 6.1.20
JSON-Serialisierung Gson 2.13.1
Routenberechnung OpenRouteService API (foot-hiking, cycling-regular)
Hintergrundjobs AndroidX WorkManager
Mindest-Android Android 8.0 (API 26)

---

Abgerufen von „http://wiki.volla.online/index.php?title=VollaHub_-_Android_App_für_Support_und_die_Volla-Community&oldid=6484“