Thanks to visit codestin.com
Credit goes to github.com

Skip to content

KabosuNeko/PerfectZen

Repository files navigation

PerfectZen

My personal Zen Browser configuration, focused on privacy, optimal performance for daily usage, and aesthetics.

📋 Overview

This configuration suite includes:

  • Zen Browser with the Transparent Zen interface mod.
  • Betterfox user.js optimized for NextDNS & uBlock Origin.
  • A list of Recommended Extensions.
  • A list of Recommended Search Engines.
  • Custom uBlock Origin configuration optimized for NextDNS.

Preview

Preview PerfectZen

🎨 Interface: Transparent Zen

This mod removes the solid background, creating a blur effect (glassmorphism) for the browser, making the interface seamless and modern.

How to activate:

  1. 🛍️ Access Store: Go to Settings or visit Zen Mods.
  2. 🔍 Search: Type Transparent Zen.
  3. Install & Configure:
    • Click Install.
    • Return to the Zen Mods menu, find the installed Transparent Zen.
    • Enable the options inside according to your preference.
  4. Install the Zen Internet extension (for best support).
  5. 🔄 Restart: Restart Zen Browser to enjoy the result.

🧩 Recommended Extensions

1. Ad & Tracker Blocking

  • uBlock Origin (Required)
    • Blocks ads, malware, and crypto-mining scripts.
    • Please use in conjunction with the backup configuration file provided in this repo.

2. Utilities

  • Bitwarden
    • Open-source password manager, secure and free.
  • SponsorBlock
    • Automatically skips sponsored segments, intros/outros on YouTube.
  • Return YouTube Dislike
    • Restores the Dislike count on YouTube to help evaluate video quality.

🔍 Recommended Search Engines

By default, Google collects a lot of data. Go to Settings > Search and add the following tools as default:

  • Mechanism: Uses data primarily from Bing combined with its own crawler, committed to user privacy.
  • Pros: Fast, excellent !bangs support (e.g., type !arch to search the Arch Wiki), simple interface.
  • Mechanism: Uses its own independent index, not dependent on Big Tech.
  • Pros: Completely independent, fast, clean interface, very good for technical queries. Also supports !bangs like DuckDuckGo.
  • Mechanism: Acts as an intermediary proxy, fetching search results directly from Google.
  • Pros: Absolute accuracy like Google but protects privacy, does not log IP addresses or personal search history.

🔐 DNS Configuration

This configuration is optimized to work with DNS at the system level. DoH (DNS-over-HTTPS) in the browser has been disabled to avoid conflicts and maximize system-level DNS performance.

Recommended: NextDNS

  1. Register for NextDNS: https://my.nextdns.io

    • Create a configuration and save the Configuration ID (format abc123).
    • Add custom filters according to your needs; I am currently using HaGeZi - Multi PRO + hostsVN (my region list).
  2. Install NextDNS:

  3. Verify:

    # Test DNS
    nextdns status
    
    # Check on web
    # Open browser: https://test.nextdns.io

🛠️ Setup & Manager (Install / Restore)

This script helps you install the configuration and manage backups automatically.

Linux (just paste in your terminal)

bash -c "$(curl -sL https://raw.githubusercontent.com/KabosuNeko/PerfectZen/main/neko-betterfox-linux.sh)"

Window (just paste in your powershell (Admin))

irm https://raw.githubusercontent.com/KabosuNeko/PerfectZen/main/neko-betterfox-window.ps1 | iex

🛡️ uBlock Origin Configuration

Installation:

  1. Open the uBlock Origin Dashboard (gear icon).
  2. Switch to the Settings tab.
  3. Scroll down to the Backup/Restore section.
  4. Select Restore from file.
  5. Select the ublock-backup.txt file from this repo.

🛠️ Troubleshooting

Website broken:

  1. Disable uBlock for the site:

    • Click uBlock icon → Power button (disable for site).
  2. Check NextDNS logs:

    • Access: https://my.nextdns.io/[your-id]/logs
    • Find blocked domains → Add to Allowlist.
  3. Temporarily stop NextDNS:

    sudo systemctl stop nextdns
    # Test site
    sudo systemctl start nextdns

Reset to default:

cd ~/.zen/*.default-release
mv user.js user.js.backup
# Restart Zen Browser

📚 Further Reading


🙏 Credits


Note: This is a configuration for personal needs. Please read and adjust the configuration files to suit your requirements before applying.

About

My personal Zen Browser configuration

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published