Skip to content

yashgorana/chrome-debloat

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

9 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Chrome Debloat

A tool to generate policies for Chromium-based browsers (Chrome, Brave, and Edge) that disable unnecessary features, telemetry, and bloatware while enabling some quality-of-life improvements.

Features

  • Attempts to disable telemetry and usage reporting
  • Removes unnecessary features and pre-installed bloatware
  • Blocks promotional content and unnecessary UI elements
  • Maintains browser functionality while reducing resource usage
  • Pre-configures essential extensions:
    • uBlock Origin
    • Cookie AutoDelete
    • Don't f*** with paste
    • I still don't care about cookies
    • SponsorBlock
    • BlockTube
    • BlankTab
    • Decentraleyes

Supported Browsers

Browser Windows macOS Linux
Google Chrome
Microsoft Edge
Brave

Quick Start

Windows

  1. Download the .reg file for your browser from generated/windows/.
  2. Open the downloaded .reg file to add the settings to the Windows Registry.
  3. Restart your browser or go to chrome://policy (or edge://policy, brave://policy) and click "Reload policies".

macOS

  1. Download the .mobileconfig file for your browser from generated/macos/.
  2. Open the downloaded .mobileconfig file to start the profile installation.
  3. Go to System Settings > Privacy & Security > Profiles and approve the new profile.
  4. Restart your browser or go to chrome://policy (or edge://policy, brave://policy) and click "Reload policies".

Linux

  1. Download the .json file for your browser from generated/linux/.
  2. Move the downloaded file to the correct policy directory (create it if needed):
    • Chrome: /etc/opt/chrome/policies/managed/chrome.json
    • Edge: /etc/opt/edge/policies/managed/edge.json
    • Brave: /etc/brave/policies/managed/brave.json
    • Note: You might need sudo rights to do this.
  3. Restart your browser or go to chrome://policy (or edge://policy, brave://policy) and click "Reload policies".

Custom Configuration

If you want to customize the policies:

  1. Clone this repository
  2. Install dependencies:
    uv sync
  3. Modify policies.yaml according to your needs
  4. Generate new configuration files:
    uv run main.py
  5. Find the generated files in generated/ directory

Uninstalling Policies

Windows:

  1. Navigate to the uninstall/windows/ directory in this repository.
  2. Run the .reg file corresponding to your browser (e.g., uninstall_chrome.reg). This will remove the registry keys added during installation.
  3. Restart your browser or go to chrome://policy (or edge://policy, brave://policy) and click "Reload policies".

macOS:

  1. Go to System Settings > Privacy & Security > Profiles.
  2. Select the profile associated with your browser (e.g., "Chrome Debloat Policies").
  3. Click the '-' (minus) button to remove the profile.
  4. Restart your browser or go to chrome://policy (or edge://policy, brave://policy) and click "Reload policies".

Linux:

  1. Remove the policy JSON file from the browser-specific directory (you might need sudo rights):
    • Chrome: sudo rm /etc/opt/chrome/policies/managed/chrome.json
    • Edge: sudo rm /etc/opt/edge/policies/managed/edge.json
    • Brave: sudo rm /etc/brave/policies/managed/brave.json
  2. Restart your browser or go to chrome://policy (or edge://policy, brave://policy) and click "Reload policies".

Policy Documentation

License

Apache 2.0

About

Debloat your Chrome, Brave, Edge, Chromium browsing experience

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages