Skip to content

πŸ“š A macOS vocabulary app that helps you collect and learn English words from daily reading, featuring clipboard monitoring and system dictionary integration.

License

Notifications You must be signed in to change notification settings

ygsgdbd/VastWords

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

32 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

VastWords πŸ“š

VastWords Logo

GitHub release (latest by date) GitHub Platform Swift Xcode SwiftUI

πŸ‡¨πŸ‡³ δΈ­ζ–‡ζ–‡ζ‘£ | English

VastWords is a macOS vocabulary application designed to help you quickly collect and learn English words encountered during daily reading. It automatically monitors the clipboard for English words and provides system dictionary lookup functionality. The application runs completely offline, with all data stored locally to ensure your privacy.

VastWords Preview

πŸ“₯ Installation

🍺 Via Homebrew (Recommended)

brew tap ygsgdbd/tap
brew install --cask vastwords

πŸ’» Manual Installation

  1. Download the latest release from the Releases page
  2. Drag VastWords.app to your Applications folder
  3. Launch VastWords from Applications or Spotlight

πŸ›  Tech Stack

  • SwiftUI + MVVM Architecture
  • CoreData + CoreStore for Data Persistence
  • Vision Framework for OCR
  • Natural Language for Lemmatization
  • Combine + Async/Await for Asynchronous Operations
  • Tuist for Project Management
  • SwiftLint + SwiftFormat for Code Standards

✨ Features

  • πŸ”„ Smart Monitoring
    • Automatic clipboard text monitoring
    • Image OCR support (using system Vision framework, offline and secure)
    • Automatic English word extraction
    • Smart word lemmatization (e.g., running β†’ run, cities β†’ city)
  • πŸ“š Integrated macOS system dictionary for real-time word definitions
  • ⭐️ Star important words
  • πŸ” Word search and filtering
  • πŸ“Š 24-hour word collection statistics
  • πŸ“₯ Word list export
  • πŸš€ Launch at login support
  • ⭐️ High-performance storage
  • 🎯 Performance optimized

πŸ” Privacy & Security

  • πŸ”’ Completely offline operation
  • πŸ’Ύ Local data storage only
  • πŸ›‘οΈ Uses system built-in features
  • 🀝 No user data collection
  • πŸ“± Minimal permissions required

⚠️ Limitations

  • Text length limit: 10,000 characters
  • Word length limit: 2-45 characters
  • Automatic filtering of common function words (e.g., a, the, in)

πŸ’» System Requirements

  • macOS 13.0 or later
  • Apple Silicon or Intel processor

πŸ”§ Development Setup

  • Xcode 15.0+
  • Swift 5.9+
  • SwiftUI
  • Tuist 3.0+

πŸ“¦ Dependencies

πŸ“„ License

This project is licensed under the MIT License. See the LICENSE file for details.

πŸ“ Third-Party Licenses

This project uses the following open source components:

About

πŸ“š A macOS vocabulary app that helps you collect and learn English words from daily reading, featuring clipboard monitoring and system dictionary integration.

Topics

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages