<p align="center">
  <img width="250" src="app/assets/icon/icon.png" alt="WebLibre Logo">
</p>

# WebLibre: The Privacy-Focused Browser

<a href="https://liberapay.com/FaFre/donate">
  <img alt="Donate using Liberapay" src="https://liberapay.com/assets/widgets/donate.svg">
</a>

WebLibre is an independent browser project built on the foundation of [Mozilla's Gecko Engine](https://en.wikipedia.org/wiki/Gecko_(software)) and [Mozilla Android Components](https://mozac.org/). It offers a fully featured web browser with support for Firefox mobile add-ons, designed with privacy and usability at its core.

> **⚠️ Alpha Release Notice**  
> WebLibre is currently in the alpha phase. Expect frequent updates, potential bugs, and breaking changes. Please report issues on [GitHub](https://github.com/FaFre/WebLibre/issues).

---

## Features

### Tab Management

- **Tab Containers:** Organize tabs into isolated containers for enhanced privacy and workflow management with optional features:
    - **Container Cookie Contexts:** Separate “cookie jars” for each container.
    - **Tor Proxy:** Route container traffic through the Tor network for anonymous browsing.
    - **Biometric Authentication:** Restrict access to containers using fingerprint or face recognition.
- **Tree View Navigation:** Visualize and manage complex tab hierarchies for better browsing context.
- **Local AI Assistance:** Use on-device AI models to group tabs and manage containers effortlessly.

### Personal Local Search Engine

- **Unified Search:** Instantly search across:
    - **Open Tabs:** By title, address, and full page content (no size limits).
    - **Web Feeds:** Aggregate and search your favorite news sites and blogs, with full content indexing.
    - **Browsing History:** Quickly find previously visited sites by title or address.
    - **Bangs:** Use custom shortcuts for direct on-site search.
- **Local-First Search:** All indexing and search operations happen on your device—your data never leaves your control.

### Privacy & Security

- **No Tracking:** WebLibre does not track or monitor your browsing.
- **Local Data Storage:** All your data stays on your device.
- **Tor Integration:** Route container or private tab traffic through the Tor network for greater anonymity.
- **Ad and Content Blocking:** Optional content blocker (uBlock Origin) installation during onboarding.
- **Web Engine Hardening:** Comprehensive and easy-to-use privacy and security presets for the Gecko Web-Engine.

### Bangs

- **Direct On-Site Search:** Use thousands of powerful shortcuts (“bangs”) to search directly on popular websites—no third-party search engine required.

---

## Getting Started

1. **Download & Install** WebLibre on your device.
2. **Organize Tabs:** Use containers for work, personal, or research contexts.
3. **Enable Tor Proxy:** Assign Tor to containers or private tabs for sensitive browsing.
4. **Add Web Feeds:** Aggregate your favorite sites for unified, private search.
5. **Try Bangs:** Search directly on your favorite websites with custom shortcuts.

<p align="center">
  <a href='https://github.com/FaFre/WebLibre/releases'>
    <img height="100" alt='Get it on GitHub' src='https://docs.weblibre.eu/static/images/badges/github.png'/>
  </a>
  <a href='https://f-droid.org/en/packages/eu.weblibre.gecko/'>
    <img height="100" alt='Get it on F-Droid' src='https://docs.weblibre.eu/static/images/badges/fdroid.png'/>
  </a>
  <a href='https://play.google.com/store/apps/details?id=eu.weblibre.gecko'>
    <img height="100" alt='Get it on Google Play' src='https://docs.weblibre.eu/static/images/badges/google_play.png'/>
  </a>
</p>

---

## Feedback & Contributions

WebLibre is in active development, and your feedback is greatly welcomed!  
Please share your ideas, report issues via [GitHub Issues](https://github.com/FaFre/WebLibre/issues).
