← Back to home

Install Guide

Last updated: 2026-04-18 · 简体中文

Publishing Assistant is a desktop app. macOS is supported first; Windows / Linux coming soon.

macOS

Step 1: Download

Pick the build that matches your Mac:

Download .dmg Apple Silicon (M1/M2/M3/M4) Download .dmg Intel
🚧 v0.1 is coming soon. Download links will point to GitHub Releases once published.

Not sure which one? Click the 🍎 Apple menu in the top-left corner → About This Mac. In the window:

Step 2: Install

1Double-click the dmg to mount it.

2Drag Publishing Assistant into the Applications folder.

3Open Launchpad / Applications, locate Publishing Assistant, then right-click → Open.

⚠️ You must use right-click → Open the first time. Double-clicking will be blocked by macOS with "cannot verify developer".

4Click "Open" in the dialog (not Cancel, not Move to Trash).

5From now on, double-click works normally — no more prompts.

Why this dance?

By default, macOS only trusts apps notarized by Apple. Publishing Assistant doesn't yet have an Apple Developer account, so the OS asks you to manually confirm "I trust this app" once. We'll get the developer account and proper signing + notarization set up; after that, double-click installs will be friction-free.

Want a one-liner instead? (advanced users)

xattr -dr com.apple.quarantine "/Applications/Publishing Assistant.app"

Run that in Terminal once and double-click will work directly. Learn more about Gatekeeper

Uninstall

Drag /Applications/Publishing Assistant to the Trash.

Your local data (account tokens, AI key, task history) is not deleted by uninstalling — it's your data. To wipe it completely:

rm -rf "$HOME/Library/Application Support/Publishing Assistant"
rm -rf "$HOME/Library/Logs/Publishing Assistant"

Windows coming soon

Windows builds (.exe / NSIS installer) will land after v0.1. SmartScreen will show a warning for unsigned builds — click "More info → Run anyway".

Linux coming soon

Linux build (AppImage) will be available in a later release, runnable on Ubuntu / Fedora / Arch / etc.

FAQ

Q: White screen / nothing happens after launch?

Open ~/Library/Logs/Publishing Assistant/main.log, copy the last few lines, and email them to [email protected].

Q: "Cannot verify developer" prompt has no "Open" button?

On newer macOS, go to System Settings → Privacy & Security. Near the bottom you'll see "'Publishing Assistant' was blocked because it is not from an identified developer". Click Open Anyway.

Q: Browser doesn't respond when connecting YouTube?

Check that your default browser can open https://accounts.google.com/ normally. If you use a proxy / VPN, make sure it supports OAuth callbacks to http://127.0.0.1:<random-port>.

Q: Where is my OpenRouter API key stored?

The API key is encrypted via the OS keychain and stored in a local SQLite database — nothing is uploaded to any server. See the Privacy Policy.