Help for search, file management, network access, and setup on macOS.
Where each command lives, which keystrokes are bound, how to grant jFile access to
your folders, and what to check when search, preview, or a remote connection does not
behave as expected.
PlatformmacOS 26 or later required
HardwareApple silicon Mac required
Main capabilitiesMulti-pane browsing with detachable panels, natural language search, preview, and network file access
Supported remote typesSMB/CIFS, FTP, FTPS, SFTP, WebDAV, Amazon S3 and S3-compatible storage, and Dropbox. NFS once mounted on the Mac.
Getting Started
jFile NLP is a multi-pane file manager for macOS. File panels sit side by side, any panel can be
split off into its own independent window, a preview pane can open beside them, and a sidebar on the
left lists your Favorites, Volumes, Places and Network Devices.
Most of what follows describes where a control lives, so you can find it once and stop hunting for it.
The active panel
Almost every command acts on the active panel - the one you last clicked. Copying,
moving, searching and view changes all follow it. If a command seems to affect the wrong side,
click once inside the panel you meant and try again.
Show or hide the second panel with the toolbar button whose tooltip reads “Toggle right file panel”. There is no menu item for it.
Each panel has its own search bar, view-mode picker, zoom slider and column filters.
First things to set up
Grant access to the folders you work in - see Permissions and Access. Until you do, a panel can open empty.
Open jFile NLP › Preferences… (⌘,) to set search depth. The window is titled Settings.
Pin the folders you use daily to Favorites by dragging them onto the sidebar.
Try one search in plain English, such as images from this month.
Help Mode
The toolbar carries a text button that cycles through Help On, Help Off
and Display Help. With help on, numbered buttons appear beside controls throughout the
window; clicking one opens a short explanation of that control in place. It is the fastest way to learn a
pane you have not used before. Full topics are also under Help › Search Help...
System requirements
jFile NLP requires macOS 26 or later and an Apple silicon Mac. Intel Macs are not supported.
Finding Files
Every panel has its own search bar at the top. Type a phrase and press Return. You do not need a special
syntax: jFile reads file type, size, dates, tags, comments and content intent out of ordinary English.
That interpretation runs locally on your Mac.
jFile does not send your search text, file metadata, or file contents to an external AI provider,
cloud AI API, or hosted language model in order to understand your query.
Examples to try
large PDFs modified last week
files tagged red
documents from last year
images larger than 10MB
comments containing invoice
audio files longer than 5 minutes
Narrowing a search
Recursive checkbox, in the panel's search toolbar, decides whether subfolders are searched at all.
Depth picker, beside it, limits how many folder levels deep that goes.
Column filters sit directly above the file list: Name, Attributes, Size, Modified and Kind. They are a second way to search - use them instead of typing a query, or to narrow one you have already run.
Defaults for recursion and depth live in jFile NLP › Preferences… under General.
Voice input
The microphone button at the far left of the search bar dictates a query instead of typing it. macOS will
ask for Microphone and Speech Recognition permission the first time. Speak the query the same way you
would type it.
Searching inside images
jFile can read text inside your images and recognise what they show, then search that. Indexing is a
deliberate step, not something that happens to your whole disk automatically:
Choose Edit › Index for Graphic OCR Search…
Choose the scope you want indexed and start it. A live count shows progress, and you can cancel.
Once indexed, ordinary queries reach that text, for example graphic files containing invoice.
Indexing continues in the background when your Mac is idle and on power. If it appears to stall, check
the status text under the panel - it reports when indexing is paused.
When Spotlight cannot answer
jFile prefers Spotlight's index because it is fast, and falls back to walking the folders itself where
the index is missing, incomplete, or switched off. It tells you on screen when it does this, so a slower
search is explained rather than mysterious. To rebuild coverage for a location, use
Edit › Reindex with Spotlight… To see what Spotlight actually
covers on a volume, open File › Volume Health… or click the
Spotlight status text beneath a panel.
Browsing and Preview
Getting around
Go › Back⌘[ and Go › Forward⌘]
Go › Up⌘U for the parent folder
Go › Home⇧⌘H, Documents⇧⌘O, Downloads⇧⌘L
Type a path straight into the address bar, or press ⌘L to focus it
⌘R refreshes the current listing
How the list looks
The three-segment control in each panel's search toolbar switches Details, List and Icons. This is the reliable route.
The zoom slider beside it scales icons from 50% to 300%.
Click any column heading to sort; click again to reverse.
The unlabelled checkbox at the far left of the address bar shows the full path in the panel.
The preview pane
View › Show Preview (⌘P) opens the preview beside the
panels; the same command closes it again, though the menu title does not change to “Hide
Preview”. Select a file and it renders in place. Brightness and contrast controls sit within the
pane for dim scans, and a lock keeps the current file on screen while you carry on browsing.
Most formats are drawn by macOS itself. jFile adds its own renderers for professional formats macOS
cannot show natively, including CAD and drafting drawings, layered image packages such as
.ora, .kra, .procreate and .sketch, and
.eps, .qoi and .ai artwork. Where jFile has no renderer of its own
it falls back to the system preview rather than showing a blank pane. Everything is rendered on your Mac;
nothing is uploaded.
Editing in place
Text, Word, OpenDocument and RTF documents can be edited directly in the preview and saved, or saved as a
copy so the original is untouched. Apple Writing Tools (proofread, rewrite, summarise) are available there
but are switched off until you enable them in
jFile NLP › Preferences… under General, where the
app explains what may leave your Mac first. Leave it off and everything in jFile stays on-device.
Comparing two folders
Point each panel at a folder and choose View › Compare Panels
(⇧⌘D) to see what differs. For ongoing work,
File › Folder Sync… (⌘Y) copies differences in
either direction; you can also right-click a local folder to reach it.
Working with Files
Copy and move act between panels, which is the point of a multi-pane layout: set the source in one
panel, the destination in another, and the operation has somewhere obvious to go.
Copying and moving
Drag between the panels, or drag out to Finder or another app.
Edit › Copy⌘C then Edit › Paste⌘V. Paste always copies; it never moves the original.
A copy inside the same APFS volume is made as a clone, so it finishes without duplicating the data.
Window › Transfers lists every copy, move and delete in progress, each with its own Cancel.
Renaming and creating
File › Rename, or right-click the file and choose Rename.
File › New Folder⌘N. Note this is New Folder, not a new window as in Finder.
File › New File offers a submenu of templates.
File › Duplicate⌥⌘D.
File › Get Info⌘I for size, dates, tags and comments.
Deleting: three different things
These are not interchangeable, and only one of them is recoverable.
Ways to remove a file, and whether you can get it back
Command
What it does
Recoverable?
File › Move to Trash
Sends the item to the macOS Trash.
Yes, from the Trash.
File › Delete
Removes the item permanently. jFile asks you to confirm first.
No.
Fast Delete
Removes a large folder and everything in it permanently, skipping the Trash. Confirmation required.
No.
Undo does not cover file operationsEdit › Undo (⌘Z) applies to text editing, not to copies,
moves or deletions. There is no undo for a completed file operation. Use
Move to Trash rather than Delete when you want a way back.
Note also that Edit › Cut (⌘X) works in text fields only and
never moves files.
When a file already exists
If the destination already holds a file of the same name, jFile stops and asks rather than overwriting
silently, offering to replace, skip or keep both. On a long transfer you can apply your answer to
everything that follows.
Network and Remote Storage
jFile reaches servers and cloud storage directly, in the same panels as your local files, without
mounting first from Finder. Open Go › Connect to Server… to enter a
server by address, or Go › Network Devices (⇧⌘K) to
scan the local network for machines that advertise themselves.
What you can connect to
SMB and CIFS shares, including ones that do not advertise themselves.
FTP and FTPS, using passive-mode transfers.
SFTP and WebDAV / WebDAVS.
Amazon S3, Backblaze B2, Cloudflare R2 and Wasabi presets, plus a custom endpoint for other S3-compatible storage.
Dropbox, connected with your own app key.
NFS shares once they are mounted on the Mac.
If a connection fails
Open the Details log inside the Network Browser window - it records what was attempted and what the server answered.
Confirm the server is reachable from this Mac at all, and that the account has permission to the specific share.
For NFS, mount the share in Finder first (Go › Connect to Server in Finder); it then appears in jFile as a volume.
Saved server profiles keep credentials in your macOS Keychain, so a changed password must be updated there or re-entered.
Searching a server is not the same as searching your Mac
A server can only answer the questions its own protocol supports. Name, type, size and modified date work
on remote connections. Filters that depend on local metadata - file contents, Finder tags, comments and
owner among them - cannot be answered remotely. jFile names the filter it could not apply on screen for
SMB, FTP/FTPS, SFTP, WebDAV and Dropbox searches, so you can tell when a result list came back broader
than you asked for.
Permissions and Access
jFile is sandboxed: macOS grants it access to the folders you nominate, not to your whole disk. This is why
a panel can open empty even though the folder plainly has files in it. Nothing is wrong with the folder -
jFile has simply not been given access to it yet.
Granting access to a folder or drive
Choose File › Add Volume or Folder to jFile…
Select the folder or drive you want jFile to work with.
Confirm. The location stays available on future launches.
If an operation is refused, jFile shows a “Permission Required” message naming the same route.
Add the enclosing folder or the whole volume rather than one file at a time, and the rest of that tree
comes with it.
Other permissions macOS may ask forMicrophone and Speech Recognition the first time you use voice search.
Screen Recording if you use
File › Save Window Screenshot…. Each is requested only when you first
use the feature, and each can be withdrawn later in System Settings under Privacy & Security.
Troubleshooting
A panel is empty, but the folder is not
The usual cause is sandbox access rather than a missing folder. Choose
File › Add Volume or Folder to jFile… and add the enclosing
folder or the whole drive. See Permissions and Access. If the location is
on an external drive or a network mount, confirm that it is currently connected.
A search misses files you can see in the folder
Check the Recursive checkbox and the Depth picker in that panel's
search toolbar first: a depth limit stops the search before it reaches deeper subfolders. Then check
the column filters above the file list, since a filter left set will narrow what you see. If results still
look short, the Spotlight index for that volume may be incomplete - open
File › Volume Health… to see its reported coverage, and use
Edit › Reindex with Spotlight… to rebuild it.
Searching a server returns more than you asked for
This is expected, and jFile says so on screen. Remote protocols cannot answer every filter: content,
tags, comments and owner are local-metadata filters. jFile applies what the server supports, names
the filter it had to drop, and returns the broader list rather than a wrong one. Narrow the results
with the column filters once they arrive.
Image search finds nothing, or indexing seems stuck
Text and object search inside images only covers folders you have indexed. Run
Edit › Index for Graphic OCR Search… and choose the scope.
Background indexing runs when the Mac is idle and on power, so it pauses on battery - the status text
beneath the panel reports this. Leave it plugged in, or run the index in the foreground.
A preview shows a generic icon instead of the file
jFile renders many professional formats itself and hands the rest to macOS. A generic icon means
neither could render that file: it may be corrupt, truncated, or a format with no renderer on this
system. Confirm the file opens in the application that created it. Also check that the preview pane
is not locked on a previous file - the lock keeps one file on screen while you browse.
A keyboard shortcut does nothing
Some commands are deliberately menu-only, and a few shortcuts you might expect from Finder are not
bound in jFile. ⌘⌫ does not move files to the Trash, and Rename has no working
keystroke - use File › Move to Trash and
File › Rename, or the right-click menu. See
Menus and Shortcuts for what is actually bound.
Menus and Shortcuts
This is the reference for where commands live. Where a command has no keystroke, that is deliberate and the
menu path is the way to reach it.
Commands with a keyboard shortcut
Command
Shortcut
Notes
jFile NLP › Preferences…
⌘,
The window is titled Settings
jFile NLP › Hide jFile NLP
⌘H
jFile NLP › Quit jFile NLP
⌘Q
File › New Folder
⌘N
New folder, not a new window
File › Open
⌘O
One item at a time
File › Get Info
⌘I
File › Duplicate
⌥⌘D
Option, not plain ⌘D
File › Folder Sync…
⌘Y
Edit › Undo / Redo
⌘Z / ⇧⌘Z
Text editing only
Edit › Copy / Paste
⌘C / ⌘V
Paste always copies
Edit › Select All
⌘A
Edit › Find
⌘F
Focuses the panel search bar
View › Show Preview
⌘P
Same command closes it
View › Compare Panels
⇧⌘D
Go › Back / Forward
⌘[ / ⌘]
Go › Up
⌘U
Parent folder
Go › Home
⇧⌘H
Go › Documents
⇧⌘O
Go › Downloads
⇧⌘L
Go › Network Devices
⇧⌘K
Starts a subnet scan
Window › Minimize
⌘M
Focus the address bar
⌘L
No menu item
Refresh the listing
⌘R
No menu item
Menu only, by design
These have no keystroke. Reach them from the menu bar or, where noted, the right-click menu.
File › Add Volume or Folder to jFile… - grant access to a folder or drive
File › Move to Trash and File › Delete - ⌘⌫ is not bound
File › Rename - also on the right-click menu
File › New File - template submenu
File › Volume Health… - per-drive diagnostic
Edit › Index for Graphic OCR Search… and Edit › Reindex with Spotlight…
Go › Desktop
Go › Connect to Server… - reach it from the menu; ⌘K may instead jump to the search bar depending on where focus is
Window › Transfers - the copy, move and delete queue
Help › Search Help..., Report a Bug…, Privacy Policy
Right-click Open With - use the right-click menu, not the File menu
Controls that live only in the window
Several things have no menu entry at all, which makes them easy to miss:
Right panel show/hide - toolbar button, tooltip “Toggle right file panel”
View mode and zoom - each panel's search toolbar
Recursive and Depth - each panel's search toolbar
Column filters - directly above each file list
Voice input - microphone button at the far left of the search bar
Show full path - unlabelled checkbox at the far left of the address bar
Help Mode - toolbar button cycling Help On, Help Off and Display Help
Network Devices log - the Details section inside the Network Browser window
Frequently Asked Questions
Why is a panel empty when the folder clearly has files in it?
jFile is sandboxed and can only read locations you have granted it. Choose
File › Add Volume or Folder to jFile… and add the folder or
the whole drive. See Permissions and Access.
Does jFile replace Finder?
It is a separate file manager, not a replacement for Finder. It suits work that benefits from
several panels open at once, any of which can be split off into its own window, plus inline
preview, plain-English search, and direct access to servers. Finder
remains available for everything else, and jFile integrates with Finder tags and the Trash.
Does my search text or file content leave my Mac?
No. Natural-language interpretation, voice transcription, OCR, image recognition and document
insights all run on your Mac. The one exception is Apple Writing Tools, which is off until you turn
it on in jFile NLP › Preferences… under General,
and which is explained there before you enable it.
Why does ⌘⌫ not delete anything?
It is not bound in jFile. Use File › Move to Trash, or
File › Delete to remove permanently. Rename likewise has no working
keystroke - use the File menu or right-click. See Menus and Shortcuts.
Can I undo a copy, move, or delete?
No. Edit › Undo covers text editing only. Prefer
Move to Trash over Delete when you want a way
back, and watch a long operation in Window › Transfers, where each
item can be cancelled while it runs.
Why did a server search return files I did not ask for?
Remote protocols cannot answer filters that depend on local metadata, such as file contents, tags,
comments and owner. jFile applies what the server supports, tells you on screen which filter it had
to drop, and returns the broader list rather than a misleading one.
What do I need to run jFile?
macOS 26 or later on an Apple silicon Mac. Intel Macs are not supported.
Support Contact
Reporting a bug from inside jFile
This is the most useful way to report a problem, because it carries the context we would otherwise
have to ask you for.
Reproduce the problem first, so the activity log contains it.
Choose Help › Report a Bug…
Describe what you were doing and what you expected to happen.
Add your email if you would like a reply. It is optional.
Choose Send Report, or Copy to send it yourself.
What the report contains
jFile shows you this before anything is sent, and the report includes:
Your description of the issue
System information such as macOS version and hardware
A recent activity log: directories visited and operations performed
No passwords, no file contents, and no personal data
Reports go over HTTPS directly to the developer's own server and are forwarded by email. No
third-party form service is involved.
Email us
For feature requests, licensing questions, or anything the in-app reporter does not cover, use the
button below to reveal the support address. Telling us your macOS version and the steps that reproduce
the problem will usually save a round trip.