← Back to Home

Open Settings by right-clicking the Notelet menu bar icon and selecting Settings…. Changes are saved automatically. The Settings window uses a sidebar with sections: General, Appearance, Toolbar, Context Menu, Shelves, Categories, and About.

General

Show in Dock

Show or hide the Dock icon. When disabled, Notelet behaves as a menu bar accessory app.

Type: Toggle Default: Disabled

Launch at Login

Automatically start Notelet when you log in to macOS.

Type: Toggle Default: Disabled

Check spelling while typing

Enable macOS spell checking in the editor. Misspelled words are underlined and offer right-click suggestions.

Type: Toggle Default: Enabled

Spelling Language

Select the dictionary used for spell checking.

Type: Dropdown Default: English (en)

Available: English (en), Nederlands (nl), Deutsch (de), Français (fr), Español (es)

Enable Global Hotkey

Enable a system-wide hotkey to open Notelet from anywhere.

Type: Toggle Default: Enabled

Note: When enabled, macOS may request Accessibility permissions.

Hotkey

Customize the global hotkey. Default: Cmd+Shift+N.

Type: Shortcut Recorder Default: Cmd+Shift+N

ESC Key Closes Window

Press Esc to close the Notelet window.

Type: Toggle Default: Enabled

Close on Copy

Automatically close the window after copying text to the clipboard.

Type: Toggle Default: Disabled

Close on Drag

Automatically close the window after dragging text into another app.

Type: Toggle Default: Disabled

Appearance

Font Family

Select the typeface used in the editor.

Type: Dropdown Default: SF Mono

Font Size

Adjust the editor text size.

Type: Slider Range: 10–24pt Default: 17pt

Font Weight

Choose how light or bold the editor text is.

Type: Dropdown Default: Light

Window Background

Set the background color of the Notelet window.

Type: Color Picker Default: White

Editor Background

Set the background color of the text editor area.

Type: Color Picker Default: White

Automatic Text Color

Automatically switch text between black/white for best contrast against your editor background. If disabled, you can pick a custom text color.

Type: Toggle Default: Enabled

Window Width

Set the width of the Notelet window.

Type: Slider Range: 350–1000px Default: 400px

Minimum Lines

The window starts at this height (in lines) and grows as you type.

Type: Slider Range: 1–20 lines Default: 3 lines

Maximum Lines

The window will not grow beyond this height (in lines); it will scroll instead.

Type: Slider Range: 3–20 lines Default: 15 lines

Padding (Top / Bottom / Left / Right)

Adjust padding around the editor text.

Type: Sliders Range: -5–20px Default: 10px

Toolbar

Top Right Buttons (Titlebar)

Show or hide the Pin, Expand, and Drag buttons in the top right corner of the window.

Pin: Default On Expand: Default On Drag Icon: Default On

Show Drag Icon

Show a drag handle icon in the titlebar. Drag from this icon to drop the current note content into another app.

Type: Toggle Default: Enabled

Tip: You can also drag directly from shelf number icons (1, 2, 3…) to drag content from any shelf, even non-active ones.

Bottom Toolbar Buttons

Choose which actions appear in the bottom toolbar.

Copy: Default On Clear: Default On History: Default On Pin / Expand: Defaults Off

Context Menu

Menu Items

Show or hide items in the right-click context menu (Copy, Clear, History, Pin, Maximize).

Type: Toggles Defaults: All enabled

Shelves

Show Shelves

Show shelf indicators and quick switching in the toolbar.

Type: Toggle Default: Enabled

Number of Shelves

Set how many shelves are available per category.

Type: Slider Range: 3–20 Default: 7

Confirm Before Archive

Ask for confirmation before archiving a shelf as done.

Type: Toggle Default: Enabled

Mark Done on Drag

Automatically mark the active shelf as done when you drag text into another app.

Type: Toggle Default: Disabled

Show Shelf Count in Category Picker

Show the number of shelves next to each category name in the category dropdown.

Type: Toggle Default: Enabled

Categories

Manage Categories

Add, delete, and reorder categories. Categories are intended for people (e.g. "Patrick") or projects (e.g. "Website Redesign").

Add: "Add Category" button Delete: Trash icon Reorder: Drag handle

Clipboard

Enable Clipboard Monitoring

Automatically capture clipboard content and save it to a dedicated category. Useful for building a clipboard history.

Type: Toggle Default: Disabled

Clipboard Category Name

The name of the category where clipboard content is saved.

Type: Text Default: "Clipboard History"

Auto-Archive After (Days)

Automatically archive clipboard items older than this many days. Set to 0 to disable auto-archiving.

Type: Number Default: 0 (disabled)

Advanced (Files & Hidden Settings)

Most preferences are stored as JSON files in ~/.notelet/. Some internal state (like whether you last used popup vs maximized) is also stored there.

Where settings are stored

  • Settings file: ~/.notelet/settings.json
  • Categories & shelves: ~/.notelet/shelfs.json
  • Per-shelf backups: ~/.notelet/Shelfs/<category-uuid>/<shelf-uuid>.json
  • Trash: ~/.notelet/Trash/ (kept for 30 days)

View your settings

cat ~/.notelet/settings.json

Reset settings

Use the in-app “Reset to Defaults” (if available), or remove the settings file.

rm ~/.notelet/settings.json

Warning: This resets preferences. Your categories and shelves are stored separately in ~/.notelet/.