{"id":29152776,"url":"https://github.com/muhammetaliaydin/sumlify","last_synced_at":"2026-04-30T03:33:31.959Z","repository":{"id":301983081,"uuid":"1010823451","full_name":"muhammetaliaydin/Sumlify","owner":"muhammetaliaydin","description":"Instantly summarize any webpage using Sumlify — a lightweight and intuitive browser extension that extracts the key ideas from long web content.","archived":false,"fork":false,"pushed_at":"2025-06-29T23:47:26.000Z","size":5,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-06-30T00:27:56.270Z","etag":null,"topics":["ai-summary","browser-extension","chrome-extension","gpt","natural-language-processing","nlp","productivity","reading-tools","summarizer","summary","text-analysis","web-extension","web-summarizer","webpage-summary"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/muhammetaliaydin.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,"zenodo":null}},"created_at":"2025-06-29T21:45:30.000Z","updated_at":"2025-06-29T23:47:29.000Z","dependencies_parsed_at":"2025-06-30T00:27:58.805Z","dependency_job_id":"f1c92127-557f-42cf-9015-bd2e553dc187","html_url":"https://github.com/muhammetaliaydin/Sumlify","commit_stats":null,"previous_names":["muhammetaliaydin/sumlify"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/muhammetaliaydin/Sumlify","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/muhammetaliaydin%2FSumlify","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/muhammetaliaydin%2FSumlify/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/muhammetaliaydin%2FSumlify/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/muhammetaliaydin%2FSumlify/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/muhammetaliaydin","download_url":"https://codeload.github.com/muhammetaliaydin/Sumlify/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/muhammetaliaydin%2FSumlify/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":262876918,"owners_count":23378140,"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":["ai-summary","browser-extension","chrome-extension","gpt","natural-language-processing","nlp","productivity","reading-tools","summarizer","summary","text-analysis","web-extension","web-summarizer","webpage-summary"],"created_at":"2025-07-01T01:02:58.323Z","updated_at":"2026-04-30T03:33:28.058Z","avatar_url":"https://github.com/muhammetaliaydin.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Sumlify - AI Web Summarizer Chrome Extension\n\n![Sumlify Logo](icons/icon128.png)\n\n**Sumlify** is a modern Chrome extension that uses Google's Gemini AI to intelligently summarize web page content. With a clean, user-friendly interface, it helps you quickly understand the key points of any article, blog post, or web page.\n\n## ✨ Features\n\n- **🤖 AI-Powered Summarization**: Uses Google Gemini 2.0 Flash for accurate, contextual summaries\n- **🌍 Multi-Language Support**: Automatic language detection with summaries in the detected language (50+ languages supported)\n- **📝 Structured Output**: Get 3 key bullet points plus a concise paragraph summary\n- **💾 Smart Caching**: Stores summaries by domain to avoid repeated API calls\n- **🚀 Fast Performance**: Optimized content extraction and processing\n- **🎨 Modern UI**: Clean, responsive design with dark/light theme support\n- **🔒 Privacy-Focused**: API key stored locally, no data sent to third parties\n- **📱 Responsive Design**: Works perfectly on all screen sizes\n\n## 🚀 Quick Start\n\n### Installation\n\n1. **Download the Extension**\n   - Clone this repository or download the ZIP file\n   - Extract to a local folder\n\n2. **Load into Chrome**\n   - Open Chrome and go to `chrome://extensions/`\n   - Enable \"Developer mode\" (top right toggle)\n   - Click \"Load unpacked\" and select the extension folder\n\n3. **Get Your API Key**\n   - Visit [Google AI Studio](https://aistudio.google.com/apikey)\n   - Create a new API key for Gemini\n   - Copy the generated key\n\n4. **Setup the Extension**\n   - Click the Sumlify icon in your Chrome toolbar\n   - Enter your Gemini API key when prompted\n   - You're ready to start summarizing!\n\n### Usage\n\n1. **Navigate to any webpage** with substantial text content\n2. **Click the Sumlify extension icon** in your Chrome toolbar\n3. **Click \"Summarize Page\"** to generate an AI summary\n4. **View the results** with key points and overview\n5. **Copy, cache, or regenerate** summaries as needed\n\n## 🛠️ Technical Details\n\n### Architecture\n\n- **Manifest V3**: Modern Chrome extension architecture\n- **Content Scripts**: Smart content extraction from web pages\n- **Background Service Worker**: Handles caching and background tasks\n- **Popup Interface**: Main user interface for interaction\n\n\n### API Integration\n\n- **Endpoint**: `https://generativelanguage.googleapis.com/v1beta/models/gemini-2.0-flash:generateContent`\n- **Authentication**: API key-based authentication\n- **Content Limit**: 8,000 characters per request (automatically truncated)\n- **Response Format**: Structured markdown with bullet points and summary\n\n## 🎯 Core Features\n\n### Smart Content Extraction\n\nThe extension intelligently extracts meaningful content from web pages by:\n\n- Identifying main content areas (`\u003cmain\u003e`, `\u003carticle\u003e`, etc.)\n- Removing navigation, advertisements, and sidebar content\n- Filtering out scripts, styles, and other non-textual elements\n- Preserving the core article or page content\n\n### Intelligent Summarization\n\nSummaries are generated with:\n\n- **3 Key Bullet Points**: Most important information\n- **Overview Paragraph**: 2-3 sentence summary\n- **Multi-Language Support**: Automatically detects page language and responds accordingly\n- **Language-Specific Prompts**: Optimized prompts for Turkish, Spanish, French, German, Italian, Portuguese, Russian, and other languages\n- **Markdown Formatting**: Clean, readable output\n- **Context Awareness**: Understands content type and adjusts accordingly\n\n### Caching System\n\n- **Domain-Based Caching**: Summaries cached by website domain\n- **24-Hour Expiry**: Automatic cache invalidation\n- **Manual Refresh**: Option to generate fresh summaries\n- **Storage Management**: Automatic cleanup of expired cache\n\n## 🔧 Configuration\n\n### Settings\n\nAccess settings through the extension popup:\n\n- **API Key Management**: View, edit, or replace your Gemini API key\n- **Cache Control**: Clear individual or all cached summaries\n- **Status Monitoring**: View current operation status\n\n### Storage\n\nThe extension stores:\n\n- **API Key**: Securely stored in Chrome's local storage\n- **Cached Summaries**: Domain-based summary cache\n- **Usage Statistics**: Summary count and usage metrics\n- **Settings**: User preferences and configuration\n\n## 🔧 Recent Improvements\n\n### Cache System Enhancement\n- **Fixed Cache Key Generation**: Now includes URL parameters and hash fragments for unique page identification\n- **Per-Page Caching**: Different pages on the same domain now have separate cache entries\n- **Debug Logging**: Added comprehensive logging for cache operations (visible in browser console)\n- **Improved Cache Management**: Better cache key generation and cleanup\n\n### Multi-Language Support\n- **Automatic Language Detection**: Detects webpage language and provides summaries in the same language\n- **50+ Languages Supported**: Including Turkish, Spanish, French, German, Italian, Portuguese, Russian, and many more\n- **Localized UI**: Status messages and interface elements adapt to detected language\n\n### Dark Mode Support\n- **Theme Toggle**: Easy switching between light and dark themes\n- **Persistent Settings**: Theme preference is saved and restored\n- **Modern Design**: Clean, accessible dark mode implementation\n\n## 🎨 UI/UX Features\n\n### Modern Design\n\n- **Clean Interface**: Minimalist, professional design\n- **Responsive Layout**: Adapts to different screen sizes\n- **Smooth Animations**: Subtle transitions and loading states\n- **Visual Feedback**: Clear status indicators and progress updates\n\n### User Experience\n\n- **Intuitive Flow**: Step-by-step guided setup\n- **Error Handling**: Graceful error messages and recovery\n- **Loading States**: Clear progress indication\n- **Success Feedback**: Confirmation of completed actions\n\n### Accessibility\n\n- **Keyboard Navigation**: Full keyboard accessibility\n- **Screen Reader Support**: Proper ARIA labels and semantics\n- **High Contrast**: Readable color combinations\n- **Focus Management**: Clear focus indicators\n\n## 🔒 Privacy \u0026 Security\n\n### Data Handling\n\n- **Local Storage Only**: API keys stored locally in Chrome\n- **No Telemetry**: No usage data sent to external servers\n- **Direct API Calls**: Content sent directly to Google Gemini\n- **No Tracking**: No user behavior tracking or analytics\n\n### API Security\n\n- **Key Protection**: API keys encrypted in local storage\n- **HTTPS Only**: All API communications over secure connections\n- **Rate Limiting**: Built-in request throttling\n- **Error Handling**: Secure error message handling\n\n## 🚀 Performance\n\n### Optimization Features\n\n- **Content Filtering**: Removes unnecessary elements before processing\n- **Request Throttling**: Prevents API abuse and quota exhaustion\n- **Efficient Caching**: Reduces redundant API calls\n- **Background Processing**: Non-blocking operations\n\n### Resource Usage\n\n- **Minimal Memory**: Lightweight content scripts\n- **Fast Startup**: Quick initialization and loading\n- **Efficient Storage**: Compressed cache storage\n- **Battery Friendly**: Optimized for mobile devices\n\n## 🛠️ Development\n\n### Prerequisites\n\n- Chrome browser (version 88+)\n- Google Gemini API key\n- Basic understanding of web development\n\n### Local Development\n\n1. **Clone the repository**:\n   ```bash\n   git clone https://github.com/muhammetaliaydin/Sumlify.git\n   cd sumlify\n   ```\n\n2. **Load the extension**:\n   - Open `chrome://extensions/`\n   - Enable Developer mode\n   - Click \"Load unpacked\"\n   - Select the project folder\n\n3. **Test the extension**:\n   - Navigate to any webpage\n   - Click the extension icon\n   - Test the summarization features\n\n### Code Structure\n\n- **popup.js**: Main application logic, API integration, UI management\n- **content.js**: Content extraction, page analysis, monitoring\n- **background.js**: Service worker, caching, background tasks\n- **styles.css**: Modern CSS with variables, responsive design\n\n## 📋 Browser Compatibility\n\n### Supported Browsers\n\n- ✅ **Chrome 88+**: Full support (primary target)\n- ✅ **Edge 88+**: Full support (Chromium-based)\n- ✅ **Opera 74+**: Full support (Chromium-based)\n- ❌ **Firefox**: Not supported (different extension architecture)\n- ❌ **Safari**: Not supported (different extension architecture)\n\n### Required Permissions\n\n- `activeTab`: Access to current tab content\n- `storage`: Local storage for API keys and cache\n- `scripting`: Content script injection\n- `https://generativelanguage.googleapis.com/*`: Gemini API access\n\n## 🤝 Contributing\n\nWe welcome contributions! Please see our [contributing guidelines](CONTRIBUTING.md) for details.\n\n### Areas for Contribution\n\n- **UI/UX Improvements**: Enhanced design and user experience\n- **Feature Additions**: New summarization options, export features\n- **Performance Optimization**: Faster content extraction, better caching\n- **Bug Fixes**: Issue resolution and stability improvements\n- **Documentation**: Improved docs, tutorials, examples\n\n## 📄 License\n\nThis project is licensed under the Apache License 2.0 - see the [LICENSE](LICENSE) file for details.\n\n## 🙏 Acknowledgments\n\n- **Google Gemini**: For providing the AI summarization API\n- **Chrome Team**: For the excellent extension platform\n- **Open Source Community**: For inspiration and best practices\n\n## 📞 Support\n\n- **Issues**: [GitHub Issues](https://github.com/muhammetaliaydin/Sumlify/issues)\n- **Documentation**: [Wiki](https://github.com/muhammetaliaydin/Sumlify/wiki)\n- **Discussions**: [GitHub Discussions](https://github.com/muhammetaliaydin/Sumlify/discussions)\n\n## 🔄 Version History\n\n### v1.0.0 (Current)\n- Initial release\n- Google Gemini integration\n- Modern UI design\n- Caching system\n- Content extraction\n- Background service worker\n\n---\n\n**Made with ❤️ for better web browsing**\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmuhammetaliaydin%2Fsumlify","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmuhammetaliaydin%2Fsumlify","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmuhammetaliaydin%2Fsumlify/lists"}