Settings

Open Preferences with ⌘ , or via Iruka → Preferences… in the menu bar.

There are six tabs: General, Files, Appearance, Terminal, Sidebar and License.

General

Iruka itself, and how it meets the rest of your system.

SettingDescription
On launchRestore the windows, tabs and folders from last time, or start fresh at your home folder.
Automatically check for updatesWhether Iruka looks for a new version on a schedule.
Automatically install updatesWhen enabled, updates download and apply in the background without asking. On by default. Takes effect the next time you quit and reopen Iruka.
Open comparisons inWhich app the diff pane's handoff button uses. See Comparing & Merging.
Finder IntegrationTurn on "Open in Iruka" in Finder's right-click menu, and assign it a keyboard shortcut. See Finder Integration.

Files

How the file list behaves.

SettingDescription
Delete key (⌫)What a bare ⌫ does: Ask first, Move to Trash immediately, or Do nothing as in Finder. ⌘⌫ always moves to the Trash without asking, and ⌥⌘⌫ deletes immediately.
Play a sound when moving items to the TrashAlso plays when you undo a delete and when emptying the Trash.
Keep folders on top when sortingOn by default. Turn it off and folders sort in among the files by whichever column you clicked — the only way Date Modified answers "what changed most recently in here". Applies to the list, the icon grid and the columns.
Calculate folder sizesOff by default, because nothing on disk records how much a folder holds — every answer means walking the whole tree. With it on, the Size column, the status bar and the preview pane fill in folder sizes in the background. The preview pane's info panel has a Calculate button either way, for the one folder you care about.

Appearance

How Iruka and your files are drawn.

SettingDescription
App themeLight, Dark, or follow the system setting.
Text sizeScales text in file lists and the sidebar. Takes effect immediately.
Render Markdown in preview paneDraw .md files as formatted text rather than as source.
Render HTML in preview paneDraw .html files as the page rather than as source. Scripts never run and nothing is fetched from the network, so a page needing either will look bare — use Edit to read the source.
Use Quick Look (Space) when the preview pane is openNormally Space does nothing while the preview pane is already showing the file. Turn this on to open the floating Quick Look window as well.

Terminal

SettingDescription
Sync with UI navigationWhen enabled, navigating in the file browser sends a directory-change command to the active terminal tab.
ShellThe shell to launch in new terminal tabs. Defaults to your system shell ($SHELL). Available picks: System Default, zsh, bash, fish (if installed), PowerShell/pwsh (if installed), Custom path. Changes apply to new tabs only — existing sessions keep their shell.
Font sizeTerminal font size in points (10–20).
Font family"System Monospaced" uses SF Mono; any installed monospaced font is available.
Ligatures (Experimental)Enable OpenType ligature features in the terminal. Off by default — see Terminal → Fonts for caveats.

Shell and Navigation Sync

When Sync is enabled, the directory-change command sent to the terminal depends on the shell:

  • POSIX shells (zsh, bash, fish, system default): cd '/path/to/folder'
  • PowerShell (pwsh): Set-Location -LiteralPath '/path/to/folder'

See Terminal → Navigation Sync for full details.

Terminal Themes

Choose a colour theme for the terminal. Changes apply immediately to all open terminal windows.

A preview swatch is shown for each theme. Select the active theme for Light and Dark mode independently.

Toggle which sidebar sections are visible and drag to reorder them. Changes take effect immediately.

Available sections: Recent, Places, Favorites, Apps, Connections, Cloud, Volumes.

Show Drop Stack controls the shelf above the sidebar, where you can park files while navigating and then copy or move them elsewhere. The same toggle is in the View menu. See Drop Stack for how it works.

License

Enter your Iruka license key to activate the app. See License & Activation for details on where to find your key.