SlimBrave Neo

Debloat and harden Brave Browser on Linux, macOS, and Windows.

SlimBrave Neo uses Chromium enterprise managed policies to disable telemetry, bloat, and unwanted features from Brave Browser. No browser extensions, no hacks, just clean policy enforcement that Brave respects natively.

Important

The only official source of SlimBrave Neo is this repository: github.com/ChaoticSi1ence/SlimBrave-Neo

This project ships source code only — Python and PowerShell scripts you can read before running. There are no official .exe, .msi, .dmg, .pkg, installers, or compiled binaries. If you find a download claiming to be SlimBrave-Neo elsewhere, it is not from this project. See SECURITY.md.

---

Interactive curses TUI. Zero dependencies, runs in any terminal.

---

Quick Start - Linux

git clone https://github.com/ChaoticSi1ence/SlimBrave-Neo.git
cd SlimBrave-Neo
sudo python3 slimbrave-linux.py

That's it. No pip install, no jq, no external dependencies. Just Python 3 and root.

CLI Mode (non-interactive)

sudo python3 slimbrave-linux.py --import "./Presets/Maximum Privacy Preset.json"
sudo python3 slimbrave-linux.py --export ~/SlimBraveNeoSettings.json
sudo python3 slimbrave-linux.py --reset

After applying, restart Brave and verify at brave://policy.

---

Quick Start - macOS

git clone https://github.com/ChaoticSi1ence/SlimBrave-Neo.git
cd SlimBrave-Neo
sudo python3 slimbrave-mac.py

Policies are written to /Library/Managed Preferences/com.brave.Browser.plist. Requires root.

CLI Mode (non-interactive)

sudo python3 slimbrave-mac.py --import "./Presets/Maximum Privacy Preset.json"
sudo python3 slimbrave-mac.py --export ~/SlimBraveNeoSettings.json
sudo python3 slimbrave-mac.py --reset

After applying, restart Brave and verify at brave://policy.

---

Quick Start - Windows

iwr "https://raw.githubusercontent.com/ChaoticSi1ence/SlimBrave-Neo/main/SlimBrave.ps1" -OutFile "SlimBrave.ps1"; .\SlimBrave.ps1

Requires Administrator privileges.

---

Features

Telemetry & Reporting

• Disable Metrics Reporting
• Disable Safe Browsing Reporting
• Disable URL Data Collection
• Disable P3A Analytics
• Disable Stats Ping

Privacy & Security

• Disable Safe Browsing
• Disable Autofill (Addresses & Credit Cards)
• Disable Password Manager
• Disable Browser Sign-in
• Enable Do Not Track
• Enable Global Privacy Control
• Enable De-AMP (strip Google AMP wrappers)
• Enable Debouncing (skip known tracking redirect hops)
• Strip Tracking URL Parameters
• Reduce Language Fingerprinting
• Disable WebRTC IP Leak
• Disable QUIC Protocol
• Block Third Party Cookies
• Force Google SafeSearch
• Disable / Force Incognito Mode (mutually exclusive)

Brave Features

• Disable Brave Rewards
• Disable Brave Wallet
• Disable Brave VPN
• Disable Brave AI Chat
• Disable Brave Shields
• Disable Brave News
• Disable Brave Talk
• Disable Brave Playlist
• Disable Web Discovery
• Disable Speedreader
• Disable Tor
• Disable Sync
• Disable IPFS

Performance & Bloat

• Disable Background Mode
• Disable Shopping List
• Always Open PDF Externally
• Disable Translate
• Disable Spellcheck
• Disable Search Suggestions
• Disable Printing
• Disable Default Browser Prompt
• Disable Developer Tools
• Disable Wayback Machine

DNS Over HTTPS

• Four modes: automatic, off, secure, custom
• Custom DoH template URL support (e.g. https://cloudflare-dns.com/dns-query)
• Inline editable template field in the TUI

---

CLI Reference

Flag	Description
--import PATH	Import a SlimBrave Neo JSON config and apply policies
--export PATH	Export current policy to a SlimBrave Neo JSON config
--reset	Remove the managed policy file
--policy-file PATH	Override policy file path
--doh-templates URL	Set custom DNS-over-HTTPS template URL
-h, --help	Show help

Import/export uses the same JSON format as the Windows PowerShell version. Configs are cross-platform compatible.

---

Presets

Maximum Privacy Preset

• Telemetry: Blocks all reporting (metrics, safe browsing, URL collection, feedback).
• Privacy: Disables autofill, password manager, sign-in, WebRTC leaks, QUIC, and forces Do Not Track.
• Brave Features: Kills Rewards, Wallet, VPN, AI Chat, Tor, and Sync.
• Performance: Disables background processes, recommendations, and bloat.
• DNS: Uses plain DNS (no HTTPS) to prevent potential logging by DoH providers.
• Best for: Paranoid users, journalists, activists, or anyone who wants Brave as private as possible.

Balanced Privacy Preset

• Telemetry: Blocks all tracking but keeps basic safe browsing.
• Privacy: Blocks third-party cookies, enables Do Not Track, but allows password manager and autofill for addresses.
• Brave Features: Disables Rewards, Wallet, VPN, and AI features.
• Performance: Turns off background services and ads.
• DNS: Uses automatic DoH (lets Brave choose the fastest secure DNS).
• Best for: Most users who want privacy but still need convenience features.

Performance Focused Preset

• Telemetry: Only blocks metrics and feedback surveys (keeps some safe browsing).
• Brave Features: Disables Rewards, Wallet, VPN, and AI to declutter the browser.
• Performance: Kills background processes, shopping features, and promotions.
• DNS: Automatic DoH for a balance of speed and security.
• Best for: Users who want a faster, cleaner Brave without extreme privacy tweaks.

Developer Preset

• Telemetry: Blocks all reporting.
• Brave Features: Disables Rewards, Wallet, and VPN but keeps developer tools.
• Performance: Turns off background services and ads.
• DNS: Automatic DoH (default secure DNS).
• Best for: Developers who need dev tools but still want telemetry and ads disabled.

Strict Parental Controls Preset

• Privacy: Blocks incognito mode, forces Google SafeSearch, and disables sign-in.
• Brave Features: Disables Rewards, Wallet, VPN, Tor, and dev tools.
• DNS: Uses custom DoH (can be set to a family-friendly DNS like Cloudflare for Families).
• Best for: Parents, schools, or workplaces that need restricted browsing.

---

How It Works

SlimBrave Neo writes Chromium managed enterprise policies to platform-specific locations. Brave reads these on startup and enforces the policies. No browser modifications needed.

• Linux: /etc/brave/policies/managed/slimbrave.json

• macOS: /Library/Managed Preferences/com.brave.Browser.plist

• Windows: Registry keys via PowerShell

• Auto-detects Brave installations: Arch (brave-bin), deb/rpm, Flatpak, Snap, macOS App, and PATH fallback

• Reads existing policies on startup and pre-checks matching features

• Full overwrite on Apply, so unchecked features are cleanly removed

• Import/export compatible with Windows PowerShell version (handles UTF-16 BOM encoding)

---

Requirements

Linux:

• Python 3 (no external dependencies)
• Root privileges (sudo)
• Brave Browser installed (any packaging method)

macOS:

• Python 3 (no external dependencies)
• Root privileges (sudo)
• Brave Browser installed

Windows:

• Windows 10/11
• PowerShell
• Administrator privileges

Windows: "Running Scripts is Disabled on this System"

Run this command in PowerShell:

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned

---

Roadmap

• Add preset configurations (Privacy, Performance, etc.)
• Import/export settings (cross-platform compatible)
• Add Linux support with full interactive TUI
• DNS-over-HTTPS with custom template URLs
• CLI mode for scripting and automation
• macOS support via managed plist policies

---

Contributors

• @alsyundawy - macOS version

---

Like this project? Give it a star!

Made with Python and PowerShell.