Greeder

A clean reading mode extension.

# Greeder - Clean Reading Mode for Chrome ## Overview Greeder is a powerful Chrome extension that transforms cluttered web pages into clean, distraction-free reading experiences. With one click or keyboard shortcut (Alt+G), it extracts article content and presents it in a beautifully formatted, customizable reader view. ## Key Features ### Smart Content Extraction - Intelligent extraction engine: Combines site-specific rules with Mozilla's Readability algorithm for accurate content detection - Automatic article detection: Pre-checks pages before entering reading mode - Fallback mechanism: If one extraction method fails, automatically tries alternatives - Three-tier rule system: Bundled rules + local cache + cloud updates for optimal performance ### Customizable Reading Experience - Three beautiful themes: Light, Dark, and Sepia modes for comfortable reading in any environment - Font customization: Choose from 8+ carefully selected fonts including system fonts, serif, sans-serif, and monospaced options - Adjustable font size: 5 size presets from small to extra-large - Line spacing control: 4 spacing options for optimal readability - Flexible toolbar: Position toolbar on top, bottom, left, or right side - Fullscreen mode: Immersive reading with F11 or toolbar button ### Advanced Annotation Tools - Doodle mode: Draw freehand annotations directly on articles using Fabric.js - Multiple drawing tools: Pen, highlighter, eraser with customizable colors and brush sizes - Perfect strokes: Smooth, natural drawing powered by perfect-freehand library - Non-destructive: Annotations are layered on top without modifying original content ### Content Editing - Live Markdown editing: Edit extracted content in split-screen view - Real-time preview: See changes instantly as you type - Preserve formatting: Markdown syntax for headers, lists, links, code blocks, and more - Syntax highlighting: Code blocks beautifully highlighted with highlight.js ### Image Gallery - Lightbox viewer: Click any image to view in fullscreen gallery - Keyboard navigation: Arrow keys to browse, Esc to close - Smooth transitions: Elegant animations between images ### Export Options - Markdown export: Download original content as .md file - PDF export: Generate professional PDFs with jsPDF - PNG export: Capture full article or selected region as image - Crop tool: Select specific portions to export ### Smart Blacklist System - Three-tier protection: Built-in patterns + user customization + cloud updates - Automatic filtering: Prevents reading mode on web apps, dashboards, and incompatible sites - Memory feature: Remembers when you manually exit reading mode on specific pages - Domain-level blocking: Wildcards supported (e.g., *.example.com) ### Internationalization - Multi-language support: Full interface in English, Chinese (中文), Japanese (日本語), Korean (한국어), German (Deutsch), French (Français), Spanish (Español), Portuguese (Português), Russian (Русский), Arabic (العربية), Hindi (हिन्दी), Bengali (বাংলা), Indonesian (Bahasa Indonesia), Italian (Italiano), and Urdu (اردو) - Auto-detection: Matches browser language preference - Remote config: Donation info and changelog localized via backend API ### Privacy & Performance - Offline-first design: Core features work without internet connection - No tracking: Zero user data collection, no analytics - Minimal permissions: Only requests necessary permissions (activeTab, storage, alarms) - Shadow DOM isolation: Reader UI completely isolated from page styles to prevent conflicts - Per-site settings: Theme and layout preferences saved per hostname ### Developer-Friendly - Open source: Transparent codebase built with modern web technologies - Manifest V3: Future-proof Chrome extension architecture - Error reporting: Optional anonymous error reports to improve extraction accuracy - Regular updates: Cloud-based rule updates for new websites ## How It Works 1. **Activate**: Click extension icon or press Alt+G on any article page 2. **Extract**: Greeder analyzes the page and extracts main content (title, body, author, date) 3. **Render**: Content displays in clean reader view with your preferred theme and settings 4. **Customize**: Adjust fonts, sizes, themes, or add annotations 5. **Export**: Save as Markdown, PDF, or PNG when finished ## Use Cases - Research & studying: Read academic papers and long articles without distractions - Content curation: Extract and save articles for later reference - Accessibility: Improve readability with larger fonts and better contrast - Annotation: Mark up articles with highlights and notes - Offline reading: Extract content once, read without internet ## Technology Stack - UI Framework: Lit (lightweight web components) - Styling: Shadow DOM for complete isolation - Extraction: Custom rule engine + @mozilla/readability - Markdown: marked.js for parsing and rendering - Drawing: Fabric.js 7.1 + perfect-freehand - Export: jsPDF + html2canvas + html-to-image - Build: Vite with dual build system (content + background scripts) ## Privacy Policy Greeder respects your privacy: - No data collection: We don't collect, store, or transmit personal information - Local storage only: All settings stored locally on your device - Optional error reports: If extraction fails, you can optionally send anonymous error reports (URL + rule ID only) to help improve accuracy - Cloud features: Remote rule updates and config use HTTPS and don't include user-identifying data - No third-party tracking: No analytics, ads, or tracking scripts ## Permissions Explained - **activeTab**: Read page content when you activate reading mode (only on active tab) - **storage**: Save your theme preferences and per-site settings locally - **alarms**: Check for rule updates periodically (every 12 hours) - **host_permissions** (greeder.top/api): Fetch extraction rules and config updates from our backend ## Support - Telegram Channel: Join @greeder_ext for updates and support - Discord: Join our community for discussions and feedback - X (Twitter): Follow for latest news and updates - Donations: Support development via Ko-fi, PayPal, or WeChat Pay - Feedback: Report issues or request features through the extension's About page ## What's New (v1.2.0) **New Features:** - Added French (Français), Korean (한국어), German (Deutsch), and Japanese (日本語) language support - Added Telegram, Discord, and X social icons in Settings page footer **Bug Fixes:** - Fixed: Donation panel now displays correct per-method icons from remote config - Fixed: Donation icons adapt to theme color via inline SVG rendering - Fixed: After exiting reading mode, ESC is no longer intercepted by Greeder - Fixed: ConfigManager now falls back to cached config on fetch failure, even when cache is stale **Improvements:** - About modal Changelog/FAQ tabs now scroll vertically with sticky header **Security:** - Restricted promotion.url to explicit http/https absolute URLs and hardened remote icon/SVG handling