Troubleshooting

Open Settings → Folders. If the folder's processing mode is Off, pick Smart Rename or a Preset. If Pause watching is on, turn it off. NameQuick also has to be running: on Mac it keeps running when you close the window, on Windows closing the window quits the app, so minimize it instead. See Watch Folders.

Files that were in a folder when you added it are treated as the starting point and are not renamed automatically. Select them in All Files and rename them yourself.

You see "NameQuick isn't allowed to read this folder." On Mac, grant access under System Settings → Privacy & Security → Files and Folders, then retry. On Windows, check that the folder is reachable and that permissions or security software aren't blocking it.

Check Supported File Formats — NameQuick covers 30+ formats, but not everything, and some depend on your AI setup. Cloud files that are only online placeholders need to be downloaded first.

Names may be waiting for your approval rather than failing. For folders set to Review first, open All Files and look for files marked with a new name. See Rename Modes.

If Start at login (Mac) or Start with Windows doesn't take effect, NameQuick shows the state it actually reached. Try again and check Login Items (Mac) or Startup apps (Windows) in your system settings.

The global rename shortcut needs automation access to Finder to see which files you selected. If you declined it, re-enable it under System Settings → Privacy & Security → Automation → NameQuick.

If you're not seeing batch-completion notifications, open Settings → Notifications and choose Enable notifications…. If the system blocks them, allow NameQuick under System Settings → Notifications (Mac) or in Windows notification settings.

Add one (guide) or switch to Managed or a local model.

Replace it with a valid key under Settings → AI → Replace. If connecting a key fails with "Your [provider] account has no API credit", add billing at the provider first; a key without credit behind it can't be used.

You see something like "OpenAI rate limit · retrying in 20 s". The provider is throttling you; NameQuick waits, retries, and may slow down to one file at a time, with no action needed. If it persists, check your provider's limits and billing. New accounts often get higher limits after a few days.

The model is marked Text only — scans need a model that reads images. Pick a model marked Reads scans & photos in Settings → AI (local models guide).

NameQuick stores keys in the macOS Keychain or the Windows Credential Manager. Unlock your Mac's keychain (it normally unlocks with login) or allow access to the Credential Manager on Windows, and retry. This message doesn't mean your key is wrong.

Settings → AI shows whether the engine isn't installed, isn't running, or isn't answering. Start the engine from NameQuick; for LM Studio, turn its local server on in the Developer tab; if Windows asked for network access, allow it and check again. Ollama must be version 0.5.0 or newer.

Self-Managed has a separate 30-rename trial with no card or time limit. Managed includes 30 free renames with no email or card, then 70 more and 14 days of your plan when you add a card.

The 30 starter renames last until used. If they run out, Managed renaming pauses, while History, Presets and settings remain available. After adding a card and choosing a plan and billing period, the first regular charge is scheduled after 14 days unless you explicitly start the subscription early. Using the trial renames before then pauses renaming and does not automatically start billing early.

Continue in Settings → Billing or on the pricing page: Managed from $12/month, or a $69 one-time Self-Managed license with your own key or a local model.

Your renames for this billing period ran out, and Settings → Account shows Out of credits. Settings → Billing shows your plan; you can upgrade tiers anytime. Renames reset with each billing period and don't accumulate; annual plans receive the full year's renames upfront.

A Self-Managed license keeps working offline for up to 7 days after a successful check; after that, connect so it can check again. Managed needs the internet to create name suggestions. If validation keeps failing online, check the system clock and any VPN/firewall, then contact support with diagnostics.

The AI model reads scanned pages from the page image, and very low-resolution or blurry scans give it little to work with. Re-scan at 300 DPI where possible. Very long documents may be named from their first pages only; the receipt in History then shows Partial document sent.

The output language is independent of the app's interface language. Open Settings → Renaming → Output language and choose Always use a language, or Match the document to follow each file's own language when it's clear.

If you haven't applied it yet, don't. After applying, open History and use Undo on that rename. Undo reverses the recorded rename where possible, but not every rename can be undone, for example when the file was moved or is open. See Undo & Rename History.