Turn your handwritten notes into searchable Obsidian knowledge.
Petrify converts handwritten note files into Excalidraw or Markdown format within Obsidian, with OCR that makes handwriting searchable. In Excalidraw format, your handwriting is preserved as-is on the canvas, where you can annotate with text, arrows, highlights, and links.
Sometimes a pen is the most natural way to capture your thoughts — sketching diagrams, jotting quick notes in a meeting, or writing freely without the constraints of a keyboard. Other times, typing is faster and more structured. If you use both, your knowledge inevitably splits in two: handwritten notes on your e-ink tablet, and typed notes in Obsidian.
The usual workaround — syncing handwriting files to Google Drive and opening them as PDFs — keeps your notes accessible but isolated. Handwriting exported as PDF is just a flat image — it can't be searched, linked, or tagged alongside your Obsidian notes. Your handwriting becomes dead data, locked away from search, graph view, and backlinks.
This matters even more as personal AI assistants like OpenClaw become mainstream. A unified knowledge base means your AI can draw from everything you've written — handwritten or typed — to give more personalized answers.
Petrify bridges this gap. It converts handwritten note files into Excalidraw or Markdown inside your vault, with OCR that makes the content searchable. The result is one vault, one knowledge base — regardless of whether you picked up a pen or a keyboard.
Petrify currently supports Viwoods (.note), Supernote X-series (.note), and PDF (.pdf) files, and its plugin architecture makes it straightforward to add support for other handwriting apps in the future.
With the PDF parser, you can sync and convert notes from any device that supports PDF export by selecting the pdf parser in your mapping.
This plugin is not yet published in the Obsidian Community Plugin directory.
- Install the BRAT plugin
- Open BRAT settings → "Add Beta plugin"
- Enter repository URL:
jo-minjun/petrify - Click "Add Plugin"
git clone https://github.com/jo-minjun/petrify.git
cd petrify
pnpm install
pnpm buildThen copy the build output to your vault:
mkdir -p <vault>/.obsidian/plugins/petrify/
cp packages/obsidian-plugin/main.js <vault>/.obsidian/plugins/petrify/
cp packages/obsidian-plugin/manifest.json <vault>/.obsidian/plugins/petrify/
cp packages/obsidian-plugin/worker.min.js <vault>/.obsidian/plugins/petrify/
cp -r packages/obsidian-plugin/tesseract-core <vault>/.obsidian/plugins/petrify/Restart Obsidian and enable Petrify in Settings > Community Plugins.
- Supported parsers: Viwoods (.note), Supernote X-series (.note), PDF (.pdf)
- Output format: Excalidraw (
.excalidraw.md) or Markdown (.md) — Excalidraw format requires the Excalidraw plugin - OCR: Extract handwritten text so your notes become searchable in Obsidian — supports Tesseract.js (local) and Google Cloud Vision (API)
- File watching: Watch external folders and automatically convert new or updated files
- Multi-folder mapping: Map multiple external folders to different vault folders, each with its own parser
- Drag & drop: Drop handwriting files into the file explorer to convert them at the drop location
- Sync command: Manually trigger a full sync via the ribbon icon or command palette (
Petrify: Sync) - Duplicate prevention: Skips already-converted files by comparing file and page content hashes
- Source delete sync: Optionally remove converted files when the source file is deleted
- Keep protection: Mark converted files as protected via frontmatter (
keep: true) to prevent deletion or re-conversion — toggle via command palette or file context menu
| Setting | Description |
|---|---|
| Output format | Output file format (Excalidraw / Markdown) |
| Setting | Description |
|---|---|
| Local file watch | Enable/disable local directory watching |
| Watch directory | External folder path to watch (with Browse button) |
| Output directory | Vault path for converted files (with Browse button) |
| Parser | Parser to use (Viwoods / Supernote X-series / PDF) |
Multiple mappings can be added, each with its own watch/output directory and parser.
| Setting | Description |
|---|---|
| Google Drive API | Enable/disable Google Drive integration |
| Client ID | OAuth2 client ID from Google Cloud Console |
| Client secret | OAuth2 client secret from Google Cloud Console |
| Authentication | Authenticate with Google account |
| Auto polling | Automatically poll for changes |
| Poll interval | Minutes between polling (1–60, default: 5) |
| Folder | Google Drive folder to watch (via Browse button) |
| Output directory | Vault path for converted files |
| Parser | Parser to use (Viwoods / Supernote X-series / PDF) |
| Setting | Description |
|---|---|
| OCR provider | OCR engine (Tesseract / Google Vision) |
| Google Vision API key | API key for Google Cloud Vision (shown when Google Vision is selected) |
| Language hints | Preferred languages for recognition (Korean, English, Japanese, Simplified Chinese, Traditional Chinese) |
| Confidence threshold | Minimum OCR confidence (0–100, default: 50) |
Google Vision API free tier: Google Cloud Vision offers 1,000 free units per month. Petrify uses one unit per page, so you can OCR up to 1,000 pages/month at no cost. See Cloud Vision pricing for the latest details.
Drag and drop handwriting files (.note, .pdf) into the file explorer to create converted files at the drop location.
- Only supported extensions are processed; others fall through to Obsidian's default behavior
- If multiple parsers match the same extension, a selection modal is shown
- "Apply to all" option to batch-apply the same parser to files with the same extension
- Drop-converted files are protected from auto-deletion
There are two ways to integrate Google Drive handwriting files:
If you use Google Drive for Desktop to sync your handwriting files locally, you can point a Watch Directory at the synced folder for automatic conversion.
- Install Google Drive for Desktop
- Set up local sync for the Google Drive folder containing your handwriting files
- Set the synced local path as a Watch Directory in Petrify settings
- macOS:
~/Library/CloudStorage/GoogleDrive-<account>/My Drive/<folder> - Windows:
G:\My Drive\<folder>(drive letter may vary)
- macOS:
If virtual drive mounting is blocked (e.g. corporate policy), the Google Drive API adapter detects changes and downloads files directly via API.
Each user needs their own Google Cloud OAuth credentials:
- Create a Google Cloud project and enable the Google Drive API
- Configure the OAuth consent screen (External, add your Google account as a test user)
- Create an OAuth 2.0 Client ID (Desktop app type) in APIs & Services > Credentials
- In Petrify settings, enable Google Drive API and enter Client ID / Client Secret
- Click Authenticate → sign in with Google in the browser
- After redirect to
localhost, copy the entire URL from the address bar and paste it into the Obsidian modal - Click Add mapping → Browse to select a Google Drive folder
- Set the output directory and parser → Save
Key features:
- Polling via Google Drive Changes API (configurable: 1–60 min)
- Direct binary download via API — no local file sync required
- Automatic session restore via OAuth refresh token
By default, this plugin does not make any network requests. Network access occurs only when using specific features:
- Tesseract.js (OCR): On first use with the Tesseract provider, language data files (~15 MB per language) are downloaded from the petrify GitHub releases and cached locally. Once downloaded, all OCR processing happens entirely on your device. No image data is sent to external servers.
- Google Cloud Vision API: When selected as OCR provider, images are sent to Google servers for text recognition. Requires a user-provided API key.
- Google Drive API: When Google Drive integration is enabled, the plugin communicates with Google servers to list and download files. Requires OAuth2 authentication.
This plugin reads files from directories outside your Obsidian vault. Specifically:
- Local file watch: Reads handwriting files from external directories you configure in settings. Only the configured watch directories are accessed.
- Google Drive: Downloads files from your Google Drive folders via API.
All configured directory paths are stored in the plugin's local data file within your vault. Sensitive data (OAuth tokens, API keys, client secrets) are stored via Obsidian's SecretStorage API, which provides OS-level encryption.
- Obsidian 1.11.4+
- Excalidraw plugin (when using Excalidraw output format)
- Desktop only (requires Node.js filesystem access)
MIT
For development setup, architecture, and package structure, see CONTRIBUTING.md.