File browser¶
The File Browser is a dockable sidebar that browses your local filesystem next to the terminal. It shows a directory tree with a navigation toolbar, a path bar, a filter, type-aware icons and a status footer. (For browsing a remote server over SFTP, use the SFTP file manager instead.)
Opening and docking¶
Toggle the panel from the menu bar:
| Menu item | Shortcut |
|---|---|
| View → File Browser → Show on Left | Shift+Cmd+B / Shift+Ctrl+B |
| View → File Browser → Show on Right | Shift+Cmd+R / Shift+Ctrl+R |
Selecting the item again hides the panel. A draggable divider resizes it (160–420 px). The panel's position, width, "show hidden" state and last directory are remembered across restarts.
Navigation¶
The toolbar and path bar drive where the tree is rooted:
| Control | Action |
|---|---|
| Back / Forward | Return to a previously visited directory |
| Up | Root the tree at the parent directory (may go above your home directory) |
| Home | Root the tree at your home directory |
| Refresh | Reload the current directory, keeping expanded folders open |
| New folder / New file | Create an item in the selected (or current) directory |
| Sort | Choose the sort key (Name, Size, Date modified) and direction (Ascending / Descending) |
| Show hidden files | Toggle dotfiles on or off |
The path bar accepts a typed path and roots the tree there. A leading ~ expands to your home directory; absolute paths outside home are allowed. The filter field below it narrows the listing to entries whose name contains the typed text (case-insensitive).
Directories load in the background, so a large or network-mounted folder no longer freezes the window; a brief loading indicator appears while a directory is read.
Keyboard shortcuts¶
When the tree has focus:
| Shortcut | Action |
|---|---|
| Enter | Open a file, or expand/collapse a folder |
| F2 | Rename the selected item inline |
| Backspace | Go up to the parent directory |
| Cmd+R / Ctrl+R | Refresh |
| Del or Cmd+Backspace | Delete the selection (choose Trash or permanent) |
| Cmd+C / Ctrl+C, Cmd+V / Ctrl+V | Copy and paste files |
| Cmd+F / Ctrl+F | Jump to the filter field |
File operations¶
Right-click an entry for the full menu:
- Open — open the file with the operating system's default application.
- Open in Snippet Editor — load a text file (up to 10 MB) into the Snippet Editor.
- Rename — rename inline; a name clash is resolved by appending
(2),(3), … - Copy / Cut / Paste — move or copy within the browser.
- Copy Path — copy the item's absolute path to the clipboard.
- Delete — a confirmation prompt offers Move to Trash or Delete Permanently. Moving to the Trash is reversible; permanent deletion cannot be undone. On a system without a Trash, only permanent deletion is offered. The deletion runs in the background so a large folder does not freeze the window.
- New Folder / New File — create an item.
- Set owner / group / permissions — change ownership and POSIX permissions (where the filesystem supports it).
- Archive — pack the selection into a
ZIP,TARorTAR.GZarchive. - Details — show type, size, path, modification time and permissions.
Each row shows a type-aware icon (folder, code, image, archive, document or executable), with a badge for symbolic links. The footer reports how many folders and files the current directory holds and how many entries are selected.
Drag and drop¶
Drag files out of the browser onto another application to copy them, and drag files into the browser to copy or move them into a folder. Dropping onto a folder targets that folder; dropping elsewhere targets the current directory. Name clashes are resolved with a (2) suffix rather than overwriting.