Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Config File Format

Complete reference for config.toml.

File Location

The configuration file is located at ~/.config/fern/config.toml.

Schema

[appearance]

KeyTypeDefaultDescription
theme"dark" | "light" | "auto""dark"Color scheme
accenthex color"#89b4fa"Accent color for highlights
font_familystring"Inter"Primary font
font_monostring"JetBrainsMono Nerd Font"Monospace font
font_iconstring"Material Symbols Rounded"Icon font

[bar]

KeyTypeDefaultDescription
position"left""left"Bar position (only left supported)
widthinteger48Expanded bar width in pixels
collapsed_widthinteger4Collapsed indicator width
persistentbooleanfalseKeep bar always visible
modulesarray["workspaces", "spacer", "clock"]Module order

[border]

KeyTypeDefaultDescription
thicknessinteger4Border thickness in pixels
roundinginteger24Corner radius in pixels

[modules.*]

Module-specific configuration. See Modules for details.

Example

[appearance]
theme = "dark"
accent = "#cba6f7"  # Catppuccin Mauve

[bar]
width = 52
persistent = false
modules = ["workspaces", "spacer", "clock"]

[border]
thickness = 4
rounding = 20

[modules.workspaces]
count = 8
show_empty = false

[modules.clock]
format_time = "%H\n%M"