Birds Browser SDK

Chrome Automation at Engine Level. Control Chromium-based browsers with powerful C++ and C# APIs for Windows developers.

Request SDK Access Quick Start

Build Powerful Browser Applications

The Birds Browser SDK gives developers direct access to browser internals that extensions and automation tools cannot reach. Build custom browsers, security tools, and automation solutions at the engine level.

Quick Start

C++ Integration

#include "BirdsEngine.h"

// Initialize the Birds Engine
BirdsEngine engine;
engine.Initialize();

// Create a browser instance
auto browser = engine.CreateBrowser();
browser->Navigate("https://example.com");

// Monitor address bar changes
browser->OnAddressBarChange([](const std::string& url) {
    std::cout << "Navigated to: " << url << std::endl;
});

// Inject custom JavaScript
browser->InjectScript(R"(
    console.log('Birds Engine Active');
)");

C# Integration

using Tracy.BirdsEngine;

// Initialize the Birds Engine
var engine = new BirdsEngine();
engine.Initialize();

// Create a browser instance
var browser = engine.CreateBrowser();
browser.Navigate("https://example.com");

// Monitor address bar changes
browser.AddressBarChanged += (sender, url) => {
    Console.WriteLine($"Navigated to: {url}");
};

// Inject custom JavaScript
browser.InjectScript(@"
    console.log('Birds Engine Active');
");

API Overview

Comprehensive APIs for complete browser control

Address Bar Monitoring API

Monitor and control the address bar. Intercept navigation, modify URLs, and implement custom URL handling.

  • OnNavigationStart
  • OnAddressBarChange
  • ModifyUrl()
  • BlockNavigation()

DOM Control API

Direct access to the DOM for manipulation, extraction, and monitoring. Execute JavaScript and receive callbacks.

  • InjectScript()
  • QuerySelector()
  • ModifyElement()
  • ObserveMutations()

DevTools Integration API

Full access to Chrome DevTools Protocol for debugging, profiling, and advanced automation.

  • ConnectDevTools()
  • SendCommand()
  • OnDevToolsEvent()
  • NetworkInterception()

Custom Branding API

Customize browser appearance including logos, colors, new tab pages, and UI elements.

  • SetBranding()
  • CustomNewTab()
  • ModifyToolbar()
  • SetTheme()

Security/DLP APIs

Implement data loss prevention, content filtering, and security policies at the browser level.

  • MonitorClipboard()
  • BlockUpload()
  • FilterContent()
  • AuditActivity()

Browser Injection API

Inject Birds Engine capabilities into existing Chromium browsers without modification.

  • AttachToBrowser()
  • InjectEngine()
  • HookNavigation()
  • ModifyBehavior()

Code Examples

URL Monitoring and Modification
// Monitor all navigations
browser.OnNavigationStart += (url) => {
    // Check for affiliate opportunities
    if (IsAffiliateSite(url)) {
        return AddAffiliateTag(url);
    }
    return url;
};

// Block specific domains
browser.AddBlockedDomain("malware.example.com");
browser.AddBlockedDomain("phishing.site");
DLP Implementation
// Monitor clipboard for sensitive data
browser.Security.MonitorClipboard(data => {
    if (ContainsCreditCard(data) ||
        ContainsSSN(data)) {
        LogSecurityEvent("Sensitive data copied");
        return BlockAction();
    }
    return AllowAction();
});

// Block file uploads to non-approved sites
browser.Security.OnFileUpload += (file, url) => {
    return IsApprovedUploadDomain(url);
};
Custom New Tab Page
// Set custom new tab page
browser.SetNewTabContent(@"
    <html>
    <body style='background: #06223c;'>
        <h1 style='color: white;'>
            Welcome to Your Browser
        </h1>
        <input type='search'
               id='search'
               placeholder='Search...'>
    </body>
    </html>
");

// Handle search from new tab
browser.OnNewTabSearch += (query) => {
    browser.Navigate($"https://search.com?q={query}");
};
DevTools Protocol Access
// Connect to DevTools Protocol
var devtools = browser.ConnectDevTools();

// Enable network monitoring
devtools.Send("Network.enable");

// Intercept network requests
devtools.OnEvent("Network.requestWillBeSent",
    (request) => {
    Console.WriteLine($"Request: {request.url}");
});

// Take screenshot
var screenshot = await devtools.Send(
    "Page.captureScreenshot"
);

Integration Steps

1
Request SDK Access

Contact our team to get SDK credentials and access to the developer portal.

2
Download SDK Package

Download the SDK including libraries, headers, and documentation for your platform.

3
Initialize in Your Application

Add Birds Engine references and initialize the engine in your application startup.

4
Build and Deploy

Build your application with the SDK and deploy to your users.

System Requirements

Development

  • Windows 10/11 (64-bit)
  • Visual Studio 2019 or later
  • .NET Framework 4.7.2+ or .NET 6+
  • C++ toolchain for native development

Runtime

  • Windows 10/11 (64-bit)
  • Chromium 120+ compatible
  • 4GB RAM minimum
  • 500MB disk space

Ready to Build?

Request SDK access and start building powerful browser applications today.

Request SDK Access