jFile NLP Support

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.

Platform macOS 26 or later required
Hardware Apple silicon Mac required
Main capabilities Multi-pane browsing with detachable panels, natural language search, preview, and network file access
Supported remote types SMB/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:

  1. Choose Edit › Index for Graphic OCR Search…
  2. Choose the scope you want indexed and start it. A live count shows progress, and you can cancel.
  3. 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
CommandWhat it doesRecoverable?
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 operations Edit › 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

  1. Choose File › Add Volume or Folder to jFile…
  2. Select the folder or drive you want jFile to work with.
  3. 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 for Microphone 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
CommandShortcutNotes
jFile NLP › Preferences…⌘,The window is titled Settings
jFile NLP › Hide jFile NLP⌘H
jFile NLP › Quit jFile NLP⌘Q
File › New Folder⌘NNew folder, not a new window
File › Open⌘OOne item at a time
File › Get Info⌘I
File › Duplicate⌥⌘DOption, not plain ⌘D
File › Folder Sync…⌘Y
Edit › Undo / Redo⌘Z / ⇧⌘ZText editing only
Edit › Copy / Paste⌘C / ⌘VPaste always copies
Edit › Select All⌘A
Edit › Find⌘FFocuses the panel search bar
View › Show Preview⌘PSame command closes it
View › Compare Panels⇧⌘D
Go › Back / Forward⌘[ / ⌘]
Go › Up⌘UParent folder
Go › Home⇧⌘H
Go › Documents⇧⌘O
Go › Downloads⇧⌘L
Go › Network Devices⇧⌘KStarts a subnet scan
Window › Minimize⌘M
Focus the address bar⌘LNo menu item
Refresh the listing⌘RNo menu item

Menu only, by design

These have no keystroke. Reach them from the menu bar or, where noted, the right-click menu.

Controls that live only in the window

Several things have no menu entry at all, which makes them easy to miss:

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.

  1. Reproduce the problem first, so the activity log contains it.
  2. Choose Help › Report a Bug…
  3. Describe what you were doing and what you expected to happen.
  4. Add your email if you would like a reply. It is optional.
  5. 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.