Fehlerbehebung

Die meisten Probleme fallen in eine von vier Kategorien: macOS-Berechtigungen, KI-Anbieter-Konfiguration, Credits/Lizenzierung oder ein Ordner, der nicht überwacht wird. Suchen Sie unten Ihr Symptom — und wenn nichts hilft, exportieren Sie die Diagnose und schreiben Sie uns eine E-Mail.

---

Dateien werden nicht umbenannt#

Der Watch Folder ist nicht aktiv. Prüfen Sie den Überwachungsstatus des Ordners in der Seitenleiste — er muss als überwacht angezeigt werden, mit aktiviertem Auto für automatische Verarbeitung. Siehe Watch Folders.

NameQuick hat keinen Zugriff auf den Ordner. macOS verlangt, dass Sie Ordnerzugriff explizit gewähren. Fügen Sie den Ordner über die +-Schaltfläche erneut hinzu, damit macOS die Berechtigungsabfrage wieder anzeigt, oder prüfen Sie Systemeinstellungen → Datenschutz & Sicherheit → Dateien und Ordner.

Der Dateityp wird nicht unterstützt. Prüfen Sie die unterstützten Dateiformate — NameQuick deckt 30+ Formate ab, aber nicht alles.

Sie sind im Prüfmodus. Namen warten möglicherweise auf Ihre Freigabe, statt fehlzuschlagen. Öffnen Sie die App und prüfen Sie die To-Process-Ansicht — siehe Umbenennungsmodi.

Berechtigungsprobleme#

"macOS hat den Helper blockiert" (Start bei Anmeldung): Öffnen Sie Systemeinstellungen → Anmeldeobjekte, erlauben Sie NameQuick im Hintergrund und versuchen Sie es erneut — die Meldung in der App führt Sie durch die Schritte.

Finder-Automation: NameQuick bittet um die Finder-Automationsberechtigung, damit Umbenennungen sofort greifen. Falls Sie sie einmal abgelehnt haben, aktivieren Sie sie wieder unter Systemeinstellungen → Datenschutz & Sicherheit → Automation → NameQuick.

Mitteilungen: Wenn Sie keine Benachrichtigungen über abgeschlossene Stapel sehen, erlauben Sie NameQuick unter Systemeinstellungen → Mitteilungen.

KI-Anbieter-Fehler#

"Add your API key in Settings → AI" — der gewählte Anbieter hat keinen Key. Fügen Sie einen hinzu (Anleitung) oder wechseln Sie zu Managed oder einem lokalen Modell.

Umbenennungen schlagen trotz gültigem Key fehl — meist fehlt dem Anbieter-Konto Guthaben. Prüfen Sie das Billing-Dashboard des Anbieters; ein Key ohne Guthaben dahinter ist nicht nutzbar.

Rate-Limit-/Quota-Fehler — der Anbieter drosselt Sie. Kleinere Stapel helfen; neue Konten erhalten nach einigen Tagen automatisch höhere Limits.

"Vision model missing" bei Bildern oder gescannten PDFs — Ihr lokales Modell ist rein textbasiert. Laden Sie ein Vision-fähiges Modell und wählen Sie es unter Einstellungen → AI (Anleitung zu lokalen Modellen).

Schlüsselbund gesperrt oder nicht verfügbar — NameQuick speichert Keys im macOS-Schlüsselbund. Entsperren Sie den Schlüsselbund Ihres Macs (normalerweise mit der Anmeldung entsperrt) und versuchen Sie es erneut.

Lokales Modell nicht erreichbar — stellen Sie sicher, dass Ollama bzw. LM Studios Server tatsächlich läuft und die Adresse unter Einstellungen → AI übereinstimmt (http://127.0.0.1:11434 für Ollama, localhost:1234 für LM Studio).

Credits, Testphase & Lizenz#

Alle operativen Details — Aktivierung, Mac-Wechsel, was einen Credit verbraucht — stehen unter Lizenz, Testphase & Credits.

Testphase aufgebraucht — die kostenlose Testphase umfasst 50 Umbenennungen über 7 Tage. Danach wählen Sie einen Plan unter Einstellungen → Nutzung oder auf der Preisseite: Managed-Credits ab $5/Monat oder die einmalige Selbst-verwaltet-Lizenz für $38 mit eigenem Key oder lokalem Modell.

Keine Credits mehr (Managed) — Ihre monatlichen Credits sind aufgebraucht. Einstellungen → Nutzung zeigt Ihr Guthaben und das Verlängerungsdatum; Sie können jederzeit upgraden, und ungenutzte Credits werden in den nächsten Monat übernommen.

Lizenz validiert offline nicht — NameQuick hat Offline-Kulanzfristen, kurze Offline-Phasen sind also kein Problem. Schlägt die Validierung online dauerhaft fehl, prüfen Sie die Systemuhr und VPN/Firewall, dann kontaktieren Sie den Support mit der Diagnose.

OCR- und Qualitätsprobleme#

Gescannte PDFs bekommen generische Namen — sehr niedrig aufgelöste Scans geben der OCR wenig Material. Scannen Sie wenn möglich mit 300 DPI neu.

Namen sind in der falschen Sprache — legen Sie Ihre bevorzugte Ausgabesprache in den Einstellungen fest; NameQuick unterstützt mehrsprachige Benennung.

Ein Name ist falsch geworden — jede Umbenennung ist umkehrbar. Finden Sie die Datei in der Processed-Ansicht der Library und machen Sie sie rückgängig; die ursprünglichen Zeitstempel bleiben in jedem Fall erhalten.

---

Hilfe bekommen#

• Diagnose exportieren über das App-Menü und an Ihre E-Mail anhängen — sie enthält Logs, nicht Ihre Dateiinhalte.
• Logs anzeigen, wenn Sie zuerst selbst nachsehen möchten.
• E-Mail an support@namequick.app — mit Ihrer macOS-Version und was Sie erwartet haben vs. was passiert ist. Echter Mensch, meist schnell.
• Feature-Ideen und Roadmap: namequick.featurebase.app/roadmap.