BeeCount   中文

Your Data, Your Control — Open Source Accounting App

Sync via BeeCount Cloud (self-hosted) / iCloud / Supabase / WebDAV / S3

🌐 Website · 📖 Docs · 💝 Donate · 💬 Telegram · 📦 APK · 🚀 TestFlight

---

🤖 New: MCP support — pair with BeeCount Cloud to drive your ledger from any MCP client.

---

💡 Why BeeCount

A lightweight, open-source, privacy-first personal finance and expense tracking app.

Traditional apps	BeeCount
❌ Data on third-party servers, no audit	✅ Fully open-source, code auditable
❌ Privacy may be analyzed and exploited	✅ Offline-first + self-hosted, developer can't access your data
❌ Service shutdown = data loss	✅ Data sovereignty, choose from 5 sync options
❌ Premium features behind paywalls	✅ Completely free (including AI / OCR / voice input)
❌ Ads / financial product recommendations	✅ Zero ads / zero tracking / zero data collection

Platform support: 🤖 Android 5.0+ · 🍎 iOS 15.5+ · 🌐 Web (built into BeeCount Cloud, see below)

📱 HarmonyOS — Discontinued

---

🌟 Core Features

🤖 AI-Powered — AI assistant / OCR / voice / auto-capture from screenshots

• AI Assistant — Natural language conversation, intent recognition, powered by Zhipu GLM-4
• OCR Photo Capture — Dual engines (local TFLite + GLM cloud), recognizes Alipay/WeChat/UnionPay screenshots
• Voice Input — Hold to speak, GLM models understand colloquial expressions
• Auto Capture from Screenshots — Android accessibility service / iOS Shortcuts back-tap

📝 Bookkeeping — multi-ledger / accounts / categories / budgets / recurring / tags / charts / import-export

• Multi-ledger — Separate ledgers for life/work/investment, each with its own currency
• Multiple accounts — Cash/card/credit, transfer auto-updates both balances
• Two-tier categories — Parent-child hierarchy
• Budgets — Total + category budgets, overspending alerts
• Recurring transactions — Daily/weekly/monthly/yearly auto-records for fixed income/expenses
• Tags — Multi-tag with color labels for flexible filtering
• Charts — Monthly reports / category rankings / trends / annual report
• Import/Export — CSV (Alipay/WeChat bills) + YAML config

🎨 Experience — dark mode / 3 languages / home widgets / theming

• Dark mode — Pure black + theme accent borders, OLED-friendly
• 3 languages — Simplified/Traditional Chinese, English, with localized formatting
• Home widgets — iOS / Android quick-record widgets
• Theme customization — Multiple primary colors

---

📸 Screenshots

More screenshots (9 themes / dark mode)

9 Core Themes

Dark Mode

---

☁️ Sync Options

BeeCount offers 5 sync options. Your data, your control. See docs/cloud-setup_EN.md for full setup guides.

Option	Best For	Highlights
BeeCount Cloud	Real-time multi-device + self-hosted + multi-user co-write	One-click Docker, sub-second sync, built-in Web, multi-user, shared ledgers
iCloud	iOS-only users	Zero config, native integration
Supabase	Cross-platform without NAS	Generous free tier, easy setup
WebDAV	NAS users	Local data, Synology/UGREEN/Nextcloud
S3 protocol	Flexible cloud storage	Cloudflare R2/AWS S3/MinIO, large free tier

🔐 Why self-host? Privacy first, cost control, data security, fully open-source. All sync code is auditable.

---

🆕 BeeCount Cloud (Self-hosted)

Sub-second multi-device sync + Web admin + multi-user isolation + AES-256 encrypted backup — Recommended for users with NAS / VPS / Docker.

Highlights

• 📱 Real-time multi-device — Phone A makes a change, Phone B and Web see it within seconds (WebSocket)
• 🌐 Built-in Web admin — One Docker image = server + web; open server URL to use
• 👥 Multi-user isolation — One server, many user accounts, each only sees their own data
• 🤝 Shared ledgers — Owner generates an invite code; family / team join the same book. Owner / Editor roles, realtime sync, every transaction tagged with creator + last editor, plus member balance stats. iOS / Android / Web all supported.
• 🔐 AES-256 encrypted backup — Multi-remote fan-out (R2 / S3 / WebDAV / B2), AES zip encryption — recoverable with standard tools even without the service

Deploy + Full Documentation

Full Docker Compose deployment, backup system, PWA, and ops details live in the Cloud repo:

👉 BeeCount-Cloud repo — One-click Docker deploy + full docs

Web Admin Preview

_{💰 Home: income/expense, asset breakdown, category heatmap, trends — at a glance (dark mode)}

More Web screenshots

_{📒 Transactions: keyword / category / account / date / tag multi-filter}

_{📱 Online devices + backup archive management}

---

🛠️ Development

Tech stack + quick start

Tech Stack

• Flutter 3.27+ · Cross-platform UI framework
• Riverpod · State management
• Drift (SQLite) · Local database ORM
• Supabase / Self-hosted BeeCount Cloud / WebDAV / S3 · Multi-option cloud sync

Quick Start

# Install dependencies
flutter pub get

# Code generation
dart run build_runner build --delete-conflicting-outputs

# Run app
flutter run --flavor dev

# Build release
flutter build apk --flavor prod --release

See docs/contributing/CONTRIBUTING.md for development conventions.

---

🤝 Contributing

All contributions welcome

• 🐛 Report a bug
• 💡 Feature request
• 💻 Code · 🌍 Translation · 📝 Docs · 🎨 Designer recruitment

Quick start: Fork → create feature branch → commit → PR. See the full contributing guide for details.

---

🎨 Skins

Contribute a skin

"Theme color + skin = the header banner." Skins come in two kinds: code skins (CustomPainter drawing gradients / shapes, auto-following the theme color) and image skins (an SVG painted edge-to-edge with BoxFit.cover, optionally recolored to the theme color via themed: true).

Easiest path: copy example_skin.svg → drop your SVG into assets/header_skins/ → register one entry in lib/styles/header_skins.dart → add an i18n name and run flutter gen-l10n.

Full spec (SVG requirements + theme recoloring + integration steps): assets/header_skins/README_EN.md.

---

💬 FAQ

Common questions

Q: Can I use it without configuring cloud services? A: Absolutely! The app uses local storage by default. All features work normally. You can export CSV for backup anytime.

Q: Which sync option should I pick? A:

• iOS single device → iCloud (zero config)
• Cross-platform + real-time multi-device → BeeCount Cloud (self-hosted, recommended)
• Cross-platform without NAS → Supabase / S3
• Have a NAS → WebDAV

Q: How is data security ensured? A: Use your own server / Storage / Bucket. WebDAV and S3 should use HTTPS. BeeCount Cloud backups are AES-256 encrypted by default.

For more details, see docs/cloud-setup_EN.md or Issues.

---

💝 Donate

BeeCount is completely free and open-source — no ads, no paid features. If you find it useful, buy the developer a coffee ☕ to support continued development.

How to Donate

Alipay / WeChat QR codes

Alipay	WeChat Pay

USDT (TRC20): TKBV69B2AoU67p3vDhnJUbMJtZ1DxuUF5C ·

Binance QR code

Cost Transparency

Item	Amount
Apple Developer Account renewal	¥688 / year
Lightweight cloud server (ICP filing)	¥79 / year
Domain	¥80 / year
Google Play Developer Account (one-time)	¥177
Annual recurring cost	¥847 / year

Supporters

*Qiao ¥12	*Rui ¥720	fishdivinity ¥100	*Shao ¥15	*Ge ¥6	*Te ¥15	*Wen ¥50	Anonymous ¥50	birdnofoots ¥10	Charies ¥10	542474846 ¥66	JOHN-2025 ¥30

💡 Already donated? Submit info to be displayed in the list.

---

📄 License

This project uses the Business Source License (BSL).

Use Case	License
✅ Personal / learning / open-source contribution	Completely free
❌ Commercial use	Requires paid license

What counts as commercial use

• Providing this software as a commercial product or service to customers
• Using it in a for-profit organization
• Building commercial products on top of this software
• Offering paid cloud services based on this software

For commercial licensing, please contact via GitHub Issues. See LICENSE for details.

---

📦 Related Repositories

Repository	Description
BeeCount-Cloud	Self-hosted sync server + Web admin (FastAPI + React)
BeeCount-Website	Website / docs repo
beecount-openharmony	HarmonyOS version (discontinued)
BeeShot	App Store screenshot generator
honeycomb	Claude Code plugin marketplace (skills/agents used for developing this project)

---

⭐ Star History

View Star history chart

---

🙏 Acknowledgments

Thanks to Guhe Bake (Internet Pure Land) and Star Mochen for promoting this project.

Thanks to everyone who has contributed code, suggestions, or feedback to BeeCount!

For questions or suggestions, please raise an Issue or join the Discussions.

BeeCount 🐝 — Making accounting simple and secure