Skip to content
wavesnowsPublic

About

No description, website, or topics provided.

Resources

Stars

2 stars

Watchers

0 watching

Forks

Repository files navigation

Snowpub

A local-first WeChat Official Account writing & publishing tool built with Electron and Vue 3. Write in Markdown, preview in WeChat style, sync with Git, and publish to your Official Account — all without leaving your desktop.

官网 · Download · Guide · 中文说明

v1.0.2 (2026-10-20) — Incremental directory refresh improves large-notebook menu responsiveness and preserves selection and expansion. Release


Snowpub

Features

  • Dual-pane editor — Markdown (CodeMirror) on the left, WeChat-styled preview on the right
  • WeChat themes — 12 built-in styles (Green / Black / Orange / Blue / Red / Serif / Cream / Morandi / Pink / Night / Bamboo / Plain), switchable anytime
  • AI assistant — Bring-your-own-agent side panel that drives locally installed CLIs (Claude Code / OpenCode / OpenClaw — you pay your own tokens). One-click presets: polish selection or full article, generate titles, write digests, or generate a custom WeChat theme from a text description and apply it instantly. Replies insert back into the editor at cursor
  • Publish to WeChat — Via Official Account API: save drafts, publish image-text articles and image posts (newspic), query status
  • Paste & drop images — Paste or drag an image while writing; saved to the note's imgs/ folder (content-hash named, deduplicated) and uploaded to WeChat in one sweep at publish time
  • Smart cover — First article image suggested as cover; ratio presets (2.35:1 headline / 1:1 / original) passed via WeChat cover_info, switchable without re-upload
  • Image library — Upload local images to WeChat material library, pick cover for articles
  • Draft sync — Fetch / delete / publish existing drafts from your OA draft box
  • Footnote references — External links auto-converted to bottom citations (WeChat-friendly)
  • Git sync — Push/pull to GitHub or Gitee with one click
  • Version history — Browse git commit history, preview and restore any version
  • Full-text search — Search across all notes instantly
  • Built-in terminal — Quick access terminal panel (`Ctrl+``), auto-navigates to current note's directory
  • Favorites & Recent — Pin, star, and quickly revisit notes
  • i18n — English and Chinese UI

Themes

12 built-in WeChat themes — one click to switch:

WeChat Green
微信绿
Tech Black
科技黑
Morandi
莫兰迪
Ink Serif
墨色衬线

Plus 8 more: Plain White / Zhihu Blue / Vibrant Orange / Chinese Red / Warm Cream / Sakura Pink / Night / Bamboo.

Installation

Download the latest installer from Releases:

  • macOS: Snowpub_x.x.x_arm64.dmg (Apple Silicon) · Snowpub_x.x.x_x64.dmg (Intel)
  • Windows: Snowpub_x.x.x.exe

macOS note: The app is not code-signed. If macOS says the app is damaged, run this in Terminal and try again:

xattr -cr /Applications/Snowpub.app

Build from Source

# Requires Node.js >= 14.17.0
npm install
npm run dev      # development
npm run build    # production build

WeChat Publishing Setup

  1. Open Settings → WeChat OA
  2. Enter your AppID and AppSecret (from OA console → Settings → Development → Basic Config)
  3. Add your machine's IP to the OA IP whitelist
  4. Click Test Connection to verify
  5. Open a .md note → click the WeChat preview icon in toolbar → write
  6. Click the publish icon → fill in title / author / digest / cover → Save Draft → Publish

Local images in your Markdown are auto-uploaded to WeChat and src replaced with OA URLs during publish.

See User Guide for details.

AI Assistant Setup

Snowpub does not bundle any model — it orchestrates agent CLIs already on your machine (BYOA):

  1. Install at least one: Claude Code, OpenCode, or OpenClaw
  2. Open the AI Assistant tab in the right sidebar — detected CLIs are listed automatically
  3. Select text (or use the whole article) → click a preset: Polish / Title / Digest / Theme
  4. Click Insert on a reply to write it back to the editor at the cursor

Git Sync Setup

  1. Open Settings → Sync
  2. Select GitHub or Gitee
  3. Enter your username, repository name, and personal access token
  4. Use the git button in the toolbar or configure auto-sync in Scheduler

Community

QQ Group: 1121242452 · Join

Donate

If Snowpub is useful to you, consider buying me a coffee ☕

WeChat Pay
WeChat Pay
Alipay
Alipay

Customization Services

Want a signature theme for your brand, or a feature built on top of Snowpub? I take custom work:

  • Theme customization — your colors, typography, and layout, delivered as a drop-in theme
  • Feature development — batch publishing, asset workflows, and more, built as private modules on the open-source core
  • Private deployment & maintenance — annual plan with updates and priority support

Scan the WeChat code below and mention "custom" in your note:

WeChat
WeChat · note "custom" when adding

License

MIT © wavesnows

About

No description, website, or topics provided.

Resources

Stars

2 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages