a drop-down scratchpad for macOS

Press

A notepad slides down from under the menu bar, over whatever you're doing. Write the thought down, press esc, carry on. Go on, it works on this page.

Install
or press ` · notes stay in this browser
The real Awning visor open below the macOS menu bar, showing notes with headings, timestamps, checkboxes and a link
no lock-in, ever

It's just a text file.

No database, no account, no sync service. Read it with cat, add to it with echo, keep it in git or Dropbox.

When another program changes the file, the visor picks it up live, even mid-sentence. Try it.

zsh
# add a line from anywhere ~ $
the real thing

Open, write, gone.

A timestamp with ⌘D, a list that continues itself, a couple of tasks ticked off with ⌘L, and back to work.

shortcuts

Hands stay on the keys.

Notes stay plain text, but headings, timestamps, lists, checkboxes, code and links are styled as you type.

⌥space

Show or hide. From any app, any desktop. Four other hotkeys to choose from.

esc

Hide. Clicking elsewhere hides it too, unless it's pinned.

⌘D

Timestamp. --- [2026-11-22 09:30] ---

⌘L

Checkbox. idea → - [ ] idea → - [x] idea

return

Lists continue. - * 1. - [ ] >, and an empty item ends the list.

⇧tab

Indent and outdent, one line or many.

⌘F

Find, with ⌘G and ⇧⌘G for next and previous.

⌘O

Open the file in your usual text editor.

psst: press some keys. the caps are listening.
your notes are safe

Careful with your words.

  1. It saves continuously.

    0.4 seconds after you stop typing, at least every 3 seconds while you keep going, and whenever you hide it, quit, or the Mac sleeps.

  2. Adding text only appends.

    Only the new text is written, so tail -f keeps working. Every other edit goes to a temporary file that's swapped in, so a crash never leaves half a file.

  3. Conflicts never lose anything.

    If another program rewrites the file before your typing is saved, your version stays and theirs is backed up to ~/.awning/conflicts/.

  4. It won't damage what it can't read.

    A file that isn't valid UTF-8 opens read-only instead of being overwritten.

  5. Symlinks stay symlinks.

    Point ~/.awning into iCloud Drive, Dropbox or a git repository and it stays a link.

install

Build it in a minute.

You need macOS 13 or later and Xcode 15 or later (or the matching Swift toolchain).

zsh
~ $ git clone https://github.com/har777/awning.git ~ $ cd awning ~/awning $ ./build.sh install ==> Done: /Applications/Awning.app
First launchThe visor drops down on its own so you know it works. After that it lives in the menu bar.
Make it yoursRight-click the menu bar icon to change the hotkey, the appearance or the notes file.
Start at loginTurn on Launch at Login from the same menu and forget it's there until you need it.