GetNote Importer

Bring your GetNote ideas, highlights, links, recordings, and AI summaries into Obsidian as clean, searchable Markdown.

GetNote Importer is an Obsidian plugin for people who capture in GetNote but think, connect, and build in Obsidian. It keeps imports readable from day one: title-based filenames, type-based folders, source metadata in frontmatter, incremental updates, selective sync, scheduled sync, and detailed sync history.

中文版说明

Why It Feels Good

• Readable files, not dumped data: notes are named from their titles and organized by note type.
• Incremental by default: unchanged notes are skipped; updated notes are refreshed.
• Checkpoint continuity: scheduled sync resumes from where it left off, without re-processing the last note.
• Selective when you need control: pick exactly which notes to bring into Obsidian.
• Scheduled when you want peace of mind: keep the vault fresh in the background.
• Audio-aware: recording notes can include downloaded audio assets and transcript content when the GetNote API provides them.
• Mobile-friendly networking: API calls use Obsidian requestUrl, keeping the plugin suitable for desktop and mobile Obsidian.

Why Not GetNote's Official Export?

GetNote's official export has significant limitations:

If you've ever tried to find that one note in a 10,000-note HTML file, you know why this plugin exists.

Screenshots

Settings page — credentials, filename format, scheduled sync toggle and interval.

Sync history modal — shows filter criteria, parameters, and per-note results (created, updated, skipped, failed) for each sync run.

Manual sync modal — specify a start date to sync by time range, with note details displayed in collapsible groups.

Synced recording note — includes audio file, transcript text, and AI summary, with metadata (uid, tags, source) recorded in frontmatter.

Features

Installation

From Obsidian Community Plugins

⚠️ The plugin is under review by Obsidian. Once approved, it will be available here.

1. Open Settings -> Community plugins -> Browse.
2. Search for GetNote Importer.
3. Install and enable the plugin.

Via BRAT

1. Install the BRAT community plugin.
2. Open Settings -> Community plugins -> BRAT -> Add a beta plugin.
3. Enter this repository URL:

https://github.com/AndyZhengyan/obsidian-getnote-importer

4. Enable GetNote Importer.

Manual Install

1. Download main.js, manifest.json, and styles.css from the latest release.
2. Put them into:

<your-vault>/.obsidian/plugins/getnote-importer/

3. Reload Obsidian and enable GetNote Importer.

Get API Credentials

Your GetNote API credentials are stored in Obsidian plugin settings and are used only to call the GetNote Open API.

1. Open the GetNote app.
2. Go to Settings -> Open Platform.
3. Create an app and copy the Token and Client ID.
4. Paste them into Settings -> GetNote Importer.

You can also use the OAuth button in the plugin settings when available.

Usage

Sync Everything

Open the plugin settings and click Sync by Time, or run this command from the command palette:

GetNote Importer: Sync Notes

Pick Notes to Sync

Click Sync by Notes, choose the notes you want, then start syncing. This is useful for project cleanup, topic-based imports, and one-off migrations.

Keep It Fresh

Enable scheduled sync, choose an interval, and optionally sync once when Obsidian starts.

Output Structure

By default, notes are written under a target folder.

vault/
└── Get笔记/
    ├── 纯文本/
    │   └── Meeting Notes.md
    ├── 链接笔记/
    │   └── 2026-04-30_Article Clip.md
    ├── 录音长录/
    │   ├── Recording Summary.md
    │   └── asset/
    │       ├── Recording Summary.mp3
    │       └── Recording Summary.md
    └── 其他/
        └── Unknown Type.md

Each Markdown note includes frontmatter so future syncs can identify and update the same GetNote item.

---
uid: "1908723638246504120"
title: "Meeting Notes"
created: 2026-04-30 12:45:24
modified: 2026-04-30 13:00:07
source: Get笔记
note_type: recorder_audio
tags: ["work"]
---

Filename Rules

Invalid filename characters such as \ / : * ? " < > | are removed automatically.

Filename Prefix

Prepend a date/time pattern to every filename. Available tokens:

Examples:

The plugin replaces each token with the corresponding value from the note's created_at timestamp. Tokens are case-sensitive — use mm for minutes, not MM (which means month).

Settings

Sync Model

GetNote Importer treats GetNote as the source of truth for imported note content.

1. Scan the target folder and build a uid -> file index from frontmatter.
2. Fetch notes from the GetNote Open API.
3. Filter notes by your sync range (max days, start date, or checkpoint timestamp).
4. Create files for new notes.
5. Update files when updated_at changes.
6. Rename files when the display title changes.
7. Record per-note results in sync history.
8. Save the last processed note's updated_at as a checkpoint for the next scheduled sync.

Privacy

• No external backend is involved.
• API credentials stay in local Obsidian plugin data.
• Note data is requested from GetNote and written directly into your vault.
• Audio attachments are downloaded only from HTTPS URLs returned by the GetNote API.

Known Limitations

• The plugin depends on the availability and response shape of the GetNote Open API.
• Audio download works only when the detail API returns a valid HTTPS audio attachment.
• Imported Markdown content may be updated by future syncs. Keep personal edits in separate notes or backlinks if you need full manual control.

Install for Local Testing

Two options:

Option 1 — Download from releases (no build needed)

1. Download main.js, manifest.json, and styles.css from the latest release.
2. Create the plugin directory if it doesn't exist:

   mkdir -p <your-vault>/.obsidian/plugins/obsidian-getnote-importer/
   

3. Copy the files in:

   cp main.js manifest.json styles.css <your-vault>/.obsidian/plugins/obsidian-getnote-importer/
   

Option 2 — Build from source

# Build the plugin
npm run build

# Create plugin directory (if it doesn't exist)
mkdir -p <your-vault>/.obsidian/plugins/obsidian-getnote-importer/

# Copy plugin files to vault
cp main.js manifest.json styles.css <your-vault>/.obsidian/plugins/obsidian-getnote-importer/

Reload Obsidian after installing: press Cmd+P (macOS) or Ctrl+P (Windows/Linux), search Reload, and choose Reload app without saving (or restart Obsidian).

Development

npm install
npm run typecheck
npm run lint
npm test
npm run build

Release assets are generated from the repository root:

• main.js
• manifest.json
• styles.css

The GitHub release workflow verifies typecheck, lint, tests, build, and version/tag consistency before uploading those files.

Obsidian Community Plugin Submission

Suggested entry for obsidianmd/obsidian-releases:

{
  "id": "getnote-importer",
  "name": "GetNote Importer",
  "author": "Zheng Yan",
  "description": "Sync notes, links, recordings, and AI summaries from GetNote into your Obsidian vault.",
  "repo": "AndyZhengyan/obsidian-getnote-importer"
}

Support

• Report bugs in GitHub Issues.
• Share ideas in GitHub Discussions.
• Star the repository if it saves you time.

License

MIT