Settings
Every setting the application has, a page for each page of the settings screen, and all of them at a glance below. They are changed on the settings screen, and kept in settings.json.
Open it with Settings… in the Options menu, or from the application menu with ⌘,.
Moving around it
- ↑ and ↓ go through the pages down the left. Tab moves into the page, on through its settings and then the buttons; ⇧Tab goes back.
- On a choice or a number, ↑ and ↓ change it rather than move — move on with Tab.
- The two lines under the page say what the setting with the focus does, ending with its name in settings.json.
- A setting changed some other way while the screen is up — hidden files, on their key — is in force at once and changes here too, in place of anything you had chosen for it and not yet applied.
- How each kind of setting is changed — check boxes, dropdowns, numbers, fields — is in Menus and dialogs.
The buttons
- OK
- Sets everything you changed on the pages, and closes the screen. Enter does the same anywhere but on another button, and so does ⌥O.
- Apply
- Sets everything you changed on the pages, and keeps the screen open. ⌥Y does the same. It is gray while nothing is changed.
- Open settings.json
- Closes the screen and opens the file in the editor, to change by hand. With changes you have not applied it asks first, since they would be lost. ⌥S does the same. What you change in the file is read the next time the application starts.
- Backups…
- The backups: take one, or put one back. What you changed on the screen waits behind it, so the backups are those of the folder in use now, not of a backups folder you changed and have not applied.
- Cancel
- Closes the screen with nothing set since the last Apply. Esc does the same. With changes you have not applied it asks first — 2 changes made here have not been applied — and opens on Keep choosing.
When a change counts, and when it is written
- Nothing you change on the pages is in force until you choose OK or Apply. Nothing moves behind the screen while you are choosing, and Cancel leaves every setting as it was.
- A dot, •, stands beside every setting you have changed and not yet applied, and beside its page in the list on the left. Apply takes the dots away.
- Only what you changed is set. A setting you did not touch stays as it is, even where something else changed it while the screen was up.
- When what was set reaches the file is Write settings, on the Backups page: as they change, the default, on quit, or when asked — by Save settings in the Options menu.
- The answers on the Privacy page are held in the same way, and given when you choose OK or Apply. They are not settings, so they are not in the list below.
- The Key bindings and File types pages lead to screens of their own, which hold what you change on them in the same way, until their own OK or Apply. The keys are kept in a file of their own, so they are not in the list below.
Diagnostics
| Log detail | logLevel | normal |
| Diagnostic for | diagnosticFor | a week |
| Keep logs for | keepLogsFor | a month |
Display
| Font size | fontSize | 15 |
| Font | fontFamily | automatic |
| Colors | theme | faithful |
| Screensaver, minutes | screensaverMinutes | 0 |
| Screensaver style | screensaver | starfield |
Viewer and editor
| Tab width | tabWidth | 8 |
| Show spaces and line endings | showWhitespace | off |
| Reopen files where they were left | reopenWhereLeft | on |
| Indent with spaces | spacesForIndent | off |
| Spaces in an indent | indentWidth | 4 |
| Line numbers in the editor | showLineNumbers | on |
| Close brackets as they are typed | closeBrackets | on |
| Mark other uses of a name | markNameUses | on |
| Web pages load everything | webPagesLoadEverything | off |
| Differences side by side | compareSideBySide | off |
Copying and moving
| Move removes originals | moveOrder | all at once |
| Copy waits for device | copyFlush | volume at the end |
| Move waits for device | moveFlush | volume at the end |
| Rename waits for device | moveWithinVolumeFlush | volume at the end |
| Delete waits for device | deleteFlush | volume at the end |
| Old copy of an archive | oldArchive | bin |
| Ask before changing an archive | askBeforeChangingArchive | off |
Terminal
| Your own terminal | externalTerminal | automatic |
| Commands open a new | externalTerminalOpens | tab |
| Built-in terminal shell | terminalShell | automatic |
| Shell reports where it is | terminalIntegration | on |
| Lines kept above screen | terminalScrollback | 10000 |
| Programs may use the clipboard | terminalClipboardWrite | off |
| Tabs are titled by | terminalTabTitle | folder |
| Left Option key | terminalLeftOption | normal |
| Right Option key | terminalRightOption | normal |
| Shell follows the pane | terminalFollowsPane | on |
| Wheel scrolls in less and man | terminalAlternateScroll | on |
Command line
| After a command ends | terminalAfterCommand | by output |
| Most lines in a notice | commandOutputLines | 2 |
| Terminal after, in ms | terminalDelay | 300 |
| Notice stays, seconds | commandNoticeSeconds | 4 |
| Command line shows | commandLinePrompt | typing row |
| Commands remembered | commandHistorySize | 1000 |
Panes
| Show hidden files | showHiddenFiles | on |
| Always show menu bar | alwaysShowMenuBar | off |
| Left pane's width | paneSplit | 50% |
| Date format | dateFormat | system |
| Sizes | sizes | automatic |
| Color size units | colorSizeUnits | on |
| Compare inside folders | compareInsideFolders | off |
| Compare file contents | compareContents | off |
| Compare marks | compareMarks | both |
| Synchronize by | synchronizeBy | size and date |
| Left pane starts in | leftPaneStartsIn | last session |
| Right pane starts in | rightPaneStartsIn | last session |
| Order names | nameOrder | as Finder does |
| Processes listed | processes | mine |
| Processes in order by | processOrder | processor time |
| Processes as a tree | processTree | off |
| The other cursor follows | syncCursorFollows | on |
| Choosing a place makes its pane active | choosingPlaceMakesPaneActive | on |
Updates
| Check for new versions | checkForUpdates | on |
| Versions to be offered | updateChannel | stable |
File types
| File types… | fileTypes | 0 rows |
| Don't ask for any file set to Run | runWithoutAsking | off |
Backups
| Write settings | saveSettings | as they change |
| Back up every | backUpEvery | week |
| Backups kept | backupsKept | 10 |
| Backups folder | backupFolder | ~/.northern-commander/backups |
Tools
| Path to jq | jqPath |