pybroswer

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

More than Python's webbrowser module: cookies, click-by-text, form fill, downloads, history, headers, and DOM query. Browser.launch() fetches pages with httpx and parses HTML. The same API also works with remote Chromium.

Install (PyDroid)

pip install httpx
pip install https://github.com/prateeknishad305/Pybrowser/archive/refs/heads/master.zip

If that fails, install httpx first, then:

pip install git+https://github.com/prateeknishad305/Pybrowser.git

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