This page lists every configurable setting in Todobar. Settings are stored locally in the app webview and persist across restarts. You can reset all values to their defaults using the Reset settings action in Settings.Documentation Index
Fetch the complete documentation index at: https://mintlify.com/Leonxlnx/todobar/llms.txt
Use this file to discover all available pages before exploring further.
Appearance
These settings control the colour scheme and visual style of the sidebar panel.The colour mode applied to the entire sidebar. Switching modes also switches to the preset last used in that mode. Click the sun or moon icon in the command rail to toggle this value.
The active theme preset within the current mode. Available values depend on the selected
theme:- Light:
'codex'(Studio),'frost'(Frostline),'paper'(Paper Trail),'clay'(Terra),'blueprint'(Blueprint) - Dark:
'codex'(Obsidian),'graphite'(Graphite),'midnight'(Nightfall),'clay'(Ember),'blueprint'(Gridlock)
Corner radius of the panel in CSS pixels. Controls how rounded the panel edges appear.Range: 12 – 28
Opacity of the panel background surface as a percentage. Lower values let the desktop show through slightly.Range: 86 – 100
Layout
These settings control where the sidebar docks, how large it is, and how it animates.Which screen edge the sidebar docks to. The value
'bottom' is accepted for backwards compatibility but is automatically remapped to 'top' by the settings sanitizer.Width of the open panel in pixels. Press Apply after changing this value. On the top dock, Todobar uses twice this value (minimum 720 px, maximum 1120 px).Range: 320 – 560
Width of the handle strip (tab) that remains visible on the docked edge when the panel is closed, in pixels.Range: 26 – 88
Height (length along the edge) of the draggable handle strip, in pixels.Range: 56 – 176
Position of the handle along the docked edge, expressed as a percentage.
0 places it at the top (or left) of the edge; 100 places it at the bottom (or right).Range: 0 – 100Duration of the panel open and close animation in milliseconds. Lower values feel snappier; higher values feel more gradual.Range: 140 – 360
Task display
These settings control the visual density of the task list and which tasks are shown.Minimum height of each task row in the list, in pixels.Range: 40 – 62
Vertical gap between consecutive task rows in the list, in pixels.Range: 4 – 14
Font size for task label text in pixels.Range: 11 – 14
Whether completed tasks are shown in the task list. When set to
false, completed tasks are hidden from view but remain stored and will reappear if you re-enable this setting.The display order of the three main sections in the sidebar. Drag sections in Settings to reorder them. Valid section IDs are
'today', 'calendar', and 'lists'. All three are always present; this setting controls their sequence only.System
These settings control how Todobar integrates with your operating system.Whether Todobar starts automatically when you log in to your macOS or Windows account. Uses the Tauri autostart plugin. Toggle this in Settings if you prefer to open Todobar manually.
Whether Todobar shows in-app reminder toasts for tasks with reminder times set. When disabled, reminders are still stored but no toast is displayed. Todobar uses its own overlay toasts rather than the operating system notification tray.