Settings & Configuration

Windows/Linux: Ctrl + ,
macOS: Cmd + ,

1. Command Palette (Cmd+K) → "Preferences"
2. Menu Bar → Lokus → Preferences
3. File tree → Right-click → Preferences

{
  "general": {
    "language": "en-US",
    "dateFormat": "YYYY-MM-DD",
    "timeFormat": "24h",
    "firstDayOfWeek": "monday",
    "timezone": "auto"
  }
}

{
  "startup": {
    "openLastWorkspace": true,
    "restoreSession": true,
    "checkForUpdates": true,
    "showWhatsNew": true,
    "openLastFile": true
  }
}

{
  "window": {
    "nativeTitleBar": true,
    "closeToTray": false,
    "minimizeToTray": false,
    "confirmBeforeQuit": true,
    "rememberWindowSize": true,
    "rememberWindowPosition": true
  }
}

{
  "editor": {
    "font": {
      "family": "Inter, system-ui, sans-serif",
      "size": 16,
      "lineHeight": 1.7,
      "letterSpacing": 0.003,
      "weight": 400,
      "monoFamily": "JetBrains Mono, Fira Code, monospace",
      "monoSize": 14
    }
  }
}

{
  "typography": {
    "h1Size": 2.0,
    "h2Size": 1.6,
    "h3Size": 1.3,
    "h4Size": 1.15,
    "h5Size": 1.0,
    "h6Size": 0.9,
    "paragraphSpacing": 1.5,
    "headingColor": "inherit",
    "linkColor": "rgb(var(--accent))",
    "codeBlockTheme": "github-dark"
  }
}

{
  "behavior": {
    "autoPairBrackets": true,
    "autoPairQuotes": true,
    "smartQuotes": false,
    "autoIndent": true,
    "wordWrap": true,
    "showLineNumbers": false,
    "showInvisibles": false,
    "highlightActiveLine": true,
    "cursorStyle": "line",
    "cursorBlinking": "blink",
    "scrollBeyondLastLine": true,
    "smoothScrolling": true
  }
}

{
  "modes": {
    "default": "editing",
    "vimMode": false,
    "emacsMode": false,
    "focusMode": false,
    "typewriterMode": false,
    "zenMode": false
  }
}

{
  "appearance": {
    "theme": "dark",
    "accentColor": "#3b82f6",
    "customTheme": null,
    "fontSmoothing": "auto",
    "reducedMotion": false,
    "highContrast": false
  }
}

{
  "ui": {
    "sidebarWidth": 280,
    "rightSidebarWidth": 280,
    "tabBarVisible": true,
    "statusBarVisible": true,
    "breadcrumbsVisible": true,
    "minimapVisible": false,
    "compactMode": false,
    "iconTheme": "vscode",
    "fileTreeIndent": 20
  }
}

{
  "colors": {
    "--bg": "#1e1e1e",
    "--fg": "#d4d4d4",
    "--accent": "#3b82f6",
    "--border": "#333333",
    "--hover": "#2a2a2a",
    "--selection": "#264f78"
  }
}

{
  "files": {
    "defaultLocation": "notes/",
    "attachmentsFolder": "attachments/",
    "templatesFolder": "templates/",
    "automaticFolderCreation": true,
    "confirmDelete": true,
    "moveToTrash": true,
    "revealNewFiles": true,
    "defaultFileTemplate": "# {{title}}\n\n{{date}}\n\n"
  }
}

{
  "autoSave": {
    "enabled": true,
    "interval": 30,
    "onFocusLoss": true,
    "onWindowClose": true,
    "showIndicator": true
  }
}

{
  "links": {
    "wikiLinkFormat": "shortest",
    "updateLinksOnMove": true,
    "updateLinksOnRename": true,
    "confirmLinkUpdates": false,
    "openInNewTab": false,
    "useRelativePaths": false,
    "detectBrokenLinks": true
  }
}

{
  "images": {
    "maxWidth": 1920,
    "maxHeight": 1080,
    "quality": 85,
    "format": "webp",
    "lazyLoading": true,
    "autoCompress": true,
    "compressionThreshold": 500
  }
}

{
  "plugins": {
    "enabled": true,
    "autoUpdate": false,
    "checkCompatibility": true,
    "marketplace": "https://plugins.lokus.app",
    "allowThirdParty": true,
    "sandboxMode": true,
    "pluginsPath": "~/.lokus/plugins/"
  }
}

{
  "plugins": {
    "ai-assistant": {
      "enabled": true,
      "apiKey": "***",
      "model": "gpt-4",
      "temperature": 0.7
    },
    "spaced-repetition": {
      "enabled": true,
      "dailyLimit": 20,
      "algorithm": "sm2"
    },
    "gmail-integration": {
      "enabled": true,
      "autoSync": true,
      "syncInterval": 300
    }
  }
}

{
  "privacy": {
    "telemetry": false,
    "crashReports": true,
    "analytics": false,
    "improvementProgram": false,
    "shareUsageData": false
  }
}

{
  "encryption": {
    "enabled": false,
    "algorithm": "AES-256",
    "encryptAttachments": true,
    "encryptMetadata": false,
    "autoLockTimeout": 300,
    "requirePasswordOnLaunch": false
  }
}

{
  "sync": {
    "endToEndEncryption": true,
    "encryptionKey": "auto-generated",
    "shareAnalytics": false,
    "minimizeMetadata": true
  }
}

{
  "performance": {
    "hardwareAcceleration": true,
    "gpu": "auto",
    "maxMemoryUsage": 2048,
    "lazyLoading": true,
    "virtualization": true,
    "indexingThreads": 4,
    "renderingEngine": "canvas"
  }
}

{
  "cache": {
    "enabled": true,
    "maxSize": 500,
    "clearOnQuit": false,
    "imageCacheSize": 200,
    "preloadImages": true
  }
}

{
  "indexing": {
    "enabled": true,
    "realTime": true,
    "batchSize": 100,
    "throttle": 200,
    "excludePatterns": ["*.tmp", ".*", "node_modules/"]
  }
}

{
  "advanced": {
    "devTools": false,
    "debugMode": false,
    "verboseLogging": false,
    "experimentalFeatures": false,
    "betaUpdates": false,
    "customCSS": "",
    "customJS": ""
  }
}

{
  "network": {
    "proxy": null,
    "timeout": 30000,
    "retries": 3,
    "offline Mode": false,
    "syncOnStartup": true,
    "backgroundSync": true
  }
}

{
  "security": {
    "sandboxPlugins": true,
    "blockExternalScripts": true,
    "validateThemes": true,
    "allowedDomains": ["*.lokus.app"],
    "contentSecurityPolicy": "strict"
  }
}

Location: ~/.lokus/settings.json

Includes:
- Application preferences
- Appearance theme
- Keyboard shortcuts
- Plugin configurations
- Privacy settings

Location: <workspace>/.lokus/workspace.json

Includes:
- File & folder preferences
- Editor settings
- Custom templates
- Local plugins
- Workspace layout

1. Workspace settings (highest priority)
2. User settings
3. Default settings (fallback)

{
  "sync": {
    "settingsSync": true,
    "syncGlobalSettings": true,
    "syncWorkspaceSettings": false,
    "syncPlugins": true,
    "syncThemes": true,
    "syncKeyboardShortcuts": true
  }
}

{
  "version": "1.3.1",
  "general": { /* general settings */ },
  "editor": { /* editor settings */ },
  "appearance": { /* theme settings */ },
  "files": { /* file management */ },
  "plugins": { /* plugin config */ },
  "privacy": { /* privacy options */ },
  "performance": { /* performance tuning */ },
  "advanced": { /* advanced options */ }
}

{
  "name": "My Workspace",
  "path": "/Users/username/Notes",
  "created": "2025-01-01T00:00:00Z",
  "lastOpened": "2025-01-23T12:00:00Z",
  "settings": {
    "editor": { /* workspace-specific editor settings */ },
    "files": { /* local file preferences */ }
  },
  "layout": {
    "sidebar": { "visible": true, "width": 280 },
    "rightSidebar": { "visible": true, "width": 280 },
    "splitView": { "enabled": false }
  }
}

{
  "keybindings": [
    {
      "command": "new-file",
      "key": "ctrl+n",
      "mac": "cmd+n"
    },
    {
      "command": "save-file",
      "key": "ctrl+s",
      "mac": "cmd+s",
      "when": "editorFocus"
    }
  ]
}

{
  "name": "My Custom Theme",
  "type": "dark",
  "colors": {
    "--bg": "#1a1a1a",
    "--fg": "#e0e0e0",
    "--accent": "#ff6b6b",
    "--border": "#333333"
  },
  "editor": {
    "background": "#1a1a1a",
    "foreground": "#e0e0e0",
    "selection": "#3d3d3d"
  }
}

1. Open Preferences (Cmd+,)
2. Go to "General" → "Import/Export"
3. Click "Export Settings"
4. Choose export format:
   - JSON (full settings)
   - Subset (selected categories)
5. Save to file

1. Open Preferences
2. Go to "Import/Export"
3. Click "Import Settings"
4. Select settings file
5. Choose import mode:
   - Replace all
   - Merge (keep conflicts)
   - Preview changes
6. Confirm import

Share with team:
1. Export settings as JSON
2. Commit to git repo
3. Team members import
4. Or: Use settings sync URL

{
  "preset": "minimal-writer",
  "ui": { "compactMode": true, "minimapVisible": false },
  "editor": { "fontSize": 18, "lineHeight": 2.0 },
  "appearance": { "theme": "sepia", "zenMode": true }
}

{
  "preset": "power-user",
  "ui": { "compactMode": false, "minimapVisible": true },
  "editor": { "vimMode": true, "showLineNumbers": true },
  "performance": { "virtualization": true }
}

{
  "preset": "student",
  "plugins": ["spaced-repetition", "pomodoro"],
  "files": { "defaultLocation": "courses/" },
  "editor": { "fontSize": 16 }
}

1. Preferences → General → Presets
2. Browse available presets
3. Preview changes
4. Click "Apply Preset"
5. Customize as needed

{
  "backup": {
    "enabled": true,
    "interval": 86400,
    "location": "~/.lokus/backups/",
    "keepVersions": 7,
    "includePlugins": true,
    "includeThemes": true
  }
}

1. Preferences → Advanced → Backup
2. Click "Create Backup Now"
3. Choose backup location
4. Backup includes:
   - All settings
   - Keyboard shortcuts
   - Themes
   - Plugin configurations

1. Preferences → Advanced → Restore
2. Select backup file
3. Preview changes
4. Click "Restore"
5. Application restarts with restored settings

1. Check file permissions
2. Verify settings.json is writable
3. Look for syntax errors
4. Check disk space
5. Restart application

1. Preferences → Advanced
2. Click "Reset All Settings"
3. Confirm reset
4. Application restarts
5. All settings restored to defaults

1. Quit Lokus
2. Rename settings.json to settings.json.backup
3. Restart Lokus (generates new settings)
4. Import backup if needed

Check these settings:
- Disable hardware acceleration
- Reduce cache size
- Disable unnecessary plugins
- Lower max memory usage
- Disable animations

- Hardware acceleration: ON
- Lazy loading: ON
- Virtualization: ON
- Cache size: 500MB
- Index in background: ON

- Telemetry: OFF
- Analytics: OFF
- Crash reports: Optional
- End-to-end encryption: ON
- Minimize metadata: ON

- Settings sync: ON
- Workspace settings: Separate
- Plugin sync: ON
- Theme sync: ON

1. Start with preset closest to needs
2. Customize editor first
3. Configure appearance
4. Set up file management
5. Install/configure plugins
6. Fine-tune performance
7. Export backup