╔══════════════════════════════════════════════════════════════════╗
║                                                                  ║
║    ███╗   ███╗ █████╗ ██████╗ ███████╗██╗  ██╗ █████╗ ██╗     ██╗║
║    ████╗ ████║██╔══██╗██╔══██╗██╔════╝██║  ██║██╔══██╗██║     ██║║
║    ██╔████╔██║███████║██████╔╝███████╗███████║███████║██║     ██║║
║    ██║╚██╔╝██║██╔══██║██╔══██╗╚════██║██╔══██║██╔══██║██║     ██║║
║    ██║ ╚═╝ ██║██║  ██║██║  ██║███████║██║  ██║██║  ██║███████╗███████╗
║    ╚═╝     ╚═╝╚═╝  ╚═╝╚═╝  ╚═╝╚══════╝╚═╝  ╚═╝╚═╝  ╚═╝╚══════╝╚══════╝
║                                                                  ║
║                  Secure. Private. Untraceable.                   ║
║                                                                  ║
║                      bad-antics | 2026                           ║
╚══════════════════════════════════════════════════════════════════╝

🛡️ Features

Privacy Protection

• 🚫 Ad Blocking — Built-in ad blocker using EasyList and EasyPrivacy
• 🔒 Tracker Blocking — Blocks known tracking domains and scripts
• 🎭 Fingerprint Protection — Prevents browser fingerprinting techniques
• 🍪 Cookie Control — Block third-party cookies by default
• 👤 User Agent Spoofing — Blend in with common browsers
• 🌐 Referrer Control — Strict referrer policy to prevent leakage

Security Features

• 🔐 HTTPS-First — Prefer secure connections
• 🛡️ WebGL Disabled — Prevents GPU fingerprinting
• 📍 Timezone Spoofing — Hide your real timezone
• 🔇 WebRTC Protection — Prevents IP leakage
• 💾 No Persistence — Clear all data on exit (optional)

Modern Browser Features

• 📑 Tabbed Browsing — Full tab management
• 📚 Bookmarks — Organize your favorite sites
• 🔍 Smart Search — DuckDuckGo by default
• ⌨️ Keyboard Shortcuts — Efficient navigation
• 🎨 Dark Theme — NullSec-styled dark interface

Optional Features

• 🧅 Tor Integration — Route traffic through Tor network
• 🔐 DNS over HTTPS — Encrypted DNS queries
• 🔧 Developer Tools — Web inspector for developers

📦 Installation

Dependencies (Debian/Ubuntu)

sudo apt install -y \
    libgtk-3-dev \
    libwebkit2gtk-4.0-dev \
    pkg-config \
    libssl-dev

Dependencies (Arch Linux)

sudo pacman -S gtk3 webkit2gtk pkg-config openssl

Dependencies (Fedora)

sudo dnf install gtk3-devel webkit2gtk4.0-devel pkg-config openssl-devel

From Source

# Clone repository
git clone https://github.com/bad-antics/marshall.git
cd marshall

# Build release
cargo build --release

# Install
sudo install -Dm755 target/release/marshall /usr/local/bin/marshall

From Releases

Download pre-built binaries from the Releases page.

🚀 Usage

# Start Marshall
marshall

# Open specific URL
marshall https://duckduckgo.com

# Private window mode
marshall --private

# With Tor enabled (requires tor feature)
marshall --tor

Keyboard Shortcuts

⚙️ Configuration

Configuration file: ~/.config/marshall/config.toml

[general]
homepage = "about:blank"
search_engine = "https://duckduckgo.com/?q="
restore_session = false
enable_javascript = true
enable_webgl = false

[privacy]
strict_mode = true
block_trackers = true
block_fingerprinting = true
block_third_party_cookies = true
clear_on_exit = true
do_not_track = true
spoof_timezone = true

[adblock]
enabled = true
filter_lists = [
    "https://easylist.to/easylist/easylist.txt",
    "https://easylist.to/easylist/easyprivacy.txt"
]

[appearance]
theme = "nullsec-dark"
dark_mode = true
font_family = "JetBrains Mono"
font_size = 14

[network]
tor_enabled = false
dns_over_https = true
doh_server = "https://cloudflare-dns.com/dns-query"

🔧 Building

Standard Build

cargo build --release

With All Features

cargo build --release --features "tor,developer"

Feature Flags

🏗️ Architecture

marshall/
├── src/
│   ├── main.rs           # Application entry point
│   ├── ui/               # GTK4 UI components
│   │   ├── window.rs     # Main browser window
│   │   ├── toolbar.rs    # Navigation toolbar
│   │   ├── urlbar.rs     # URL/address bar
│   │   ├── tabbar.rs     # Tab management UI
│   │   ├── statusbar.rs  # Status bar
│   │   └── theme.rs      # CSS theming
│   ├── engine/           # WebKit engine wrapper
│   ├── privacy/          # Privacy protection
│   │   ├── tracker_blocker.rs
│   │   ├── fingerprint_protection.rs
│   │   └── cookie_manager.rs
│   ├── adblock/          # Ad blocking engine
│   ├── tabs/             # Tab management
│   ├── bookmarks/        # Bookmark storage
│   ├── history/          # Browsing history
│   ├── config/           # Configuration
│   └── network/          # Network utilities
├── Cargo.toml
├── LICENSE
└── README.md

🔐 Privacy Philosophy

Marshall is built on the principle of privacy by default:

1. Minimal Data Collection — We don't collect any telemetry
2. Secure Defaults — Privacy features enabled out of the box
3. Transparency — Open source, auditable code
4. User Control — You decide what data to keep

🤝 Contributing

Contributions welcome! Please read our contributing guidelines.

# Run tests
cargo test

# Run with debug logging
RUST_LOG=debug cargo run

# Check formatting
cargo fmt --check

# Run clippy
cargo clippy

📄 License

MIT License - see LICENSE file.

🔗 Links

• Website: bad-antics.github.io
• Discord: discord.gg/killers
• GitHub: @bad-antics