Quick Start - bayraktarozcan/Brave-Omega-Project GitHub Wiki

Language / Dil   EN English  ·  TR Türkçe

🚀 Quick Start — Brave Omega

Get Brave Omega running in 3 minutes with a single copy-paste command.

Prerequisites

Requirement Detail
OS Windows 11 (latest stable 26H2 build recommended)
Browser Brave Browser — latest stable (brave.com/download)
PowerShell 5.1+ (included with Windows 11; PowerShell 7.6.6 recommended)
Privileges Administrator (required for HKLM registry writes)
Execution Policy Handled automatically via -ExecutionPolicy Bypass flag

⚠️ Always use the latest stable Brave release before running. Verify at brave.com/latest.

One-Line Execution

The unified script asks for your language on first launch (Press 1 for English / Türkçe için 2'ye basın), or pin it up front:

PowerShell -ExecutionPolicy Bypass -File ".\BraveOmega.ps1" -Language TR

PowerShell -ExecutionPolicy Bypass -File ".\BraveOmega.ps1" -Language EN

The -ExecutionPolicy Bypass flag applies only to this single command — no permanent execution policy change, no attack surface exposure. Close the window and everything resets.

Preview Mode (-WhatIf)

PowerShell -ExecutionPolicy Bypass -File ".\BraveOmega.ps1" -WhatIf

Shows what would change without writing to the registry.

Clean Uninstall (-Reset)

PowerShell -ExecutionPolicy Bypass -File ".\BraveOmega.ps1" -Reset

Removes all Brave Omega policies from HKLM, HKCU, and Omaha GUIDs.

[!NOTE] The reset backs up both hives first (%TEMP%\BravePolicyBackup) and aborts without removing anything if that backup fails. A reset you cannot undo is not a reset.

Selecting a Hardening Level

When you run the script without parameters, it shows an interactive menu:

1. Brave Only
2. Essential [Recommended]
3. Balanced
4. Advanced
5. Strict
Your selection (2):

To skip the menu in automated deployments:

# Essential level (recommended) — add -Language EN/TR to skip the language question:
PowerShell -ExecutionPolicy Bypass -File ".\BraveOmega.ps1" -Level Essential

Available levels: BraveOnly, Essential, Balanced, Advanced, Strict (EN) or BraveYalniz, Temel, Dengeli, Gelismis, Kati (TR).

Selecting a Browser

Before the level menu, the script asks for the target browser (Brave default):

1. Brave
2. Chrome
Enter choice (1-2):

Skip it with -Browser Brave|Chrome (alias -Tarayici). Chrome runs target HKLM\SOFTWARE\Policies\Google\Chrome and skip Brave-only policies; verify at chrome://policy instead of brave://policy.

Step-by-Step (Expanded)

1. Open PowerShell as Administrator

  • Press Win → type PowerShell
  • Right-click Windows PowerShell → Run as Administrator

2. Navigate to Project Folder

cd "C:\Users\Downloads\Brave-Omega"

Adjust path if you extracted elsewhere.

[!IMPORTANT] Keep config.json and the Profiles/ folder next to BraveOmega.ps1. The 151 policies live in those files, not in the script — see Installation §2. Running a lone copy of the .ps1 fails before applying anything.

3. Run the Script

# Unified script asks for language first (or pin with -Language EN/TR):
PowerShell -ExecutionPolicy Bypass -File ".\BraveOmega.ps1"

4. Restart Brave

  • Close all Brave windows completely
  • Reopen Brave

5. Verify

Navigate to brave://policy in Brave — all policies (51 for Essential level) should show as Active.

What the Script Does

Phase Action
1. Pre-flight Detects running Brave, prompts continue/cancel
2. Backup Creates timestamped .reg backup of HKLM policy hive
3. Apply Writes policies across 3 tiers based on selected level (24/51/83/123/151)
4. Summary Per-category success/failure counters + rollback info
5. Cleanup Exits cleanly — no residual processes

Rollback (If Needed)

Backups are written to %TEMP%\BravePolicyBackup before the script touches the registry. Import the one you need:

# Machine-wide policies
reg import "$env:TEMP\BravePolicyBackup\HKLM_BravePolicy_YYYYMMDD_HHMMSS.reg"

# Per-user policies and Omaha GUID
reg import "$env:TEMP\BravePolicyBackup\HKCU_BraveSoftware_YYYYMMDD_HHMMSS.reg"

Each file carries a timestamp (e.g. HKLM_BravePolicy_20260613_120000.reg).

Common Issues

Issue Resolution
"CRITICAL ERROR" on launch Right-click PowerShell → Run as Administrator
No policies in brave://policy Close all Brave windows and reopen
[ERROR] in output Confirm Administrator mode; re-run
"Unknown" policy in brave://policy Verify Brave version matches Compatibility Matrix

Next Steps

🚀 Hızlı Başlangıç — Brave Omega

Brave Omega'yı 3 dakikada çalıştırın, tek bir kopyala-yapıştır komutuyla.

Ön Gereksinimler

Gereksinim Ayrıntı
İşletim Sistemi Windows 11 (önerilen: en güncel kararlı 26H2 derlemesi)
Tarayıcı Brave Browser — en güncel kararlı (brave.com/download)
PowerShell 5.1+ (Windows 11 ile birlikte gelir; PowerShell 7.6.6 önerilir)
Ayrıcalık Yönetici (HKLM kayıt defteri yazmaları için gerekli)
Çalıştırma İlkesi -ExecutionPolicy Bypass bayrağı ile otomatik olarak yönetilir

⚠️ Çalıştırmadan önce her zaman en güncel kararlı Brave sürümünü kullanın. brave.com/latest adresinden doğrulayın.

Tek Satırda Çalıştırma

Birleşik betik ilk açılışta dilinizi sorar (Press 1 for English / Türkçe için 2'ye basın) veya önden sabitleyin:

PowerShell -ExecutionPolicy Bypass -File ".\BraveOmega.ps1" -Language TR

PowerShell -ExecutionPolicy Bypass -File ".\BraveOmega.ps1" -Language EN

-ExecutionPolicy Bypass bayrağı yalnızca bu tek komut için geçerlidir — kalıcı çalıştırma ilkesi değişikliği yok, saldırı yüzeyi maruziyeti yok. Pencereyi kapatın, her şey sıfırlanır.

Ön İzleme Kipi (-WhatIf)

PowerShell -ExecutionPolicy Bypass -File ".\BraveOmega.ps1" -WhatIf

Kayıt defterine yazmadan nelerin değişeceğini gösterir.

Temiz Kaldırma (-Reset)

PowerShell -ExecutionPolicy Bypass -File ".\BraveOmega.ps1" -Reset

Tüm Brave Omega politikalarını HKLM, HKCU ve Omaha GUID'lerinden kaldırır.

[!NOTE] Sıfırlama önce her iki kovanın da yedeğini alır (%TEMP%\BravePolicyBackup); yedekleme başarısız olursa hiçbir şeyi kaldırmadan vazgeçer. Geri alınamayan bir sıfırlama, sıfırlama değildir.

Sıkılaştırma Seviyesi Seçme

Betik parametresiz çalıştırıldığında etkileşimli bir menü gösterir:

1. Brave Yalnız
2. Temel [Önerilen]
3. Dengeli
4. Gelişmiş
5. Katı
Seçiminiz (2):

Otomatik dağıtımlarda menüyü atlamak için:

# Temel seviye (önerilen)
PowerShell -ExecutionPolicy Bypass -File ".\BraveOmega.ps1" -Level Temel

Kullanılabilir seviyeler: BraveOnly/BraveYalniz, Essential/Temel, Balanced/Dengeli, Advanced/Gelismis, Strict/Kati.

Tarayıcı Seçme

Seviye menüsünden önce betik hedef tarayıcıyı sorar (varsayılan Brave):

1. Brave
2. Chrome
Seçiminiz (1-2):

-Browser Brave|Chrome (-Tarayici takma adlı) ile atlayın. Chrome koşuları HKLM\SOFTWARE\Policies\Google\Chrome yolunu hedefler ve Brave'e özgü politikaları atlar; doğrulamayı brave://policy yerine chrome://policy adresinden yapın.

Adım Adım (Genişletilmiş)

1. PowerShell'i Yönetici Olarak Aç

  • Win tuşuna bas → PowerShell yaz
  • Windows PowerShell'e sağ tıkla → Yönetici olarak çalıştır

2. Proje Klasörüne Git

cd "C:\Users\Downloads\Brave-Omega"

Farklı bir yere çıkardıysanız yolu buna göre ayarlayın.

[!IMPORTANT] config.json dosyasını ve Profiles/ klasörünü BraveOmega.ps1'in yanında tutun. 151 politika bu dosyalarda durur, betiğin içinde değil — bkz. Kurulum §2. Betiğin yalnız başına kopyalanmış hâli hiçbir şey uygulamadan hata verip durur.

3. Betiği Çalıştır

# Türkçe
PowerShell -ExecutionPolicy Bypass -File ".\BraveOmega.ps1"

4. Brave'i Yeniden Başlat

  • Tüm Brave pencerelerini tamamen kapat
  • Brave'i yeniden aç

5. Doğrula

Brave'de brave://policy adresine git — tüm politikalar (Temel seviyede 51) Etkin olarak görünmelidir.

Betik Ne Yapar?

Aşama Eylem
1. Ön Kontrol Çalışan Brave'i tespit eder, devam/iptal istemi gösterir
2. Yedekleme HKLM politika kovasının zaman damgalı .reg yedeğini oluşturur
3. Uygulama Seçilen seviyeye göre 3 katmanda politikaları yazar (24/51/83/123/151)
4. Özet Kategori bazında başarı/hata sayaçları + geri alma bilgisi
5. Temizlik Artık süreç bırakmadan temiz çıkış

Geri Alma (Gerekirse)

Yedekler, betik kayıt defterine dokunmadan önce %TEMP%\BravePolicyBackup klasörüne yazılır. İhtiyacınız olanı içe aktarın:

# Makine geneli politikalar
reg import "$env:TEMP\BravePolicyBackup\HKLM_BravePolicy_YYYYMMDD_HHMMSS.reg"

# Kullanıcı başına politikalar ve Omaha GUID
reg import "$env:TEMP\BravePolicyBackup\HKCU_BraveSoftware_YYYYMMDD_HHMMSS.reg"

Her dosya zaman damgası taşır (ör. HKLM_BravePolicy_20260613_120000.reg).

Sık Karşılaşılan Sorunlar

Sorun Çözüm
Başlatmada "KRİTİK HATA" PowerShell'e sağ tıkla → Yönetici olarak çalıştır
brave://policy'de politika yok Tüm Brave pencerelerini kapat ve yeniden aç
Çıktıda [HATA] satırları Yönetici modunu doğrula; yeniden çalıştır
brave://policy'de "Bilinmiyor" politikası Brave sürümünün Uyumluluk Matrisi ile eşleştiğini doğrula

Sonraki Adımlar