Fehlerbehebung

Die App zeigt „Demo mode", obwohl mein Gerät steckt

Nach Häufigkeit sortiert:

1. Du hast es nach dem Start der App eingesteckt. Klick Re-check device im gelben Banner. Kein Neustart nötig.
2. Ein anderes Programm hat das Gerät offen – SDR#, GQRX, CubicSDR, SDR++, ein Soapy-Werkzeug. Beenden, Gerät aus- und einstecken, Re-check device klicken.
3. Windows: Der Treiberschritt fehlt für diesen USB-Port. Siehe Erste Schritte. Das ist einmal pro Port nötig, nicht einmal pro Rechner.
4. Es ist ein RTL-SDR Blog V4. Die V4-Unterstützung ist experimentell und standardmäßig aus; nimm einen Stick der V3-Klasse.
5. Kabel- oder Hub-Problem. Manche USB-Kabel können nur laden. Probier einen direkten Port am Rechner statt eines Hubs.
6. Der Stick ist defekt. Test ihn in einem anderen SDR-Programm.

macOS sagt, die App sei beschädigt oder von einem unbekannten Entwickler

Das ist die einmalige Gatekeeper-Sperre – KlarFunk hat noch keine Apple-Developer-ID. Nimm Systemeinstellungen → Datenschutz & Sicherheit → Trotzdem öffnen, oder den xattr-Befehl aus Erste Schritte. Das machst du nur einmal.

Windows SmartScreen blockiert den Installer

Weitere Informationen → Trotzdem ausführen klicken. Du kannst die Datei vorher gegen den veröffentlichten SHA-256 in SHA256SUMS.txt prüfen.

Das Fenster bleibt nach dem Splash leer oder weiß

Gib ihm auf einer langsamen Maschine einen Moment; der erste Start auf einem alten Intel-Mac kann 30–40 Sekunden dauern.

Bleibt es leer, belegt womöglich ein anderes Programm den Port 38080. KlarFunk RF weicht automatisch auf den nächsten freien Port aus, aber wenn es keinen findet, beende, was ihn hält – ein lokaler Webserver, Jupyter, eine zweite Kopie von KlarFunk – und starte neu. Einmal in eine andere App und zurück zu wechseln zeichnet das Fenster ebenfalls neu.

„Port in use", oder die App hängt nach einem Neustart eine Minute

Das System hält den Port nach einem sauberen Beenden noch etwa eine Minute reserviert. Warte kurz und versuch es erneut.

Alles erscheint belegt oder alles frei

Der Rauschschwellwert passt nicht zu diesem Raum – nicht der Raum ist ungewöhnlich. Fahr einen frischen Sweep, klick Suggest threshold (oder drück T) und zieh die Linie zum Feinjustieren. Siehe Freie Fenster finden.

Beim Abhören höre ich nichts

Listen läuft nur mit einem RTL-SDR; auf anderen Geräten ist der Button nicht verfügbar. Prüf das Ausgabegerät des Systems und die Pegelanzeige neben dem Button, und senk den Squelch, falls er das Audio abschneidet.

Hörst du Rauschen statt Audio, ist das System vermutlich digital (ULX-D, QLX-D, Axient, EW-D, Digital 6000, Sony DWX). FM-Demodulation kann die nicht dekodieren – das Rauschen bestätigt aber, dass dort ein Träger sitzt.

Die tinySA Ultra zeigt über 800 MHz Unsinn

Der Ultra-Modus muss am Gerät selbst aktiviert werden: CONFIG → MORE → ENABLE ULTRA, Code 4321. Die App kann ihn nicht aus der Ferne einschalten.

Der Advisor liefert weniger Kanäle als angefragt

Das gemessene freie Spektrum reicht für diese Anzahl mit dem gewählten Profil und den Gerätefamilien nicht aus. Probier das andere Profil, weniger Kanäle oder ein breiteres Band. Siehe Show koordinieren.

Beim Öffnen der App passiert gar nichts

Die Scanner-Engine schreibt beim Start ein Log: auf macOS im Temp-Ordner als klarfunk-sidecar.log (Terminal öffnen, open $TMPDIR eingeben), auf Windows in %TEMP%. Schick es an support@squaresmile.de zusammen mit einer Beschreibung, was du gemacht hast.

Probleme mit Download und Lizenz

Die passieren auf der Plattform, bevor die App überhaupt im Spiel ist.

Wo fragen

support@squaresmile.de. Bei Hardware-Problemen schreib dazu, welches Gerät du nutzt, und füg auf dem Mac die Ausgabe von system_profiler SPUSBDataType | grep -i rtl ein, damit wir V3 von V4 unterscheiden können. Bei Abstürzen häng klarfunk-sidecar.log an.