Upload files to "/"

.gitignore

@@ -0,0 +1 @@
+/target

Cargo.toml

@@ -0,0 +1,23 @@
+#Cargo.toml
+[package]
+name = "RustyWolf"
+version = "0.1.1"
+edition = "2024"
+
+[dependencies]
+anyhow = "1.0"
+base64 = "0.22"
+clap = { version = "4.5", features = ["derive"] }
+serde_json = "1.0"
+tao = "0.31"
+ureq = "2.12"
+url = "2.5"
+wry = { version = "0.47", features = ["fullscreen"] }
+image = { version = "0.25", default-features = false, features = ["bmp", "ico", "png"] }
+dirs = "6.0"
+
+[package.metadata.bundle]
+name = "RustyWolf"
+identifier = "com.rustywolf.browser"
+icon = ["src/rustywolf.icns"]
+

README.md

@@ -0,0 +1,172 @@
+# RustyWolf
+
+RustyWolf is a minimal, privacy-focused browser shell built with Rust + system webviews.
+
+(complete honesty, this whole thing is vibecoded, however I never paid for any ai service (I got a free student plan for a year) so if you wanna avoid AI slop, just skip this but I never contributed to the AI BOOM with my money, if you wanna contribute, feel free to do so)
+
+- macOS: native `WKWebView`
+- Linux: `WebKitGTK`
+- Windows: `WebView2`
+
+No Firefox install. No extension system. Fast startup, clean UI.
+
+<img width="2912" height="1900" alt="image" src="https://github.com/user-attachments/assets/90d3880e-bb3e-44f5-8307-bc96011e24c8" />
+
+## What It Does
+
+- Really, I mean really lightweight! the reason I even made this is because I need a lightweight browser to run on my old macbook unibody 2010 4gb ddr3
+    - So light in fact in my gentoo(openrc)+i3wm setup it took only 285mb ram with one tab open (dvorakmortonxd.dev) compared to firefox which took 866mb ram
+    - THATS 3.04 TIMES AS MUCH RAM, so yeah it is light
+    - tabs have a toggle for Keeping-in-ram (`K`), it basically just saves the url if its off and reloads it on reclick, if you toggle it on it keeps the whole page in ram.
+- Privacy-first defaults: DuckDuckGo home + search fallback from the URL bar
+- Multi-tab browsing with back, forward, reload, and keyboard shortcuts (`Ctrl/Cmd+T`, `W`, `L`)
+- Built-in custom adblock with top-bar toggle (`ADS`)
+- Popup permission gate: asks before a site opens a new tab
+- Download support with live progress panel (`D`) and session download history
+- Properties page with session browsing history + download history
+- Default window size `1000x600` (still fully resizable)
+- Optional `--private` mode when backend support is available
+
+## Run
+
+```bash
+cargo run --
+```
+
+```bash
+cargo run -- --url https://example.com
+cargo run -- --url example.com
+cargo run -- --title "RustyWolf"
+cargo run -- --private
+cargo run -- --dry-run
+
+# Linux backend controls (wayland has issues currently, x11 recommended)
+cargo run -- --linux-backend x11
+cargo run -- --linux-backend wayland
+cargo run -- --linux-disable-dmabuf
+cargo run -- --linux-backend x11 --linux-disable-dmabuf
+```
+
+## Privacy Notes
+
+RustyWolf applies baseline hardening in page context:
+
+- `navigator.doNotTrack = "1"`
+- disables legacy `openDatabase`
+- disables `RTCPeerConnection`
+
+Adblocking is built-in and lightweight. It is not full uBlock Origin parity.
+
+# Linux Setup (prerequisites)
+
+Install WebKitGTK development/runtime packages before building.
+
+## Debian
+
+```bash
+sudo apt update
+sudo apt install -y libwebkit2gtk-4.1-dev libgtk-3-dev build-essential pkg-config git appmenu-gtk3-module appmenu-gtk2-module
+curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
+source "$HOME/.cargo/env"
+```
+
+## Arch
+
+```bash
+sudo pacman -Sy
+sudo pacman -S --needed webkit2gtk-4.1 gtk3 base-devel pkgconf git appmenu-gtk-module
+curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
+source "$HOME/.cargo/env"
+```
+
+## Gentoo
+
+(u can replace doas with sudo btw)
+```bash
+doas emerge --sync
+doas emerge --ask net-libs/webkit-gtk:4.1 x11-libs/gtk+ virtual/pkgconfig dev-vcs/git x11-misc/appmenu-gtk-module
+curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
+source "$HOME/.cargo/env"
+```
+
+## Linux media playback deps (important)
+
+If Linux logs `gstreamer element autoaudiosink not found` or YouTube/audio fails, install GStreamer audio/video plugins.
+
+Debian/Ubuntu/Pop!_OS example:
+
+```bash
+sudo apt update
+sudo apt install -y gstreamer1.0-tools
+sudo apt install -y gstreamer1.0-plugins-base gstreamer1.0-plugins-good
+sudo apt install -y gstreamer1.0-plugins-bad gstreamer1.0-libav
+sudo apt install -y gstreamer1.0-pulseaudio gstreamer1.0-pipewire gstreamer1.0-alsa
+```
+
+Verify the sink exists:
+
+```bash
+gst-inspect-1.0 autoaudiosink
+```
+
+If your distro is not Debian-based, install the equivalent GStreamer base/good/bad/libav + audio sink plugin packages.
+
+# Linux Troubleshooting (Wayland/X11)
+
+RustyWolf supports both X11 and native Wayland on Linux.
+
+Some NVIDIA + WebKitGTK stacks can fail with dmabuf/gbm allocation errors, especially on Wayland.
+
+Try these launch modes:
+
+```bash
+# safest fallback on many NVIDIA setups
+cargo run -- --linux-backend x11 --linux-disable-dmabuf
+
+# native wayland
+cargo run -- --linux-backend wayland
+
+
+# auto backend, dmabuf disabled only
+cargo run -- --linux-disable-dmabuf
+```
+
+If you still see `Failed to load module "appmenu-gtk-module"`, that is a desktop GTK setup issue (not a RustyWolf crash).
+
+Debian/Ubuntu/Pop!_OS fix:
+
+```bash
+sudo apt update
+sudo apt install -y appmenu-gtk3-module appmenu-gtk2-module
+```
+
+If you do not want global appmenu integration, remove `appmenu-gtk-module` from GTK settings files:
+
+```bash
+~/.config/gtk-3.0/settings.ini
+/etc/gtk-3.0/settings.ini
+/etc/xdg/gtk-3.0/settings.ini
+```
+
+# MacOS
+
+## installing Homebrew (skip if already installed)
+
+```bash
+/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
+```
+
+# Windows Setup
+
+Install the Microsoft Edge WebView2 Runtime (Evergreen), then build normally with Rust MSVC toolchain.
+
+- WebView2 Runtime: https://developer.microsoft.com/microsoft-edge/webview2/
+- Rust toolchain target: `x86_64-pc-windows-msvc`
+
+## Dev Quick Checks
+
+```bash
+cargo fmt
+cargo check
+cargo test
+```

src/cli.rs

@@ -0,0 +1,50 @@
+//cli.rs
+use clap::{Parser, ValueEnum};
+
+#[derive(Debug, Clone, Copy, ValueEnum)]
+pub enum LinuxBackend {
+    Auto,
+    X11,
+    Wayland,
+}
+
+#[derive(Debug, Parser)]
+#[command(
+    name = "rustywolf",
+    about = "Privacy-focused WebKit browser",
+    long_about = "RustyWolf launches an embedded WebKit browser window.",
+    version
+)]
+pub struct Cli {
+    #[arg(long, help = "Optional startup URL (defaults to https://duckduckgo.com)")]
+    pub url: Option<String>,
+
+    #[arg(long, help = "Set a custom window title")]
+    pub title: Option<String>,
+
+    #[arg(long, help = "Try private/incognito mode when backend supports it")]
+    pub private: bool,
+
+    #[arg(long, help = "Print launch settings without opening a window")]
+    pub dry_run: bool,
+
+    #[arg(
+        long,
+        value_enum,
+        default_value_t = LinuxBackend::Auto,
+        help = "Linux only: prefer a windowing backend (auto, x11, wayland)"
+    )]
+    pub linux_backend: LinuxBackend,
+
+    #[arg(
+        long,
+        help = "Linux only: disable WebKit dmabuf renderer (helps some NVIDIA/Wayland setups)"
+    )]
+    pub linux_disable_dmabuf: bool,
+}
+
+impl Cli {
+    pub fn parse_args() -> Self {
+        Self::parse()
+    }
+}

src/main.rs

@@ -0,0 +1,17 @@
+//main.rs
+mod cli;
+mod webview;
+
+use anyhow::Result;
+
+fn main() {
+    if let Err(err) = run() {
+        eprintln!("error: {err:#}");
+        std::process::exit(1);
+    }
+}
+
+fn run() -> Result<()> {
+    let cli = cli::Cli::parse_args();
+    webview::launch_webkit(&cli)
+}