diff --git a/README.md b/README.md
@@ -1,5 +1,153 @@
# UAF — Ultimate AP Finder
+A Linux-based wireless AP detection and analysis tool for PCI-DSS security auditing.
+
+> [한국어 버전은 아래에 있습니다 (Korean version below)](#uaf--ultimate-ap-finder-1)
+
+## Why UAF?
+
+In enterprise environments, PCI-DSS (Payment Card Industry Data Security Standard) compliance requires **wireless AP vulnerability assessments**. You need to identify authorized vs. rogue APs, and detect open networks or APs using weak encryption.
+
+Existing tools either stop at basic scanning, lack active reconnaissance capabilities, or don't provide output formats ready for enterprise audit reports.
+
+**UAF** was built to solve this:
+
+- Real-time collection of all nearby APs with automatic security classification (encryption/authentication/WPS)
+- Visual highlighting of open (OPN) APs for immediate identification
+- Active connection to suspicious APs to map network structure (DHCP, gateway, clients)
+- Export results to CSV/JSON for direct use in audit reports
+
+---
+
+## Features
+
+### Passive Scanning
+- Real-time AP detection across 2.4GHz / 5GHz / 6GHz bands
+- Security classification: WEP, WPA, WPA2, WPA3, OPN
+- 802.11 a/b/g/n/ac/ax standard detection
+- Channel width detection (20/40/80/160 MHz)
+- Hidden SSID detection and recovery
+- MAC vendor lookup
+- Band/sort filtering
+
+### Active Scanning
+- Interactive UI with arrow key AP selection
+- Active reconnaissance after connecting to open (OPN) APs
+- DHCP information gathering, ARP scan for connected client detection
+- Gateway port scan (22, 53, 80, 443, 8080, 8443)
+- Instant results via overlay panel
+
+### Export
+- CSV / JSON export (including active scan results)
+- Configuration file support
+
+---
+
+## Requirements
+
+- Python 3.10+
+- Linux (`iw`, `ip` commands)
+- Root privileges
+- WiFi adapter with monitor mode support
+
+## Installation
+
+### From PyPI
+
+```bash
+pip install uaf
+```
+
+### From source
+
+```bash
+git clone https://github.com/devastator-x/uaf.git
+cd uaf
+pip install -e .
+```
+
+## Usage
+
+```bash
+# Basic scan (auto-detect interface)
+sudo uaf
+
+# Specify interface
+sudo uaf -i wlan0
+
+# Scan specific channels only
+sudo uaf -c 1,6,11
+
+# Band filter
+sudo uaf -b 2.4
+
+# Change sort order
+sudo uaf --sort channel
+
+# Save to CSV
+sudo uaf -w output.csv
+
+# Use config file
+sudo uaf --config /path/to/config.ini
+```
+
+## Keybindings
+
+### Normal Mode
+| Key | Action |
+|-----|--------|
+| `q` | Quit |
+| `w` | Write CSV |
+| `j` | Write JSON |
+| `b` | Cycle band filter (All / 2.4GHz / 5GHz / 6GHz) |
+| `s` | Cycle sort mode (RSSI / Channel / ESSID / ENC) |
+| `Enter` | Enter AP selection mode |
+
+### Selection Mode
+| Key | Action |
+|-----|--------|
+| `↑` / `↓` | Navigate through AP list |
+| `Enter` | Run active scan on selected open AP |
+| `Esc` | Exit selection mode |
+
+## Configuration
+
+Default config path: `~/.config/ap-scanner/config.ini`
+
+```ini
+[scanner]
+interface = wlan0
+band = all
+sort = rssi
+no_color = false
+verbose = false
+```
+
+## Development
+
+```bash
+pip install -e ".[dev]"
+pytest tests/ -v
+```
+
+## License
+
+GPL-2.0-or-later. See [LICENSE](LICENSE) for details.
+
+---
+
+<br>
+
+<h2 align="center">
+================================================================================<br>
+한국어 (KOREAN)<br>
+================================================================================
+</h2>
+
+<br>
+
+# UAF — Ultimate AP Finder
+
PCI-DSS 무선 보안 감사 대응을 위한 Linux 기반 AP 탐지 및 분석 도구.
## Why UAF?
@@ -17,9 +165,9 @@ PCI-DSS 무선 보안 감사 대응을 위한 Linux 기반 AP 탐지 및 분석
---
-## Features
+## 기능
-### Passive Scanning
+### 수동 스캔 (Passive Scanning)
- 2.4GHz / 5GHz / 6GHz 전 대역 실시간 AP 탐지
- 보안 분류: WEP, WPA, WPA2, WPA3, OPN
- 802.11 a/b/g/n/ac/ax 표준 탐지
@@ -28,35 +176,35 @@ PCI-DSS 무선 보안 감사 대응을 위한 Linux 기반 AP 탐지 및 분석
- MAC 벤더 조회
- 대역/정렬 필터링
-### Active Scanning
+### 능동 스캔 (Active Scanning)
- 화살표 키로 AP 선택하는 인터랙티브 UI
- 오픈(OPN) AP 접속 후 능동 정찰
- DHCP 정보 수집, ARP 스캔으로 연결 클라이언트 탐지
- 게이트웨이 포트 스캔 (22, 53, 80, 443, 8080, 8443)
- 결과 오버레이 패널로 즉시 확인
-### Export
+### 내보내기 (Export)
- CSV / JSON 내보내기 (능동 스캔 결과 포함)
- 설정 파일 지원
---
-## Requirements
+## 요구 사항
- Python 3.10+
- Linux (`iw`, `ip` 명령어)
- Root 권한
- Monitor 모드 지원 WiFi 어댑터
-## Installation
+## 설치
-### From PyPI
+### PyPI에서 설치
```bash
pip install uaf
```
-### From source
+### 소스에서 설치
```bash
git clone https://github.com/devastator-x/uaf.git
@@ -64,7 +212,7 @@ cd uaf
pip install -e .
```
-## Usage
+## 사용법
```bash
# 기본 스캔 (인터페이스 자동 탐지)
@@ -89,28 +237,28 @@ sudo uaf -w output.csv
sudo uaf --config /path/to/config.ini
```
-## Keybindings
+## 키 바인딩
-### Normal Mode
-| Key | Action |
-|-----|--------|
-| `q` | Quit |
-| `w` | Write CSV |
-| `j` | Write JSON |
-| `b` | Cycle band filter (All / 2.4GHz / 5GHz / 6GHz) |
-| `s` | Cycle sort mode (RSSI / Channel / ESSID / ENC) |
-| `Enter` | Enter AP selection mode |
+### 일반 모드
+| 키 | 동작 |
+|----|------|
+| `q` | 종료 |
+| `w` | CSV 저장 |
+| `j` | JSON 저장 |
+| `b` | 대역 필터 순환 (All / 2.4GHz / 5GHz / 6GHz) |
+| `s` | 정렬 모드 순환 (RSSI / Channel / ESSID / ENC) |
+| `Enter` | AP 선택 모드 진입 |
-### Selection Mode
-| Key | Action |
-|-----|--------|
-| `↑` / `↓` | Navigate through AP list |
-| `Enter` | Run active scan on selected open AP |
-| `Esc` | Exit selection mode |
+### 선택 모드
+| 키 | 동작 |
+|----|------|
+| `↑` / `↓` | AP 목록 탐색 |
+| `Enter` | 선택한 오픈 AP에 능동 스캔 실행 |
+| `Esc` | 선택 모드 종료 |
-## Configuration
+## 설정
-Default config path: `~/.config/ap-scanner/config.ini`
+기본 설정 파일 경로: `~/.config/ap-scanner/config.ini`
```ini
[scanner]
@@ -121,13 +269,13 @@ no_color = false
verbose = false
```
-## Development
+## 개발
```bash
pip install -e ".[dev]"
pytest tests/ -v
```
-## License
+## 라이선스
-GPL-2.0-or-later. See [LICENSE](LICENSE) for details.
+GPL-2.0-or-later. 자세한 내용은 [LICENSE](LICENSE)를 참조하세요.
|