46
Files
Anatolii Hrynchuk edited this page 2026-11-20 07:56:23 +02:00
This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

KSwitcher Files

English | Українська

Open Files from the KSwitcher tray menu. The two panes can show different folders on local disks, paired PCs or FTP servers. Alt+F1 and Alt+F2 open the drive list for the left and right panes. Reopen the list to refresh remote drives.

Compare files

Mark two files in the active pane or put the cursor on one file in each pane. Open Commands → Compare files or press Shift+F11. Local, LAN and FTP text files up to 2 MiB and 100,000 lines can be compared in a separate, read-only Windows window.

Drag the central splitter to resize the panes. Use Ctrl+mouse wheel to zoom and F7/F8 to jump between change blocks. Leading and trailing whitespace is ignored by default. Select Show whitespace changes to include it. Set the shortcut, font and colors under Options → File comparison → Font and colors.

Ctrl+Left/Right adjusts the main file panes. The selection total includes folder sizes calculated with F3. ≥ marks a lower bound. Failed local F5–F8 operations can be retried through Windows UAC when access is denied.

FTP connections

  1. Open the source menu with Alt+F1 or Alt+F2, then choose FTP or press 1. Shift+F4 creates a connection, F4 edits it, and Enter opens it in that pane.
  2. Enter a profile name, host, port (21 by default), user name and password. A blank user name selects anonymous login. Windows DPAPI protects saved passwords. Plain FTP sends data without encryption. Names use UTF-8 by default. Enable Use Windows encoding for file names and reconnect if a legacy server uses the system Windows code page.
  3. The title shows the server’s actual working directory. Enter or double-click on .. goes up one directory. The server root has no .. row. To return to saved connections, reopen FTP from the source menu.

F3 or Enter views a file, F4 edits it, and F2 in the editor uploads changes. A reported change in the remote size or modification time leaves the edits in the editor and prevents replacement. F5 copies files and folder trees between the FTP pane and a local pane in either direction. FTP replacement requires server support for rename over an existing file. F6 renames a single item in its current FTP folder. F8 confirms permanent deletion and separately asks before deleting a nonempty folder tree.

Local drive letters and displayed digits activate their source immediately. FTP uses 1. LAN drives and Wake use available digits 2–9 and 0, which stay assigned while the menu is open.

Open files and folders

With visible panes and an empty command line, Shift+Enter opens the current local folder in File Explorer or invokes the Windows default action for a local file, including BAT and CMD. Plain Enter opens folders in the pane and uses the embedded terminal for BAT and CMD.

Press Enter or double-click an item. Folders open in the current pane, documents open in their default Windows apps, and EXE files launch as separate processes. BAT and CMD files, including paths with spaces, run with the environment of the existing embedded PowerShell session. Their output appears below the panes. To open a LAN file in an external Windows app, copy it to a local folder first.

Both local panes refresh when another program creates, changes, or deletes files in the folders they display. Focus stays where it was, and the cursor stays on the selected item if it is still present.

Folder sizes

F3 measures the folder under the cursor or each marked folder. On .. it measures all folders in the current list. The queue runs one folder at a time, with Queued for waiting folders and a spinner after two seconds on the folder being measured. Moving the cursor leaves the spinner in that folder’s row. Esc cancels the active pane’s queue in place. Changing the directory or source also cancels the queue. Finished sizes appear in Size in Wide mode and on the status line when configured. Unreadable contents produce a partial result.

Text viewer and editor

  • F3 opens the read-only viewer and F4 opens the editor. Alt+F3 opens the Windows default app and Alt+F4 invokes the registered Edit action. From v0.6.105, the Editor has a purple pencil icon and the Viewer has a teal eye icon in the title bar and Alt+Tab. Windows groups their windows separately on the taskbar. F6 updates the icon and group in the same window. The text area uses the selected palette from the moment it appears. Reopening a file offers to switch to its existing window. Closing the file manager leaves its open text windows running.
  • From v0.6.94, F3 opens a rendered Markdown preview with tables, code blocks, interactive task-list checkboxes and Mermaid diagrams. Mermaid uses bundled assets and works without internet access. An invalid diagram leaves its source visible and the rest of the document readable. Checkbox changes are written to the Markdown source and restored when reopening the file. The viewer reports save errors. Mermaid edge labels appear above their connecting lines. Markdown files over 8 MiB or systems without working WebView2 use the text viewer.
  • From v0.6.95, the preview appears after Mermaid renders. Changes to the local file refresh the open preview and preserve scroll position. Click internal links to navigate in the same window and Shift+click to open a separate window. Use the Back and Forward arrows, mouse side buttons or Alt+Left/Right for history. Ctrl+W closes the viewer. Ctrl+Tab cycles through Files and its open editors and viewers without closing them. Up and Down wrap in menus and drop-downs and skip separators.
  • Relative links and images resolve from the original document folder. For a LAN document, Files fetches images in the background and linked files on click from the same paired PC. Linked Markdown documents use their own folder as the base.
  • F6 switches between View and Edit in the same window for files supported by the built-in editor. Markdown uses the rendered preview in View mode and the syntax-highlighted text editor in Edit mode. Unsaved changes prompt for Save, Discard or Cancel. Cancel or a failed save leaves the editor open with the changes.
  • F3 and F4 on LAN panes download the file in the background to a temporary disk copy. Saving sends it back to the remote PC. The save is rejected if the remote size or modification time has changed, and your edits stay in the editor. Update the remote KSwitcher to v0.6.85 or later for writeback. External Alt+F3 and Alt+F4 still require a local copy.
  • Syntax → Automatic recognizes C#, C/C++, HTML, JavaScript, SQL, PowerShell and other formats. Choose a Lexilla lexer manually from the Syntax menu. Multiline highlighting restarts at page boundaries.
  • Large files open in pages of about 1 MiB. Ctrl+Page Up/Down switches pages and F5 goes to a page. Ctrl+F searches the current page and F3 repeats the search. Open shared search history with the arrow or Alt+Down.
  • F2 or Ctrl+S saves. Edits on other pages are staged on disk. An edited page can grow to 8 MiB in UTF-8, and saving requires disk space for a new copy. Undo works on the current page. Closing prompts to save only when there are pending edits.
  • Options → Viewer / Editor provides separate settings for wrapping, line numbers, whitespace, current-line highlighting, tab width and color schemes including FAR (blue). The editor also supports automatic indentation and configurable line endings. Set the shared font in Appearance → Font.
Editor Viewer
Purple Editor pencil Teal Viewer eye

Markdown appearance and HTML

From v0.6.121, if WebView2 fails to finish starting, Files retries once in the same window before opening the text viewer. The bundled Mermaid library loads when the document contains a Mermaid diagram.

From v0.6.104, Ctrl+F or the magnifier opens search in the rendered document. Search ignores case and shows the match count and the current match. Enter and F3 move to the next match. Shift+Enter and Shift+F3 move to the previous match. The shortcuts wrap at the ends. Escape closes the search first.

From v0.6.103, Options → Viewer → Markdown sets the maximum width, font family and font size, independently of the text editor. The defaults are 960 px, the system font and 12 pt. Set width to 0 for full window width. Apply updates open Markdown previews. Files Options reopens on its last section, including after Cancel, which discards unapplied edits.

The preview renders HTML tables, inline formatting, links and relative images in Markdown. Use <span style="white-space: nowrap">In Development</span> inside a table cell to keep the text together. The viewer filters scripts, embedded pages and event handlers.

HTML within the Markdown preview

From v0.6.99, Enter and Shift+Enter can run the typed command with panes hidden. Running a command reveals terminal output if hidden. When the panes are hidden, Enter on an empty line sends a blank line to the terminal.

From v0.6.100, with focus in the terminal output, Enter and Shift+Enter return focus to the command line to act on the typed command. Submitting a command scrolls to the latest terminal output.

From v0.6.101, the same keys also work with an empty command line and visible panes when focus is in the terminal output. Enter opens the selected item and Shift+Enter uses the default Windows action for the selected local item.

From v0.6.97, selecting another row clears the cursor highlight from the previous row. A click updates only the affected cursor rows when selecting a file or switching panes. From v0.6.98, Left and Right clear the previous highlight when jumping to the first or last row with an empty command line.

The command line keeps keyboard focus in the main window. With an empty command line, Enter opens the item under the cursor.

  • Ctrl+F inserts the full path of the item under the active pane cursor at the command-line caret, or replaces selected text. Double quotes are added only when the path contains spaces. On the .. row it inserts the path of the open folder.
  • Ctrl+Enter inserts just the file or folder name at the caret or replaces selected text. Names with spaces are quoted. The parent-folder row is skipped.
  • From v0.6.103, Ctrl+C and Ctrl+Insert copy selected terminal output. Without an output selection, both copy the full nonempty command line. Ctrl+Insert with an empty command line copies marked names from the active pane in display order, one per line, or the name under the cursor if there are no marks. Paths and the parent-folder entry are skipped.
  • From v0.6.93, Ctrl+R refreshes the current folder in the active pane. The cursor and marks stay on items that still exist. Refresh clears folder sizes measured with F3. F2 also works.
  • Ctrl+V and Shift+Insert paste at the caret or replace the selection.
  • Alt+character starts a case-insensitive filename or folder prefix search. The Search popup opens at the bottom of the active pane on the first match. Release Alt and keep typing to refine the prefix. Backspace removes a character, Esc closes the popup, and Enter opens the current result.
  • F9 opens the menu. Pressing Alt alone leaves the menu closed.

Command-line suggestions — v0.6.107

Type in the Files command line with the panes visible or hidden. Ctrl+O toggles the panes. Suggestions narrow while you type. At the end of the line, up to five distinct recent commands with a matching prefix appear first. History suggestions also work in LAN panes.

  • Up and Down select a suggestion. Tab inserts the selected or first suggestion. Enter inserts a highlighted suggestion, as does a click on it. Press Enter again to run it, or use Shift+Enter to run the current line immediately. Esc closes the list and keeps your text.
  • With the list closed and panes visible, Tab by itself switches the active pane and Up and Down move the pane cursor. Page Up and Page Down move the pane cursor even while the list is open. With no list, Esc clears the command line.
  • The local terminal suggests PowerShell commands, aliases, parameters and paths. After cd , choose a directory and keep typing a nested path. Relative path suggestions use the active pane’s folder. Path suggestions can include quotes for spaces.
  • The offline Windows catalog follows documented subcommands and argument choices. For example, netsh interface ipv4 show co suggests config, while schtasks /query /fo suggests CSV, LIST, and TABLE. F1 opens the full Microsoft Learn article for the command or subcommand in your browser.
  • After ipconfig /renew or ipconfig /release , suggestions use local adapters with DHCP enabled for IPv4. Adapter names with spaces are quoted. Git completion uses the installed Git for Windows script and local repository data, including matching branch names where applicable. dotnet suggestions use the installed .NET SDK.
  • The main Files window uses a blue two-pane icon with a teal frame. The Editor and Viewer retain their own icons.

Windows command suggestions with panes hidden

Main Files title with the new icon

File operations and commands

From v0.6.90, separators in Commands distinguish navigation, viewing and editing, and remote PC actions. Arrow keys skip separators. Shared notices fit their text and show a scrollbar only for overflow.

Use F5 to copy, F6 to move or rename, and F8 to delete. The F8 Delete item in the key bar opens the same confirmation as the keyboard shortcut. The FAR-style key bar uses gray key labels on black and dark action names on teal. When a destination file already exists, the Ask mode shows its size and modification time alongside the incoming file.

While reading a local or LAN folder, the active pane shows Reading with a count of files and folders. The previous list stays visible during reading. Esc stops the scan and displays the entries already read, marked Partial. Ctrl+R reads the folder again. Mouse selection works beyond the first 65,536 rows. Copy and Rename/Move validate destinations in the background, and waiting for a folder listing after UAC happens in the background. F8 moves items to the Recycle Bin, and Shift+Delete deletes them permanently.

From v0.6.110, entering a folder or returning to its parent refreshes only the affected panel and the command line. The other panel can still refresh independently if its own folder changes.

From v0.6.111, a panel updates as soon as the background scan finishes. Press Ctrl+U with both panels visible to swap their sides. The folders, view modes, cursor positions, and marked items move with the panels. The active panel stays active on its new side. Ctrl+Tab switches between Files, Editor, and Viewer windows. With only Files open, it leaves the active panel in place.

From v0.6.114, clicking a row in the other pane moves the active highlight directly to that row. If the previous row in that pane used a custom unfocused cursor style, it returns directly to its normal style.

From v0.6.115, Shift+F4 in a local pane opens or creates a file in the editor. Leave the file name blank for a generated New_File_…txt name. A new file is written when you save it. After editing, press Esc and choose Save to set its name, code page, BOM and line endings. Canceling the save options leaves the draft open. Typing updates the status line without flashing the editor.

When Enter opens a local file through Windows, Files shows its absolute path in terminal output and command history. Selecting that history entry inserts the command to reopen the file from any folder. The embedded terminal hides its cursor when inactive.

From v0.6.112, Ctrl+Shift+Tab cycles backward through the same windows, including the Markdown preview. Ctrl+Tab cycles forward in opening order. Both shortcuts wrap at the ends of the list.

When rows overflow, the panels and Files popups show up and down arrows, a dotted track, and a thumb lighter than the surface. This applies to the drive and LAN picker, command suggestions and history, folder shortcuts, and drop-down lists such as Make folder history. Long notices also use this scrollbar. Click an arrow to move one row, click the track to move by a page, or drag the thumb.

Far-style scrollbar in Folder shortcuts

When copy, move or delete fails, Files opens a red dialog. If a local file or folder is locked, choose Processes… to see process names and PIDs. End process forces the selected process to exit after confirmation, which can lose unsaved work. The list refreshes after the process exits. Retry the original operation. Scans can be partial for large folders or inaccessible items. The list covers local processes.

F7 → Make folder creates entries in the active pane. Use the arrow or Alt+Down to open name history. With Process multiple names, separate names with commas or semicolons and quote names that contain either separator. Link type offers none, directory junction, or symbolic link. Target is active for links. Symbolic links depend on Windows permissions. Update both PCs before creating links in a LAN pane.

Files dialogs stay open when you click outside the app, move with their owner, and narrow to their minimum width as the owner narrows.

Make folder name history

Use the embedded PowerShell terminal for commands. Alt+F8 opens searchable command history. Search by command or topic, select a result, then press Enter to put the full command in the command line. Ctrl+E recalls older commands. Configure these shortcuts and file styles in Files Options. Changes applied there take effect in other open Files windows on the same PC.

From v0.6.119, a local command starts in the active pane’s folder, shown at the prompt. For example, after switching panes with Tab, git clone <URL> creates the repository’s directory under the folder shown at the prompt. PowerShell keeps the same session. If a command changes directory with cd, Files follows it in the originating pane provided that pane has stayed in its starting folder.

From v0.6.113, the terminal output area stays dark while WebView2 loads.

PowerShell on a paired PC

Update both PCs to v0.6.86 or later. On the PC that will run commands, open Files → Options → Command line → Command history, enable Allow paired PCs to run PowerShell commands here, and apply the change. It is disabled by default. When enabled, paired PCs can run commands under the Windows account running KSwitcher, without elevation.

In a LAN pane, enter a command and press Enter. PowerShell starts in that pane’s current directory on the remote PC. Output, errors and the exit code appear as text in the Files terminal. PowerShell progress metadata is hidden. Use v0.6.87 or later on the PC that runs the command. Each command runs separately, so a change of directory or PowerShell variable lasts only for that command. Press Escape while the command line is empty to cancel a running remote command.

From v0.6.100, if you press Enter for another command while a LAN command is still running, Files keeps the new command in the input field and displays the cancellation instructions. Clear the command line and press Escape to cancel the running command.

From v0.6.105, LAN PowerShell also starts when KSwitcher on the receiving PC is running as administrator. Commands such as dir still run with standard user rights. If an older receiving PC reports 0xC0000142 before any output, update that PC to v0.6.105 or later.

Use v0.6.102 or later on both PCs to receive PowerShell startup failures directly in Files. If Windows reports DLL initialization failure 0xC0000142 on the receiving PC, Files displays the error and accepts another command. The failure occurs before PowerShell executes the command.

After updating from v0.6.95 or later, reopen Files to use the new version and load the LAN peer list.

Wake a paired PC — v0.6.108

Open Change drive with Alt+F1 or Alt+F2. Click the underlined Wake beside the offline status of the paired PC, or use the arrow keys to focus the action and press Enter. The status bar reports whether the Wake-on-LAN packet was sent. Setup and troubleshooting.

Hibernation and updates on a paired PC

From v0.6.89, F9 → Commands offers Hibernate remote PC and Update remote KSwitcher when the active pane is a LAN pane. If the panes show different PCs, select the intended pane and check the PC name in the confirmation.

The sending PC shows a red warning before hibernating or updating the selected PC, with No focused by default.

On the target PC, open Files → Options → Command line → Command history and enable Allow paired PCs to hibernate this PC, Allow paired PCs to update KSwitcher here, or both. Both permissions are off by default. Windows hibernation must be enabled for the hibernate action.

If a newer stable package is available, the updater verifies it, closes KSwitcher and this installation’s Files, Config, screenshot editors and bundled StayHere without prompts, then restarts KSwitcher after installation. Forced closure discards unsaved changes. The target PC records the closed processes and update result in kswitcher.log.

From v0.6.91, Change drive retries failed queries to paired PCs. Remote updates wait for a running update check. The journal confirms exits of processes from this installation, including Files running from an update backup.

Українська · LAN

PowerShell cd updates the pane that submitted the command. Ctrl+Alt+F activates an open Files window. When Write log is enabled, LAN diagnostics are saved to the separate kswitcher-files.log.

Change drive shows the reason when a peer lookup fails. No paired computers means KSwitcher returned an empty list.

From v0.6.109, Ctrl+0–9 opens the single folder assigned to the pressed digit or shows only that digit’s list when it has multiple entries. Enter opens the selected folder in the active panel. Insert adds the current folder, F4 edits the shortcut, Delete removes it, and Ctrl+Up/Down changes its order. Use Commands → Folder shortcuts to choose a group or Ctrl+Shift+0–9 to add the current folder to a digit.

Ctrl+F1 selects Brief and Ctrl+F2 selects Wide for the active panel. Ctrl+F3–F12 are reserved for other panel modes. Update any command-history bindings that used Ctrl with a function key in Options → Command line → Command history.