A browser extension that filters unwanted content across every website.
⚠️ Official Preview Release: This is a preview version (v0.1.0-preview) of Calm the Chaos. Features may be incomplete or subject to change.By default, content filtering is only enabled for specific platforms (CNN, LinkedIn, Reddit, StackOverflow and YouTube). You can enable filtering for additional domains through the extension settings.
The extension filters content based on the following categories defined in keywords/keyword-groups.json:
| Category | Description |
|---|---|
| Climate and Environment | Topics related to climate change, environmental issues, and natural disasters |
| Economic Policy | Terms related to economic policies, financial markets, labor issues, and economic inequality |
| Education | Topics related to educational policies, curriculum controversies, and academic freedom |
| Gun Policy | Keywords related to gun control, rights, and legislation |
| Healthcare and Public Health | Topics related to healthcare access, costs, reform, and public health policies |
| Immigration | Topics related to immigration policies, border security, and refugee issues |
| International Coverage | Topics related to global conflicts, diplomatic relations, and international affairs |
| LGBTQ+ | Keywords related to LGBTQ+ rights, legislation, and social issues |
| Media Personalities | Names of influential media figures and personalities |
| Military and Defense | Topics related to military operations, defense policy, and weapons systems |
| Political Organizations | Various political groups, movements, and organizations |
| Political Rhetoric | Terms and phrases commonly used in political discourse |
| Political Violence and Security Threats | Topics related to political violence, extremism, and security concerns |
| Race Relations | Topics related to racial equality, discrimination, and social justice |
| Religion | Topics related to religious beliefs, conflicts, and discrimination |
| Reproductive Health | Keywords related to reproductive rights, healthcare, and policy |
| Social Policy | Topics related to social programs, welfare, and public assistance |
| US Government Institutions | Federal agencies and government institutions |
| US Political Figures - Full Name | Notable US political figures referenced by full names |
| US Political Figures - Single Name | Notable political figures referenced by single names |
| Violence Against Women | Keywords related to violence against women |
| Vaccine Policy | Topics related to vaccine mandates, requirements, and public health measures |
| World Leaders | Current and notable international political leaders |
While the default keywords are US-centric, you can easily maintain your own regional keyword list:
-
Create a plain text file with your keywords (one per line), for example:
keyword1 keyword2 keyword3 -
Host this file anywhere on the web (e.g., GitHub Gist, Pastebin)
-
In the extension settings:
- Go to the "Import/Export" tab
- Paste your URL in the "Enter URL to import settings" field
- Click "Import from URL"
-
Enable "Check for new keywords on startup" to automatically update your keywords when you start your browser
- 🔍 Customizable Filtering: Tailor your browsing experience by defining custom keywords and keyword groups.
- 🌐 Platform-Specific Features:
- Reddit: Filter posts based on keywords while keeping subreddits visible. Optionally enable comment thread filtering with granular control over top-level comments vs replies.
- LinkedIn: Smart filtering of posts and articles while preserving professional networking features.
- YouTube: Content filtering across video titles, descriptions, and comments.
- CNN & StackOverflow: Targeted content filtering while maintaining site functionality.
- 🔄 Flexible Matching: Choose between exact and flexible matching to refine content identification.
- 🔒 Domain Control: Enable or disable filtering for specific domains to match your browsing habits.
- 🔗 Updates Section: The keyword list will be updated every few hours with the newest cast of characters and controversies.
- Clone or Download: Get this repository on your local machine.
- Open Chrome Extensions: Navigate to
chrome://extensions/. - Enable Developer Mode: Toggle the switch in the top right corner.
- Load Unpacked: Click and select the directory where this extension is located.
Once installed, the extension works automatically based on your settings. Customize these settings through the options.html page, accessible from the extension's icon in the Chrome toolbar.
In the extension settings under "Elements" tab:
- Reddit Comment Filtering: Toggle "Filter Reddit Comment Threads" to enable/disable comment filtering. When enabled:
- Top-level comments containing filtered keywords are completely hidden
- For reply comments, only the filtered comment is hidden while preserving the thread structure
- Posts are always filtered based on keywords, while subreddits remain visible
To load the extension in Chrome for development:
- Clone or Download the Repository: Get a local copy of the project on your machine.
- Open Chrome Extensions Page: Navigate to
chrome://extensions/in your Chrome browser. - Enable Developer Mode: Toggle the "Developer mode" switch at the top right corner.
- Load Unpacked Extension: Click on the "Load unpacked" button.
- Select the Extension Directory: Browse to the directory where you cloned or downloaded the repository and select it.
- Extension Loaded: The extension should now be loaded into Chrome and ready for testing.
Remember to reload the extension from the extensions page after making changes to see the updates.
- Develop a configurable scale to adjust the sensitivity of the algorithm in identifying containers to hide. This would allow users to fine-tune the content filtering based on their preferences.
Contributions are welcome! If you're a CSS, HTML, or JavaScript expert and can help improve the algorithm for finding containers, I'd love your input. Please feel free to submit a pull request or open an issue with your ideas.
This project is licensed under the MIT License. See the LICENSE file for more details.
While I'm a software architect, I am not really a JavaScript developer. I can hack it, so this extension was built with Claude.ai, Cline, OpenRouter.ai, Anthropic's API and VS Code.
I used OpenRouter when I'd run out of Anthropic tokens FOR THE DAY. The limit is way too low. It cost about $80 in total but that's because I chose the wrong model on OpenRouter (antropic/auto?) that didn't have caching. I was also giving it huge files before the refactor.