A simple, cross-platform RSS reader — for macOS / Windows, built for fast browsing and distraction-free reading.
简体中文 | English
- Three-column layout: source/folder tree · article list · reading view
- Subscription management: add feeds, organize into folders, OPML import/export
- Scheduled fetching: RSS / Atom parsing with background auto-refresh
- Focused reading: full-text reading view + distraction-free focus mode
- Fast search: global full-text search across titles, summaries, and notes
- Notes: attach notes to articles for later review
- Desktop notifications: new-article alerts, macOS Dock / Windows taskbar badges
- Keyboard driven: a complete set of shortcuts
- Theme & i18n: light / dark / follow-system, Chinese & English
- Performance & offline: lightweight list queries, local cache, readable offline
| Dependency | Version | Install |
|---|---|---|
| Go | ≥ 1.25 | https://go.dev/dl/ |
| Node.js | ≥ 20 | https://nodejs.org/ |
| pnpm | ≥ 9 | npm install -g pnpm |
| Wails v3 CLI | latest | go install github.com/wailsapp/wails/v3/cmd/wails3@latest |
Platform-specific requirements:
- macOS: install Xcode Command Line Tools —
xcode-select --install - Windows: WebView2 Runtime (preinstalled on Windows 11)
# Clone the repository
git clone https://github.com/clip-rss/clip.git
cd clip
# Install frontend dependencies
cd frontend
pnpm install
cd ..
# Pull Go dependencies
go mod tidywails3 task devStarts the Vite dev server and Go backend; changes apply live.
# Build the binary for the current platform
wails3 task build
# Package a distributable installer (macOS → .app / Windows → installer)
wails3 task packageArtifacts are output to the bin/ directory.
# Go backend tests
go test ./...
# Frontend type check + unit tests
cd frontend
pnpm typecheck
pnpm testAfter modifying bound methods or Go models under api/, regenerate the frontend TS bindings:
wails3 generate bindingsDo not hand-edit files under frontend/bindings/.