Preview: These docs are available early so you can start using them now. Some pages may still be incomplete, outdated, or change as WebLibre develops.

How WebLibre Is Organized

WebLibre is an Android browser organized as a personal web environment. Profiles own data and settings, containers organize activities, tabs and web-app windows display sites, and connections decide how browsing reaches the network. These are related choices, not a stack of isolation levels: a separate window does not automatically mean separate cookies or a different connection. Knowing what each part does helps you pick the lightest tool for a task.

How the Parts Fit Together

Profiles

Each profile owns its bookmarks, history, cookies and saved logins, open tabs, extensions, feeds, and settings. Use profiles for different people or for a complete split between parts of your life. Switching profiles restarts WebLibre.

Containers

Groups inside a profile. A container collects related tabs, can open assigned sites automatically, and can keep its pages out of history or the search index. With Cookie Isolation, a container also gets its own cookies and site data, can use its own connection, and can clear its cookies and site data on exit. Containers share cookies with regular browsing unless you turn on Cookie Isolation when you create them. That choice cannot be changed later.

Tabs

Tabs come in three types. Regular tabs are for everyday browsing. Private tabs stay out of your normal history and are not restored after an app restart. Isolated tabs each keep their own cookies and logins, separate from every other tab, and survive quitting WebLibre.

Web apps

Web apps are sites installed on your Android home screen. They can open in their own app-style window and use the storage context chosen during installation: normal storage, the source tab’s cookie-isolated container or isolated session, or a fresh isolated session. Each web app stays tied to its profile. A container-backed web app shares that container’s logins and connection settings.

Connections: Tor, VPN, and proxies

WebLibre includes Tor and a WireGuard VPN and proxy client, so you do not need a separate Tor or VPN app for your browsing. Tor sends your traffic through several relays, which helps hide your IP address from the sites you visit. A WireGuard VPN connects WebLibre to a VPN server, such as one from your VPN provider or your own, using its configuration file. Other proxy types, such as SOCKS, HTTP, and Shadowsocks, also send traffic through a server you choose. With a VPN or proxy, websites see that server’s address instead of yours. In the app, these appear as connections, next to your normal internet connection. You can send all regular tabs, private tabs, a cookie-isolated container, or a single isolated tab through Tor, a VPN, or a proxy, while everything else stays on your normal connection. If a required Tor, VPN, or proxy connection is not running, WebLibre blocks the affected tabs instead of quietly using your normal connection. These connections apply only to WebLibre; other apps on your device keep using your normal connection.

Which logins a tab shares and whether it uses Tor, a VPN, or a proxy are independent choices. Separate cookies help keep accounts apart, but do not hide your IP address. An isolated tab can have its own connection independently of a container it belongs to.

What Belongs to the Profile

Bookmarks, extensions, feeds, and settings belong to the profile, so containers, tabs, and web apps in the same profile share them. Cookies, logins, and site data are shared too, unless a container has Cookie Isolation, a tab is private or isolated, or a web app keeps its own logins.

If you need different extensions or settings for one activity, use a separate profile instead of a container.

Which Tool to Use

You want to Use

Share a device with other people

Separate profiles, each with its own lock if needed

Keep work and personal accounts apart every day

Cookie-isolated containers, or profiles for a full split

Sign in to a second account once, or test a site as a new visitor

An isolated tab

Browse without adding to your normal history

A private tab

Open a site like a separate app

A web app, set to share logins or keep its own

Send one activity through Tor, a VPN, or a proxy

A cookie-isolated container, or a single isolated tab, set to use Tor, a VPN, or a proxy

For a side-by-side comparison of what each option separates, see Profiles, containers, and isolated tabs.

The Same Environment on Larger Screens

The same Android app adapts to phones, tablets, foldables, and larger windows. Resizing the browser changes its layout, not the profile, login storage, or connection assigned to your browsing.

On larger screens, a resizable side panel can combine tabs, address and search controls, toolbar actions, and pinned add-ons. Mouse and trackpad input supports panel resizing and optional auto-hide; hardware keyboards provide customizable browser shortcuts. Touch gestures and toolbar actions remain available too.

See Larger Screens and Input for layout choices, or follow the keyboard and mouse workflow.

Keep and Move Your Setup

  • Profile backups save a whole profile as an encrypted file.

  • Export & Import Settings moves selected settings between profiles or devices without a full backup.

  • Sync keeps tabs, bookmarks, and history aligned with your other devices.

  • Encrypted account sync for WebLibre Supporters stores WebLibre’s own settings, encrypted before upload.

Next Steps