{"id":25012975,"url":"https://github.com/moinsen-dev/chrome-extension-hardcode-blackout","last_synced_at":"2026-01-08T21:05:10.680Z","repository":{"id":275804023,"uuid":"927244253","full_name":"moinsen-dev/chrome-extension-hardcode-blackout","owner":"moinsen-dev","description":"Hardcore Blackout is a Chrome extension designed to filter unwanted social media content based on user-defined keywords, AI-powered content analysis, and browsing history management.","archived":false,"fork":false,"pushed_at":"2025-02-04T16:43:50.000Z","size":556,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"develop","last_synced_at":"2025-02-04T17:43:21.864Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":null,"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/moinsen-dev.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":"2025-02-04T16:36:54.000Z","updated_at":"2025-02-04T16:43:53.000Z","dependencies_parsed_at":"2025-02-04T17:43:24.876Z","dependency_job_id":"7ef740cb-de7e-4f81-af95-d3981a018f0b","html_url":"https://github.com/moinsen-dev/chrome-extension-hardcode-blackout","commit_stats":null,"previous_names":["moinsen-dev/chrome-extension-hardcode-blackout"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/moinsen-dev%2Fchrome-extension-hardcode-blackout","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/moinsen-dev%2Fchrome-extension-hardcode-blackout/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/moinsen-dev%2Fchrome-extension-hardcode-blackout/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/moinsen-dev%2Fchrome-extension-hardcode-blackout/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/moinsen-dev","download_url":"https://codeload.github.com/moinsen-dev/chrome-extension-hardcode-blackout/tar.gz/refs/heads/develop","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":246273557,"owners_count":20750906,"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":[],"created_at":"2025-02-05T06:19:07.791Z","updated_at":"2026-01-08T21:05:10.675Z","avatar_url":"https://github.com/moinsen-dev.png","language":null,"funding_links":[],"categories":[],"sub_categories":[],"readme":"# Hardcore Blackout\n\n[![TypeScript](https://img.shields.io/badge/TypeScript-4.9.5-blue.svg)](https://www.typescriptlang.org/)\n[![React](https://img.shields.io/badge/React-18.0.0-blue.svg)](https://reactjs.org/)\n[![MUI](https://img.shields.io/badge/MUI-5.0.0-blue.svg)](https://mui.com/)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n[![Chrome Extension](https://img.shields.io/badge/Chrome-Extension-green.svg)](https://chrome.google.com/webstore)\n[![Local AI](https://img.shields.io/badge/AI-Ollama-orange.svg)](https://ollama.ai/)\n\nA sophisticated Chrome extension that helps you take control of your social media experience through advanced content filtering and rating, powered by local AI processing with Ollama.\n\n![Hardcore Blackout](hardcore-blocker.jpeg)\n\n## Features\n\n### 🎯 Smart Content Rating\n- Real-time content analysis using Ollama AI models\n- 0-100 rating scale with visual indicators\n- Content classification with icons (💬 Personal, 💼 Business, 💻 Tech, etc.)\n- Comprehensive rating components:\n  - Content Quality (40%)\n  - Emotional Impact (30%)\n  - User Preferences (30%)\n\n### 🛡️ Content Filtering\n- Platform-specific content detection (Twitter, Facebook, Reddit, LinkedIn)\n- Customizable filtering thresholds\n- Visual feedback through color-coded ratings\n- Quick actions: Hide/Block content\n- Automatic content dimming or hiding based on quality scores\n\n### 🔒 Privacy First\n- All processing happens locally using Ollama\n- No data sent to external servers\n- Complete control over AI model selection\n- Your social media content never leaves your device\n\n### 📊 Feed Analytics\n- Track content quality trends over time\n- Identify top authors and content types\n- Export analytics data (CSV/JSON)\n- LinkedIn-specific feed analysis\n\n### ⚡ Performance\n- Efficient post detection and processing\n- Smart caching system with 24-hour expiration\n- Minimal impact on browsing experience\n- Real-time processing counter\n\n### 🎨 Modern UI\n- Clean, intuitive interface\n- Dark mode support\n- Material Design components\n- Responsive overlays and popups\n- Welcome screen with feature overview\n\n## Tech Stack\n\n- **Frontend**: React 18, TypeScript, Material-UI\n- **Styling**: TailwindCSS, PostCSS\n- **AI**: Ollama (local LLM server)\n- **Build**: Webpack 5, Babel\n- **Storage**: Chrome Storage API, SQL.js for analytics\n\n## Prerequisites\n\nBefore you begin, ensure you have the following:\n\n1. **Node.js and npm**\n   - Download and install from [nodejs.org](https://nodejs.org/)\n   - Required version: 16.x or higher\n\n2. **Ollama**\n   - Download and install from [ollama.ai](https://ollama.ai/)\n   - Run Ollama locally: `ollama serve`\n   - Pull a model (e.g., `ollama pull llama3.2` or `ollama pull gemma3:4b`)\n\n3. **Git**\n   - For cloning the repository\n\n## Installation\n\n### 1. Clone the repository\n```bash\ngit clone https://github.com/yourusername/chrome-extension-hardcode-blackout.git\ncd chrome-extension-hardcode-blackout\n```\n\n### 2. Install dependencies\n```bash\nnpm install\n```\n\n### 3. Build the extension\n```bash\nnpm run build\n```\n\n### 4. Load in Chrome\n1. Open Chrome and navigate to `chrome://extensions/`\n2. Enable \"Developer mode\" (toggle in top right)\n3. Click \"Load unpacked\"\n4. Select the `dist` directory from the project\n\n### 5. Start Ollama\nMake sure Ollama is running on your system:\n```bash\nollama serve\n```\n\n## Development\n\n### Available Scripts\n\n```bash\n# Development build with watch mode\nnpm run dev\n\n# Production build\nnpm run build\nnpm run prod\n\n# Type checking\nnpm run type-check\n\n# Linting\nnpm run lint\nnpm run lint:fix\n\n# Testing\nnpm test\nnpm run test:watch\nnpm run test:coverage\n```\n\n### Project Structure\n\n```\nsrc/\n├── background/          # Background service worker\n│   ├── index.ts        # Main background script\n│   ├── ollama-service.ts # Ollama API integration\n│   └── database-service.ts # Analytics database\n├── content/            # Content scripts\n│   ├── content-script.ts # Main content script\n│   └── feed-analyzer.ts  # LinkedIn feed analytics\n├── ui/                 # React UI components\n│   ├── popup/          # Extension popup\n│   └── options/        # Options page\n└── utils/              # Shared utilities and types\n```\n\n### Development Workflow\n\n1. **Start Ollama**: Ensure Ollama is running locally\n2. **Run dev build**: `npm run dev` for automatic rebuilding\n3. **Reload extension**: Click refresh in `chrome://extensions/` after changes\n4. **Debug**: Use Chrome DevTools for debugging\n\n## Configuration\n\n### Ollama Setup\n\n1. **Install Ollama models**:\n   ```bash\n   # Recommended models\n   ollama pull llama3.2      # Fast, balanced\n   ollama pull gemma3:4b     # Google's Gemma\n   ollama pull mistral       # Mistral AI\n   ollama pull phi3          # Microsoft Phi-3\n   ```\n\n2. **Configure in extension**:\n   - Click the extension icon\n   - Go to Settings\n   - Select your preferred Ollama model\n   - Adjust inference settings (temperature, max tokens)\n\n### Content Filtering Settings\n\n- **Auto-Hide Threshold**: Posts below this score are hidden (default: 20)\n- **Dim Threshold**: Posts below this score are dimmed (default: 40)\n- **Highlight Threshold**: Posts above this score are highlighted (default: 80)\n\n## Usage\n\n### Basic Usage\n\n1. **Initial Setup**:\n   - Install the extension\n   - Ensure Ollama is running\n   - Visit the options page for initial configuration\n\n2. **Browsing Social Media**:\n   - Navigate to supported platforms (Twitter, Facebook, Reddit, LinkedIn)\n   - Posts are automatically analyzed and rated\n   - Look for the rating overlay in the top-right of each post\n\n3. **Understanding Ratings**:\n   - 🔴 0-20: Very Poor (auto-hidden)\n   - 🟠 20-40: Poor (dimmed)\n   - 🟡 40-60: Fair (slightly dimmed)\n   - 🟢 60-80: Good (normal display)\n   - 🟢 80-100: Excellent (may be highlighted)\n\n4. **Content Classification Icons**:\n   - 💬 Personal/Social\n   - 💼 Business\n   - 💻 Technology\n   - 💰 Finance\n   - 📰 News\n   - 🎬 Entertainment\n   - 📚 Education\n   - 📢 Promotion/Ads\n   - 🏛️ Politics\n   - 📄 Other\n\n### Advanced Features\n\n- **Feed Analytics** (LinkedIn only):\n  - View content quality trends\n  - Track top authors\n  - Export data for analysis\n\n- **Quick Actions**:\n  - Hide: Temporarily hide a post\n  - Block: Permanently block similar content\n\n## Troubleshooting\n\n### Common Issues\n\n1. **\"Ollama Not Available\" error**:\n   - Ensure Ollama is running: `ollama serve`\n   - Check if it's accessible at `http://localhost:11434`\n   - Try clicking \"Check Ollama Status\" in settings\n\n2. **No ratings appearing**:\n   - Check the extension console for errors\n   - Verify Ollama has a model loaded\n   - Ensure you're on a supported platform\n\n3. **Performance issues**:\n   - Try a smaller Ollama model (e.g., `phi3`)\n   - Adjust max tokens in settings\n   - Clear cached ratings in Chrome storage\n\n## Contributing\n\nWe welcome contributions! Please see our [Contributing Guidelines](CONTRIBUTING.md) for details.\n\n### Development Process\n1. Fork the repository\n2. Create your feature branch (`git checkout -b feature/amazing-feature`)\n3. Commit your changes (`git commit -m 'Add amazing feature'`)\n4. Push to the branch (`git push origin feature/amazing-feature`)\n5. Open a Pull Request\n\n## Privacy \u0026 Security\n\n- **Local Processing**: All AI inference happens on your device via Ollama\n- **No External APIs**: No content is sent to external services\n- **Data Storage**: Only ratings and analytics are stored locally\n- **Open Source**: Full code transparency\n\n## License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n\n## Acknowledgments\n\n- [Ollama](https://ollama.ai/) for local LLM inference\n- [Material-UI](https://mui.com/) for UI components\n- The open-source community for inspiration and support\n\n---\n\n**Note**: This extension requires Ollama to be installed and running on your local machine. It does not include any AI models - you must download them separately through Ollama.","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmoinsen-dev%2Fchrome-extension-hardcode-blackout","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmoinsen-dev%2Fchrome-extension-hardcode-blackout","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmoinsen-dev%2Fchrome-extension-hardcode-blackout/lists"}