Frequently Asked Questions
Answers to common questions about RenameClick features, billing, providers, and more.
General
What is RenameClick?
RenameClick is a desktop AI application that reads the actual content of your files — images and documents — and generates meaningful, descriptive filenames. It also sorts files into category folders, searches files by meaning, and automates folder watching.
What platforms does RenameClick support?
macOS (Apple Silicon and Intel) and Windows.
Is RenameClick free?
Yes, with limits. Free users get unlimited AI analysis and 30 successful rename/move operations per month. Pro users get unlimited operations.
Does RenameClick work offline?
Yes. After downloading the built-in AI model (~4 GB one-time download), the Local provider runs entirely on your machine with no internet connection needed.
Files & Processing
How many files can I process at once?
Up to 30,000 files by default. This can be raised to 500,000 in Local AI Settings.
What file types are supported?
Images: JPG, JPEG, PNG, GIF, WebP, BMP, SVG, HEIC, HEIF, TIFF, TIF Documents: PDF, DOC, DOCX, TXT, MD, CSV, RTF, ODT
Does AI analysis spend credits?
No. AI analysis (generating name suggestions) is completely free and unlimited. Credits are only consumed when you actually apply a rename or move operation.
What happens with scanned PDFs?
If a PDF has no extractable text, RenameClick renders the first page as an image and uses AI vision to analyze it.
Is processing sequential or parallel?
Sequential — one file at a time. This ensures stable AI performance especially with the local model.
Renaming
Will my original files be destroyed?
No. AI analysis only creates suggestions. Nothing on disk changes until you explicitly click "Apply". You can also undo any applied operation.
Are file extensions preserved?
Yes, always. A .pdf stays .pdf, a .jpg stays .jpg.
What happens if two files get the same suggested name?
Duplicate names are automatically made unique by appending _1, _2, etc.
Can I edit the suggested names before applying?
Yes. Click on any suggested name to edit it inline. You can also use Find & Replace across all names.
Can I undo a rename?
Yes. After applying, use Undo to revert files to their original names and locations.
Custom Instructions
What are Custom Instructions?
Custom prompts that let you write your own AI instructions to control exactly how files are named. For example, extract specific fields from invoices and format the filename as Vendor_InvoiceNumber_Date.
Why are Format and Language disabled when I use a custom prompt?
Because your custom prompt now controls the final filename structure. The Format and Language selectors would conflict.
Can I use Custom Instructions with Categorization?
Yes. Custom Instructions control the filename only. Categorization still uses the actual file content independently.
Categories & Organization
How does categorization work?
When enabled, AI analyzes each file's content and assigns it to the most appropriate category from your selected preset. Files are then moved into subfolders named after their categories.
Can I create my own categories?
Yes. Create custom category presets with your own category names and descriptions.
What happens if AI can't categorize a file?
It assigns null — the file stays uncategorized and won't be moved.
AI Search
What is AI Search?
A workspace that finds files by their content meaning, not filename. Describe what you're looking for and AI identifies matching files.
Can AI Search rename or move files?
No. AI Search is read-only. You can reveal files in Finder/Explorer, exclude them, or move them to trash.
Are search results saved?
Yes. Search results persist across app restarts.
Auto Flow
What is Auto Flow?
Automated folder monitoring. Set a source folder, a destination, turn on Watch — and new files are renamed, categorized, and moved automatically.
Can I run multiple watch rules?
Yes. Each row is independent with its own source, destination, format, prompt, language, and categories.
Does Auto Flow process incomplete downloads?
No. Files are stabilized first — the app waits until size and modification time stop changing.
Providers & Models
What AI providers are supported?
Local (built-in, free, offline), OpenAI, Google Gemini, Alibaba Cloud (Qwen), LM Studio, and Ollama.
Which provider should I use?
Start with Local — it's free, private, and works offline. Switch to OpenAI or Google if your hardware doesn't satisfy the system requirements for the local model.
How much RAM does the local model need?
~4 GB for the bundled model.
Can I use my own local models?
Yes, via LM Studio or Ollama. Install a vision-capable model, start their server, and connect RenameClick to it.
Credits & Billing
How do credits work?
AI analysis is always free. Credits are consumed only on successful rename/move to disk. Free: 30 operations/month. Pro: unlimited.
When do credits renew?
Monthly, on the same day of month as your initial usage.
Settings & Data
Can I transfer settings to another machine?
Yes. Export to a .rclick file and import on another device. Includes all presets, prompts, categories, and Auto Flow config.
Where is my data stored?
All data is stored locally. No data is sent anywhere unless you explicitly use a cloud provider.
Is my data private?
With the Local provider, all processing happens on your machine. Cloud providers receive file content only during active processing when you explicitly use them.