Settings
NoteCove’s settings let you customize the application to your needs. Access settings via File > Settings or the keyboard shortcut Cmd+, (macOS) / Ctrl+, (Windows/Linux).
Storage Directories
Manage your local storage locations. Storage Directories (SDs) are where your notes, tasks, and other data live on disk.
- Add new storage directories
- Remove existing ones
- Set Active: Choose which SD is currently active for new content
- Cloud storage detection: Identifies if your SD is inside a cloud storage folder (Dropbox, iCloud, Google Drive, etc.) for sync
See the Sync Configuration guide for more details on storage directory setup.
User
Configure your identity:
- Username: Your display name shown in notes and tasks
- Handle: Your @mention handle for collaboration features
Appearance
Customize the look and feel:
- Dark Mode: Toggle between light and dark themes
- Font Family: Choose your preferred body font
- Link Display: Control how links are displayed in the editor
- Checkbox Settings: Configure checkbox behavior (strikethrough, auto-reorder, nope mode)
Link Previews
Configure oEmbed link unfurling:
- Enable or disable link preview fetching
- Manage the oEmbed cache
- Control which URLs are unfurled
See Link Unfurling for more details.
CLI Keys
Manage CLI authorization keys. When you use notecove init from a terminal, the desktop app issues a secret key scoped to that directory. This tab lets you review and manage all issued keys.
What You Can See
For each CLI key:
- Working Directory: The path where the CLI was initialized
- Creation Date: When the key was issued
- Project Scope: Which projects the CLI can access (all projects, or a specific allowlist of project slugs)
- Notes Scope: What notes access the CLI has (none, SD-scoped, folder-scoped, or all notes)
- Shared Secret: The authentication token (masked by default, click the eye icon to reveal)
Managing Keys
- Revoke: Remove a single key. The CLI at that directory will lose access and need to re-initialize
- Revoke All: Remove all CLI keys at once. Useful if you want to reset all CLI access
A confirmation dialog appears before any revocation to prevent accidental removal.
Best Practices
- Periodically review your CLI keys to ensure only expected directories have access
- Revoke keys for directories you no longer use
- Each key is scoped to its working directory — moving your project to a new directory requires a new
notecove init
Web Server
Configure the built-in web server for browser access to your notes:
- Start/Stop: Toggle the server on and off
- Port: Choose which port to listen on (1024-65535)
- Localhost Only: Restrict access to your local machine
- TLS: Configure encryption (off, self-signed, or custom certificate)
- QR Code: Scan to connect from a mobile device
- Connected Clients: View and disconnect active browser sessions
- Token Management: Regenerate the access token to invalidate existing sessions
See Web Server feature for more details.
Recovery
Data backup and recovery tools:
- Create Backup: Make a manual backup of any storage directory
- Restore Backup: Restore from an existing backup
- Restore from Custom Location: Restore from a backup at an arbitrary path
- Backup List: View all available backups with metadata (size, note count, date)
- Delete Backup: Remove old backups you no longer need
See Backup & Recovery for a complete guide.
Advanced
Fine-tune sync and polling behavior:
- Polling Rate: How frequently to check for changes (per minute)
- Hit Multiplier: Increase polling frequency after detecting changes
- Max Burst: Maximum polls per second during bursts
- Recent Edit Window: How long after editing to maintain increased polling
- Full Repoll Interval: How often to do a complete repoll of all data
- Fast Path Max Delay: Maximum delay for the fast-path optimization
These settings are primarily useful for optimizing sync performance on slower storage or high-latency connections.