Troubleshooting

The generated filename stays blank

The document may still be queued or processing. If the placeholder never changes:

• Check Settings → Models and make sure the selected model is downloaded.
• Try Medium if another model is selected.
• Use the inspector to see whether any fields were extracted.

Model download failed

Open Settings → Models and click download again. Renamo resumes partial downloads when possible.

If the model still fails, check your network connection and make sure enough disk space is available.

The wrong vendor was detected

Renamo tries to use the issuer or merchant, not the billed-to customer. If a document repeatedly picks the wrong party:

• Add a custom field with a stricter description.
• Edit the generated filename directly for that file.
• Submit bad filename feedback with a short explanation.

Rename all is disabled

At least one document must be in the Ready state and have a non-empty generated filename.

The file was not renamed

Renamo uses macOS file moves. A rename can fail if:

• The file was moved or deleted after being added.
• The folder is read-only.
• Another app is locking the file.
• The generated name is not valid after sanitization.

The sidebar shows failed files with a warning icon, and the footer shows the last error.

I want to start over

Remove files from the list with Delete or Backspace, or quit and reopen Renamo. Debug builds also include Debug → Complete Reset.