Caja · Support
Caja - Support
Caja
Support
Last updated: August 24, 2026 · Applies to the Caja app for macOS
Something not working? Email jlama@julio-lama.com and I will get back to you.
1. Contact
Email: jlama@julio-lama.com
It helps if you include your macOS version, the Caja version (bottom left of the app window), and what you were doing when it went wrong.
2. Installing
1. Download the `.dmg` from the Caja page.
2. Open it and drag Caja onto the Applications shortcut.
3. Open Caja from Applications.
The first time you open it, macOS asks whether you are sure, because it came from the internet. Click Open. Caja is signed and checked by Apple, so no warning about an unidentified developer appears.
"macOS protects this folder"
Desktop, Documents and Downloads are protected by macOS, and no app reaches them without your say-so. If Caja shows this screen, press Choose the folder and pick the same folder yourself — the system takes that as a yes.
You can also grant it once and for all in System Settings → Privacy & Security → Files and Folders.
3. The tools
They all work the same way: pick one, look at what it is about to do, and press the button. Nothing changes until you do.
ordena sorts the loose files in a folder into folders by type — Images, Documents, Installers, and so on. It leaves your own subfolders alone and skips hidden files. Undo puts everything back.
candado protects a folder from being deleted by accident, including what is inside it. The same button takes the lock off. While it is on, you cannot add anything new to that folder either.
puerto shows which programs are listening on a port — useful when something says "port 3000 is already in use". It marks what is part of macOS and refuses to touch it, warns you when closing something would quit a whole app, and points out the stray servers you forgot. Closing a program cannot be undone.
discos ejects disks and installer images left mounted. It tells you which file each one came from. Ejecting deletes nothing.
respalda copies a folder somewhere else and then checks, file by file, that every copy arrived whole. It never removes anything from the original.
instalados finds the `.dmg` and `.pkg` files sitting in Downloads and on your Desktop, and tells you how much space they take. It only offers to clear the ones whose app it can find in Applications — if it cannot find the app, it leaves the file alone, because you may never have installed it. They go to the Trash, not deleted.
4. Common questions
Does Caja delete anything, ever?
No tool deletes a file. `ordena` and `respalda` move or copy; `candado` and `discos` change nothing inside your folders. The only thing that disappears is a program you ask `puerto` to close.
What happens to my own folders when I use ordena?
Nothing. A folder inside Downloads stays exactly where it is. The one exception is macOS `.app` bundles, which are treated as installers.
Two files with the same name?
The second one is renamed — `report.pdf` becomes `report (2).pdf`. Nothing is ever overwritten.
Can I undo something from yesterday?
`ordena`'s Undo reverses its most recent run. If a file has been moved or deleted since, Caja skips it and tells you how many it skipped. Closing a program with `puerto` cannot be undone at all.
I locked a folder and now I can't save into it.
That is what the lock does — it stops anything from being added, moved or deleted. Open `candado`, pick that folder, and take the lock off.
Why won't a disk eject?
Almost always because something is still using it. Close whatever has a file open on it and try again; `discos` shows you what macOS said.
The app is in the wrong language.
Caja starts in your Mac's language. Use the `ES | EN` switch at the bottom left to change it — your choice is remembered.
New tools appeared on their own. Is that normal?
Yes. Each update can add one, and it shows up in the box without you reinstalling anything.
5. Where caja keeps things
- Your settings — language, and the destination you chose for respalda: `~/.caja/ajustes.json`
- Undo records: `~/.ordena/historial/`
To remove Caja completely: drag it from Applications to the Trash, then delete those two folders.
6. Updates
Caja checks for a newer version once a day, shortly after you open it. If one exists, the link at the bottom of the main screen says so — quietly, with a dot. Click it to see what the new version adds and to download it.
You can also check whenever you like: that same link at the bottom asks straight away.
Updates are never installed automatically. Caja downloads nothing on its own — it only ever tells you, and you decide. To install one, open the downloaded `.dmg` and drag Caja onto Applications, over the old one.
7. Reporting a bug
Email jlama@julio-lama.com with what you expected, what happened, and which folder you were working on. The path is enough — please do not send files =)