> **Language / Dil**  
> [EN English](#-english)  ·  [TR Türkçe](#-türkçe)

<a id="-english"></a>

# 🚀 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 25H2 build recommended) |
| **Browser** | **Brave Browser — latest stable** ([brave.com/download](https://brave.com/download)) |
| **PowerShell** | 5.1+ (included with Windows 11) |
| **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](https://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
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
PowerShell -ExecutionPolicy Bypass -File ".\BraveOmega.ps1" -WhatIf
```

Shows what would change without writing to the registry.

### Clean Uninstall (-Reset)

```powershell
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:

```powershell
# 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).

---

## 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

```powershell
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](Installation.md#2-navigate-to-project-folder). Running a
> lone copy of the `.ps1` fails before applying anything.

### 3. Run the Script

```powershell
# 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:

```powershell
# 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](Version-Compatibility-Matrix.md) |

---

## Next Steps

- [📖 Full Installation Guide](Installation.md)
- [🏗️ Architecture Overview](Architecture.md)
- [📋 Policy Reference](Policy-Reference.md)
- [🛡️ Security Model](Security.md)

---

---

<a id="-türkçe"></a>

# 🚀 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ı 25H2 derlemesi) |
| **Tarayıcı** | **Brave Browser — en güncel kararlı** ([brave.com/download](https://brave.com/download)) |
| **PowerShell** | 5.1+ (Windows 11 ile birlikte gelir) |
| **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](https://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
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
PowerShell -ExecutionPolicy Bypass -File ".\BraveOmega.ps1" -WhatIf
```

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

### Temiz Kaldırma (-Reset)

```powershell
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:

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

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

---

## 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

```powershell
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](Installation.md#2-proje-klasörüne-git). Betiğin yalnız başına
> kopyalanmış hâli hiçbir şey uygulamadan hata verip durur.

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

```powershell
# 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:

```powershell
# 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](Version-Compatibility-Matrix.md#-türkçe) ile eşleştiğini doğrula |

---

## Sonraki Adımlar

- [📖 Tam Kurulum Kılavuzu](Installation.md#-türkçe)
- [🏗️ Mimari Genel Bakış](Architecture.md#-türkçe)
- [📋 Politika Başvurusu](Policy-Reference.md#-türkçe)
- [🛡️ Güvenlik Modeli](Security.md#-türkçe)