Repository navigation
settings
Generated by
scripts/settings-reference.shfrom rCommander's settings schema (crates/rc-engine/src/settings/), the settings dialog's pages and its texts; do not edit by hand. It cannot drift from what the program does: the same rows are the program's settings.
Every setting of the settings dialog (Configuration > Settings...), page by page in the
dialog's order, with its key, the values it takes and its default. The key is the name an AI
assistant uses with the MCP tools settings_get and settings_set (MCP server), and the
name an exported settings file carries.
-
Protected: only a person in the window changes it;
settings_setrefuses it for every caller, so an assistant never widens its own rights or chooses the programs and code that run. - Restart: it takes effect the next time rCommander starts.
| Setting | Key | Values | Default | Description |
|---|---|---|---|---|
| Language | appearance.language |
One of Automatic (auto), English (en), Deutsch (de), Français (fr), Español (es) |
Automatic | The language of menus, dialogs and messages. Automatic uses the language of Windows when rCommander has it, English otherwise. Restart. |
| Theme | appearance.theme |
One of System (system), Light (light), Dark (dark) |
System | Light or dark; System follows Windows, also when it changes while rCommander runs. Each mode draws with its theme (Themes tab). |
| Themes of connections and WSL distributions | appearance.connection_themes |
On or off | On | A connection and a WSL distribution can each have a theme of their own for each mode (the connection in the connection manager, the distribution on the tab Themes): the panel - the list, the headers, the tabs - and its SSH or WSL terminal draw with it, so servers and distributions are told apart at a glance. Off: every panel draws with the window's theme; the connections and distributions keep theirs. |
| Show the function-key bar | appearance.function_key_bar |
On or off | On | The row of F3 to F8 at the bottom of the window; the keys work either way. |
| Show the button bar | appearance.button_bar |
On or off | On | The bar of buttons under the menu bar; Configuration > Button bar... changes its buttons. |
| Show the vertical button bar | appearance.vertical_button_bar |
On or off | Off | A second bar of buttons between the two panels, as Total Commander's Button Bar 2. |
| Bar above the panels | buttonbar.horizontal |
A whole number from 0 to 2147483647 | 0 | The id of the bar the button bar shows; 0 shows the first. Use as button bar in the button bars' window sets it. |
| Bar between the panels | buttonbar.vertical |
A whole number from 0 to 2147483647 | 0 | The id of the bar the vertical button bar shows; 0 shows the first. |
| Size of the button symbols | buttonbar.icon_size |
One of 16 pixels (16), 24 pixels (24), 32 pixels (32) |
24 pixels | The side of a button's symbol, in pixels. |
| Show the drive buttons | appearance.drive_bar |
On or off | On | The bar of drive buttons above the panels; the drive line under it stays. |
| Show the command line | appearance.command_line |
On or off | On | The command line under the panels. |
| Show the status bar | appearance.status_bar |
On or off | On | The line at the bottom of the window with the MCP server, the jobs and the news. |
| Menu bar | appearance.menu_bar |
On or off | On | The menu bar at the top of the window, opened with Alt and a menu's underlined letter. Without it every command keeps its key and its row in the command palette (Ctrl+Shift+P). |
| Menu bar style | appearance.menu_bar_style |
One of In the theme's colours (drawn), Windows menu (native) |
In the theme's colours | How Windows shows the menu bar: drawn by rCommander in the theme's colours, or the Windows menu, which knows only light and one dark grey. Alt with a menu's underlined letter opens a menu either way. Changes at once. |
| Mac look on macOS | appearance.macos_look |
On or off | On | On: macOS's greys for light and dark mode with the accent chosen in System Settings, San Francisco and Menlo as fonts, and a transparent title bar over the window. Off: the look rCommander has on Windows and Linux, with the system's title bar. The menus stay in the system's menu bar either way. Only on macOS. Restart. |
| Dialogs in windows of their own | appearance.dialog_windows |
On or off | On | When on, the dialogs open in windows of their own that you can move and resize; each opens where you left it. That is the connection manager, find files, multi-rename, compare/synchronize, the checksum results, the login-script editor and Lister, the smaller dialogs: backup, restore, export and import, properties, quick connect, network drives, pack and unpack, the checksum forms, the directory hotlist and Run command, the file operations: copy, move, new folder or file, delete, their questions and the progress window, and the small questions: an agent's call, host keys and certificates, the vault, quitting, an archive's password, a large download and synchronizing. Multi-rename, the smaller dialogs, the file operations and the questions (but synchronizing's, which waits only for its window) keep the main window waiting; beside the others you can work on in the main window. When off, they open over the main window. |
| Ask to restart when the graphics are lost | appearance.gpu_loss_notice |
On or off | On | When on and the graphics card loses its device (a driver reset, standby, a change of GPU), rCommander can no longer draw; a message box asks whether to restart it. Tabs and places are kept, transfers continue at the next start. When off, the window stays as it is until you close it. |
| Setting | Key | Values | Default | Description |
|---|---|---|---|---|
| File list font | appearance.list_font |
The name of an installed font | empty | The font of both file lists, their tabs and the path line; a monospaced one lines up names, sizes and dates. Default is the interface font. |
| File list font size | appearance.list_font_size |
A whole number from 8 to 24 | 13 | In points, 8 to 24; the rows grow and shrink with it. |
| Terminal font | terminal.font |
The name of an installed font | empty | The font of the terminals in the panels. Default is Cascadia Mono. |
| Terminal font size | terminal.font_size |
A whole number from 8 to 24 | 13 | In points, 8 to 24. |
| Viewer font | viewer.font |
The name of an installed font | empty | The font of the viewer's text and hex views (F3, Quick View). Default is Cascadia Mono. |
| Viewer font size | viewer.font_size |
A whole number from 6 to 72 | 13 | In points, 6 to 72. Ctrl+wheel, Ctrl++ and Ctrl+- in the viewer change it for one window, or store it here when the setting below says so. |
| Setting | Key | Values | Default | Description |
|---|---|---|---|---|
| Theme of the light mode | appearance.theme_light |
The id of a colour theme, built in (such as fluent-dark, nord-light) or the person's own; one of the other mode or none at all draws with Fluent |
fluent-light |
The colours rCommander draws with while the look is light, the terminals' included. |
| Theme of the dark mode | appearance.theme_dark |
The id of a colour theme, built in (such as fluent-dark, nord-light) or the person's own; one of the other mode or none at all draws with Fluent |
fluent-dark |
The colours rCommander draws with while the look is dark, the terminals' included. |
| Themes of the WSL distributions | appearance.wsl_themes |
Lines, one per WSL distribution: its name, a tab, a light theme's id and a dark theme's id after another tab, either empty for the window's | empty | Per WSL distribution a light and a dark theme: a panel on its share and its WSL terminal draw with it. |
| Light: Text | appearance.colours.light.text |
A colour #rrggbb; empty for the look's own |
empty | The names and the other text of the file lists, the tree and the panels. Empty: the look's own. |
| Light: Background | appearance.colours.light.background |
A colour #rrggbb; empty for the look's own |
empty | The fill of the file lists, the tree and the panels. Empty: the look's own. |
| Light: Second background | appearance.colours.light.stripe |
A colour #rrggbb; empty for the look's own |
empty | Every other row, while Alternate row colours (Lists) is on. Empty: the look's own tint. |
| Light: Cursor | appearance.colours.light.cursor |
A colour #rrggbb; empty for the look's own |
empty | The cursor's row in the panel that has the keyboard. Empty: a tint of the accent. |
| Light: Cursor in the other panel | appearance.colours.light.cursor_inactive |
A colour #rrggbb; empty for the look's own |
empty | The cursor's row in the other panel. Empty: the look's own grey. |
| Light: Cursor text | appearance.colours.light.cursor_text |
A colour #rrggbb; empty for the look's own |
empty | The text of the cursor's row. Empty: the text colour. |
| Light: Marked names | appearance.colours.light.marked |
A colour #rrggbb; empty for the look's own |
empty | The names of marked entries, as Total Commander colours them. Empty: the accent. |
| Light: Accent | appearance.colours.light.accent |
A colour #rrggbb; empty for the look's own |
empty | Windows' accent colour, replaced: the active panel's frame, the buttons, the cursor's tint. Empty: Windows' own. |
| Dark: Text | appearance.colours.dark.text |
A colour #rrggbb; empty for the look's own |
empty | The names and the other text of the file lists, the tree and the panels. Empty: the look's own. |
| Dark: Background | appearance.colours.dark.background |
A colour #rrggbb; empty for the look's own |
empty | The fill of the file lists, the tree and the panels. Empty: the look's own. |
| Dark: Second background | appearance.colours.dark.stripe |
A colour #rrggbb; empty for the look's own |
empty | Every other row, while Alternate row colours (Lists) is on. Empty: the look's own tint. |
| Dark: Cursor | appearance.colours.dark.cursor |
A colour #rrggbb; empty for the look's own |
empty | The cursor's row in the panel that has the keyboard. Empty: a tint of the accent. |
| Dark: Cursor in the other panel | appearance.colours.dark.cursor_inactive |
A colour #rrggbb; empty for the look's own |
empty | The cursor's row in the other panel. Empty: the look's own grey. |
| Dark: Cursor text | appearance.colours.dark.cursor_text |
A colour #rrggbb; empty for the look's own |
empty | The text of the cursor's row. Empty: the text colour. |
| Dark: Marked names | appearance.colours.dark.marked |
A colour #rrggbb; empty for the look's own |
empty | The names of marked entries, as Total Commander colours them. Empty: the accent. |
| Dark: Accent | appearance.colours.dark.accent |
A colour #rrggbb; empty for the look's own |
empty | Windows' accent colour, replaced: the active panel's frame, the buttons, the cursor's tint. Empty: Windows' own. |
| Colours by file type | appearance.colour_rules |
Rules, one per line: a mask as for Num+, a tab, a colour #rrggbb, and a dark colour after another tab |
empty | A name takes the colour of the first rule whose mask it matches, as Total Commander's "Define colors by file type": masks as for Num+ (*.exe;*.bat, *\ for folders, | before exclusions), a colour for the light look and one for the dark (empty: the light one). |
| Setting | Key | Values | Default | Description |
|---|---|---|---|---|
| Alternate row colours | appearance.alternate_rows |
On or off | On | Tints every other row of the file lists and tables, so the eye keeps its line. |
| Shorten long file names | appearance.name_cut |
One of At the end (end), In the middle (middle) |
At the end | Where a file or folder name too long for its column is cut: at the end, or in the middle so the start and the end stay. The whole name shows in a tooltip. |
| Tooltip delay for long names (ms) | appearance.name_tip_delay |
A whole number from 0 to 5000 | 500 | How long the pointer rests on a shortened file or folder name before the whole name shows. 0 shows it at once. |
| Mark hidden and system files with ! | appearance.mark_hidden |
On or off | On | When hidden files are shown, the icon of a hidden or system file or folder is faded with a ! over it, as in Total Commander. |
| Extension column width | columns.ext_width |
A whole number from 24 to 640 | 56 | In pixels at the default font size, 24 to 640; both file lists, scaled with their font. Drag the gap left of a column's title to change it, double-click it for the default. |
| Size column width | columns.size_width |
A whole number from 40 to 640 | 96 | In pixels at the default font size, 40 to 640; both file lists, scaled with their font. |
| Packed size column width | columns.packed_width |
A whole number from 40 to 640 | 96 | Inside an archive; in pixels at the default font size, 40 to 640. |
| Date column width | columns.date_width |
A whole number from 48 to 640 | 128 | In pixels at the default font size, 48 to 640; both file lists, scaled with their font. |
| Rights column width | columns.rights_width |
A whole number from 40 to 640 | 84 | On a server; in pixels at the default font size, 40 to 640. |
| Owner column width | columns.owner_width |
A whole number from 40 to 640 | 120 | In pixels at the default font size, 40 to 640; both file lists, scaled with their font. |
| Owner column | columns.owner |
On or off | Off | Shows user and group in the file lists where they are known: on an SFTP server, and local folders on Linux and macOS. |
| Left panel's share | panels.split_permille |
A whole number from 100 to 900 | 500 | Of the width of both panels, in tenths of a percent, 100 to 900; 500 is half. Drag the gap between the panels to change it, double-click it for half. |
| Separate tree | panels.separate_tree |
One of Off (off), One for both panels (one), One beside each panel (two) |
Off | A folder tree beside the panels, as Total Commander's separate tree: off, one left of both panels for the active one, or one left of each panel. Ctrl+Shift+F8 switches; Shift+Tab moves the keyboard between a file list and its tree. |
| Separate tree's width | panels.tree_width |
A whole number from 120 to 800 | 220 | In pixels at the default list font size, 120 to 800. Drag the tree's right edge to change it, double-click it for the default. |
| Volume name in the drive line | panels.drive_line_volume |
On or off | On | Shows the drive's volume name in brackets after the drive, a server's or WSL distribution's name for those. |
| Root and up buttons in the drive line | panels.drive_line_buttons |
On or off | On | Ends each panel's drive line with \ (to the drive's root) and .. (one folder up). |
| File icons | appearance.file_icons |
One of Native (native), Generic (generic), Off (off) |
Native | Native shows the icons Explorer shows (on Windows; elsewhere the generic ones); Generic a file and a folder symbol; Off no icons. |
| Setting | Key | Values | Default | Description |
|---|---|---|---|---|
| Switch to a column set by folder | columns.auto_switch |
On or off | On | A panel entering a folder that a column set's folder mask matches shows that set; the first set in the list wins. A view chosen by hand stays until a folder of another set. |
| Where no folder mask matches | columns.auto_default |
One of Unchanged (unchanged), Full view (full), Brief view (brief) |
Unchanged | What a panel shows in a folder no column set's mask matches, as Total Commander's default mode: the view stays unchanged, or the full or the brief view. |
| Setting | Key | Values | Default | Description |
|---|---|---|---|---|
| Show Markdown files as a preview | viewer.markdown_preview |
On or off | On | Lister (F3) and Quick View (Ctrl+Q) show a .md or .markdown file formatted; 5 switches between the preview and the text. Off: such files open as text, and 5 still shows the preview. Images are never loaded, HTML in the file is shown as text, and only http, https and mailto links open, on a click. |
| Select and copy in the Markdown preview | viewer.markdown_select |
On or off | On | The mouse selects text in the preview, also across paragraphs, lists, tables and code; Shift+click extends, a double click takes a word, a triple click a line. Ctrl+A selects all, Ctrl+C copies the selection as plain text. Applies to files opened afterwards. |
| Colour code blocks in the Markdown preview | viewer.markdown_code_highlight |
On or off | On | A code block whose tag names a language (```rust, ```json, ```sh, ```python, ```sql and other common ones) shows keywords, strings, numbers and comments in the theme's colours. A block without a tag or with an unknown one stays plain; a block over 64 KiB stays plain. Applies to files opened afterwards. |
| Largest picture shown at full detail (megapixels) | viewer.picture_megapixels |
A whole number from 4 to 256 | 32 | A picture with more pixels is scaled down to this many before it is shown, so a very large photo or scan opens without using gigabytes of memory; zoom and the status line still go by its own size. Higher is sharper when you zoom in. |
| Open as DOS text (code page 437) | viewer.dos_extensions |
File extensions without dots, separated by spaces | nfo diz |
File extensions without dots, separated by spaces. Lister (F3) and Quick View (Ctrl+Q) show such files in the DOS character set, with its box-drawing art, and without wrapping; a file with a byte-order mark, in UTF-16 or in UTF-8 beyond plain ASCII keeps its own encoding. In the viewer S switches to DOS and A back to ANSI. Empty: no file opens as DOS text. |
| Let the blocks of DOS art touch | viewer.dos_tight_lines |
On or off | On | DOS text - an .nfo, a .diz, or any file switched to DOS with S - draws its lines exactly as tall as the viewer font's full block, so the block characters of its art join without gaps, as in Total Commander's Lister. Off: its lines are as tall as any other text's. |
| Ctrl+wheel, Ctrl++ and Ctrl+- change the viewer's text size | viewer.text_zoom |
On or off | On | In Lister (F3) and Quick View (Ctrl+Q) the text, binary, hex and Markdown views get a step larger or smaller, from 6 to 72 points; Ctrl+0 goes back to the viewer font size. In the image view the same keys zoom the picture and Ctrl+0 fits it to the window. Off: Ctrl+wheel scrolls, and in Quick View Ctrl+Num+ and Ctrl+Num- select and deselect all as in the panels. |
| A changed text size | viewer.text_zoom_keep |
One of Applies to this viewer window only (window), Is saved as the viewer font size (setting) |
Applies to this viewer window only | This window only: the size stays with that viewer window and the files N and P step to, or with Quick View while its cursor moves; the next viewer opens at the viewer font size. Saved: every change is stored as the viewer font size, so every viewer opens at it, and Ctrl+0 stores the default 13. |
| Show a photo's EXIF beside the picture | viewer.exif |
On or off | On | Lister (F3) and Quick View (Ctrl+Q) offer the EXIF of a JPEG, PNG or WebP photo - camera, exposure, date, position - as a second view beside the picture; 7 switches between them. Only the EXIF block is read. Off: a photo shows the picture alone. |
| N and P step through the marked files | viewer.step_through_selection |
On or off | On | F3 with marked files: Lister steps only through those; Shift+F3 shows the file under the cursor alone. |
| Show certificates and keys with their checks | viewer.certificates |
On or off | On | Lister (F3) and Quick View (Ctrl+Q) show a certificate, certificate request or key file (PEM, DER, OpenSSH, authorized_keys) as its checks and objects - validity, chain, whether a key belongs to its certificate, weak keys and signatures - as text and, on 7, as a tree. A private key is shown only by its type, size, encryption and fingerprint, never decrypted. Off: the file shows as it is. |
| Warn this many days before a certificate expires | viewer.cert_expiry_warning_days |
A whole number from 0 to 365 | 30 | A certificate whose end is fewer days away is a warning in the certificate view's checks; 0 never warns. |
| Setting | Key | Values | Default | Description |
|---|---|---|---|---|
| Tile size | thumbnails.size |
A whole number from 32 to 512 | 96 | The side of a thumbnail in pixels, 32 to 512 (96 as in Total Commander). Ctrl and the mouse wheel over the thumbnails change it in steps. |
| Keep thumbnails on disk | thumbnails.disk_cache |
On or off | On | Thumbnails of local files are kept in your cache folder, so a folder shows them at once the next time. Files on servers, devices and in archives never go there. |
| Disk cache size (MiB) | thumbnails.cache_mb |
A whole number from 16 to 4096 | 256 | 16 to 4096. At the start the thumbnails used longest ago go once the cache is larger. |
| Thumbnails on servers, devices and in archives | thumbnails.remote |
On or off | Off | Off: files over SFTP and FTP, on phones and inside archives show their icon, and nothing is read for a thumbnail. On: pictures up to 32 MiB are read whole; their thumbnails stay in memory only. |
| Explorer's thumbnails for other files | thumbnails.explorer |
On or off | Off | PDFs, videos and documents get the thumbnail Explorer shows. This runs the thumbnail handlers other programs installed inside rCommander, on every file you look at. Off, those files show their icon. |
| Setting | Key | Values | Default | Description |
|---|---|---|---|---|
| Left panel starts in | folders.left_start |
An absolute path | empty | An absolute folder; empty for the home folder. A folder that is missing at the start counts as empty. Restart. |
| Right panel starts in | folders.right_start |
An absolute path | empty | An absolute folder; empty for the home folder. A folder that is missing at the start counts as empty. Restart. |
| Calling up a workspace | workspaces.apply_mode |
One of Replace all tabs (replace_all), Replace the tabs, keep locked ones (replace_keep_locked), Add the tabs (add) |
Replace all tabs | What a workspace does to the tabs a panel has when you call it up (Ctrl+Shift+W, the command palette, its own key): its tabs replace all of the panel's (the default); its tabs replace the panel's and locked tabs stay; or its tabs come after the panel's. A folder the panel shows already is not opened a second time. Terminals of the same kind that run already are reused. |
| Workspace at the start | workspaces.on_start |
A short name: letters, digits, ., _ and -
|
empty | The workspace rCommander calls up when it starts, by its id, after the tabs of the last run came back; empty for the last run's tabs alone. A start folder forced with RC_START_DIR wins. Takes effect at the next start. Restart. |
| Keep the file filter separately for each tab | tabs.filter_per_tab |
On or off | On | On, each tab keeps the file filter of Ctrl+F10, Ctrl+F11 and Ctrl+F12; off, the tabs of a panel share one, as in Total Commander before version 10. |
| Ask before closing all tabs | tabs.confirm_close_all |
On or off | On | Close all tabs from a tab's menu or the menu Commands asks whether the locked tabs close too; off, it closes the unlocked ones at once. |
| Most visited folders in the history list | history.frequent_shown |
A whole number from 0 to 50 | 10 | How many of the most visited folders Alt+Down lists below the folder history; the counts halve every 30 days. 0 shows none and counts nothing. |
| Programs (Ctrl+F11) | filters.programs |
File extensions without dots, separated by spaces | exe com bat cmd pif |
The extensions Ctrl+F11 shows as programs, separated by spaces. Outside Windows a file with an execute bit is a program too. |
| Use the ignore list | ignore_list.enabled |
On or off | Off | On, the names and paths of the ignore list never show in the file lists, the flat views, the search and the folder sizes, and copies and moves leave them where they are; deleting a folder names how many it holds. |
| Ignore list | ignore_list.entries |
Lines, one entry each: a name or a mask (*.bak), a path (%USERPROFILE%\AppData), \Path on every drive, a \ at the end for folders only; at most 1000 lines |
empty | One entry per line: a name or mask (*.bak) hides it in every folder; a path (%USERPROFILE%\AppData) hides that folder on this computer; \Path without a drive on every drive; a \ at the end only folders. At most 1000 lines. |
| Quick search starts with | quick_search.keys |
One of Ctrl+Alt with letters (ctrl_alt), Alt with letters (alt), Letters alone (letters) |
Ctrl+Alt with letters | Ctrl+Alt with letters searches and letters alone go into the command line. With letters alone, typing searches; the command line then takes text after a click into it. |
| Quick search matches anywhere in a name | quick_search.anywhere |
On or off | Off | Off: a name must start with the typed text. * and ? work as wildcards either way. |
| Quick search tells upper from lower case | quick_search.case_sensitive |
On or off | Off | Off: report and Report match alike. |
| Quick search hides what does not match | quick_search.filters |
On or off | Off | On: the quick search shows only the files and folders that match, as the filter (Ctrl+S) does; Enter keeps it, Escape shows everything again. Off: it only moves the cursor to the match. |
| Find files starts with Search archives ticked | search.archives_default |
On or off | Off | On: Alt+F7 opens with Search archives ticked, so zip, 7z and tar files on local drives are searched like folders. Each search can still change it. |
| Find files offers Everything | search.everything |
On or off | On | On: where Everything (voidtools, 1.4 or later) runs, Find files offers to take its candidates from Everything's index, also with ev: before the masks. Windows only. |
| Disk usage shows | disk_usage.size |
One of Bytes of the files (bytes), Space occupied on the volume (allocated) |
Bytes of the files | What the disk-usage window (Ctrl+Shift+L) shows and sorts by: the bytes of the files, or what they occupy on the volume where the file system tells it (a dash elsewhere). |
| Largest files listed | disk_usage.largest_files |
A whole number from 10 to 1000 | 100 | How many of the largest files the disk-usage window keeps on its second tab (10 to 1000). |
| Enter opens archives | archive.enter_opens |
On or off | On | On: Enter on a .zip, .7z or .tar file shows its contents in the panel. Off: the system opens it. Ctrl+PageDown always opens an archive in the panel. |
| Archive decoder memory (MiB) | archive.decoder_memory_mib |
A whole number from 16 to 4096 | 256 | The most memory unpacking an .xz, .tar.xz or .7z file may set aside for its dictionary. A file whose header asks for more is refused before anything is reserved, so a crafted archive of a few bytes cannot take gigabytes. 256 MiB is more than any xz or 7-Zip preset uses. Counts for archives opened from now on. |
| Check a changed archive | archive.verify_after_update |
On or off | On | On: after files are added to an archive or removed from it, the new archive is read back before it replaces the old one; if it does not read back, the old one stays. Off saves the second read of a large archive. |
| Enter verifies checksum files | checksum.enter_verifies |
On or off | On | On: Enter or a double click on a .sfv, .md5, .sha, .sha1, .sha256, .sha512, .b3 or .blake3 file checks the files it lists. Off: the system opens it. Ctrl+Shift+F10 always checks it. |
| Num+, Num- and Shift+F2 select folders too | selection.include_folders |
On or off | Off | On: Num+ and Num- also select and deselect folders whose names fit the mask (*.* takes every folder), and Shift+F2 also selects the folders only one side has. A mask ending in \ always means folders only. |
| Space moves the cursor to the next entry | selection.space_moves_down |
On or off | On | On: Space selects the entry under the cursor and moves on to the next one, as Insert does. Off: the cursor stays on the entry. A folder is counted either way. |
| A click clears the selection (as in Explorer) | mouse.click_clears_marks |
On or off | Off | Off: a click in a file list only moves the cursor and the selection stays, as in Total Commander. On: a click also clears the selection, as in Windows Explorer. Ctrl+click and Shift+click select either way. |
| Drag tabs to reorder them | tabs.drag_reorder |
On or off | On | On: a tab dragged within its tab bar goes where it is dropped, as in Total Commander; a click still shows it, Escape cancels the drag. Off: a press on a tab only shows it. In the list of tabs (Ctrl+Shift+A) Ctrl+Up and Ctrl+Down move a tab either way. |
| A drive change goes to the other panel's folder | drives.follow_other_panel |
On or off | On | On: changing to the drive the other panel shows (drive bar, drive menu, or a drive letter in the command line such as d:) opens the other panel's folder, as in Total Commander. Off: the folder this panel last showed on that drive, else the drive's root. |
| A drive letter in the command line (such as d:) follows the other panel on the same drive too | drives.follow_on_own_drive |
On or off | On | On: a drive letter in the command line (such as d:) opens the other panel's folder even when this panel is already on that drive, at another folder, as in Total Commander. The drive bar and the drive menu leave a panel on its own drive where it is. Works only while "A drive change goes to the other panel's folder" is on. |
| Read the panels again on return to the window | panels.refresh_on_focus |
On or off | On | On: when you come back to rCommander from another program, every panel that shows a folder on a local drive or a WSL distribution is read again, so a file saved meanwhile appears. Cursor, selection and scroll position stay. Switching between rCommander's own windows reads nothing again. Servers and archives are never read again this way. |
| Also network drives and shares | panels.refresh_on_focus_network |
On or off | Off | On: the return to the window also reads panels on mapped network drives and network shares (\\server\share) again. Off by default, since a slow server would be asked on every return. Works only while "Read the panels again on return to the window" is on. |
| Show portable devices in the drive bar | drives.portable_devices |
On or off | On | On: phones, tablets and cameras connected over USB (MTP) appear in the drive bar under their own name; their files can be read, copied both ways and deleted, and new folders created on them. Off: the system is not asked for them. |
| Git status in the file lists | panels.git_status |
One of Off (off), Local drives (local), Also network drives (local_network) |
Off | Where rCommander runs git to mark changed, new and ignored files and to show the branch. Off (the default) runs git nowhere; Local drives on fixed and removable drives and in WSL distributions (only while the distribution runs); Also network drives adds network drives and shares. git runs only for a folder inside a repository, hardened against the repository's own configuration: no filter driver (Git LFS among them) and no fsmonitor runs, so an LFS file whose time changed may show as modified. Needs git 2.36 or newer. Only you can switch this on; an agent cannot. Protected. |
| Dim the files git ignores | panels.git_ignored |
On or off | On | On: entries a .gitignore excludes are drawn dimmed. Off: git is not asked for them, which is quicker in large repositories. |
| Git branch in the status line | panels.git_branch |
On or off | On | On: a panel's status line shows the repository's branch with the commits ahead of and behind its upstream, or HEAD and the commit when it is detached. |
| Read the panels again when their folder changes | panels.watch |
On or off | Off | On: a folder shown in a panel is watched, and a file created, deleted or renamed in it appears within about a second, as Total Commander's automatic refresh does. Cursor and selection stay. Only folders on this machine are watched; archives, servers and search results are not. Off by default. |
| Also when size, date or attributes change | panels.watch_changes |
On or off | Off | On: a file that only grows or gets a new date also reads the panel again. Off by default, since a download in progress would read the panel over and over. |
| Also network drives and shares | panels.watch_network |
On or off | Off | On: folders on mapped network drives and network shares are watched too. Off by default, since some servers keep a connection open for each watched folder or stop reporting without notice. |
| Drives never watched | panels.watch_exclude |
Drive letters such as DE; a backslash stands for every network share (UNC path); empty for none |
empty | Drive letters such as DE, and a backslash (\) for every network path (\\server\share). Empty: every drive is watched. |
| Read while another program is in front | panels.watch_background |
On or off | On | On: changes are shown while you work in another program. Off: a change is only noted, and the panel is read once when you come back. |
| Read the panels again when a terminal command ends | terminal.refresh_panels_on_prompt |
On or off | On | On: when the shell of a local or WSL terminal is back at its prompt after a command, the panels showing local folders are read again, so a file the command made appears. Works without the file watcher; needs the shell integration. SSH terminals never read the panels. |
| Tree: Enter opens the folder in the panel | tree.open_on_enter |
On or off | Off | Off, a panel shows the folder under a tree's cursor once the cursor rests for a moment; on, only after Enter or a double-click, as Total Commander's option. |
| Sort names | sort.names |
One of Like Windows (Total Commander) (windows), Like Linux (byte order) (linux), By the panel's target (by_target) |
Like Windows (Total Commander) | Like Windows and Total Commander: upper and lower case alike, symbols before digits before letters, hyphens and apostrophes only between otherwise equal names. Like Linux: the byte order of ls in the C locale, capitals first. By the panel's target: Windows' order on this computer's drives, Linux' on SSH and FTP servers and inside WSL. |
| Sort numbers by their value | sort.numbers_by_value |
On or off | On | On: file2 comes before file10, as in Total Commander and the Explorer. Off: digits compare as characters, file10 before file2. |
| Setting | Key | Values | Default | Description |
|---|---|---|---|---|
| F10 | keys.f10 |
One of Closes dialogs, quits without one (close_and_quit), Closes dialogs only (close_dialogs), Does nothing (off) |
Closes dialogs, quits without one | With a dialog open, F10 closes it as Esc does; with none open it quits rCommander. In a terminal panel F10 belongs to the shell. |
| Always underline access keys | keys.underline_access_keys |
On or off | Off | On: the underlined letters of the dialogs' buttons always show. Off: they show while Alt is held, as in Windows. Alt with the letter presses the button either way; the letter alone does while a button or checkbox has the focus ring. |
| Show keys in context menus | keys.context_menu_shortcuts |
On or off | On | On: the menus rCommander draws - a tab's, the file list's own, the queue's - show each entry's key on the right, as Windows menus do. Off: the entries' names only. |
| The connection manager opens in its list, on the connection used last | connections.focus_list |
On or off | On | When on, Ctrl+F opens the connection manager with the keyboard in the list and the cursor on the connection you used last, so the arrow keys and Enter choose at once; a letter typed there goes into the filter. When off, the keyboard starts in the filter field. |
| Cmd works as Ctrl on macOS | keys.macos_cmd_as_ctrl |
On or off | On | On: Cmd does what Ctrl does in the keymap (Cmd+R refreshes, Cmd+Shift+P opens the command palette), Ctrl still works, and keys show with the Cmd symbol. Off: only Ctrl is Ctrl, a key pressed with Cmd is left to the system, and keys show with the Control symbol. Only on macOS. |
| Shortcuts | keys.overrides |
Pairs key=command, separated by spaces; key= takes a standard key away |
empty | Your changes to the standard keys, as the Shortcuts tab writes them: Ctrl+K=copy gives Ctrl+K the copy, F5= takes F5 away, Ctrl+1=theme:dark:nord-dark switches to the dark Nord theme. The standard keys: Keyboard shortcuts. Protected. |
| Setting | Key | Values | Default | Description |
|---|---|---|---|---|
| Default shell | terminal.default_shell |
A short name: letters, digits, ., _ and -
|
empty | The shell a new terminal session runs; when it is not installed, the first shell found. |
| Terminal follows the panel | terminal.follow_panel |
On or off | On | Turning to the terminal, or moving the panel while it shows the terminal, changes the shell's folder too - only while the shell waits at an empty prompt, never into a running program. |
| Panel follows the terminal | terminal.panel_follows |
On or off | On | Turning back to the files shows the folder the shell was last in. |
| Shell integration | terminal.shell_integration |
On or off | On | New shells (PowerShell, bash, zsh, cmd) report their folder and prompt to rCommander; without it neither direction follows. Applies to shells started from now on. |
| Warn when a login script types a secret without a password prompt | login_scripts.warn_secret_prompt |
On or off | On | The login-script editor marks a Send secret step whose step before does not wait for a password prompt: the secret would be typed into whatever waits there, a shell too, and could end up in its history. |
| End programs started in a terminal with it | terminal.end_programs_on_close |
On or off | On | On, closing a terminal - or rCommander - also ends what its shell started, such as ssh, a build or a window opened from it, so nothing keeps running unseen. Off, only the shell ends and programs started from it keep running. Windows; elsewhere closing the terminal hangs them up. |
| Ctrl+C copies selected text | terminal.copy_ctrl_c |
On or off | On | On, Ctrl+C copies the text selected in a terminal and clears the selection; with nothing selected it interrupts the running program as always. Off, Ctrl+C always interrupts; Ctrl+Shift+C copies either way. |
| Right click copies selected text | terminal.copy_right_click |
On or off | On | On, a right click copies the text selected in a terminal and clears the selection; with nothing selected it pastes (Windows). Off, a right click always pastes. |
| Copy text as soon as it is selected | terminal.copy_on_select |
On or off | Off | On, letting go of the mouse after selecting text in a terminal copies it at once. Off, selected text is copied with Ctrl+C, Ctrl+Shift+C or a right click. |
| Ctrl+V pastes text | terminal.paste_ctrl_v |
On or off | On | On, Ctrl+V pastes the text on the clipboard into a terminal; with no text on it - an image, say - Ctrl+V goes to the running program, which may paste the image itself. Off, Ctrl+V always goes to the program; Ctrl+Shift+V and a right click paste either way. |
| Programs may copy to the clipboard | terminal.osc52_copy |
On or off | On | On, a program in a terminal - also on a server you are connected to - may put text on the clipboard (OSC 52), as Claude Code does with what you select in it. Programs can never read the clipboard this way. Off, such copies are dropped. |
| Programs on a server may copy to the clipboard | terminal.osc52_remote |
On or off | On | On, a program in an SSH terminal may put text on the clipboard too (OSC 52), as in Windows Terminal. Off, only the programs of local and WSL terminals may. Either way only the terminal a panel shows sets the clipboard, with at most 1 MiB of text, and the status line says which one did. |
| Shift with the mouse selects text | terminal.shift_selects |
On or off | On | On, holding Shift while you select with the mouse selects text in the terminal even when a program such as Claude Code or vim takes the mouse; Ctrl+C or a right click then copies it. Off, the mouse always goes to such a program. |
| Ctrl+Alt+V pastes an image as a file path | terminal.paste_image |
On or off | On | On, the key (Ctrl+Alt+V unless changed in Shortcuts) saves the clipboard's image as a PNG file where the terminal's program can read it - the temp folder, the same file under /mnt for WSL, /tmp on an SSH server, uploaded without asking - and pastes its path, for Claude Code and other programs that read images from a path. The files are removed when the terminal closes. Off, the key does nothing. |
| Most agent keys offered per login | ssh.agent_max_keys |
A whole number from 1 to 20 | 5 | How many keys of the SSH agents one login offers, the connection's own key first. A server counts each key against its limit of tries and learns every key offered (1-20). Protected. |
| Use OpenSSH certificates at the SSH login | ssh.certificates |
On or off | On | A certificate your CA signed for a key is offered before the key itself: the one stored with the key, the certificate file beside a key file (its name with -cert.pub), and those an SSH agent holds. Importing a key also takes the certificate beside it. Off, keys log in alone and the agents' certificates are passed over. Protected. |
| Answer one-time code questions at the SSH login | connections.totp_autofill |
On or off | On | When a connection has a one-time code seed, rCommander answers the server's question for a verification code with the current code. Off, the question is left unanswered, as without a seed; a login script's Send one-time code step still sends it. Protected. |
| Allow port forwards from other computers | ssh.forwards_lan |
On or off | Off | Lets a port forward listen on 0.0.0.0, :: or another address of this computer, which other computers reach and which the firewall asks about. Off, such a forward does not start. Protected. |
| Reconnect port forwards after a lost session | ssh.forward_reconnect |
On or off | On | On, the next connection through a forward connects its session again; off, a lost session stops its forwards. |
| Show running port forwards in the status bar | ssh.forwards_in_status_bar |
On or off | On | "Forwards: n" while some run; each one in its tooltip. |
| Setting | Key | Values | Default | Description |
|---|---|---|---|---|
| Lock the vault after minutes without use | vault.idle_lock_minutes |
A whole number from 0 to 1440 | 15 | 0 never locks. Locked, stored secrets need the master password again. Protected. |
| Lock the vault at the latest after hours unlocked | vault.max_unlocked_hours |
A whole number from 0 to 168 | 8 | Counted from the unlock, however often it is used. 0 sets no limit. Protected. |
| Lock the vault when Windows locks or goes to sleep | vault.lock_on_session_lock |
On or off | On | Win+L, the lock screen, sleep and hibernation lock the vault. Protected. |
| Offer the Windows Credential Manager as a secret source | vault.wincred_source |
On or off | On | A connection can take its password from a generic entry of the Windows Credential Manager, read at every connect. Only on Windows; rCommander never changes the entries. Protected. |
| Let connections use shared credentials | vault.shared_credentials |
On or off | On | A shared credential keeps a user, password, key and passphrase once in the connection manager, and any number of connections can use it. Off, every connection uses its own again and the manager offers no credentials. Protected. |
| Keep the checkout reason for later connects | vault.checkout_keep_reason |
On or off | On | A reason given for a PAM system's checkout goes with the connection's later checkouts until rCommander ends. Off, every checkout asks for a new one. Protected. |
| Setting | Key | Values | Default | Description |
|---|---|---|---|---|
| MCP server on | mcp.http.enabled |
On or off | On | Off, agents reach rCommander neither over HTTP nor through rcommander mcp. Protected. |
| Port | mcp.http.port |
A whole number from 0 to 65535 | 0 | The port on 127.0.0.1; 0 picks a free one. The server restarts on the new port at once. Protected. |
| Allow confirmation codes without a window | mcp.ask.headless_code |
On or off | Off | When rCommander is not running, rcommander mcp has nobody to ask. Off, every tool that asks is refused there; on, the agent gets a one-time code and is told to ask you - but nothing proves you saw it. Protected. |
| Minutes an executing call stays allowed | mcp.ask.exec_session_minutes |
A whole number from 0 to 480 | 30 | "Allow here for ... min" lets an agent keep typing into the same terminal or running commands on the same server for this long without asking again; another terminal or server still asks. 0 never offers it. The status bar shows what is allowed; a click there takes it back. Protected. |
| Ask before reading or writing outside the panels' folders | mcp.ask.outside_panels |
On or off | Off | On, a reading or writing tool asks you first when a file or folder it names lies outside the two folders the panels show - wherever links lead. Off, the agent reads and writes where the policy allows; keys, credential files and start-up files stay refused either way. Protected. |
| New token at every start | mcp.token.rotate_on_start |
On or off | Off | On, each start of rCommander gives the MCP server a new access token, so a token copied before stops working; rcommander mcp picks the new one up by itself. Off, the token stays until you make a new one - an HTTP client configured with it keeps working. Protected. Restart. |
| Record the agents' calls | mcp.audit_log |
On or off | On | On, every tool call an agent makes is kept in the list below with what rCommander decided, its arguments masked. Off, nothing is recorded. Protected. |
| Setting | Key | Values | Default | Description |
|---|---|---|---|---|
| Viewer (F3) | files.viewer |
An absolute path | empty | An external program for F3. Empty: rCommander's own viewer. Protected. |
| Editor (F4) | files.editor |
An absolute path | empty | The program F4 and Shift+F4 open a file with. Empty: Notepad. Protected. |
| Git program | panels.git_program |
An absolute path | empty | The git that marks the file lists. Empty: the first git in the folders of PATH (absolute ones only), on Windows then Git for Windows in Program Files. In a WSL distribution its own /usr/bin/git runs. Only you can change this; an agent cannot. Protected. |
| Internal associations | files.associations |
The internal associations as a JSON list of rules, edited in the window Internal associations...; empty for none | empty | Commands by file type that Enter and the context menu run ahead of the system's association; F3 and F4 do not use them. Protected. |
| Use the internal associations | files.associations_enabled |
On or off | On | Off: Enter and the context menu use the system's association alone. Protected. |
| Load extra commands from all matching types | files.associations_all_matches |
On or off | Off | The context menu offers the named commands of every rule whose mask matches, not only the first's. Protected. |
| After a server file opened for editing is saved | remote_edit.upload |
One of Ask (ask), Upload without asking (auto) |
Ask | F4, Enter and an external viewer on an SFTP, FTP or FTPS file open a local copy, watched for saves. Ask: each save asks whether to upload it (with a box to stop asking). Upload without asking: each save goes to the server at once, as Total Commander's "Automatically re-upload changed files". Protected. |
| Check the server's file before an upload | remote_edit.check_server_changes |
On or off | On | Before a copy goes up, the file on the server is looked at: if its size or time changed since it was opened, or it is gone, you are asked first - Overwrite, Upload as copy or Not now. Protected. |
| Enter opens programs on a server | remote_edit.open_programs |
On or off | Off | Off, Enter refuses a server file that would run as a program (an extension of PATHEXT on Windows, an execute bit elsewhere): copy it first (F5). On Windows every fetched copy is marked as coming from the internet either way. Protected. |
| External compare program | compare.external_tool |
An absolute path | empty | Compare by content (Ctrl+Shift+F3), the Compare button of the overwrite question and a row of Synchronize directories start this program with the two files instead of the diff window - such as WinMerge, Beyond Compare, Meld, KDiff3 or opendiff. Shift held at the click opens the diff window anyway. Empty: the diff window. Protected. |
| Arguments of the compare program | compare.external_args |
A program's arguments: words, double quotes round one with spaces; %1 is the left file, %2 the right one |
"%1" "%2" |
%1 is the left file, %2 the right one; double quotes keep spaces in one argument, and no shell reads them. Files on a server or in an archive go as read-only copies. Protected. |
| Setting | Key | Values | Default | Description |
|---|---|---|---|---|
| Copy buffer (KiB) | transfers.buffer_kib |
A whole number from 16 to 16384 | 256 | How much of a file one read and one write move, for copies and moves on this machine and to and from servers. Counts from the next copy. |
| Transfers at once per server | transfers.per_connection |
A whole number from 1 to 8 | 2 | How many copies and moves to or from one server run at the same time; the others wait in the queue. |
| Transfers at once in all | transfers.max_running |
A whole number from 1 to 16 | 4 | How many copies and moves run at the same time altogether; a drive on this machine always takes one at a time. |
| Retries after a lost connection | transfers.retry_count |
A whole number from 0 to 10 | 3 | How often a copy or move to or from a server tries again when the connection breaks, each time continuing the file where it stopped. Then the job pauses and waits for Resume; 0 pauses at once. |
| First wait before a retry (seconds) | transfers.retry_delay_secs |
A whole number from 1 to 300 | 5 | How long a transfer waits before its first retry after a lost connection; each further wait is twice as long. |
| Ask before quitting while transfers run | app.confirm_quit_with_transfers |
On or off | On | Quitting with F10, the window's close button or Alt+F4 while copies, moves or other jobs run or wait asks first. The queue is kept and continues at the next start either way. |
| Delete for good where there is no recycle bin | delete.permanent_without_trash |
On or off | Off | Servers, network shares and WSL folders have no recycle bin. When on, F8 and Delete there ask to delete for good, as Shift+Delete does. When off, they delete nothing there and say so; Shift+Delete deletes for good. |
| Links to folders | ops.copy_links |
One of Copy the folder's contents (contents), Copy the link (link), Skip (skip) |
Copy the folder's contents | What F5 and F6 to another drive or server do with a link to a folder (also a junction). Copy the contents: the folder it leads to arrives as a plain folder, and a move removes only the link. Copy the link: the link is made anew at the target, leading where it led. Skip: the link is passed over and counted as skipped. A move on the same drive always moves the link itself. |
| Undo a failed multi-rename | rename.undo_on_failure |
On or off | On | A swap or a ring of names goes through temporary names. When a rename fails in the middle of one, on puts every name back at once; off stops there and the message names each file left under a temporary name, which Undo puts back. |
| Shift+F6 on several selected items opens a dialog | rename.selection_dialog |
On or off | On | When on, Shift+F6 with two or more selected files and folders opens the rename dialog with the mask *.*, as Total Commander does, so a mask such as *.old renames them all. When off, Shift+F6 always renames the item under the cursor in the list. |
| F7 offers the name under the cursor | mkdir.prefill_cursor_name |
On or off | On | When on, the new folder dialog starts with the name of the file or folder under the cursor, selected, so typing replaces it. When off, it starts empty. |
| One queue job per file or folder | queue.one_job_per_item |
On or off | On | When on, copying, moving or deleting several files and folders puts each of them into the queue as a job of its own, in the order selected, so each can be paused, moved or cancelled on its own; an answer for all still holds for all of them. When off, the whole selection is one job. |
| Queue in a window of its own | queue.window_own |
On or off | On | When on, Ctrl+Shift+Q opens the queue in a window of its own that you can move, resize and leave open while you work on in the main window; it shows each running job's file, progress, speed and time left. When off, the queue opens over the main window. |
| Jobs listed under the panels | queue.strip_rows |
A whole number from 1 to 50 | 5 | How many jobs the background bar under the panels lists, in the order of the queue window (Ctrl+Shift+Q), which shows them all. |
| Show jobs that run at once in the queue | queue.show_at_once |
On or off | On | When on, the queue window (Ctrl+Shift+Q) also lists the copies, moves and deletes confirmed with OK, which run at once rather than wait in the queue: a group of their own at the top, marked "Runs at once", paused, resumed and cancelled like the other jobs. When off, the window lists only the jobs queued with F2 or into a list; the bar under the panels still shows every job. |
| Show the speed of all running jobs together | queue.total_speed |
On or off | On | When on, the queue window shows under its list how many jobs run and their speed together once more than one runs, beside the selected job's line. When off, only the selected job's speed shows. |
| Leave out the lane column while all jobs share one lane | queue.hide_single_lane |
On or off | On | The lane column of the queue window names what a job waits for: Local for the local drives, a server or share by its name, or Runs at once. When on, the column is left out while every job listed is in the same lane, so the paths get its room. When off, it always shows. |
| Packing, checksums, sync and multi-rename run at once | queue.tools_at_once |
On or off | On | When on, packing, unpacking, creating and checking checksums, splitting and combining files, synchronizing folders and multi-rename start at once, even while a copy to the same drive is running, as copies confirmed with OK do; the queue window lists them as running at once. When off, they go into the queue and wait behind the jobs before them. |
| Look up FTP links when listing | ftp.resolve_links_in_listing |
On or off | Off | On: an FTP folder's listing asks the server what each link points to (up to 64 links, one or two requests each) and shows them last. Off: links show at once and are looked up when you enter, open or copy one; a link to a folder then shows as one. For connections made after the change. |
| Ask before a password goes over plain FTP | ftp.ask_plaintext |
On or off | On | On: before rCommander logs in to an FTP server without TLS, where the user name and password cross the network unencrypted, it asks you - for this time, or for the server until rCommander closes. Off: it logs in at once and warns afterwards. Anonymous logins send no password and are never asked about. |
| Upper and lower case on SFTP servers | sftp.case_sensitivity |
One of Detect for each server (auto), Different names (Linux, Unix) (sensitive), One name (Windows, macOS) (insensitive) |
Detect for each server | Whether an SFTP server takes Data and data for one name, as a server on Windows or macOS does. Detect: rCommander asks the server once when it connects, without writing anything. It decides whether copying a folder into itself under another case is refused and whether a rename that only changes the case goes through a temporary name. For connections made after the change. |
| Rights of a completed SFTP upload | sftp.upload_rights |
One of Everyone may read (rw-r--r--, 644) (644), The group may write too (rw-rw-r--, 664) (664), Only you (rw-------, 600) (600) |
Everyone may read (rw-r--r--, 644) | While an upload runs, its file on the server is readable by you alone. Once it is complete it gets these rights - unless the copy keeps the source's attributes, which come after. A file that is overwritten in place keeps its own. For connections made after the change. |
| Inventory sync every (minutes) | inventory.refresh_minutes |
A whole number from 0 to 10080 | 60 | How often each server inventory synced before is synced again; 0 syncs only when you ask (0-10080). |
| Setting | Key | Values | Default | Description |
|---|---|---|---|---|
| Run plugins | plugins.enabled |
On or off | On | Off: no plugin runs, and the built-in viewer shows every file. The plugins stay installed and keep their own switches. Protected. |
| Failures before a plugin is suspended | plugins.crash_limit |
A whole number from 1 to 10 | 3 | A plugin that crashes, hangs or runs out of memory this many times within five minutes is suspended until you resume it on this page (1-10). Protected. |
| Largest text a viewer plugin may write (MiB) | plugins.viewer_output_limit_mib |
A whole number from 1 to 4096 | 256 | A viewer plugin's text output stops at this size (1-4096 MiB); the viewer shows what came so far. Protected. |
| Show a viewer plugin's text in colour | plugins.viewer_token_colors |
On or off | On | A viewer plugin can show a file as coloured text, as an editor does - keys, strings, numbers and comments each in their own colour. The colours are the theme's, in light and in dark; the plugin only says what each part is. Off: the same text without colour. The hex and binary views never show colour. Protected. |
| Extensions given to a plugin | plugins.associations |
Pairs extension=plugin id, separated by spaces |
empty | Pairs such as csv=<plugin id>, separated by spaces: that plugin shows the extension, ahead of what the plugins claim. Built-in formats come first. Empty: the plugins' own claims. Protected. |
| Development mode: accept unsigned plugins | plugins.development_mode |
On or off | Off | For plugin authors: unsigned packages can be installed and run, marked as unsigned everywhere. Leave it off otherwise - a signature is what tells you who made a plugin. Protected. |
| Latest calls listed per plugin | plugins.recent_calls_shown |
A whole number from 0 to 100 | 10 | How many of a plugin's latest calls its details list, behind a click, and how many plugins_list answers with over MCP. 0 leaves the list out; the summary of the calls stays. Protected. |
| Largest file a compare plugin is handed (MiB) | plugins.compare_limit_mib |
A whole number from 1 to 256 | 16 | Two files are compared by structure (JSON, CSV) only up to this size each (1-256 MiB); larger ones are compared line by line, and the compare window says why. Protected. |
A plugin's own settings are declared in its manifest and stored as plugin.<id>.<key>,
protected like these; they are changed on the tab Installed with the plugin selected. The
bundled viewers' settings are described in Plugins.
| Setting | Key | Values | Default | Description |
|---|---|---|---|---|
| Export the settings | exchange.export.settings |
On or off | On | Whether the next export starts with the settings ticked: every setting of this dialog, the protected ones too. The MCP token, the vault and the window positions are never exported. |
| Export the connections | exchange.export.connections |
On or off | On | Whether the next export starts with the connections ticked: their folders, hosts, users, key paths and login scripts. Passwords and keys go with them only when you tick them in the export. |
| Export the trusted host keys and certificates | exchange.export.trust |
On or off | On | Whether the next export starts with the SSH host keys and FTPS certificates you trusted ticked. |
| Export the hotlist and tabs | exchange.export.hotlist |
On or off | On | Whether the next export starts with the directory hotlist and the folder tabs ticked. Places on a server or inside an archive are not exported. |
| Encrypt exports | exchange.export.encrypted |
On or off | On | Whether the next export starts encrypted with an export password of its own. Each export keeps the choice it was made with. Protected. |
| Automatic backups to keep | backup.keep |
A whole number from 1 to 1000 | 10 | After each backup into the backup folder, the oldest backups with a generated name beyond this number are deleted. Backups you named yourself are never deleted. Protected. |
| Setting | Key | Values | Default | Description |
|---|---|---|---|---|
| Check for updates by itself | update.check_enabled |
On or off | On | A check asks the release host for one public file per channel, with the user agent rCommander/<version> and nothing else: no cookie, no installation id, nothing about the system or its use. The host sees the address, the time and the version. Check now always works. Protected. |
| Hours between checks | update.check_interval_hours |
A whole number from 1 to 168 | 24 | The first check comes a few minutes after the start, then one every so many hours (1 to 168). Protected. |
| Channel | update.channel |
One of Stable (stable), Beta (beta) |
Stable | Stable offers releases only; beta offers pre-releases too and the release that follows them. Until you choose, the channel of the running version applies. Nothing older than the running version is ever offered. Protected. |
| Update source | update.source |
An https:// folder serving the update manifests; empty for the official releases |
empty | Empty for the official GitHub releases. A mirror is an https:// folder serving rcommander-update-stable.json, rcommander-update-beta.json and the packages below it; its manifests are checked against the key built into rCommander all the same. Protected. |
| Proxy for updates | update.proxy |
Empty for the system's proxy, direct, or http(s)://host:port without a login |
empty | Empty for the system's proxy (the Windows Internet options, HTTPS_PROXY and NO_PROXY), direct for none, or http://host:port. No user name or password: a proxy that asks for a login is not supported; copy the download address instead. Protected. |
| Show what is new after an update | update.whats_new_after_update |
On or off | On | The first start after an update says so once; What's new opens the changelog. Protected. |
| Install updates by themselves | update.auto_install |
One of Off (off), When quitting (on_quit), When idle (when_idle) |
When quitting | Off: you install. When quitting (the default): a new version is downloaded in the background and installed as rCommander ends; the next start runs it, and a download not finished by then never holds up quitting. When idle: also restarts into it once nothing happened for the minutes below - no input, no job in the queue, no terminal or SSH session, no dialog. A version whose install failed is never installed by itself again. Protected. |
| Minutes without input before an idle update | update.idle_minutes |
A whole number from 5 to 240 | 30 | How long nothing may happen before "when idle" restarts into the update (5 to 240). Protected. |
| Days to keep the database copy after an update | update.backup_retention_days |
A whole number from 0 to 3650 | 14 | Before every update the database is copied; after a proven update only the newest copy stays, and after these days it goes too. 0 keeps it for good. Protected. |
218 settings on 11 pages: 49 protected, 6 taking effect at the next start.
Getting started
Using rCommander
- Panels
- Themes
- Connections
- Workspaces
- Button bar
- Own commands and Start menu
- Terminal
- Archives
- Tools
- Backup and restore
- Plugins
- Updates
Developing
Reference