---
id: geckordp
version: "1.0.3"
license: MIT License Copyright 2023 jpramosi Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the… (full text in the JSON record)
license_treatment: permissive
maintenance: aging
---

# geckordp — A client implementation of Firefox DevTools over remote debug protocol.

License: permissive · Maintenance: aging · Downloads: 94.1K/mo

## What it is and what it does

Geckordp exposes Firefox's remote debug protocol as a Python library, enabling direct programmatic interaction with a Firefox browser instance. It acts as a low-level client that communicates with Firefox's debug server, allowing you to control tabs, inspect DOM, execute scripts, monitor network traffic, and automate browser behavior without relying on higher-level webdriver abstractions.

The package is designed as a foundation for building tools on top—web UI testing frameworks, browser automation scripts, extension testers, and network analysis tools. It requires a pre-configured Firefox profile with remote debugging enabled and uses helper classes like ProfileManager to handle profile setup. The API mirrors geckodriver concepts where possible and exposes actors that correspond to different Firefox subsystems.

Use it for:

- Automated web UI testing and browser interaction testing for Firefox-specific scenarios.
- Building custom browser automation tools that need fine-grained control over Firefox internals.
- Network traffic analysis and HTTPS recording by intercepting browser debug protocol messages.
- Testing Firefox extensions and WebExtensions in an automated environment.
- Web scraping with headless Firefox when standard webdriver tools are insufficient.
- Remote browser control and monitoring for distributed testing or CI/CD pipelines.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Geckordp is a Python client for Firefox's remote debug protocol, allowing programmatic control and inspection of Firefox browser instances through a low-level API.

Yes, if you need Firefox-specific browser automation or remote debugging capabilities and are willing to work with a beta-stage library. Install it for UI testing, extension testing, or custom browser tooling. The low dependency count and permissive license make it low-risk to try. However, verify platform compatibility for your target OS and confirm Firefox version alignment before committing to production use.

## Install

pip install geckordp
uv add geckordp
poetry add geckordp

## Installing geckordp

Before you install: Low install friction with only two runtime dependencies (jmespath, psutil). The package is in beta status and has aged since its last release in September 2024, though the repository remains active with recent commits as of April 2025.

License in practice: MIT License permits free use, modification, and distribution with minimal restrictions—suitable for both open-source and commercial projects.

Quickstart:

pip install geckordp

from geckordp.firefox import Firefox
from geckordp.rdp_client import RDPClient
from geckordp.actors.root import RootActor

Firefox.start("https://example.com/", 6000, "profile_name", ["-headless"])
client = RDPClient()
client.connect("localhost", 6000)
root = RootActor(client)
tabs = root.list_tabs()

Requires Firefox 129.0 or compatible version installed; minimum Python 3.10; a pre-configured Firefox profile with remote debugging enabled.

Verify before relying:

- Compatibility with Firefox versions other than 129.0 and whether older versions work reliably.
- Windows and macOS platform support status (marked as uncertain in documentation).
- Performance characteristics and scalability for concurrent browser sessions.
- Whether all geckodriver API actors are fully implemented or if gaps exist.

## Package facts

- License: MIT License Copyright 2023 jpramosi Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the… (full text in the JSON record) (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: aging
- Downloads: 94.1K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

firefox remote debug protocol python, browser automation firefox rdp, firefox devtools client, headless firefox control, firefox ui testing library, browser remote debugging, firefox webdriver alternative, firefox-automation, browser-testing, remote-debugging

[View on SkillFed](https://skillfed.io/packages/geckordp) · [View on PyPI](https://pypi.org/project/geckordp/)