pybroswer

Python browser for PyDroid. No Chromium, Playwright, or PC host is required on the phone.

Fixes Python webbrowser gaps: click/fill/scrape, CSS + XPath, HTTP status, cookies, tab reuse/close, headless (no GUI). Browser.launch() fetches pages with httpx and parses HTML. Optional remote Chromium on PC.

Install (PyDroid)

pip install -U pybroswer

Import name:

from pybroswer import Browser

from pybrowser import Browser also works.

Check:

import pybroswer
print(pybroswer.__version__, pybroswer.__file__)

PyDroid usage

from pybroswer import Browser

with Browser.launch() as browser:
    shot = browser.browse("https://example.com")
    print(shot.title, shot.url, shot.text)

    with browser.create_session(device="mobile") as page:
        page.goto("https://example.com")
        print(page.title(), page.url())
        print(page.text()[:200])
        print(page.links())
        print(page.cookies())

        # Click first real link, or pass CSS / visible text:
        # page.click()
        # page.click("a#login")
        # page.click(text="More information")
        # page.click("text=More information")
        # page.fill({"q": "hello"})
        # page.press("Enter", selector="input[name=q]")

Browser() with no URL also starts the local HTTP engine.

Optional: PC Chromium

If you want real Chromium on a PC:

pip install "pybroswer[chromium]"
playwright install chromium
python -m pybroswer serve --port 5173

From PyDroid:

from pybroswer import Browser
with Browser.connect("http://192.168.1.10:5173") as browser:
    ...

In-process on PC: Browser.launch(engine="chromium").

Limits (phone HTTP engine)

• JS-heavy SPAs are not rendered (you get the HTML the server sent)
• Screenshot is a 1x1 placeholder PNG
• evaluate only supports simple document.title / querySelector expressions
• Iframe contents are not fetched separately
• Click coordinates (x, y) require Chromium

Forms, links, cookies, downloads, type/press/select, headers, and redirects work.

Beyond webbrowser.open(url):

from pybroswer import Browser

browser = Browser.launch()
browser.open("https://example.com")   # webbrowser-compatible
with browser.create_session() as page:
    page.goto("https://httpbin.org/forms/post")
    page.fill({"custname": "Ada", "custtel": "123"})
    page.click("text=Submit")
    print(page.cookies())
    file = page.download("https://example.com/favicon.ico")
    print(file["filename"], file["bytes"])

API