Themes & icons

Choose a theme in F9 → Options → Theme. The theme gallery shows all six: Midnight, Aurora, Neon, Classic, Paper, and Ember.

Themes use fixed colors, so a customized terminal palette does not change how they look. Terminals without true color get the nearest colors from the 256-color palette.

Every file has an icon. In Ghostty, Borg uses the richer Nerd Font icons automatically; other terminals get portable symbols by default: / for folders, @ for links, and * for executables. Set icon-style = "nerd" to use rich icons in another terminal with a suitable font, or icon-style = "portable" to always use the portable symbols. The default, "auto", adapts to the terminal and does not save what it detects as your font preference.

Release archives include Borg Mono, a monospace font with Nerd Font icons. Install its regular and bold styles from fonts/, select Borg Mono in your terminal’s settings, and choose the "nerd" icon style. Borg cannot change your terminal’s font for you. The installer puts the fonts in ${XDG_DATA_HOME:-~/.local/share}/borg-commander/fonts; Homebrew puts them in $(brew --prefix)/share/borg-commander/fonts.