App, PWA & Offline

Tunetorch läuft in jedem aktuellen Browser. Für den Alltag auf dem Handy oder Rechner gibt es zwei weitere Möglichkeiten: die installierbare PWA und die Android-App.

PWA installieren

Du kannst Tunetorch auf Handy und Rechner zum Startbildschirm hinzufügen. Es öffnet sich dann in einem eigenen Fenster ohne Browser-Leiste.

Wie das geht, zeigt dir Einstellungen → Reiter „App“ → Installation. Dort steht genau das, was zu deinem Gerät passt:

Rechner: ein Hinweis auf Chrome/Edge und, sobald der Browser es anbietet, ein Knopf Jetzt installieren.
iOS: eine Anleitung („Teilen → Zum Home-Bildschirm“). Eine eigene iOS-App gibt es nicht.
Android: der Link zur Tunetorch-App im Play Store (siehe unten) und darunter die Web-App als Alternative.

Die Oberfläche und die Cover werden auf dem Gerät zwischengespeichert (Cover 30 Tage), die Musik selbst nicht. Updates kommen automatisch: Ein neuer Stand wird von selbst übernommen, und die App lädt neu.

Die PWA braucht einen Server, der über HTTPS erreichbar ist. Browser erlauben die dafür nötigen Service Worker nur über HTTPS oder localhost. Siehe Konfiguration → Reverse-Proxy.

Native Android-App

Auf Android ist die App die bessere Wahl. Sie spielt unabhängig vom Browser und läuft auch im Hintergrund zuverlässig weiter, ohne dass du Akku-Ausnahmen einrichten musst.

Sie wird über den Google Play Store verteilt und dort auch aktualisiert. Den Link findest du unter Einstellungen → App → Installation. Dein Server muss dafür nichts bereitstellen.

Die App ist noch nicht im Store. Die Veröffentlichung läuft gerade, sie kommt bald. Bis dahin steht an der Stelle des Links ein Hinweis. Solange nutzt du Tunetorch auf Android als Web-App: Einmal auf den Startbildschirm gelegt, öffnet es sich in einem eigenen Fenster. Was dabei fehlt, steht im nächsten Abschnitt.

Beim ersten Start trägst du die Adresse deines Servers ein, also dieselbe, unter der du Tunetorch im Browser aufrufst. Die App kann mehrere Server verwalten.

Die Sprache der App richtet sich nach zwei Einstellungen. Was die App selbst zeigt (Server-Einrichtung, Server-Auswahl, Benachrichtigung und die Reiter in Android Auto), folgt der Systemsprache des Handys: Deutsch auf einem deutschen Gerät, sonst Englisch. Die Oberfläche deines Servers darin folgt deiner Einstellung unter Aussehen. Steht sie auf „Automatisch", ist beides dieselbe Sprache.

Der Reiter „App“

In den Benutzer-Einstellungen gibt es einen Reiter App. Was darin steht, hängt davon ab, wo du Tunetorch öffnest:

Im Browser und in der PWA steht dort die Rubrik Installation (siehe oben).
In der Android-App stehen dort die Einstellungen, die nur für dieses Gerät gelten und nicht mit dem Server abgeglichen werden: oben die App-Version, darunter die drei Speicher. Die Rubrik Installation fehlt hier, die App ist ja schon installiert.

Audio-Cache

Tunetorch speichert schon gehörte Titel auf dem Gerät. So laufen sie auch im Funkloch, und du sparst mobile Daten.

Zuletzt gehörte Titel zwischenspeichern (ab Werk aus) behält abgespielte Titel. Du legst fest, wie viele (10 bis 200). Ist die Grenze erreicht, fliegt der am längsten nicht gehörte Titel raus.
Belegter Speicher und Anzahl der Titel aktualisieren sich, während du hörst.
Cache leeren räumt auf.
Ändert sich das Original auf dem Server, wird die gespeicherte Fassung verworfen.

Downloads

Neben dem automatischen Cache kannst du einzelne Titel, ganze Alben oder alle Titel eines Interpreten dauerhaft offline speichern: Optionen-Menü (⋮) → Offline herunterladen. Du wählst dabei die Qualität (Original / Hohe Qualität / Kleine Datei). Während des Ladens zeigt ein kleiner Hinweis über der unteren Leiste den Fortschritt (bei mehreren Titeln „3 von 5") und meldet am Ende, dass die Titel offline verfügbar sind.

Anders als der Cache, der ältere Titel wieder verdrängt, bleiben Downloads, bis du sie selbst entfernst. Ohne Netz spielt die App sie von der gespeicherten Kopie, und die Statistik zählt trotzdem mit.

Verwalten kannst du sie unter App → Downloads. Dort siehst du Belegung und Anzahl, und der Knopf Verwalten öffnet eine Liste aller Downloads nach Album sortiert. Alben mit mehreren Titeln lassen sich aufklappen, bei jedem Titel stehen Qualität und Format. Du kannst einzelne Titel, ganze Alben oder alles auf einmal entfernen.

Cover-Cache

Album- und Interpret-Bilder speichert die App beim Anzeigen auf dem Gerät. Das macht das Blättern schneller und zeigt Cover auch offline. Belegung, Anzahl und einen Knopf Leeren findest du unter App → Cover-Cache.

Alle drei Speicher gelten nur für dieses Gerät und werden nicht mit dem Server abgeglichen.

Offline-Modus

Die App startet auch ohne Netz und zeigt dann nur, was offline abspielbar ist: deine Downloads und vollständig zwischengespeicherte, schon gehörte Titel.

Der Modus schaltet sich automatisch ein, sobald das Gerät offline ist. Ein kurzer Hinweis erscheint, und solange der Modus aktiv ist, zeigt ein Offline-Symbol am Benutzernamen das an. Kommt das Netz zurück, schaltet die App wieder um.

Du kannst ihn auch selbst einschalten, über Benutzermenü → Offline-Modus. Zum Beispiel, um vor einem Flug zu prüfen, was du unterwegs hören kannst.

Im Offline-Modus gilt:

Offline verfügbare Titel spielen unabhängig von der gewählten Qualitätsstufe. Es läuft immer die Kopie auf dem Gerät. Liegt ein Titel in mehreren Qualitäten vor, nimmt die App die beste. Die Qualitätsauswahl im Menü ist deshalb ausgeblendet.
Funktionen, die den Server brauchen (Hochladen, Statistik, Playlists, Favoriten, Bearbeiten, Löschen, Export), sind ausgeblendet.
Wiedergaben gehen nicht verloren. Die App merkt sie sich und trägt sie nach, sobald wieder Netz da ist. Statistik und Verlauf bleiben vollständig.

Mehrere Server

Damit du immer weißt, mit welchem Server du gerade verbunden bist, steht der Name, den du der Verbindung gegeben hast, ganz oben im Benutzermenü. Das gilt nur für die App. Im Browser siehst du die Adresse ja ohnehin in der Adresszeile.

Tippst du auf diesen Namen, öffnet sich die Server-Auswahl mit allen gespeicherten Verbindungen und ihrem Speicherverbrauch. Dort kannst du eine andere öffnen, eine bearbeiten oder entfernen oder eine neue anlegen. Du wirst dabei nicht abgemeldet: Gehst du mit der Zurück-Taste zurück, läuft alles weiter, auch die Musik. Erst wenn du eine andere Verbindung öffnest, startet die App damit neu.

Einen eigenen Eintrag „Abmelden" hat die App deshalb nicht. Die Server-Auswahl meldet dich beim Öffnen einer Verbindung ohnehin neu an. (Im Browser steht „Abmelden" wie gewohnt im Menü.)

Löschst du eine Verbindung, meldet die App dich zuerst beim Server ab. Deine Anmeldung dort ist damit sofort ungültig. Danach entfernt sie alle Downloads und Caches, die zu dieser Verbindung gehören. Ohne Netz entfällt nur die Abmeldung, gelöscht wird trotzdem.

Teilst du dein Handy mit anderen? Die App merkt sich zu jeder Verbindung Benutzername und Passwort. Wer die App öffnet, ist damit angemeldet und sieht deine Bibliothek. Willst du das verhindern, lösche die Verbindung, bevor du das Gerät weitergibst. Das ist der Weg, auf dem die App auch dein gespeichertes Passwort vergisst. Deine Downloads für diesen Server gehen dabei mit. Bei der nächsten Nutzung legst du die Verbindung einfach neu an.

Die App achtet außerdem auf die Ränder des Geräts (Status- und Navigationsleiste, Kameraloch), damit nichts verdeckt wird. Das gilt in jedem Layout, also auch auf dem Tablet im Querformat, wo die App die Desktop-Ansicht mit Kopfzeile und Seitenleiste zeigt.

Android Auto

Im Auto blätterst du dich über vier Reiter durch deine Bibliothek oder spielst per Sprachsuche ab. Die Oberfläche der App muss dafür auf dem Handy nicht geöffnet sein.

Reiter	Inhalt
Home	Ganz oben Weiterhören und Angefangene Hörbücher (siehe unten), darunter zuletzt hinzugefügte Alben, zuletzt gehörte Titel und Interpreten sowie die meistgehörten Interpreten, Titel und Alben. Diese Listen aktualisieren sich während der Fahrt.
Favoriten	Lieblings-Interpreten, -Alben und -Titel.
Playlists	Deine Playlists.
Datenbank	Die ganze Bibliothek nach Interpreten, Alben, Titeln, Genre und Jahr (Genre und Jahr jeweils unterteilt).

Weiterhören

Hast du am Handy Musik gehört und steigst ins Auto, spielt Tunetorch einfach weiter, solange die App noch läuft. Wurde sie inzwischen beendet (aus der Übersicht weggewischt, Handy neu gestartet), steht in Home ganz oben „Weiterhören". Ein Tipp darauf setzt die letzte Warteschlange fort, am selben Titel und an derselben Stelle. Dasselbe passiert, wenn du bei leerer Wiedergabe die Play-Taste am Lenkrad drückst.

Der Eintrag erscheint nur, wenn es etwas fortzusetzen gibt. Hast du die Warteschlange in der App geleert, fehlt er.
Mit der Einstellung „Mit neuer Playlist starten" (Benutzer-Einstellungen → Playlist) gibt es ihn nicht. Dort willst du ja ausdrücklich jedes Mal frisch beginnen.
Die Warteschlange gehört zu deinem Konto. Meldest du dich ab, ist sie weg, und wer sich danach auf dem Handy anmeldet, bekommt sie nicht angeboten.

Hörbücher im Auto

Hörbücher laufen im Auto wie in der App im Hörbuch-Modus: Tunetorch merkt sich die Stelle, und die Wiedergabe setzt immer dort fort. Das gilt auch, wenn du im Auto ein anderes Kapitel antippst, denn im Auto kann Tunetorch nicht nachfragen wie in der App. Ein bestimmtes Kapitel wählst du danach über die Warteschlange.

Unter Home → Angefangene Hörbücher stehen alle Hörbücher, die du angefangen hast, auch die aus dem Browser oder von einem anderen Gerät. Als Hörbuch erkennt das Auto ein Album, wenn es ein Hörbuch-Genre hat oder schon als Hörbuch angefangen wurde.

Hörbuch außerhalb der Hörbuch-Genres: Beim ersten Mal startest du es in der App, im Browser oder in der PWA über „Als Hörbuch abspielen". Im Auto direkt geht das nicht, dort gibt es kein Optionen-Menü. Danach erkennt das Auto es von selbst.

Außerdem

Eigene Streaming-Qualität fürs Auto (Benutzer-Einstellungen → Wiedergabe → Android Auto), unabhängig von der Qualität in der App.
Wiedergabe fortsetzen (ab Werk an): Tippst du einen Titel in einer Liste an, läuft die Liste ab diesem Titel weiter. Das gilt auch, wenn du ihn über eine Buchstaben-Gruppe (siehe unten) erreicht hast. Es läuft dann die ganze Liste weiter, nicht nur die Gruppe.
Lange Listen werden nach Buchstaben gruppiert. Android Auto kann nur Listen bis zu einer bestimmten Länge anzeigen. Ab 200 Einträgen zeigt Tunetorch deshalb zuerst eine Auswahl nach Anfangsbuchstaben (A · B · C … · # für Ziffern und Sonderzeichen) und darin die Einträge. Ist ein Buchstabe selbst zu voll (unter „S" kommen schnell ein paar hundert Interpreten zusammen), folgt eine Auswahl nach dem zweiten Buchstaben (Sa · Sb · Sc …) und bei Bedarf nach dem dritten. Buchstaben mit wenigen Einträgen führen direkt zur Liste. Wo die Reihenfolge wichtig ist (Playlists, „zuletzt gehört", Favoriten), wird stattdessen in Abschnitte geteilt („1–200", „201–400" …), damit die Reihenfolge erhalten bleibt.
In der Wiedergabeansicht steht ein Herz: Ein Tipp darauf nimmt den laufenden Titel in deine Favoriten auf oder wieder heraus. Ist das Herz gefüllt, ist der Titel schon ein Favorit. Dasselbe Herz findest du in der Benachrichtigung am Handy. Die App am Handy zeigt die Änderung, sobald sie die Bibliothek das nächste Mal lädt.
Cover erscheinen in allen Listen und bei der Wiedergabe. Lautstärke-Angleichung, Equalizer und das Zählen von Wiedergaben funktionieren wie in der App.
Tags stehen in eckigen Klammern hinter Titel- und Albumnamen („Wish You Were Here [Live]“), in den Listen wie bei der Wiedergabe. Farbige Etiketten wie in der App kann Android Auto nicht darstellen – es zeichnet alle Texte in seiner eigenen Schrift.
Kann die Bibliothek nicht geladen werden (etwa beim Start in einem Funkloch), steht statt leerer Listen oben im Reiter ein Eintrag mit dem Namen der Liste und dem Hinweis „Konnte nicht geladen werden · Tippen für neuen Versuch". Ein Tipp darauf versucht es noch einmal. Sobald das Handy wieder Empfang hat, lädt die App die Bibliothek von selbst nach.
Steht dort „Anmeldung nötig", hat der Server das gespeicherte Passwort abgelehnt – meist, weil es geändert wurde. Öffne dann die App am Handy: Sie zeigt direkt die Bearbeitung der Verbindung, dort trägst du das neue Passwort ein.
Die Bibliothek ist schon nach Konto gefiltert. Eingeschränkte Konten sehen nur ihre Freigaben. Dafür musst du vorher einmal in der App angemeldet gewesen sein. Läuft die Anmeldung ab (standardmäßig nach 7 Tagen ohne Nutzung), meldet sich die App im Auto mit dem gespeicherten Passwort selbst neu an – du musst dafür nicht ans Handy.

Hinweis: Hast du die App als APK-Datei installiert (statt aus dem Play Store), zeigt Android Auto sie nur an, wenn in den Entwickler-Optionen „Unbekannte Quellen“ aktiviert ist.