Skip to content

jmwang028/desknot

Repository files navigation

DeskNote

A macOS sticky note app — freely place notes on your desktop, auto-synced to Markdown.

Main

About

DeskNote is a native macOS sticky note app. Create multiple notes, position them anywhere on your desktop, and their content is automatically saved as Markdown files to a folder of your choice — Obsidian vault, iCloud, or any local directory.

Still a work in progress. Feedback and suggestions are welcome!

Features

  • Multiple sticky notes freely placed on desktop, positions auto-saved
  • Three colors: Yellow / Blue / Green
  • Auto-syncs content as Markdown files to any folder
  • Supports Obsidian vault, iCloud, or any local directory
  • Desktop pin mode (notes stay visible during "Show Desktop")
  • Adjustable opacity and font size
  • Auto-adapts to Chinese/English system language
  • LLM-friendly — stores notes as plain Markdown files, easily readable and writable by Claude, OpenClaw, and other tools

Settings

Requirements

  • macOS 14.0 or later
  • Apple Silicon or Intel processor

Installation

Build from source

git clone https://github.com/jmwang028/desknot.git
cd desknot
open DeskNote.xcodeproj

Then in Xcode: Product → Run (or Cmd + R).

Download pre-built app

Download the latest DeskNote.app from the Releases page and move it to your Applications folder.

If you see "cannot be opened because the developer cannot be verified", right-click the app in Finder and select "Open".

Usage

  1. Launch the app — a welcome window will appear
  2. Click "Select Folder" and choose a directory (iCloud, Obsidian vault, or any folder)
  3. Once connected, create notes via the menu bar: Note → New Note
  4. Close a note to save its content as Markdown automatically

Note

Building

  • Xcode 15+
  • Swift 5
  • SwiftUI + AppKit
  • No third-party dependencies

Known Limitations

  • Notifications not yet implemented
  • Rich text editing not supported, plain text only
  • Code quality has plenty of room for improvement — contributions are welcome!

Ideas or suggestions? Feel free to open an Issue or PR!

License

MIT

Copyright © 2025 jmwang028

About

A macOS sticky note app — freely place notes on your desktop, auto-synced to Markdown. LLM-friendly.

Topics

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages