Skip to main content
otter-note creates sticky markdown notes that float above your desktop on a Wayland layer-shell surface. Pin notes to any corner, edit them in place, preview rendered markdown, and bind Super+N for quick access. Notes persist across sessions as plain markdown files. Edit them with any text editor outside Otter Shell.

Commands

Editing Notes

In edit mode, the layer-shell surface edits your markdown file directly. Press Ctrl+S to save, or close the surface and it saves on exit. Press Ctrl+M to toggle rendered markdown preview. In view mode, only the header buttons accept pointer and keyboard input. The note body is pass-through, so apps underneath keep receiving events and the note does not block your work.

Pinning

Use --pin to position the note surface in a corner before opening it:

Configuration

otter-note reads ~/.config/otter-shell/otter-note.conf:
  • notes_path: absolute path for note storage. Empty uses $XDG_DATA_HOME/otter-shell/notes.md, falling back to ~/.local/share/otter-shell/notes.md if XDG_DATA_HOME is unset

Hotkey Setup

Bind otter-note new to Super+N in your compositor config for sticky note access from anywhere on the desktop.