dodo — Configure

Introduction

By default, dodo looks for: ~/.config/dodo/config.toml

If the file doesn't exist, dodo falls back to defaults.

You can look at this complete config file for reference: config.toml.

The config is split into sections:

[ui.*]
[colors]
[rendering]
[behavior]
[llm]
[keybindings]

NOTE

Each section is independent. Remove what you don't need.

UI

Window

Key	Type	Description	Default
`fullscreen`	bool	Start fullscreen.	false
`menubar`	bool	Show menubar.	false
`startup_tab`	bool	Show startup tab.	false
`window_title`	string	Template string. `{}` is replaced by base file name.	`"{} - dodo"`

[ui.window]
fullscreen = false
menubar = false
startup_tab = false
window_title = "{} - dodo"

Statusbar

Key	Type	Description	Default
`visible`	bool	Show statusbar.	true
`padding`	array	Padding [top, right, bottom, left].	[5, 5, 5, 5]
`show_session_name`	bool	Show current session name.	true
`show_file_name`	bool	Show current file name.	true
`show_mode`	bool	Show current interaction mode.	true
`show_page_number`	bool	Show current page number.	true
`show_progress`	bool	Show reading progress.	true

[ui.statusbar]
visible = true
padding = [ 5, 5, 5, 5 ]
show_session_name = true
show_file_name = true
show_mode = true
show_page_number = true
show_progress = true

Command Palette

Key	Type	Description	Default
`show_shortcuts`	bool	Display keyboard shortcuts.	false
`height`	int	Palette height in pixels.	400
`width`	int	Palette width in pixels.	600

[ui.command_palette]
show_shortcuts = false
height = 400
width = 600

Key	Type	Description	Default
`visible`	bool	Show LLM widget by default.	false
`panel_width`	int	Widget panel width in pixels.	400

[ui.llm_widget]
visible = false
panel_width = 400

Layout

Key	Type	Description	Default
`mode`	string	`"single"`, `"top_to_bottom"`, `"left_to_right"`	`"top_to_bottom"`
`initial_fit`	string	`"none"`, `"width"`, `"height"`, `"window"`	`"width"`
`auto_resize`	bool	Fit document to window on resize.	false
`spacing`	int	Spacing between pages.	0

[ui.layout]
mode = "top_to_bottom"
initial_fit = "width"
auto_resize = false
spacing = 0

Zoom

Key	Type	Description	Default
`level`	float	Default zoom factor.	1.0
`factor`	float	Factor for zoom in/out.	1.25

[ui.zoom]
level = 1.0
factor = 1.25

Selection

Key	Type	Description	Default
`drag_threshold`	int	Drag threshold in pixels.	100

[ui.selection]
drag_threshold = 100

Scrollbars

Key	Type	Description	Default
`horizontal`	bool	Show horizontal scrollbar.	true
`vertical`	bool	Show vertical scrollbar.	true
`auto_hide`	bool	Auto-hide scrollbars.	true
`search_hits`	bool	Show search hits on scrollbar.	true
`size`	int	Scrollbar thickness in pixels.	12
`hide_timeout`	int	Time in ms to hide when auto_hide is true.	1000

[ui.scrollbars]
horizontal = true
vertical = true
auto_hide = true
search_hits = true
size = 12
hide_timeout = 1000

Markers

Key	Type	Description	Default
`jump_marker`	bool	Show jump marker.	true

[ui.markers]
jump_marker = true

Links

Key	Type	Description	Default
`boundary`	bool	Show link boundary box.	false
`detect_urls`	bool	Detect and create links for URLs in text.	true
`url_regex`	string	Regex for URL detection.	(see below)

[ui.links]
boundary = false
detect_urls = true
url_regex = "(https?://|www\\.)[^\\s<>()\\\"']+"

Link Hints

Key	Type	Description	Default
`size`	float	Relative scale for link hint labels.	0.25

[ui.link_hints]
size = 0.25

Tabs

Key	Type	Description	Default
`visible`	bool	Show tab bar.	true
`auto_hide`	bool	Hide tab bar when only one tab.	true
`closable`	bool	Allow closing tabs.	true
`movable`	bool	Allow reordering tabs.	true
`elide_mode`	string	`"none"`, `"start"`, `"middle"`, `"end"`	`"middle"`
`bar_position`	string	`"top"`, `"bottom"`, `"left"`, `"right"`	`"top"`

[ui.tabs]
visible = true
auto_hide = true
closable = true
movable = true
elide_mode = "middle"
bar_position = "top"

Outline

Key	Type	Description	Default
`visible`	bool	Show outline by default.	false
`panel_position`	string	`"left"`, `"right"`	`"left"`
`type`	string	`"overlay"`, `"dialog"`, `"side_panel"`	`"overlay"`
`panel_width`	int	Panel width in pixels.	300

[ui.outline]
visible = false
panel_position = "left"
type = "overlay"
panel_width = 300

Highlight Search

Key	Type	Description	Default
`visible`	bool	Show highlight search by default.	false
`panel_position`	string	`"left"`, `"right"`	`"right"`
`type`	string	`"overlay"`, `"dialog"`, `"side_panel"`	`"overlay"`
`panel_width`	int	Panel width in pixels.	300

[ui.highlight_search]
visible = false
panel_position = "right"
type = "overlay"
panel_width = 300

Colors

All colors are RGBA hex strings.

Key	Description	Default
`accent`	Accent UI color.	`#3daee9FF`
`background`	Background color.	`#00000000`
`search_match`	Search match highlight.	`#55500033`
`search_index`	Current search hit highlight.	`#55FF0055`
`link_hint_bg`	Link hint background.	`#000000FF`
`link_hint_fg`	Link hint foreground.	`#ea3ee9FF`
`selection`	Selection overlay.	`#33000055`
`highlight`	Highlight color.	`#55FF0055`
`jump_marker`	Jump marker indicator.	`#FF0000FF`
`annot_rect`	Rectangle annotation color.	`#55FF5588`
`annot_popup`	Popup annotation background.	`#FFFFFFAA`

[colors]
accent = "#3daee9FF"
background = "#00000000"
search_match = "#55500033"
search_index = "#55FF0055"
link_hint_bg = "#000000FF"
link_hint_fg = "#ea3ee9FF"
selection = "#33000055"
highlight = "#55FF0055"
jump_marker = "#FF0000FF"
annot_rect = "#55FF5588"
annot_popup = "#FFFFFFAA"

Rendering

Key	Type	Description	Default
`dpi`	float	Base render DPI.	72.0
`dpr`	float or map	Device pixel ratio (global or per-output).	(see example)
`cache_pages`	int	How many pages to keep in cache.	4
`antialiasing_bits`	int	4=good, 8=high.	8
`icc_color_profile`	bool	Enable ICC color management.	true

[rendering]
dpi = 72.0
dpr = { "eDP-1" = 1.25, "DP-5" = 1.0, "DP-7" = 1.0 }
cache_pages = 4
antialiasing_bits = 8
icc_color_profile = true

DPR

Use a map if you run mixed DPI monitors. Use a single float if you don't care.

Behavior

Key	Type	Description	Default
`initial_mode`	string	Startup mode.	`"text_select_mode"`
`always_open_in_new_window`	bool	Open files in a new window.	false
`remember_last_visited`	bool	Restore last visited file.	true
`page_history`	int	History depth.	100
`confirm_on_quit`	bool	Ask before quitting.	false
`invert_mode`	bool	Invert colors.	false
`auto_reload`	bool	Auto reload file when it changes.	true
`recent_files`	bool	Track recent files.	true
`num_recent_files`	int	Max recent files count.	25
`undo_limit`	int	Undo history size.	25
`synctex_editor_command`	string	Editor command using `%f` and `%l`.	`"zeditor %f:+%l"`

[behavior]
initial_mode = "text_select_mode"
always_open_in_new_window = false
remember_last_visited = true
page_history = 100
confirm_on_quit = false
invert_mode = false
auto_reload = true
recent_files = true
num_recent_files = 25
undo_limit = 25
synctex_editor_command = "zeditor %f:+%l"

LLM (Optional)

Works only if dodo is compiled with LLM support.

Key	Type	Description	Default
`provider`	string	LLM backend.	`"ollama"`
`model`	string	Provider model name.	`"llama3.2:3b"`
`max_tokens`	int	Response length limit.	`512`

[llm]
provider = "ollama"
model = "llama3.2:3b"
max_tokens = 512

Keybindings

Keybindings are plain strings. Multi-key chords are supported (comma-separated).

Full shipped defaults

[keybindings]
command_palette = "Ctrl+Shift+P"
open_file = "o"
close_file = "Ctrl+w"
link_hint_visit = "f"
link_hint_copy = "Shift+F"
scroll_left = "h"
scroll_down = "j"
scroll_up = "k"
scroll_right = "l"
prev_location = "Ctrl+o"
next_page = "Shift+J"
prev_page = "Shift+K"
first_page = "g,g"
last_page = "Shift+G"
goto_page = "b"
outline = "t"
search = "/"
search_this_page = "?"
search_next = "n"
search_prev = "Shift+N"
zoom_reset = "0"
zoom_in = "="
zoom_out = "-"
tab1 = "Alt+1"
tab2 = "Alt+2"
tab3 = "Alt+3"
tab4 = "Alt+4"
tab5 = "Alt+5"
tab6 = "Alt+6"
tab7 = "Alt+7"
tab8 = "Alt+8"
tab9 = "Alt+9"
tab_next = "Ctrl+Period"
tab_prev = "Ctrl+Comma"
text_select_mode = "1"
region_select_mode = "2"
annot_rect_mode = "3"
annot_edit_mode = "4"
text_highlight_mode = "5"
annot_pen_mode = "6"
annot_popup_mode = "7"
delete = "d"
file_properties = "Ctrl+Shift+F"
invert_color = "i"
fullscreen = "F11"
fit_height = "Ctrl+Shift+H"
fit_width = "Ctrl+Shift+W"
fit_window = "Ctrl+Shift+="
auto_resize = "Ctrl+Shift+R"
toggle_menubar = "Ctrl+Shift+M"
toggle_panel = "Ctrl+Shift+B"
toggle_tabs = "Ctrl+Shift+T"
cancel_selection = "escape"
yank = "y"
about = "F12"
save = "Ctrl+S"
select_all = "Ctrl+A"
rotate_clock = ">"
rotate_anticlock = "<"
list_text_highlights = "]"
undo = "u"
redo = "Ctrl+R"
toggle_focus_mode = "Ctrl+Space"
reselect_last_selection = "g,v"
highlight_annot_search = "Alt+Shift+H"
completion_next = "Ctrl+n"
completion_prev = "Ctrl+p"
toggle_llm_widget = "Ctrl+Shift+L"
toggle_statusbar = "Ctrl+Shift+S"

Theming

Kvantum is a powerful SVG-based theme engine for Qt. It supports dark themes, custom widgets, and integrates well with Qt6. It is available in the standard repository for your distribution. Once installed, select a theme in kvantummanager and set:

export QT_STYLE_OVERRIDE=kvantum

Introduction

UI

Window

Statusbar

Command Palette

LLM Widget

Layout

Zoom

Selection

Scrollbars

Markers

Links

Link Hints

Tabs

Outline

Highlight Search

Colors

Rendering

Behavior

LLM (Optional)

Keybindings

Theming