Troubleshooting

Solutions for common issues with AI models, processing, workspaces, LM Studio workaround, and more.

LM Studio Workaround

If the built-in local AI has issues on your hardware (Intel Arc GPU, insufficient VRAM, CPU fallback problems), you can use LM Studio as an alternative local provider.

When using LM Studio with CPU inference, processing a file takes approximately 10-14 seconds instead of ~0.5 seconds with GPU acceleration. This is expected — CPU inference is significantly slower.

Before You Start

Update your GPU drivers — Make sure you have the latest drivers for your graphics card (NVIDIA, AMD, or Intel)
Install the latest RenameClick version — Download the newest version from the website
Ensure at least 4 GB of free RAM — The local AI model requires sufficient memory

If these steps don't resolve your issue, follow the LM Studio setup below.

Step 1: Install LM Studio

Download and install LM Studio from lmstudio.ai.

Step 2: Download the AI Model

Open LM Studio
Go to the Search tab
Search for qwen3-vl-4b
In Download Options, choose: Qwen3 VL 4B GGUF Q4_K_M
Click Download (approximately 4 GB)

LM Studio — Download Qwen3 VL 4B model

Step 3: Start the LM Studio Server

Go to the Developer tab (or click the green icon in the left sidebar)
Load the downloaded model

Click Start Server — It should start on: http://localhost:1234

Step 4: Configure RenameClick

Open RenameClick
Click the provider dropdown (currently showing "Local")
Select LM Studio — it should show as green (connected)

RenameClick — Provider selector with LM Studio

If LM Studio is not green, go to "Configure Models", refetch LM Studio, and select the qwen3 VL 4b model:

RenameClick — Configure Models for LM Studio

Processing Issues

Files show errors after processing

Network error: Check internet if using a cloud provider
Model error (503): The local model is still loading — wait and retry
File access error: The file may be locked or permissions restricted
Click the retry button on individual files or "Re-run All" for all failed files

Processing is slow

Local model processes one file at a time — this is by design for stability
Large images and multi-page documents take longer
Consider using a cloud provider for faster results on large batches
Close other GPU-intensive applications if using the local model

Workspace Issues

"AI Search is running" / workspace locked

Workspaces use mutual exclusion to prevent resource conflicts:

Stop AI Search before starting Rename processing
Stop Rename processing before starting AI Search
Turn off Auto Flow Watch before starting AI Search

Can't switch providers

Provider/model switching is locked while AI Search is running or any Auto Flow row is watching. Stop the active task first.

Files don't appear after drag & drop

Check that the files are supported types (see Supported File Types)
If dropping a folder, check the recursive scanning toggle
The batch file limit may be reached — raise it in Local AI Settings

Auto Flow Issues

Auto Flow isn't processing new files

Verify Watch is ON (green indicator)
Check that source and destination folders are set correctly
Files inside the destination folder are ignored (loop prevention)
Files still being downloaded/copied are stabilized before processing

"No credits left" in Auto Flow

Free users: credits ran out. Auto Flow pauses automatically. Upgrade to Pro or wait for monthly renewal.

Files are being re-processed

Check that the file wasn't modified after being processed
Files recently moved by the app are tracked for 10 seconds to prevent re-triggering

"Rename with RenameClick" not showing in Finder

The Quick Action is installed on first launch. Try restarting the app.
Check System Settings > Extensions > Finder > Quick Actions
On macOS: the option appears under Quick Actions or Services in the right-click menu