Settings

A reference to each settings section on the desktop and on the phone. Every table says which settings are synced through your server and which stay on the device where you set them.

On this page

In short

  • Open Settings from the sidebar (desktop) or the drawer (phone). The desktop has tabs: General, Projects, Quick Entry / View, Notifications, Assistant, Pro and Keyboard Shortcuts. The phone has General, Projects, Notifications, Gestures and Assistant.
  • Most settings are per device. Look, behavior, notification and shortcut choices stay on the device where you set them. Setting the theme on your phone does not change your computer.
  • Some settings are synced. They live on your server and appear on every device you sign in on: your Inbox, task order, custom lists, categories, templates, planner defaults, and a few more. Tables below mark them Synced.
  • Settings save as you change them. There is no Save button.
  • Only a few shortcuts can be changed. See Keyboard shortcuts.

How to read the tables: Synced follows you to every device. This device stays where you set it.

Desktop Desktop

General

Connection

SettingWhat it doesFollows you
Vikunja URLThe server Vicu talks to. Shown, not editable, when you signed in with a password or single sign-on.This device
Sign OutSigns out. First sends what is waiting and asks if anything has not reached the server.This device
API Token and Test ConnectionOnly when you signed in with a token. Paste a new one to replace it. Disconnect removes it.This device

Appearance

SettingWhat it doesFollows you
ThemeLight, dark or systemThis device
ClockSystem, 12-hour or 24-hourThis device
Task rowsCompact (one title line) or Comfortable (up to three title lines and a line of notes)This device

Preferences

SettingWhat it doesFollows you
Launch on startupStarts Vicu when you sign in to your computerThis device
Start hiddenStarts without a window. Needs the tray icon.This device
Confirm before deletingAsks before deleting tasks, projects, labels and listsThis device
Subtasks in task listsInside task keeps them in the task, Expandable shows them under the parentThis device
Show today & overdue count on app iconA badge with the number of tasks due today and overdueThis device
What does urgent mean?Schedule for Today or Mark Important: what the top action in a task's right-click menu doesThis device

Tick the smart lists you want above your projects. The Inbox always stays. A hidden list still opens from the command palette. This choice is per computer.

Task Completion Sound

A sound when you complete a task. Pick a file (MP3, WAV, OGG, M4A, AAC or FLAC, up to 10 MB), use Play to hear it, or reset to the default. This device.

Routines

SettingWhat it doesFollows you
Enable routinesOff hides Routines, its Today section and its reminders. Nothing is deleted.This device
Show routines in TodayLists the routines still open todayThis device
Routines shown on TodayHow many due routines show: 1, 2 (the default), 3, 5 or all. The rest wait behind a line such as "2 later today".This device
Hidden shared routinesRoutines someone shared that you hid, with a way to show them againSynced

See Routines.

Task Parser

SettingWhat it doesFollows you
Parse task metadata from textReads labels, projects, priority, dates and repeats from what you type. Off makes the title plain text.This device
Syntax ModeTodoist style (#project, @label, p1) or Vikunja style (+project, *label, !1)This device
! in task title sets due date to todayA lone ! before or after a title means due todayThis device

See Quick add.

Projects

SettingWhat it doesFollows you
Inbox projectWhere new tasks land. Setup suggests the one another device already chose.Synced
Project listYour projects and categories, with New project and New category, drag to reorder, and each project's menuSynced
Sort project tasks byThe global order: Due date then manual, Due date then priority, Manual, Priority, Title, Newest first, Oldest first. A project can have its own.Synced
Show project progress in the sidebarA ring per projectThis device
Show task count in the sidebarOpen tasks per project. Off until you turn it on.This device
Enable project review trackingTurns the review list onThis device
Default review cadence (days)How often projects are due for review. 14 to start.This device
Exclude Inbox from review listLeaves the Inbox outThis device
Excluded from reviewProjects you left out, with Include againSynced (stored with the project)
Import saved filtersTurns your Vikunja saved filters into custom listsSynced (the lists)

See Projects and labels, Custom lists and Review and guided organizing.

Quick Entry / View

All of these are This device. See On the desktop.

SettingWhat it does
Enable Quick Entry, Enable Quick ViewEach is off until you turn it on
Hotkey (Quick Entry)Default Alt+Shift+V, Cmd+Shift+Space on a Mac
Default ProjectWhere Quick Entry saves
Secondary Projects, Project Cycle ModifierThe projects you can switch to, and the key that does it
Hotkey (Quick View)Default Alt+Shift+B, Cmd+Shift+B on a Mac
ListWhat Quick View shows
Include tasks due today from all projectsAdds today's tasks from every project
Browser IntegrationPage Linking, Chrome Extension ID, Re-register Bridge
Obsidian IntegrationNote Linking, API Key, Vault Name, Port, Test Connection. Not on Linux.

Notifications

All This device, except the list of places.

SettingWhat it does
Enable desktop notificationsThe master switch. On a Mac, the first notification asks for permission.
Scheduled RemindersA Morning reminder and an Afternoon reminder with a time each. Include Overdue tasks, Tasks due today, Tasks due tomorrow. Play sound and Stay until dismissed.
Task RemindersPlay sound and Stay until dismissed for reminders you set on tasks
Default reminderAdded to every new task that has a due date and no reminder. Relative to the due, start or end date. Never added to existing tasks.
Test NotificationSends a test
PlacesThe places you saved on your phone, read only. Synced.

Assistant

All This device: the assistant's provider, key and models do not sync. See The assistant.

SectionWhat it holds
ThinkingProvider (OpenAI, Anthropic, Google Gemini, OpenRouter, Ollama, Open WebUI or another compatible server), address, key, Model, and Use a different model for Ask
FeaturesSwitches for Smart dictation, Brain dump, Ask and Talk, each with Try it
HearingSpeech models to download so voice is recognized on your computer, and the Language
PrivacyDelete conversations

Pro

Turn Pro on for this device, choose its parts, and set Assistant help in Pro. Those choices are per device. The work area, the cap on active initiatives and the escalation rule are synced. See Vicu Pro.

Plan

Plan sits on the Pro tab, but works whether Pro is on or off. Shown unless you use standalone mode. See Plan your day and Events and calendars.

SettingWhat it doesFollows you
Show Plan in the sidebarTurns the Plan screen on. Off by default. A time you set on a task shows on every device either way.This device
Default lengthWhat a task takes when you drop it on a timeSynced
Work hoursStart and end of your day, used for free time, Fit and Plan my daySynced
Ask me to plan tomorrowAn evening notification at the time you chooseThis device
Show routines on the timelineRoutine pills on PlanThis device
CalendarsConnected calendars, their colors, Busy only, and Import a calendar fileThis device

Keyboard Shortcuts

Shows the shortcut list, and the Voice input shortcut (This device, off until you record one). See Keyboard shortcuts.

Phone Phone

Settings are in the drawer. Everything on the phone is per device unless marked.

General

SectionWhat it holdsFollows you
AccountUsername, email, auth method, server, Sign OutThis device
AppearanceTheme (System, Light, Dark), Pure black, Use device colours (Android only), Task rows (Compact or Comfortable)This device
Bottom BarThe last three slots, Smart list colours, Reset to DefaultsThis device
PlanShow Plan in the drawer, and the Plan options (default length and work hours sync, the evening nudge does not)Switch: this device. Length and hours: Synced
ProTurn on Pro on this device and its partsThis device
DrawerWhich views the drawer listsThis device
WidgetSmart add button, Context navigationThis device
RoutinesEnable routines, Show routines in Today, Routines shown on Today, Hidden shared routinesThis device. Hidden shared routines: Synced
LogbookHide old completed tasks and Keep completed tasks for a number of days. Nothing is deleted.This device
Input ParsingNatural Language Parsing, Syntax Mode (Todoist or Vikunja), and "Add ! to set the due date to today"This device
PreferencesConfirm before deleting, Subtasks in task lists, Keep add-task open, Left-handed add button, Play sound when completing a taskThis device
Data & SyncStatus, Sync Now, Retry All, Clear Failed, Clear Cache & Re-sync, Background activity (iPhone and iPad)n/a

Projects

SectionWhat it holdsFollows you
Inbox ProjectChoose inbox project, and Move dated tasks out of InboxInbox: Synced. The move option: This device
DisplayTask order (and Sort tasks per project), Subprojects in project views, Show project progress, Show task countOrder: Synced. The rest: This device
ReviewEnable project review tracking, Default review cadence, Exclude Inbox from review, and the list of excluded projectsThis device
Projects, LabelsYour projects (tap to edit, hold to drag, ⋮ for more) and labelsSynced
Custom ListsYour custom lists, and the import of saved filtersSynced

Notifications

See Vicu on your phone. This device: Task Reminders, Sound, Daily Summary and its times and counts, Default Reminder, Send Test Notification, the Quick Add tile (Android) or Add task control hint (iPhone and iPad). Places sync by name, and positions stay on the phone.

Gestures

Swipe Right and Swipe Left, each set to one action. This device.

Assistant

Provider, key, models, features and speech models. This device. Parakeet is the suggested speech model on phones. Downloads wait for Wi-Fi unless you allow mobile data.

Accessibility

Vicu follows your system's accessibility settings; there is nothing to turn on in Vicu.

  • Keyboard Desktop: everything works from the keyboard. Lists move with the arrow keys, menus and pickers jump to an item as you type its name, and one focus ring shows where you are. See Keyboard shortcuts.
  • Screen readers All devices: menus, dialogs and lists are real controls with names, and changes such as "Completed" are announced. On the phone, every task row has screen reader actions, such as Complete, Due today and Due tomorrow.
  • Less motion All devices: when your system asks for reduced motion, Vicu replaces movement with simple fades. On Windows that is Settings, Accessibility, Visual effects, Animation effects.
  • Contrast themes Desktop: with a Windows contrast theme, Vicu uses the system's colors and keeps every meaning visible by shape or text, not color alone. Priority, for example, is shown by bars and a mark, not only by color.
  • Text size iPhone and iPad: Vicu follows Dynamic Type.

Settings that always sync

For quick reference, these follow your account to every device:

  • The Inbox project
  • Task order, global and per project, and subtask order
  • Custom lists and imported saved filters
  • Project categories and icons
  • Task templates
  • Plan default length and work hours
  • Your own Events
  • Saved place names and location reminders
  • Hidden shared routines and routine reminder choices
  • The date of your last weekly review
  • Pro's work area, cap and escalation rule, and Pro data

Everything else stays on the device. Sync and offline explains how this works.

Suggest a change to this page