AudioStream - Radio & Player — Betriebsanleitung

OFFIZIELLE ANLEITUNG

AudioStream bedienen — von Radio bis NAS

AudioStream - Radio & Player verbindet Internetradio, Musik von deinem NAS und lokale Dateien in einer App. Ohne eigenen Server funktioniert Radio offline. Mit deinem Server synchronisierst du Favoriten, Playlists und Medien.

iOS & macOS Offline-Radio WebDAV-NAS Kein Server voreingestellt

Erste Schritte

Nach der Installation startet die App im Standalone-Modus — sofort Radio hören, ohne Konfiguration.

App öffnen — unten zwischen Radio und Medien wechseln.
Radio — Sender nach Land wählen oder oben suchen. Herz-Symbol speichert Favoriten lokal.
Medien — lokale Dateien importieren oder NAS per WebDAV hinzufügen (Einstellungen).
Optional: Server — nur wenn du ein eigenes Backend betreibst: URL in Einstellungen eintragen und Betriebsart wählen.

AUDIOSTREAM⚙

♥ GESPEICHERTE SENDER

Sender …

♥

Sender …

♥

🇩🇪 DEUTSCHLAND

Landessender …

RadioMedien

AUDIOSTREAM♥ ≡ ⚙

Titel
Künstler · NAS

Titel
Künstler · Lokal

RadioMedien

Betriebsarten

Unter Einstellungen → Betriebsart legst du fest, wie die App Daten bezieht.

Standalone

Standard nach Installation und Werkseinstellung. Radio über RadioBrowser (offline-fähig). Favoriten nur auf dem Gerät. NAS direkt per WebDAV ohne Backend.

Mit Server

Alles über deine API: Radio-Favoriten, Medien-Favoriten, Playlists, NAS-Browse. Erfordert eingetragene Server-URL.

Automatisch

Server nutzen wenn erreichbar, sonst Standalone-Verhalten für Radio. Praktisch für unterwegs.

Neue Nutzer starten ohne voreingestellte Server-URL. Jeder trägt seine eigene Adresse ein — es gibt keinen mitgelieferten Server.

Radio

Der Radio-Tab bündelt Kuratiertes, Favoriten, Länderauswahl und Online-Suche.

Gespeicherte Sender

Tippe auf ♥ bei einem Sender. Favoriten werden lokal gespeichert (Standalone) oder mit dem Server synchronisiert (verbundener Modus).

Länder & Suche

Wähle ein Land für regionale Sender. Die Lupe oben öffnet die Online-Suche über RadioBrowser bzw. deinen Server.

Now Playing & Metadaten

Während der Wiedergabe zeigt der Player Titel und Künstler aus dem Stream (ICY-Metadaten). Cover werden automatisch ermittelt.

Aktualisieren

Nach unten ziehen (Pull-to-Refresh) lädt Senderlisten und Favoriten neu.

Medien

Musik von NAS, Docker-API, iPhone, iCloud oder heruntergeladenen Dateien.

Quellen-Chips (oben)

Symbol	Quelle	Funktion
📱 iPhone	Lokal	Musik auf dem Gerät. Erneut tippen → Dateien hinzufügen.
Apple	iCloud	Import aus iCloud Drive. Erneut tippen → weitere Titel wählen.
🐳 Docker	NAS Musik	Musikbibliothek über Docker-API (eigene Domain in Einstellungen).
≡	NAS-Verbindungen	WebDAV/SMB-Quellen aus Einstellungen.
⚙	Einstellungen	Quellen, Server, Theme, Daten.

Ansicht & Sortierung (Medien-Leiste)

Rechts in der Navigationsleiste: ♥ Favoriten, Playlists, Ansicht.

Sortierung	Layout
Titel · Künstler · Jahr	Liste · Symbole klein/mittel/groß

Bei Sortierung Künstler oder Jahr werden Titel in Gruppen mit Überschriften angezeigt.

Lokale Dateien (iPhone)

Chip iPhone tippen oder Dateien-Dialog. MP3, M4A, FLAC, … — Cover aus eingebetteten ID3-Tags.

iCloud

Chip Apple tippen → iCloud-Dateiauswahl. Importierte Titel bleiben in der App-Sandbox; Cover aus den Audiodateien.

Docker NAS Musik

Eigene Musik-API auf dem NAS. Domain unter Einstellungen eintragen. API-Dokumentation →

Ordner durchsuchen (NAS)

Bei WebDAV-NAS: in Unterordner navigieren, Zurück-Pfeil oben links. Audiodateien antippen zum Abspielen.

Download von NAS

Einzelne Titel oder ganze Ordner auf das Gerät laden. Offline hören ohne NAS-Verbindung.

Aus Liste entfernen

Einträge können aus der Ansicht ausgeblendet werden, ohne die Datei auf dem Server zu löschen.

Nach Import oder Quellenwechsel zeigt die App sofort die gewählte Bibliothek — Lokal, iCloud oder NAS Musik.

NAS einrichten (WebDAV)

Im Standalone-Modus verbindet sich die App direkt per WebDAV — kein separates Backend nötig.

Einstellungen öffnen → NAS-Server hinzufügen.
Anzeigename vergeben (z. B. „Mein NAS“).
Protokoll WebDAV wählen (SMB erfordert Server-Modus).
Host/IP, Port, Basis-Pfad eintragen — typisch HTTPS Port 443 oder 9555.
Benutzername & Passwort — Passwort wird nur im Geräte-Keychain gespeichert.
Speichern — Verbindung erscheint unter Medien.

SMB funktioniert nur mit „Mit Server“ / „Automatisch“ und deinem eigenen Backend. Für Standalone immer WebDAV verwenden.

NAS-Verbindung löschen entfernt nur die Konfiguration auf dem Gerät — Dateien auf dem NAS bleiben erhalten.

Playlists & Medien-Favoriten

Playlists und serverseitige Medien-Favoriten erfordern einen konfigurierten Server.

Playlists

Medien-Tab → Playlist-Symbol. Neue Playlist mit + erstellen. Titel aus der Bibliothek hinzufügen. Mit Server synchronisieren (↻).

Medien-Favoriten

♥ bei einem NAS-Titel — erscheint unter Favoriten. Nur im verbundenen Server-Modus über alle Geräte synchron.

Player

Mini-Player unten, Vollbild per Antippen.

Steuerung	Bedeutung
▶ / ⏸	Wiedergabe / Pause
⏮ / ⏭	Vorheriger / nächster Titel (Medien)
AirPlay	Wiedergabe auf Lautsprecher / Apple TV
Wischen nach unten	Vollbild schließen

Radio-Streams laufen endlos. Bei Medien zeigt der Player Titel, Künstler und Cover (ID3 oder NAS-Metadaten).

Darstellung (Dunkel / Hell / System)

Einstellungen → Darstellung — Erscheinungsbild der gesamten App.

System

Folgt den iOS-/macOS-Einstellungen. Standard nach Werkseinstellung.

Dunkel

Immer Dark Mode — OLED-Hintergrund mit Glass-Effekten.

Hell

Immer Light Mode — helle Oberfläche mit angepassten Kontrasten.

Unter Farben (Premium) lassen sich Akzent, Toolbar und Favorit-Herz individuell einstellen.

Einstellungen

Zahnrad oben in Radio oder Medien.

Medien hinzufügen

Lokale Dateien, iCloud oder NAS-Verbindung anlegen.

NAS Musik API

Docker-Domain eintragen und testen. Details: Docker API Dokumentation.

Darstellung

System, Dunkel oder Hell — siehe Abschnitt Darstellung.

Farben

Akzent, Symbole, Favorit-Herz und Aktionsfarben anpassen (Premium). „Standardfarben wiederherstellen“ setzt das Theme zurück.

Eigenen Server einrichten

Optional — nur wenn du ein kompatibles AudioStream-Backend betreibst.

Betriebsart Mit Server oder Automatisch wählen.
API-URL eintragen, z. B. https://dein-server.example/api
Speichern, dann Verbindung testen (grüner Haken = OK).

Die App enthält keine voreingestellte Server-Adresse. Jeder Nutzer verwendet seinen eigenen Server oder bleibt im Standalone-Modus.

Werkseinstellung & Datenschutz

Für App Store und Datenschutz: alle persönlichen Daten auf dem Gerät löschen.

Einstellungen → Daten → Alle Daten löschen

Löscht unwiderruflich auf diesem Gerät:

Radio- & Medien-Favoriten (lokal)
NAS-Verbindungen & Keychain-Passwörter
Lokale Medien, Bookmarks, Downloads
Playlists (lokal)
Server-URL & Betriebsart (zurück auf Standalone)
Theme-Farben

Dein Server wird nicht berührt. Daten auf einem selbst betriebenen Backend bleiben erhalten. Nach dem Reset synchronisiert die App nicht automatisch — du musst Server-URL und Modus neu einrichten.

CarPlay (iOS)

Now Playing und Steuerung sind vorbereitet. Für die CarPlay-App im Auto ist das Apple CarPlay-Audio-Entitlement erforderlich (Vorlage: WebRadio.carplay.entitlements.example im Projekt).

Häufige Fragen

Warum sehe ich bei iCloud keine Cover?

Cover werden aus den ID3-Tags der importierten Audiodatei gelesen. Fehlt ein eingebettetes Bild, zeigt die App ein farbiges Platzhalter-Symbol.

Warum sehe ich nach dem Reset noch Daten?

Prüfe, ob Betriebsart noch „Mit Server“ / „Automatisch“ ist und eine URL eingetragen ist — dann lädt die App erneut vom Server. Nach Werkseinstellung ist Standalone aktiv und die URL leer.

Radio ohne Internet?

Im Standalone-Modus funktioniert Radio über RadioBrowser (Netz nötig für Senderliste). Gespeicherte Stream-URLs in Favoriten können je nach Sender auch im Mobilfunk weiter spielen.

Welche Audioformate?

MP3, M4A, AAC, WAV, FLAC, OGG und gängige Stream-Formate.

macOS vs. iOS?

Gleiche Funktionen. Auf dem Mac größeres Fenster, Dateizugriff über den System-Dialog statt iOS-Dateien-App.