User guide · Chapter 14

Settings and Customization

Now we'll move to making the app yours. The Settings window has four tabs: Pens, Shortcuts, General and Backups. Open it from the Cocoa menu › Settings…, or with Command-comma. This chapter goes tab by tab, then covers the customizations that live elsewhere: a folder's own pens, paper defaults, and the panes you can hide.

Pens

Settings › Pens
  1. A pen row: swatch, Name, color, treatment, render style, Collects, Makes study cards, delete
  2. Add Pen menu
  3. "Drag to reorder. Order sets ⌃1 to ⌃9."

These are the pens every folder uses unless it has its own set (chapter 6). Two ship with the app: Highlight, the plain yellow pen, and Important, in red. Each row ①, left to right:

  • The color swatch and Name field. The name is what appears in the Marks menu, the pen tray, Collections and the AI prompts.
  • The color menu: Yellow, Red, Green, Blue, Purple, Orange, Pink, Teal.
  • The treatment menu sets how a mark looks besides its color: Color only, Margin bracket, Dotted underline, ! in the margin, ? in the margin.
  • The render style menu sets how the pen's collection reads: Cards (one row per mark) or Continuous prose (the marks run together as text).
  • Collects (a tray icon) decides whether marks made with this pen gather into a collection.
  • Makes study cards (a graduation cap) decides whether they become recall cards.
  • Delete (a minus in a circle). The alert asks Delete Formulas? and offers Delete Pen, Keep Highlights: text already marked keeps its highlight and shows as an unknown pen until you make a pen with that name again.

Add Pen ② is a menu of suggested pens: Formulas (green), Definitions (blue), Examples (purple), On the Exam (orange), Unclear (pink), Quotes (teal) and Summary (yellow, rendered as continuous prose), plus a blank pen to name yourself. When every suggestion is installed it reads All suggested pens added. Drag rows to reorder them; the order sets the shortcuts ⌃1 to ⌃9 ③.

Shortcuts

Every command in the app is listed here with its shortcut on the right, in groups: Document, Format, Editing, View, Navigation, Find, Marks and Window. Click a shortcut to change it: the label reads Press a key…; press the new combination. A shortcut you have changed is tinted and gets a small back-arrow to reset it alone. Restore Defaults appears in the bottom strip while any change exists.

The strip also reports conflicts: No conflicts. with a checkmark, or 2 conflicting shortcuts. in orange when two commands share a combination. Some combinations belong to macOS, among them Cut, Copy, Paste, Select All, Undo, Redo, Quit, Minimize, Hide, Command-comma and the screenshot keys. Record one of those and it is refused in red: belongs to macOS. It would never reach Cocoa.

The read-only version of this list is Keyboard Shortcuts (⌘/): a filterable sheet you can read mid-sentence.

General

  • Quick Capture › Global shortcut sets the key that opens the capture panel from any app. Default ⌥Space. Click the recorder and press a new combination.
  • Writing › Check spelling while typing is on by default; misspellings get the small card under the word (chapter 4).
  • Writing › Offer corrections is on by default, and greyed out when spelling is off.
  • Writing › Smart quotes and dashes is off by default. On, straight quotes become curly and hyphens become dashes as you type, the way macOS does in other apps.
  • Menu Bar › Run in the menu bar only is off by default. On, the app lives in the menu-bar book icon with no Dock icon; Open Cocoa in that menu brings the window back.

Backups

The daily archives, described in chapter 13: one row per kept zip with Show in Finder, and Export Everything Now….

Customizations outside Settings

  • A folder's own pens live in Library › inside the folder › Highlighters (chapter 6). The pane reads "Following the pens above this folder. Any change makes this folder's own set."; Follow the Parent Again drops it.
  • Paper is set per note in the Inspector (⌥⌘I); Make This the Folder Default writes it into the folder (chapter 4).
  • Folder color and icon come from a right-click on a folder in the Library (chapter 3).
  • Panes and bars live in the View menu, which shows or hides the sidebar ⌃⌘S, outline ⌃⌘O, inspector ⌥⌘I, files ⌥⌘P, format bar ⇧⌘B, status bar ⌥⌘/ and page thumbnails ⌃⌘P.
  • Page mode and zoom are Continuous ⌘1 / One Page ⌘2, with ⌘+ ⌘- ⌘0.
  • Sort in the Library offers Manual, Name, Date Modified, Date Created, Size.

Maya sets up her pens

Maya opens Settings with Command-comma. In Pens she adds Definitions and Formulas from Add Pen, gives Definitions a Dotted underline and turns on its Makes study cards, and gives Formulas ! in the margin. She drags Definitions to the top so it is ⌃1. In General she turns on Smart quotes and dashes. In Shortcuts she tries to give Focus Mode a combination macOS owns and reads the red refusal, then picks another.

Summary

  • Pens: name, color, treatment, render style, Collects, Makes study cards; drag to set ⌃1 to ⌃9.
  • Shortcuts: click to rebind; conflicts and macOS-owned combinations are called out; Restore Defaults.
  • General: Quick Capture key (⌥Space), spelling, corrections, smart quotes, menu-bar-only.
  • Backups: the daily zips.

Common mistakes

  • Deleting a pen and expecting the highlights to vanish. They stay, as an unknown pen.
  • Rebinding to a system combination and wondering why nothing happens, when the strip explains it in red.
  • Turning off Check spelling and looking for Offer corrections, which is greyed out until spelling is on.

Best practices

  • Name pens by meaning; keep the two or three you actually use at ⌃1 to ⌃3.
  • Give a folder its own pens only when its subject really needs them.
  • Leave Run in the menu bar only off until you know you want a capture-first app.

Keyboard shortcuts used

ShortcutWhat it does
⌘/Keyboard Shortcuts
⌥SpaceQuick Capture
⌃1 … ⌃9Apply pen 1 to 9
⌥⌘IShow / Hide Inspector
⌃⌘S / ⌃⌘O / ⌥⌘PShow / Hide Sidebar / Outline / Files
⇧⌘B / ⌥⌘/ / ⌃⌘PShow / Hide Format Bar / Status Bar / Page Thumbnails
  • Chapter 6, Highlighters and Pens.
  • Chapter 15, Keyboard Shortcuts, the full list.
  • Chapter 13, Import, Export, Backups and Sync.