Home - nightcodex7/BravePurifier GitHub Wiki
Welcome to the BravePurifier Wiki
Ultra-lightweight privacy-focused Brave Browser installer and debloater
🚀 Quick Navigation
- Installation Guide - Complete installation instructions
- Privacy Features - Detailed privacy enhancements
- Supported Systems - Compatible Linux distributions
- Configuration - Advanced configuration options
- Troubleshooting - Common issues and solutions
- FAQ - Frequently asked questions
- Contributing - How to contribute to the project
- Changelog - Version history and updates
🚀 Cross-Platform Support
- Linux: Full support for all major distributions.
- Windows: Support coming soon! Windows compatibility is a work in progress and will be available in a future release.
📖 About BravePurifier
BravePurifier is a comprehensive script that not only installs Brave Browser but also applies maximum privacy hardening with zero bloat. It's designed for privacy-conscious users who want maximum protection with minimal effort.
Key Benefits
- 🔒 Maximum Privacy: Disables all telemetry and tracking
- 🛡️ Enhanced Security: Applies hardened security policies
- 🚫 Zero Bloat: Removes unnecessary features and components
- 🌐 Universal: Supports all major Linux distributions
- ⚡ Lightweight: Minimal dependencies and fast execution
🎯 Quick Start
curl -fsSL https://raw.githubusercontent.com/nightcodex7/BravePurifier/main/brave-purifier.sh | sudo bash
📚 Documentation Structure
This wiki is organized into several sections:
Installation & Setup
- Installation Guide - Step-by-step installation
- System Requirements - Prerequisites and compatibility
- Post-Installation - What to do after installation
Features & Configuration
- Privacy Features - Complete privacy enhancement list
- Security Features - Security hardening details
- Configuration - Advanced configuration options
- Customization - How to customize settings
Support & Development
- Troubleshooting - Common issues and solutions
- FAQ - Frequently asked questions
- Contributing - Development guidelines
- API Reference - Script functions and variables
🔗 External Links
- Main Repository: https://github.com/nightcodex7/BravePurifier
- Issues: GitHub Issues
- Releases: GitHub Releases
Debloating Features
Brave Purifier now lets you choose privacy/debloat options in simple groups:
- Brave Features & Services: Rewards, Wallet, VPN, News, Talk, Sync, pings, analytics, crypto, web3, etc.
- Privacy & Tracking: Telemetry, Safe Browsing, Metrics, Log Upload, Heartbeat
- Autofill & Passwords: Autofill, Password Manager
- Permissions: Camera, Microphone, Location, Notifications, Sensors, Popups, WebUSB, WebBluetooth, Serial, HID, FileSystem, etc.
- Other UI & Suggestions: Spellcheck, Home Button, Import Passwords, Import Search Engine
Prompted separately:
- Search Suggestions
- Web Store
- Background Mode
Reset to Defaults:
- At the start, you can choose to reset all Brave settings to defaults (does NOT delete bookmarks, passwords, cookies, credentials, autofill, or sync data).
Search Engine:
- At the end, you can choose to set Google as the default search engine, or keep it unchanged.
Example prompt:
Do you want to reset all Brave settings to defaults before applying debloat? (This will NOT delete bookmarks, passwords, cookies, credentials, autofill, or sync data. Only settings will be reset.) [y/N]: n
Would you like to apply ALL recommended debloat options? [Y/n]: n
You will be prompted for each group. Enter 'y' to debloat, 'n' to keep as is.
Brave Features & Services (Rewards, Wallet, VPN, News, Talk, Sync, pings, analytics, crypto, web3, etc.)
Disables all Brave-specific services, crypto, rewards, wallet, and telemetry.
Debloat this group? [Y/n]: y
Privacy & Tracking (Telemetry, Safe Browsing, Metrics, Log Upload, Heartbeat)
Disables all tracking, telemetry, and privacy-invasive features.
Debloat this group? [Y/n]: y
Autofill & Passwords (Autofill, Password Manager)
Disables autofill and password manager features.
Debloat this group? [Y/n]: n
Permissions (Camera, Microphone, Location, Notifications, Sensors, Popups, WebUSB, WebBluetooth, Serial, HID, FileSystem, etc.)
Blocks access to sensitive device features and permissions.
Debloat this group? [Y/n]: y
Other UI & Suggestions (Spellcheck, Home Button, Import Passwords, Import Search Engine)
Disables UI suggestions and import features.
Debloat this group? [Y/n]: n
Search Suggestions (address bar autocomplete, etc.)
Disables search suggestions in the address bar.
Debloat this option? [Y/n]: y
Web Store (extension/add-on store visibility)
Hides the web store icon and blocks extension installs.
Debloat this option? [Y/n]: y
Background Mode (Brave running in background)
Prevents Brave from running in the background.
Debloat this option? [Y/n]: y
Do you want to set Google as the default search engine? (Otherwise, it will remain unchanged) [y/N]: n
All relevant settings for each group or option will be applied automatically.
Created by nightcodex7