🌐 Visit Official Website (GitHub Pages)
English | 简体中文
TheBerry is an ultra-fast, offline-first personal desktop productivity suite built with Tauri v2 + Rust on the backend and SolidJS + TypeScript + Tailwind CSS on the frontend.
- Instant federated search across Launcher apps, Clipboard history, Code Snippets, and local Files.
- Dedicated category filter tags (
@app,@clip,@snip,@file). - Full keyboard workflow:
↑/↓navigate,Enteractivate,Ctrl+Ccopy path,Ctrl+Ereveal in Explorer,Escdismiss.
- Background daemon capturing plain text, URLs, and image screenshots.
- Real-time base64 image thumbnails with fullscreen zoom viewer.
- Deep redb full-text search with content type (
text,image,url,json) and pin filters. - Batch selection and deletion mode.
- Automatic Windows Start Menu (
.lnk) application discovery scanner. - Custom arguments, working directories, and multi-command batch execution.
- Placeholder template expansion:
${DATE},${TIME},${UUID},${CLIPBOARD_TEXT}. - Real-time live evaluation preview card while writing snippets.
- JSON backup export and bulk import.
- Batch image compression and format conversion across PNG, JPEG, and WebP.
- High-fidelity Lanczos3 scaling, aspect ratio preservation, and quality tuning.
- 4 One-click presets (
Web Optimized (WebP 80%),Lossless (PNG),Thumbnail (600px),Mobile (1280px JPG)). - Byte reduction and storage savings percentage telemetry.
- Instant multi-drive file matching with substring keyword highlighting.
- Sortable table columns (Name, Size, Path) and 1-click Explorer reveal.
- Native Windows QuickLook spacebar file previews integrated into File Search, Spotlight, and Image Converter.
- High-performance folder synchronization with Two-way, Mirror, and Update modes.
- Comparison engine supporting Timestamp & Size or cryptographic Content Hash (SHA-256).
- Real-time filesystem change monitoring with configurable debouncing.
- Safe deletion handling via Recycle Bin, timestamped Versioning archives, or permanent removal.
- Image Compressor: Deep multi-threaded image optimization with SIMD encoding, quality sliders, max dimension scaling, and byte savings telemetry.
- Markdown & Rich Text Converter: Bi-directional Markdown ➔ HTML ➔ Plain text conversions, live preview, and one-click rich text clipboard export for Word, Outlook, and WeChat.
- Excel & CSV Sheet Converter: Rapid conversion between XLSX, XLS, CSV, and TSV with paginated table viewer, multi-sheet workbook tabs, JSON export, and Excel-compatible UTF-8 BOM encoding.
- PDF Organizer (Merge & Split): Combine multiple PDFs with custom reordering and per-file page ranges; extract and split pages by range into separate documents.
- PDF to Images: High-resolution page rendering (1x, 2x, 3x DPI scale) exporting to PNG, JPEG, and WebP.
- Windows Native OCR & AI Vision: Built-in Windows 10/11 offline OCR (
Windows.Media.Ocr) with instant screenshot paste (Ctrl+V) and direct bridge to TheBerry AI assistant. - Word to PDF Converter: Headless batch conversion of
.docxand.docfiles to PDF via Windows Office automation. - Cryptographic File Hash: Multi-threaded checksum calculator verifying MD5, SHA-1, SHA-256, and SHA-512.
- Batch File Renamer: Advanced renaming engine supporting regular expressions, prefixes/suffixes, sequential numbering, and real-time preview.
- QR Code Tools: Offline QR code generation for text, URLs, and Wi-Fi networks, plus barcode scanning from images.
- JSON & YAML Converter: Structured data formatting, bi-directional conversion, and live syntax validation.
- Customizable Card Hub: Categorized sections and flat grid modes with pointer-based drag reordering and right-click pin to sidebar.
- 100% Bilingual Localization: Full English & Simplified Chinese coverage across all views, modal dialogs, tag badges, and toast notifications.
- HTML5 drag-and-drop reordering for both the Sidebar navigation and Toolbox cards.
- Right-click context menu to customize tool display names/aliases, hide items, or reset defaults.
- Three-tier hidden items depot: (1) Collapsible bottom "Stored Utilities" drawer (
+ N), (2) Toolbox pin toggles, and (3) Global Navigation Manager modal.
- Native Rust HTTP streaming downloader writing directly to
<data_dir>/updates/without browser redirects or CORS limits. - Real-time download progress with percentage, downloaded/total bytes, and throughput transfer speed.
- 1-click silent NSIS installer invocation (
/S) followed by graceful main process termination and restart, eliminating manual uninstallation. - Native Windows Registry
Runkey autostart toggle (no UAC elevation needed). - Full database & preferences JSON backup export & restore.
- Interactive keyboard shortcuts cheatsheet modal (
?/F1).
graph TD
UI[SolidJS + Tailwind CSS Frontend] <-->|Tauri IPC / SafeInvoke| Core[Rust Core Engine]
Core <--> redb[(redb ACID Embedded DB)]
Core <--> toml[config.toml & bootstrap.toml]
Core <--> system[Windows Registry / arboard / Lanczos3]
- Backend: Rust + Tauri v2
- Frontend: SolidJS + TypeScript + Vite + Tailwind CSS
- Storage: redb embedded transactional database + TOML
- Data Policy: 100% offline, user-configured storage directory (default
<Documents>/BerryAppData).
- Windows 10 (version 1903+) or Windows 11 (x64)
- Node.js (v20+) & pnpm
- Rust & Cargo (1.78+)
- (Optional) QuickLook for native desktop spacebar previews
# Install dependencies
pnpm install
# Run frontend unit tests
pnpm test
# Run backend Rust integration tests
cargo test --manifest-path src-tauri/Cargo.toml
# Start desktop app in development mode
pnpm tauri dev
# Build production bundle
pnpm tauri build- Architecture Overview
- Module IPC Interfaces
- Milestone 1 Specification
- Milestone 2 Specification
- Milestone 3 Specification
- ADR-0001: Architecture Foundation
- ADR-0002: Persistence Layer (redb + TOML)
- ADR-0003: Frameless GUI & System Tray
- ADR-0004: MVP Feature Suite
- ADR-0005: Offline Privacy & Security
- ADR-0006: GUI Polish, Autostart & Deep Search
- ADR-0007: Unified Database Portability & CI Pipeline