mirror of
https://github.com/johannesjo/super-productivity.git
synced 2026-07-17 16:37:43 +00:00
Page:
3.02 Settings and Preferences
Pages
0.01 Style Guide
0.02 Wiki QA and Maintenance
2.01 Downloads and Install
2.11 Run the Development Server
2.12 Package the App
2.13 Run with Docker
2.14 Build for Android
2.15 Develop a Plugin
2.16 Set Up Development Environment
2.17 Add a New Issue Integration
2.18 Contribute Translations
2.19 Sync Proton Drive via rclone
2.20 Import from Todoist
3.05 Web App vs Desktop
3.06 User Data
3.07 Issue Integration Comparison
3.08 Sync Integration Comparison
3.09 Theming
3.97 Obsidian Linter Config MD
3.98 Obsidian Linter Config YAML
4.01 The Today View
4.02 Inbox View
4.03 Planner View
4.04 Schedule View
4.05 Board View
4.06 Project View
4.07 Tag View
4.07a Tags_Eat the Frog
4.07b Tags_Ordinal Priorities
4.08 Time Estimates
4.09 Task Attributes
4.10 Task Notes
4.11 Subtasks
4.12 Scheduled Tasks
4.13 Repeating Tasks
4.14 How Time Is Logged
4.15 Timers and Focus Mode
4.16 Break Reminders
4.17 Idle Time
4.18 Reflection
4.19 Metrics
4.20 Task Archiving
4.21 Worklog
4.22 Quick History
4.23 Managing Your Data
4.24 Integrations
No results
12
3.02 Settings and Preferences
github-actions[bot] edited this page 2026-07-14 14:46:20 +00:00
Table of Contents
- Settings And Preferences
- Global Settings
- global-settings.Localization
- global-settings.App-Features
- global-settings.Misc-Settings
- global-settings.Tasks
- global-settings.Short-Syntax
- global-settings.Idle-Handling
- global-settings.Keyboard-Shortcuts
- global-settings.Time-Tracking
- global-settings.Reminders
- global-settings.Schedule
- global-settings.Sound
- Plugins
- Productivity Helper
- productivity-helper.Focus-Mode
- productivity-helper.Break-Reminder
- productivity-helper.Evaluation-and-Metrics
- productivity-helper.Simple-Counters-and-Habit-Tracking
- productivity-helper.Domina-Mode
- Sync & Export
- Project, Tag, Today, And Inbox Settings
Settings And Preferences
Note: All settings will be shown with the default values.
Note: Differences between the Web app and the Desktop app are specified in 3.05-Web-App-vs-Desktop.
Global Settings
global-settings.Localization
- Datetime format locale — Controls numeric date formatting and the
12/24-hour time format. The ISO 8601 option uses
YYYY-MM-DDand a 24-hour clock. With ISO 8601 selected, weekday labels in Schedule, Habits, and Planner follow the app language.
global-settings.App-Features
global-settings.Misc-Settings
- Show current countdown in the tray / status menu (macOS only) — Shows the active timer or countdown in the desktop status menu title. When this is disabled and current-task display is enabled, the title can show the current task instead.
- Automatically check for new versions (desktop only, default: on) — Once a day the desktop app asks the GitHub releases API whether a newer version has been published and shows a dismissible notice linking to the download page. No personal data is sent, nothing is installed automatically, and each version is announced at most once. The setting (and a manual "Check for updates" link in the settings footer) only appears on builds without their own update channel; Microsoft Store, Mac App Store, and Snap builds update through their stores and never check.
global-settings.Tasks
- Show current task in the tray / status menu (macOS/Windows only) — Allows the desktop tray or status menu to show the active task. On macOS, the current countdown setting takes priority while it is enabled.
global-settings.Short-Syntax
global-settings.Idle-Handling
- Enable idle time tracking — When enabled, Super Productivity will detect when you are away from the computer and show an idle dialog asking what you did.
- Minimum idle time — The amount of time you need to be away before the idle dialog is shown.
- Only show idle dialog when a task is active — Only show the idle dialog when a task is currently being tracked.
- Suppress idle dialog during work sessions — When enabled, the idle dialog will not appear while a focus mode work session is running. Useful when you are working at the computer without active keyboard/mouse input (e.g. reading, studying, or writing exams). Default: off (opt-in).
global-settings.Keyboard-Shortcuts
See 3.03-Keyboard-Shortcuts for full list.
global-settings.Time-Tracking
global-settings.Reminders
global-settings.Schedule
global-settings.Sound
Plugins
plugins.Plugins
Productivity Helper
productivity-helper.Focus-Mode
productivity-helper.Break-Reminder
productivity-helper.Evaluation-and-Metrics
productivity-helper.Simple-Counters-and-Habit-Tracking
productivity-helper.Domina-Mode
Sync & Export
sync-and-export.Sync
sync-and-export.Sync-and-Export
sync-and-export.Sync-Safety-Backups
sync-and-export.Automatic-Backups
- Enable automatic backups — Creates local backups automatically when supported by the current platform.
- Restore latest automatic backup — Android only. Restores the latest usable automatic backup and replaces the current local data after confirmation.
- Maximum backup files — Desktop only. Limits how many automatic backup JSON files are kept in the
backups/folder; older files are deleted once the limit is exceeded.
Project, Tag, Today, And Inbox Settings
Project Settings
project-settings.Basic-Settings
- Enable Project Backlog — Adds a separate backlog list to the project.
- Hide project from sidebar — Removes the project from the sidebar project list. The project stays active: its tasks can still appear in cross-project task views such as Today, Planner, Schedule, Boards, and Search. The sidebar visibility menu remains the place to show the project again; project short syntax does not match hidden projects.
project-settings.Theme
Theme settings can include background images for light mode, dark mode, or both.
When at least one background image is set, the background contrast and blur
sliders are shown. The blur slider defaults to 0px. When at least one mode has
no background image, the colored background tint setting is shown. See
3.09-Theming for theme details.
1.00-Quickstarts
2.00-How_To
Using Super-Productivity
- 2.01-Downloads and Install
- 2.02-Restore-Data-From-Backup
- 2.03-Add-Tasks
- 2.04-Manage-Subtasks
- 2.05-Manage-Scheduled-Tasks
- 2.06-Manage-Repeating-Tasks
- 2.07-Manage-Task-Integrations
- 2.08-Choose-Sync-Backend
- 2.09-Configure-Sync-Backend
- 2.19-Sync-Proton-Drive-via-rclone
- 2.13-Run-with-Docker
Contributing to Super-Productivity
- 2.18-Contribute-Translations
- 2.11-Run-the-Development-Server
- 2.16-Set-Up-Development-Environment
- 2.12-Package-the-App
- 2.14-Build-for-Android
- 2.15-Develop-a-Plugin
- 2.17-Add-a-New-Issue-Integration
3.00-Reference
- 3.01-API
- 3.02-Settings-and-Preferences
- 3.03-Keyboard-Shortcuts
- 3.04-Short-Syntax
- 3.05-Web-App-vs-Desktop
- 3.06-User-Data
- 3.07-Issue-Integration-Comparison
- 3.08-Sync-Integration-Comparison
- 3.09-Theming
4.00-Concepts
Data-and-Integrations
Organizing
- 4.06-Project-View
- 4.07-Tag-View
- 4.08-Time-Estimates
- 4.09-Task-Attributes
- 4.10-Task-Notes
- 4.11-Subtasks
Planning
Doing
- 4.01-The-Today-View
- 4.02-Inbox-View
- 4.05-Board-View
- 4.14-How-Time-Is-Logged
- 4.15-Timers-and-Focus-Mode
- 4.16-Break-Reminders
- 4.17-Idle-Time
- 4.08-Time-Estimates
Reviewing
If you have further questions, please refer to the discussions page.