https://github.com/ricardorodrigues-ca/bebrave
Take control of your Brave Browser on macOS - disable unwanted features, enhance privacy, and remove bloat with an easy-to-use configuration tool.
https://github.com/ricardorodrigues-ca/bebrave
bebrave brave brave-browser debloat debloat-script debloater macos privacy script telemetry
Last synced: 2 months ago
JSON representation
Take control of your Brave Browser on macOS - disable unwanted features, enhance privacy, and remove bloat with an easy-to-use configuration tool.
- Host: GitHub
- URL: https://github.com/ricardorodrigues-ca/bebrave
- Owner: ricardorodrigues-ca
- License: mit
- Created: 2025-09-20T04:42:24.000Z (10 months ago)
- Default Branch: main
- Last Pushed: 2025-09-20T05:23:12.000Z (10 months ago)
- Last Synced: 2025-09-28T02:52:32.856Z (10 months ago)
- Topics: bebrave, brave, brave-browser, debloat, debloat-script, debloater, macos, privacy, script, telemetry
- Language: Python
- Homepage:
- Size: 1.18 MB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# BeBrave for macOS
BeBrave is a powerful Python script designed for macOS users to streamline their Brave Browser experience by toggling and configuring unwanted features. With BeBrave, you can easily disable or enable various Brave functionalities, customize settings, and improve privacy.
## Features
### Privacy & Security Controls
- **Telemetry & Reporting**: Disable metrics reporting, safe browsing data collection, URL data collection, and feedback surveys
- **Privacy Settings**: Configure autofill, password manager, browser sign-in, WebRTC IP leak protection
- **Security Options**: Block third-party cookies, enable Do Not Track, force Google SafeSearch
- **Network Protection**: Disable QUIC protocol, configure DNS over HTTPS
### Brave-Specific Features
- **Brave Rewards**: Toggle rewards system
- **Brave Wallet**: Enable/disable cryptocurrency wallet
- **Brave VPN**: Control VPN functionality
- **Brave AI Chat**: Toggle AI chat features
- **Brave Shields**: Configure ad/tracker blocking
- **Tor Integration**: Enable/disable Tor functionality
- **Sync Services**: Control data synchronization
### Performance & Bloat Removal
- **Background Processes**: Disable background mode and unnecessary services
- **Media & Shopping**: Turn off recommendations and shopping lists
- **Browser Features**: Disable translate, spellcheck, promotions, search suggestions
- **Developer Tools**: Optionally disable developer tools access
### Configuration Management
- **Bulk Operations**: Select all/none options for quick configuration
- **Export/Import**: Save and restore configuration sets as JSON files
- **DNS Configuration**: Configure DNS over HTTPS modes (automatic, off, custom)
## Requirements
- macOS
- Python 3.x (with tkinter support)
## Installation
1. Clone or download this repository
2. No additional dependencies required - uses only Python standard library
## Usage
### Running the Application
```bash
python3 bebrave_macos.py
```
### Using the GUI
1. **Status Banner**: The top banner shows the application is ready to configure Brave Browser preferences
2. **Current Settings**: The app automatically reads your existing Brave preferences and shows checkmarks for currently enabled features
3. **Select Features**: Choose from organized categories:
- Telemetry & Reporting
- Privacy & Security
- Brave Features
- Performance & Bloat
4. **Bulk Selection**: Use "Select All" checkbox for quick configuration
5. **DNS Configuration**: Choose DNS over HTTPS mode from dropdown (current setting is automatically loaded)
6. **Apply Changes**: Click "Apply Settings" to write configuration to Brave
7. **Export/Import**: Save your configuration or load previously saved settings
### Configuration Storage
Settings are stored in `~/Library/Preferences/com.brave.Browser.plist` using macOS defaults system.
## Important Notes
- **Restart Required**: Restart Brave Browser after applying changes
- **Backup Recommended**: Consider exporting current settings before major changes
- **Reset Option**: "Reset All" button removes all custom policies and restores defaults
## Safety
- All changes use official Brave/Chromium policy keys
- Settings can be easily reverted using the "Reset All" function
- Export/import functionality allows for configuration backup and restoration
- No modification of Brave application files - only policy preferences
## Troubleshooting
- **Changes Not Applied**: Restart Brave Browser completely
- **Restore Defaults**: Use "Reset All" button or manually delete the plist file
## Copyright Notice
**Brave**, **Brave Browser**, and the **Brave lion head logo** are trademarks and copyrights of Brave Software, Inc. This project is an independent, unofficial tool and is not affiliated with, endorsed by, or sponsored by Brave Software, Inc.
This tool interacts with Brave Browser through official policy mechanisms and does not modify the browser application itself.
## License
This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.