Settings

TaskNotes provides extensive configuration options through a tabbed settings interface. The settings system allows you to customize every aspect of the plugin's behavior, from basic task defaults to advanced field mapping and visual customization.

Settings Organization

The settings interface is organized into eight main categories:

Task Defaults: Core task settings, folder management, and default values for new tasks Inline Tasks: Editor integration settings for task widgets and conversion features Calendar: Calendar view configurations, time settings, and display preferences Performance: Options to optimize plugin performance for large vaults Field Mapping: Customize YAML property names to match your existing vault structure Statuses: Define custom status workflows with colors and completion behavior Priorities: Configure priority levels with weights and visual styling Pomodoro: Timer settings, automation options, and session management

Configuration Approach

TaskNotes settings follow these principles:

Sensible Defaults: All settings include default values that work well for most users Immediate Application: Most setting changes take effect immediately without requiring restart Validation: Input validation prevents invalid configurations and provides clear error messages Flexibility: Extensive customization options accommodate different workflows and vault structures

Core Settings Categories

Task Management Configuration

Settings that control how tasks are created, stored, and organized:

Default folder location for new tasks
Task identification tags and exclusion rules
Filename generation patterns and templates
Default values for task properties

Editor Integration Settings

Controls for how TaskNotes integrates with your note editing workflow:

Task link widget display options
Instant conversion button behavior
Natural language processing features
Integration with task creation defaults

Calendar and Scheduling

Configuration for calendar views and time-based features:

Default calendar view modes and navigation
Time slot duration and working hours
External calendar subscription management
Timeblocking functionality

Advanced Customization

Settings for users who need specialized configurations:

Custom YAML property names through field mapping
Status and priority system customization
Performance optimization for large vaults
Pomodoro timer and productivity features

Detailed Settings Documentation

The following sections provide comprehensive documentation for each settings category:

Task Defaults: Folder management, default values, and template configuration
Inline Task Settings: Editor integration and conversion options
Calendar Settings: Calendar views, time configuration, and external calendar integration
Advanced Settings: Field mapping, custom statuses/priorities, and performance options

3.1 KiB Raw Blame History