差分
このページの2つのバージョン間の差分を表示します。
| 次のリビジョン | 前のリビジョン | ||
| mac:vleben:manual_en [2026/10/02] – 作成 - 外部編集 127.0.0.1 | mac:vleben:manual_en [2026/10/12] (現在) – 外部編集 127.0.0.1 | ||
|---|---|---|---|
| 行 1: | 行 1: | ||
| # VLE-Ben User Manual | # VLE-Ben User Manual | ||
| - | |||
| - | English edition of [manual.md](manual.md). | ||
| A keyboard-first two-pane filer. The mouse works too; this manual centers on the keys. | A keyboard-first two-pane filer. The mouse works too; this manual centers on the keys. | ||
| 行 9: | 行 7: | ||
| ## How the screen is laid out | ## How the screen is laid out | ||
| - | - In the blue and black themes, the focused title is a white bar with black text. FILER, FTP, VIEWER, EDITOR, SEARCH, TREE, and GALLERY sit on a cyan bar with black text, and one character of cyan continues on each side. When a pane is inactive, that name is cyan text. Only the letters that were yellow become black on a yellow bar. The bar is the same height as the white bar. An inactive pane is not inverted; a line sits under its title. In the white theme, the focused header is dark blue | + | - In the blue and black themes, the focused title is a white bar with black text. FILER, FTP, VIEWER, EDITOR, SEARCH, TREE, and GALLERY sit on a cyan bar with black text. When a pane is inactive, that name is cyan text. In the white theme, the focused header is dark blue |
| - The toolbar at the top is a hint of the commands. **While Shift is held** it switches to the ⇧ keys. **While fn is held** it switches to F3–F8 | - The toolbar at the top is a hint of the commands. **While Shift is held** it switches to the ⇧ keys. **While fn is held** it switches to F3–F8 | ||
| - | - The status line at the bottom shows the selected file’s attributes, owner, size, date, and name. **While Shift is held** it switches to free space on mounted local disks. When the current location is Samba or FTP, only that drive is listed. In two panes it follows the active side. When files are tagged, the focused | + | - The status line at the bottom shows the selected file’s attributes, owner, size, date, and name. **While Shift is held** it switches to free space on mounted local disks. When the current location is Samba or FTP, only that drive is listed. In two panes it follows the active side. The filer title’s right side shows the file count. `..` is not counted. With tags it shows `3 / 12`, then the sort. With no tags it shows only the file count. On the active bar the count inverts so it stays visible. Search shows the number found the same way, `3 / 12` when files are tagged. The leave hint is on the bottom row. The tag count and tag marks stay on that pane when it is not active. They are not shown on the preview. While Quick Look is showing, the right end says QuickLook. Image and video previews show pixel size and camera name at the right end |
| ### Layout | ### Layout | ||
| 行 17: | 行 15: | ||
| | Key | Screen | | | Key | Screen | | ||
| |------|------| | |------|------| | ||
| - | | **⇧1** | Left filer + right VIEWER (startup default) | | + | | **⇧1** / **⌘1** | Single Filer Mode. Left filer + right VIEWER (startup default) | |
| - | | **⇧2** | Filer on both sides | | + | | **⇧2** / **⌘2** | Dual Filer Mode. Filer on both sides. Search, the viewer, the editor, and the gallery open on the focused side | |
| - | | **⇧3** / **G** | Left filer + right gallery | + | | **G** | Gallery on that pane. G again returns to the filer | |
| - | | **⇧4** / **⌘F** | File search | + | | **F** / **⌘F** | File search. In Dual Filer Mode, on the focused side. Two searches stay separate | |
| + | | **W** | Switch between Single Filer Mode and Dual Filer Mode. Dual Filer Mode activates the right pane. Single Filer Mode activates the left. An unsaved editor asks before the switch | ||
| + | |||
| + | In Dual Filer Mode, the header of the side that does not have focus is a gray bar. | ||
| + | |||
| + | The window title is `VLE-Ben - FILER: path`: VLE-Ben, then the focused header. The tab name is only that header. A filer shows `FILER: path`, and an editor or viewer shows `EDITOR: name`. An unsaved editor adds `*` after the name. | ||
| ## Useful first steps | ## Useful first steps | ||
| 行 26: | 行 29: | ||
| 1. On a folder you return to often, press **⇧O** (set as the startup folder) so **O** can bring you back | 1. On a folder you return to often, press **⇧O** (set as the startup folder) so **O** can bring you back | ||
| 2. On folders you visit often, press **+** to add them to the **J** jump list | 2. On folders you visit often, press **+** to add them to the **J** jump list | ||
| - | 3. To read text one file after another, turn **P** (always-preview) on (meant for ⇧1) | + | 3. To read text one file after another, turn **P** (always-preview) on (meant for Single Filer Mode) |
| ## Moving | ## Moving | ||
| 行 37: | 行 40: | ||
| | Home / End | First / last row | | | Home / End | First / last row | | ||
| | Page Up / Page Down | One page | | | Page Up / Page Down | One page | | ||
| - | | Enter | Enter a folder or archive. A symbolic link to a folder opens the target; a link to a file moves to that file’s folder and selects it. A missing target is an error. While extensions are shown, applications and document packages are entered as folders. While they are hidden, you stay outside. A `.app` asks before launch only while extensions are hidden, and shows “Launching…” until the launch finishes. A disk image is mounted and you move onto that volume. | + | | Enter | Enter a folder or archive. A symbolic link to a folder opens the target; a link to a file moves to that file’s folder and selects it. While extensions are shown, applications and document packages are entered as folders. While they are hidden, you stay outside. A disk image is mounted and you move onto that volume. | |
| | Backspace / **-** | Go to the parent (leave an archive). At the root of a disk image, go to the folder that holds the image | | | Backspace / **-** | Go to the parent (leave an archive). At the root of a disk image, go to the folder that holds the image | | ||
| - | | Tab | Switch focus between left and right | | + | | Tab | Switch focus between left and right. The editor does not switch |
| - | | ⇧Tab | In two panes, swap the contents. Focus stays on the same side | | + | | ⇧Tab | In two panes, swap the contents. Focus stays on the same side. The editor does not swap | |
| + | | ⌃Tab / ⌃⇧Tab | Next tab / previous tab | | ||
| | ← → | Move between panes (in the tree, collapse / expand) | | | ← → | Move between panes (in the tree, collapse / expand) | | ||
| | ⇧← ⇧→ | Always move focus to the left or right pane | | | ⇧← ⇧→ | Always move focus to the left or right pane | | ||
| + | | ⌘← ⌘→ | Move focus between panes in every layout | | ||
| | **H** / **~** | Go to the home folder | | | **H** / **~** | Go to the home folder | | ||
| | **/** | Go to the root (`/`) | | | **/** | Go to the root (`/`) | | ||
| | **O** | Go to the startup folder. If none is set, or that folder is gone, go home | | | **O** | Go to the startup folder. If none is set, or that folder is gone, go home | | ||
| - | | **⇧O** | Set the folder you have open as the startup folder | + | | **⇧O** | Set the folder you have open as the startup folder | |
| - | | **V** | Move from the list of mounted volumes. If you use iCloud Drive, it appears after the disks and before FTP. A removable volume | + | | **V** | Move from the list of mounted volumes. A removable volume |
| + | | **B** | Folders left since launch. The previous folder is first. Choose one to go there | | ||
| | **J** | Jump (remembered folders) | | | **J** | Jump (remembered folders) | | ||
| | **⇧J** | Open a saved pair of left and right folders | | | **⇧J** | Open a saved pair of left and right folders | | ||
| - | | **+** | Add the folder you have open to Jump (asks first) | | + | | **+** | Add the folder you have open to Jump | |
| + | |||
| + | ### Back (B) | ||
| + | |||
| + | - Lists folders left since launch, newest first. The folder open now is omitted | ||
| + | - The previous folder is selected. Enter returns there | ||
| + | - **1–9** and a click go there too | ||
| + | - The list clears when the app quits | ||
| ### Jump (J) | ### Jump (J) | ||
| 行 58: | 行 71: | ||
| - **Home** moves to the filter field | - **Home** moves to the filter field | ||
| - **Del** deletes a bookmark | - **Del** deletes a bookmark | ||
| - | - **S** on a row sets that path as the startup folder. An FTP bookmark cannot be the startup folder | + | - **S** on a row asks, then sets that path as the startup folder. An FTP bookmark cannot be the startup folder |
| - On FTP, **+** remembers that connection’s folder | - On FTP, **+** remembers that connection’s folder | ||
| 行 65: | 行 78: | ||
| - **⇧J** opens the list of saved left-and-right pairs | - **⇧J** opens the list of saved left-and-right pairs | ||
| - **1–9** and **Enter** open that pair on both sides at once. The screen becomes two filers | - **1–9** and **Enter** open that pair on both sides at once. The screen becomes two filers | ||
| - | - **+** in the list remembers the left and right folders you have open (asks first). Both sides must be folders. A folder inside an archive, or a right side that is the viewer, is not remembered | + | - **+** in the list remembers the left and right folders you have open. Both sides must be folders. A folder inside an archive, or a right side that is the viewer, is not remembered |
| - **Del** removes that pair. **Esc** closes the list | - **Del** removes that pair. **Esc** closes the list | ||
| - If either folder is gone, neither side moves, and the pair is removed from the list | - If either folder is gone, neither side moves, and the pair is removed from the list | ||
| - | - An FTP folder can be remembered. The password is not stored in the pair | + | - An FTP folder can be remembered |
| ### Tree (T) | ### Tree (T) | ||
| - | - The tree root is the startup | + | - The tree root is the folder |
| - | - ← → collapse and expand. → on a folder that is already open moves to the file list on the right. After the folder changes, the cursor is on the first file. Returning to the same folder keeps that position. If there are no files, the cursor stays on the folder. With always-preview on, that file (including the first) is previewed | + | - ← → collapse and expand. → on a folder that is already open moves to the file list on the right. After the folder changes, the cursor is on the first file |
| - | - **Enter** moves into that folder and returns to the ordinary filer. While extensions are shown, a package is a folder. While they are hidden, you do not enter; only a `.app` asks before launch | + | - **Enter** moves into that folder and returns to the ordinary filer |
| - **Esc** leaves the tree and stays in the folder you had open | - **Esc** leaves the tree and stays in the folder you had open | ||
| 行 80: | 行 93: | ||
| - **Enter** on a file (or move the cursor while always-preview is on) | - **Enter** on a file (or move the cursor while always-preview is on) | ||
| - | - Opening a file from ⇧2 (two filers) lays the viewer | + | - The title and the name below match the filer |
| - | - Focus normally stays on the filer | + | - In Dual Filer Mode, the viewer |
| - | - When the right pane has focus, ↑ ↓ scrolls the text by one visible line, or advances a Quick Look preview. Text moves without animation. An animated image steps one frame. Page Up / Page Down and Space / ⇧Space move one screen. Home / End go to the start and the end. The left list does not move during this. Space does not tag the left pane. Commands aimed at the left pane (copy, delete, tag, and so on) do not arrive. Move between panes with Tab, ⇧Tab, and ←→. **E** opens the EDITOR. ⇧1–⇧4 change the layout | + | - When the right pane has focus, ↑ ↓ scrolls the text by one visible line, or advances a Quick Look preview. Move between panes with Tab, ⇧Tab, and ←→. **E** opens the EDITOR. ⇧1–⇧2 change the layout |
| ### What each kind looks like | ### What each kind looks like | ||
| 行 88: | 行 101: | ||
| | Kind | Appearance | | | Kind | Appearance | | ||
| |------|--------| | |------|--------| | ||
| - | | Folder | With always-preview: counts of the immediate children, | + | | Folder | Always-preview |
| | Text | Up to about 64 KB from the start. BOM, then strict UTF-8, then UTF-16 from a NULL pattern, then the Mac language (Japanese: CP932 / Shift_JIS, EUC-JP, Windows-1252. Western languages try Windows-1252 first) | | | Text | Up to about 64 KB from the start. BOM, then strict UTF-8, then UTF-16 from a NULL pattern, then the Mac language (Japanese: CP932 / Shift_JIS, EUC-JP, Windows-1252. Western languages try Windows-1252 first) | | ||
| | Markdown (`.md` / `.markdown`) | Headings are colored and table columns line up. **E** shows the source | | | Markdown (`.md` / `.markdown`) | Headings are colored and table columns line up. **E** shows the source | | ||
| | HTML (`.html` / `.htm`) | The VIEWER shows only the text of the body. **E** opens the source in the EDITOR | | | HTML (`.html` / `.htm`) | The VIEWER shows only the text of the body. **E** opens the source in the EDITOR | | ||
| - | | Image | Scaled to fit the pane. The next image replaces the previous one without clearing it first. Pixel size and camera name appear at the right end | | + | | Image | Scaled to fit the pane. Pixel size and camera name appear at the right end | |
| | APNG / animated GIF | A still frame, plus a frame stepper at the upper right | | | APNG / animated GIF | A still frame, plus a frame stepper at the upper right | | ||
| - | | PDF | Page view. On open it fits the width and starts at the top of page 1. A rotated page does the same. The scale is left alone after that. With focus on the right pane, ↑↓ scrolls | | + | | PDF | Page view. With focus on the right pane, ↑↓ scrolls | |
| - | | Application (`.app`) | Always-preview and search show the icon. Enter steps inside while extensions are shown. While they are hidden, launch asks first | | + | | Application (`.app`) | Always-preview and search show the icon, with the file name under it | |
| - | | Document package (`.pages` / `.key` / `.numbers` / `.rtfd` / `.egwud` / `.egwut`) | Always-preview shows a preview. Enter steps inside while extensions are shown. While they are hidden, you stay outside. The preview is the same. An old Keynote | + | | Document package (`.pages` / `.key` / `.numbers` / `.rtfd` / `.egwud` / `.egwut`) | Always-preview shows a preview. Enter steps inside while extensions are shown. While they are hidden, you stay outside. The preview is the same. An old Keynote is not previewed | |
| | Video | Quick Look, and it does not autoplay. `.mov` has playback controls and opens paused. Pixel size and camera name appear at the right end | | | Video | Quick Look, and it does not autoplay. `.mov` has playback controls and opens paused. Pixel size and camera name appear at the right end | | ||
| | Audio | Quick Look, and it does not autoplay | | | Audio | Quick Look, and it does not autoplay | | ||
| - | | Word-like (`.doc` and similar) | Text is extracted when that works. Runs of blank lines are kept to two. Otherwise | + | | Word-like (`.doc` and similar) | Text is extracted when that works. Otherwise Quick Look | |
| - | | Lotus Word Pro (`.lwp`), Ichitaro (`.jtd` / `.jtdc` / `.jtt` / `.jttc`) | The body becomes text. `.jtdc` is a compressed Ichitaro document. Otherwise Quick Look. They do not open in the EDITOR | | + | |
| - | | Publisher (`.pub`), `.jtp` | Quick Look | | + | |
| | Disk image (`.dmg` / `.sparseimage` and similar) | Enter mounts it and moves onto that volume. A writable image allows copy, move, and delete inside. Going to the parent from the root returns to the folder that holds the image | | | Disk image (`.dmg` / `.sparseimage` and similar) | Enter mounts it and moves onto that volume. A writable image allows copy, move, and delete inside. Going to the parent from the root returns to the folder that holds the image | | ||
| 行 108: | 行 119: | ||
| ### Always-preview (P) | ### Always-preview (P) | ||
| - | When it is on, the right pane follows the selection in the list. The same file is not redrawn. This is meant for ⇧1 (viewer on the right). A folder | + | When it is on, the right pane follows the selection in the list. While the selection |
| ## Editing (EDITOR) | ## Editing (EDITOR) | ||
| 1. Open a text file in the VIEWER (or select it) | 1. Open a text file in the VIEWER (or select it) | ||
| - | 2. **E** (or **⌘E**) enters the EDITOR. The caret and the scroll start at the top | + | 2. **E** (or **⌘E**) enters the EDITOR |
| 3. **⌘S** saves | 3. **⌘S** saves | ||
| - | 4. **Esc** | + | 4. **Esc** |
| Notes: | Notes: | ||
| 行 122: | 行 133: | ||
| - A file inside an archive cannot be edited or saved | - A file inside an archive cannot be edited or saved | ||
| - Click the encoding at the right end of the status line to change it. Besides UTF-8, UTF-16, CP932, Shift_JIS, and EUC-JP, you can choose Windows-1252 / 1250 / 1251 / 1253 / 1254 / 1257, GB18030, Big5, EUC-KR, and CP949. Japanese Shift_JIS-family text is Shift_JIS unless bytes `F0`–`FC` appear, in which case it is CP932. Saving keeps the encoding the file was opened with | - Click the encoding at the right end of the status line to change it. Besides UTF-8, UTF-16, CP932, Shift_JIS, and EUC-JP, you can choose Windows-1252 / 1250 / 1251 / 1253 / 1254 / 1257, GB18030, Big5, EUC-KR, and CP949. Japanese Shift_JIS-family text is Shift_JIS unless bytes `F0`–`FC` appear, in which case it is CP932. Saving keeps the encoding the file was opened with | ||
| - | - A column ruler appears at the top of the EDITOR. The text starts under it | + | - A column ruler appears at the top of the EDITOR |
| - | - When the caret leaves | + | - **Tab** and **⇧Tab** do not move focus or swap the panes |
| + | - A file has one editor. If the other pane, another tab, or another window is already editing it, focus stays here and an error is shown | ||
| ## Working with files | ## Working with files | ||
| 行 132: | 行 144: | ||
| |------|--------| | |------|--------| | ||
| | Space | Tag a file and move to the next row (folders cannot be tagged. Files inside an archive can). When the right preview has focus, Space scrolls the preview down one screen | | | Space | Tag a file and move to the next row (folders cannot be tagged. Files inside an archive can). When the right preview has focus, Space scrolls the preview down one screen | | ||
| - | | **⇧Space** | Clear tags on the focused pane (no confirmation. The other pane keeps its tags). When the right preview has focus, | + | | **⇧Space** | Clear tags on the focused pane. When the right preview has focus, the preview |
| - | | **W** | Tag by wildcard (for example `*.pdf`). Files inside an archive can be tagged | | + | | **Y** | Tag by wildcard (for example `*.pdf`). Files inside an archive can be tagged | |
| When any file is tagged, copy, move, and delete use the tags on the focused pane. Moving to another folder on that pane clears that pane’s tags. Moving the cursor or the folder on the other pane does not. With no tags and no mouse selection, copy and move use the file or folder under the cursor, and delete uses the file under the cursor (delete a folder with ⇧D). | When any file is tagged, copy, move, and delete use the tags on the focused pane. Moving to another folder on that pane clears that pane’s tags. Moving the cursor or the folder on the other pane does not. With no tags and no mouse selection, copy and move use the file or folder under the cursor, and delete uses the file under the cursor (delete a folder with ⇧D). | ||
| 行 141: | 行 153: | ||
| You can work on items in the current folder with the mouse. This is separate from tags (`*`). | You can work on items in the current folder with the mouse. This is separate from tags (`*`). | ||
| - | - A click selects that one item. A click on empty space clears the selection (Esc does not) | + | - A click selects that one item. A click on empty space clears the selection. The status line, Enter, and Copy leave that row alone. The next ↑ or ↓ brings the cursor back to that row (Esc does not clear it). While always-preview is on, the right pane goes empty too. A viewer opened with Enter while always-preview is off stays open |
| - A right-click on empty space shows only **New File** and **New Folder** | - A right-click on empty space shows only **New File** and **New Folder** | ||
| - **⌘-click** adds or removes an item (a row already chosen from the keyboard stays) | - **⌘-click** adds or removes an item (a row already chosen from the keyboard stays) | ||
| 行 147: | 行 159: | ||
| - Drag a selection onto a folder row (including `..`) and choose **copy** or **move** into that folder | - Drag a selection onto a folder row (including `..`) and choose **copy** or **move** into that folder | ||
| - A drop on empty space in the other filer (not on a file row) uses that pane’s current folder as the destination | - A drop on empty space in the other filer (not on a file row) uses that pane’s current folder as the destination | ||
| - | - Files dragged **from Finder** drop onto a folder row or a pane the same way. When the destination is FTP, the upload goes to the open current folder no matter which row you drop on (asks first. Folders can be sent too) | + | - Files dragged **from Finder** drop onto a folder row or a pane the same way. A drop from the other pane onto FTP does the same: the upload goes to the open current folder no matter which row you drop on (asks first. Folders can be sent too) |
| - With two or more items selected, **C** / **M** use that selection (folders may be included) | - With two or more items selected, **C** / **M** use that selection (folders may be included) | ||
| - | - A right-click on a row opens a menu for that item (Preview, Enter, Exec, Edit, Rename, Attr, Tag, Copy, Move, Delete, Compress, Extract, New Folder, New File). A file shows **Preview** (the VIEWER). A folder or archive shows **Enter** (step inside). While extensions are shown, a package also shows **Enter**. While they are hidden, a `.app` shows **Enter** and asks before launch, a document package shows **Preview**, | + | - A right-click on a row opens a menu for that item (Preview, Enter, Exec, Edit, Rename, Attr, Tag, Copy, Move, Delete, Compress, Extract, New Folder, New File). A right-click inside a multi-selection keeps that selection. A right-click on an unselected row selects that one row. A file shows **Preview** (the VIEWER). A folder or archive shows **Enter** (step inside). **Exec** opens the file in its associated app |
| - A right-click on a filer pane title offers **Copy Full Path**, **Open in Terminal**, and **Show in Finder**. Terminal and Finder use the local folder you have open. They are unavailable on FTP and inside an archive. A viewer title offers **Copy Full Path** and **Copy Name** | - A right-click on a filer pane title offers **Copy Full Path**, **Open in Terminal**, and **Show in Finder**. Terminal and Finder use the local folder you have open. They are unavailable on FTP and inside an archive. A viewer title offers **Copy Full Path** and **Copy Name** | ||
| 行 156: | 行 168: | ||
| | Key | Action | | | Key | Action | | ||
| |------|------| | |------|------| | ||
| - | | **C** | Copy. Out of a ZIP, and into a ZIP, both work. tar / tgz / lzh can be copied out | | + | | **C** | Copy. Out of a ZIP, and into a ZIP, both work | |
| | **M** | Move (a move inside the same folder is refused). Inside a ZIP, the item is removed after it has been copied out. A read-only archive refuses the move | | | **M** | Move (a move inside the same folder is refused). Inside a ZIP, the item is removed after it has been copied out. A read-only archive refuses the move | | ||
| | **D** | Delete (tagged files, or the file under the cursor). Inside a ZIP, that item is removed from the archive | | | **D** | Delete (tagged files, or the file under the cursor). Inside a ZIP, that item is removed from the archive | | ||
| 行 164: | 行 176: | ||
| | **I** | New empty file | | | **I** | New empty file | | ||
| | **A** | Attributes (mode, date, time). The file name is shown in full at the start. Owner / Group are displayed | | | **A** | Attributes (mode, date, time). The file name is shown in full at the start. Owner / Group are displayed | | ||
| - | | **X** | Open in the associated app (choose when there are several). A `.app` asks first, and a message stays up until the launch | + | | **X** | Open in the associated app (choose when there are several) |
| - | | **Z** | ZIP compress. Confirm the file name and press Enter (Esc cancels). One item starts as “name.zip”; | + | | **⇧X** | Type arguments after the file under the cursor and run it once in the current folder. Enter runs, Esc cancels. A file with the execute bit, or `.sh` `.bash` `.zsh` `.command`, can be run. Words inside quotes are one argument. Pipes and other commands cannot be entered. When it finishes, the result is shown. If there is no output and the exit code is 0, it says “Finished”. Unavailable inside an archive and on FTP | |
| - | | **U** | Extract. The zip / tar / tgz / lzh under the cursor is unpacked into the current folder. A single top-level folder stays as it is. Loose items go into a folder named without the extension. Existing files are not overwritten. If that folder already exists, nothing is extracted. Unavailable inside an archive and on FTP | | + | | **Z** | ZIP compress. Confirm the file name and press Enter. One item starts as “name.zip”; |
| + | | **U** | Extract. Confirm with Enter (Esc cancels). The right-click Extract command asks the same way. The zip / tar / tgz / lzh under the cursor is unpacked into the current folder. A single top-level folder stays as it is. Loose items go into a folder named without the extension. Existing files are not overwritten. If that folder already exists, nothing is extracted. A zip also restores the execute bit, symbolic links, and the zip's quarantine, so an extracted app can launch. Unavailable inside an archive and on FTP | | ||
| #### Where a copy or move goes | #### Where a copy or move goes | ||
| - | - **⇧2** (filers on both sides): the other pane. Confirmation is enough. A single-file copy shows that file name at the start of the prompt | + | - **Dual Filer Mode**: the other pane, when that pane is a filer or the gallery. Confirmation is enough. When the other pane is search, the viewer, or the editor, type a path. A single-file copy shows that file name at the start of the prompt |
| - | - **⇧1** / **⇧3**: type a destination path. A relative path is from the current folder. Enter on an empty field uses the folder you have open. A single-file copy shows the file name instead of a count | + | - **Single Filer Mode**: type a destination path. A relative path is from the current folder. Enter on an empty field uses the folder you have open. A single-file copy shows the file name instead of a count |
| - When the destination is the current folder and that file is already there, type another name. Enter with the same name warns and does not close | - When the destination is the current folder and that file is already there, type another name. Enter with the same name warns and does not close | ||
| - | - Copy, move, and delete show the file name and `File 2 / 5` even when they finish quickly. Progress is a row of `[#### | ||
| ## Changing how the list looks | ## Changing how the list looks | ||
| 行 179: | 行 191: | ||
| | Key | Action | | | Key | Action | | ||
| |------|------| | |------|------| | ||
| - | | **F** | Filter the names on screen. Esc ends it | | + | | **⇧F** | Filter the names on screen. Esc ends it | |
| - | | **S** | Sort (name / date / size). Left and right are separate. The first time the right pane appears, the sort is NAME. The current sort is on that pane’s bar, as `SORT: | + | | **S** | Sort (name / date / size). The current sort is on that pane’s bar, as `SORT: |
| | **L** | Localized names (`Documents` becomes `書類`, and so on) | | | **L** | Localized names (`Documents` becomes `書類`, and so on) | | ||
| | **.** | Show or hide hidden files | | | **.** | Show or hide hidden files | | ||
| | **⇧.** | Show every filename extension (the same idea as Finder. Off follows each file’s “hide extension” flag). `.localized` is hidden while this is off and shown while it is on. On: applications and document packages open as folders, and the extension is shown. Off: they stay packages and you do not enter them. The preview is the same | | | **⇧.** | Show every filename extension (the same idea as Finder. Off follows each file’s “hide extension” flag). `.localized` is hidden while this is off and shown while it is on. On: applications and document packages open as folders, and the extension is shown. Off: they stay packages and you do not enter them. The preview is the same | | ||
| - | The first time, extension display follows Finder’s “Show all filename extensions”. After you toggle **⇧.** once, the app keeps its own setting. The size column of a package (an application or a document) is that file’s size, not a folder’s `< | + | The first time, extension display follows Finder’s “Show all filename extensions”. After you toggle **⇧.** once, the app keeps its own setting. The size column of a package (an application or a document) is that file’s size, not a folder’s `< |
| - | ## Gallery (G / ⇧3) | + | ## Gallery (G) |
| - | Thumbnails of the images in the left list are laid out on the right. The arrow keys move the selection. While it is active, the blue and black themes | + | That pane shows the same files as the filer, as thumbnails |
| - | ## File search (⇧4 / ⌘F) | + | ## File search (F / ⌘F) |
| - | The left pane becomes search. Opening it clears the left pane’s tags. Spotlight looks under the folder you name. From the top: **Place**, then **Find**. | + | The left pane becomes search. Spotlight looks under the folder you name. From the top: **Place**, then **Find**. |
| - | **Place** starts as the current folder when search opened. Editing the path limits the search to that folder and below. `~` and a path relative to that current folder both work. An empty field returns to the current folder from when search opened. | + | **Place** starts as the current folder when search opened. The name follows localized names. Editing the path limits the search to that folder and below. `~` and a path relative to that current folder both work. An empty field returns to the current folder from when search opened. |
| **Find** is one word. Nothing is searched while it is empty. There are no wildcards. | **Find** is one word. Nothing is searched while it is empty. There are no wildcards. | ||
| 行 201: | 行 213: | ||
| **Match** is **Name only** or **Include text**. It starts as name only. Include text searches both file names and indexed contents under that place. On that row, **←→** or **Space** switches it. | **Match** is **Name only** or **Include text**. It starts as name only. Include text searches both file names and indexed contents under that place. On that row, **←→** or **Space** switches it. | ||
| - | - Each row uses the ordinary list layout: name, size, date. While a search is running, that status sits at the bottom | + | - Each row uses the ordinary list layout: name, size, date, and the same colors as the filer. While a search is running, that status sits at the bottom |
| - **↓** enters the results, and **↑↓** moves in that list. The right preview and the bottom status follow that file. The cursor in the current folder does not move | - **↓** enters the results, and **↑↓** moves in that list. The right preview and the bottom status follow that file. The cursor in the current folder does not move | ||
| - On a result, **Space** tags (not a folder), **C** copies, **M** moves, **D** deletes. Existing tags are the target. **→** moves to the preview on the right. While the preview has focus, **Space** / **⇧Space** scroll it one screen, and tags or copy do not reach the results. **Tab** or **←** returns to search. **⇧2** makes the right side a filer, and you can copy or move there. **⇧→** moves to the right pane. **⇧1** returns to the preview | - On a result, **Space** tags (not a folder), **C** copies, **M** moves, **D** deletes. Existing tags are the target. **→** moves to the preview on the right. While the preview has focus, **Space** / **⇧Space** scroll it one screen, and tags or copy do not reach the results. **Tab** or **←** returns to search. **⇧2** makes the right side a filer, and you can copy or move there. **⇧→** moves to the right pane. **⇧1** returns to the preview | ||
| - | - **E** edits, **X** opens externally (depending on the item). **↑↓** in the editor moves through the text and does not change the file | + | - **E** edits, **X** opens externally (depending on the item) |
| - | - A right-click on a result selects that row and opens a menu. A file offers **Preview**, | + | - A right-click on a result selects that row and opens a menu. A file offers **Preview**, |
| - | - **Esc** ends search | + | - **Enter** on a compressed file in the results opens it. `..` or **Backspace** goes to the parent. At the top of the archive, that is the folder that holds the file. **Esc** returns to the search results |
| + | - **Enter** on a disk image (`.dmg` / `.sparseimage` | ||
| + | - **Esc** ends search. Tags made in search are cleared and do not stay on the filer count | ||
| ## Colors | ## Colors | ||
| 行 214: | 行 228: | ||
| | Cyan | Folder | | | Cyan | Folder | | ||
| | Pale green | Folder shown with a localized name | | | Pale green | Folder shown with a localized name | | ||
| - | | Yellow | Compressed archive | | + | | Yellow | Compressed archive, disk image (`.dmg` and similar) |
| | White | File you can read and write | | | White | File you can read and write | | ||
| | Purple | File you can read but not write | | | Purple | File you can read but not write | | ||
| 行 231: | 行 245: | ||
| ## Quit | ## Quit | ||
| - | **Q** — asks “Quit?” and then quits. | + | **Q** asks “Quit? |
| ## FTP | ## FTP | ||
| - | **FTP Connection…** on the **VLE-Ben** menu stores | + | **FTP Connection…** on the **VLE-Ben** menu stores explicit-FTPS connections. It opens on the list. Order is by server name, and by account name when the server is the same. ↑↓ selects a row, and Enter opens that setup. **New** starts a blank setup. In the setup, ↑↓ moves between fields. Space toggles FTPS and passive. Enter saves and returns to the list. Esc returns to the list without saving. On the list, Del asks before deleting, |
| - | In the **V** volume list, disks come first, then iCloud Drive when you use it, then the saved FTP connections. A removable disk has an icon on the right of the row; click it or press **U** to unmount. The startup disk has no icon. The label is `user@server`, | + | In the **V** volume list, disks come first, then iCloud Drive when you use it, then the saved FTP connections. A removable disk has an icon on the right of the row; click it or press **U** to unmount |
| - | Transfers and deletes show the file name and `File 2 / 5`. Esc cancels. A drop from Finder | + | Transfers and deletes show the file name and `File 2 / 5`. Esc cancels. A drop of files or folders |
| ## Language and display | ## Language and display | ||
| - | **Save** on the **File** menu writes the editor’s contents. | + | **Save** on the **File** menu writes the editor’s contents. It is gray when the editor is not open. |
| From the **Edit** menu: | From the **Edit** menu: | ||
| 行 252: | 行 266: | ||
| From the **View** menu: | From the **View** menu: | ||
| - | - **Viewer**, **2 Filers**, **Gallery**, | + | - **Single |
| - **Refresh** (⌘R), **Refresh All** (⇧⌘R) | - **Refresh** (⌘R), **Refresh All** (⇧⌘R) | ||
| - | - **Language**: | + | - **Language**: |
| - **Color Theme**: Blue (Retro) / Black (Dark) / White (Light). The default is blue. It does not follow the system dark or light appearance | - **Color Theme**: Blue (Retro) / Black (Dark) / White (Light). The default is blue. It does not follow the system dark or light appearance | ||
| - **Font Size**: the monospaced size of the UI | - **Font Size**: the monospaced size of the UI | ||
| 行 262: | 行 276: | ||
| With no modifier: | With no modifier: | ||
| - | **C M D N K I A X Z · E T G P · F S L · J H O U V W · Q** | + | **C M D N K I A X Z U · E T G P W · F S L · B J H O V Y · Q** |
| While Shift is held: | While Shift is held: | ||
| - | **⇧D ⇧Space ⇧. ⇧O ⇧J · ⇧← ⇧→ · ⇧1 ⇧2 ⇧3 ⇧4** | + | **⇧D |
| While fn is held: | While fn is held: | ||
| 行 276: | 行 290: | ||
| The status chips at the right end also toggle when clicked. **PREV** is always-preview, | The status chips at the right end also toggle when clicked. **PREV** is always-preview, | ||
| - | When the active pane is FTP, unavailable commands are dimmed: move, attributes, exec, compress, tree, extract, wildcard, and set startup folder. Move is also dimmed when the other pane is FTP. Gallery and file search are dimmed when the left pane is FTP. On a row’s right-click menu, exec, attributes, move, and compress are unavailable under the same conditions. | + | When the active pane is FTP, unavailable commands are dimmed: move, attributes, exec, Shift-X, compress, tree, extract, wildcard, and set startup folder. Move is also dimmed when the other pane is FTP. Gallery and file search are dimmed when the left pane is FTP. On a row’s right-click menu, exec, attributes, move, and compress are unavailable under the same conditions. |
| ## Filer key bindings (letters) | ## Filer key bindings (letters) | ||
| 行 285: | 行 299: | ||
| |-|----------------------|-----------------------|------------------| | |-|----------------------|-----------------------|------------------| | ||
| |A|Change attributes|Change attributes|Change attributes| | |A|Change attributes|Change attributes|Change attributes| | ||
| - | |B|Backup to tape|—|—| | + | |B|Backup to tape|—|Back| |
| |C|Copy|Copy|Copy| | |C|Copy|Copy|Copy| | ||
| |D|Delete file|Delete file|Delete file| | |D|Delete file|Delete file|Delete file| | ||
| |E|Edit file|Start editor|Editor mode| | |E|Edit file|Start editor|Editor mode| | ||
| - | |F|File search|File search|Name filter| | + | |F|File search|File search|File search| |
| |G|—|—|Gallery| | |G|—|—|Gallery| | ||
| - | |H|Run a child process | + | |H|Run a child process|Change directory|Go to the home folder| |
| - | |I|File system information|Create an ish / maj file|New empty file| | + | |I|File system information|Create an ish/maj file|New empty file| |
| |J|—|Directory jump|Directory jump| | |J|—|Directory jump|Directory jump| | ||
| - | |K|Make directory | + | |K|Make directory|Make directory|Make directory| |
| - | |L|Absolute | + | |L|Change |
| - | |M|Move|Move|Move | + | |M|Move|Move|Move| |
| - | |N|—|Rename | + | |N|—|Rename|Rename| |
| - | |O|—|—|Go to the startup folder | + | |O|—|—|Go to the startup folder| |
| - | |P|Compress | + | |P|Compress||Always-preview| |
| |Q|Quit|Quit|Quit| | |Q|Quit|Quit|Quit| | ||
| - | |R|Rename|Run | + | |R|Rename|Run|Rename| |
| |S|Sort|Sort|Sort| | |S|Sort|Sort|Sort| | ||
| |T|Tree view|Tree view|Tree view| | |T|Tree view|Tree view|Tree view| | ||
| |U|Expand archive|Extract / restore ish·maj|Extract| | |U|Expand archive|Extract / restore ish·maj|Extract| | ||
| |V|View file|Show file|Choose a volume| | |V|View file|Show file|Choose a volume| | ||
| - | |W|Write the displayed directory|Write the sort result|Wildcard tag| | + | |W|Write the displayed directory|Write the sort result|Switch layout| |
| - | |X|Execute file (eXec)|Execute command | + | |X|Execute file|Execute command|Open |
| - | |Y|—|Change wildcard|—| | + | |Y|—|Change wildcard|Bulk wildcard| |
| - | |Z|—|Compress COM/ | + | |Z|—|Compress COM/EXE|ZIP compress| |
| ## When something does not work | ## When something does not work | ||
