URL Warning Extension

About

A powerful Chrome extension designed to protect users from potentially harmful websites by using customizable blacklists and whitelists.

## 🛡️ Features

### Core Protection
- **Real-time Website Scanning**: Instantly checks websites against your custom blacklist and whitelist
- **Path-based URL Matching** (NEW!): Target specific paths within domains (e.g., block `example.com/malware` but allow `example.com/safe`)
- **Auto-refreshing Lists**: Keep your protection up-to-date with scheduled refreshes
- **Smart Notification System**: Get informed about blocked sites and protection status

### Advanced Customization
- **Custom Blacklist & Whitelist Management**: 
  - Import from local JSON files
  - Fetch from remote URLs
  - Clear lists with a single click
- **Multiple Data Sources**:
  - Built-in default lists from `nerd.bh/apis/warnme/`
  - Support for custom remote endpoints
  - Local file imports

### User Experience
- **Tab-based Settings Interface**: Easily navigate between Blacklist, Whitelist, Settings, and About
- **Sleek Notification Toasts**: Non-intrusive alerts with auto-dismissal
- **Mobile-friendly Design**: Responsive layout works on all devices
- **Terminal-styled About Page**: Unique developer information with animations


## 🔧 Usage

### Basic Usage
- The extension icon will change color based on the current site's status:
  - 🟢 Green: Safe site
  - 🔴 Red: Blacklisted site
  - 🔵 Blue: Whitelisted site
  - ⚪ Gray: Default/Not checked

- Click the extension icon to see site status and available actions

### Customizing Protection

#### Managing Blacklist
1. Open extension options by right-clicking the icon and selecting "Options"
2. Go to the "Blacklist" tab
3. Choose your blacklist source:
   - Upload a local JSON file
   - Fetch from a remote URL
   - Use the built-in default list
4. Clear the entire blacklist with the "Clear Blacklist" button when needed

#### Managing Whitelist
1. Navigate to the "Whitelist" tab
2. Add trusted sites that should bypass the protection
3. Import/export whitelist data as needed
4. Clear the entire whitelist with the "Clear Whitelist" button when needed

#### Advanced URL Patterns
- Block specific paths: `example.com/malware`
- Block subdomains: `ads.example.com`
- Block specific sections: `forum.example.com/spam`
- Block with wildcards: `*.example.com`

## ⚙️ Configuration Options

- **Auto-refresh Lists**: Choose refresh frequency (hourly, daily, weekly)
- **Notifications**: Toggle popup notifications and toast alerts
- **Refresh on Block**: Automatically refresh lists when a blocked site is encountered
- **Reset to Default**: Reset all settings to default values