{"id":23350720,"url":"https://github.com/ygsgdbd/vastwords","last_synced_at":"2025-07-18T16:32:49.537Z","repository":{"id":268488873,"uuid":"902744052","full_name":"ygsgdbd/VastWords","owner":"ygsgdbd","description":"📚 A macOS vocabulary app that helps you collect and learn English words from daily reading, featuring clipboard monitoring and system dictionary integration.","archived":false,"fork":false,"pushed_at":"2024-12-22T10:40:58.000Z","size":875,"stargazers_count":11,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-02-13T20:17:29.239Z","etag":null,"topics":["clipboard","combine","dictionary","education","macos","menubar-app","offline","offline-first","productivity","swift","swifterswift","swiftui","tuist","vocabulary-learning"],"latest_commit_sha":null,"homepage":"","language":"Swift","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ygsgdbd.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-12-13T07:19:45.000Z","updated_at":"2024-12-31T11:37:18.000Z","dependencies_parsed_at":"2024-12-17T04:35:34.147Z","dependency_job_id":"ea0626f3-0a83-4938-bb2b-39aa4095009d","html_url":"https://github.com/ygsgdbd/VastWords","commit_stats":null,"previous_names":["ygsgdbd/vastwords"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ygsgdbd%2FVastWords","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ygsgdbd%2FVastWords/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ygsgdbd%2FVastWords/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ygsgdbd%2FVastWords/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ygsgdbd","download_url":"https://codeload.github.com/ygsgdbd/VastWords/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247704579,"owners_count":20982299,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["clipboard","combine","dictionary","education","macos","menubar-app","offline","offline-first","productivity","swift","swifterswift","swiftui","tuist","vocabulary-learning"],"created_at":"2024-12-21T08:17:53.853Z","updated_at":"2025-04-07T18:20:38.718Z","avatar_url":"https://github.com/ygsgdbd.png","language":"Swift","funding_links":[],"categories":[],"sub_categories":[],"readme":"# VastWords 📚\n\n\u003cdiv align=\"center\"\u003e\n  \u003cimg src=\"Screenshots/logo.png\" alt=\"VastWords Logo\" width=\"128\" height=\"128\"\u003e\n\u003c/div\u003e\n\n[![GitHub release (latest by date)](https://img.shields.io/github/v/release/ygsgdbd/VastWords)](https://github.com/ygsgdbd/VastWords/releases)\n[![GitHub](https://img.shields.io/github/license/ygsgdbd/VastWords)](https://github.com/ygsgdbd/VastWords/blob/main/LICENSE)\n[![Platform](https://img.shields.io/badge/platform-macOS%2013%2B-brightgreen)](https://github.com/ygsgdbd/VastWords)\n[![Swift](https://img.shields.io/badge/Swift-5.9-orange.svg)](https://swift.org)\n[![Xcode](https://img.shields.io/badge/Xcode-15.0%2B-blue)](https://developer.apple.com/xcode/)\n[![SwiftUI](https://img.shields.io/badge/SwiftUI-3.0-blue)](https://developer.apple.com/xcode/swiftui)\n\n[🇨🇳 中文文档](README_zh.md) | English\n\nVastWords 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.\n\n\u003cdiv align=\"center\"\u003e\n  \u003cimg src=\"Screenshots/preview-dark.png\" alt=\"VastWords Preview\" width=\"360\"\u003e\n\u003c/div\u003e\n\n## 📥 Installation\n\n### 🍺 Via Homebrew (Recommended)\n\n```bash\nbrew install ygsgdbd/tap/vastwords\n```\n\n### 💻 Manual Installation\n\n1. Download the latest release from the [Releases](https://github.com/ygsgdbd/VastWords/releases) page\n2. Drag VastWords.app to your Applications folder\n3. Launch VastWords from Applications or Spotlight\n\n## 🛠 Tech Stack\n\n- SwiftUI + MVVM Architecture\n- CoreData + CoreStore for Data Persistence\n- Vision Framework for OCR\n- Natural Language for Lemmatization\n- Combine + Async/Await for Asynchronous Operations\n- Tuist for Project Management\n- SwiftLint + SwiftFormat for Code Standards\n\n## ✨ Features\n\n- 🔄 Smart Monitoring\n  - Automatic clipboard text monitoring\n  - Image OCR support (using system Vision framework, offline and secure)\n  - Automatic English word extraction\n  - Smart word lemmatization (e.g., running → run, cities → city)\n- 📚 Integrated macOS system dictionary for real-time word definitions\n- ⭐️ Star important words\n- 🔍 Word search and filtering\n- 📊 24-hour word collection statistics\n- 📥 Word list export\n- 🚀 Launch at login support\n- ⭐️ High-performance storage\n- 🎯 Performance optimized\n\n## 🔐 Privacy \u0026 Security\n\n- 🔒 Completely offline operation\n- 💾 Local data storage only\n- 🛡️ Uses system built-in features\n- 🤝 No user data collection\n- 📱 Minimal permissions required\n\n## ⚠️ Limitations\n\n- Text length limit: 10,000 characters\n- Word length limit: 2-45 characters\n- Automatic filtering of common function words (e.g., a, the, in)\n\n## 💻 System Requirements\n\n- macOS 13.0 or later\n- Apple Silicon or Intel processor\n\n## 🔧 Development Setup\n\n- Xcode 15.0+\n- Swift 5.9+\n- SwiftUI\n- [Tuist](https://tuist.io) 3.0+\n\n## 📦 Dependencies\n\n- [CoreStore](https://github.com/JohnEstropia/CoreStore)\n- [Defaults](https://github.com/sindresorhus/Defaults)\n- [SwifterSwift](https://github.com/SwifterSwift/SwifterSwift)\n- [SwiftUIX](https://github.com/SwiftUIX/SwiftUIX)\n\n## 📄 License\n\nThis project is licensed under the MIT License. See the [LICENSE](LICENSE) file for details.\n\n### 📝 Third-Party Licenses\n\nThis project uses the following open source components:\n\n- [CoreStore](https://github.com/JohnEstropia/CoreStore) - MIT License\n- [Defaults](https://github.com/sindresorhus/Defaults) - MIT License\n- [SwifterSwift](https://github.com/SwifterSwift/SwifterSwift) - MIT License\n- [SwiftUIX](https://github.com/SwiftUIX/SwiftUIX) - MIT License ","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fygsgdbd%2Fvastwords","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fygsgdbd%2Fvastwords","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fygsgdbd%2Fvastwords/lists"}