Usage

Importing CockyGrabber

Note: You will need to add System.Data.SQLite to your project. The package can be downloaded from the official website or from NuGet. (In future versions of CockyGrabber, this won't be necessary)

using CockyGrabber;
using CockyGrabber.Grabbers;

Grabbing Information

Grabbing Information from Chromium/Blink-based Browsers

Example that shows how to grab Chrome cookies using the ChromeGrabber:

ChromeGrabber grabber = new ChromeGrabber(); // Create Grabber
var cookies = grabber.GetCookies(); // Collect all Cookies with GetCookies()

// Print the Hostname, Name, and Value of every cookie:
foreach (Blink.Cookie cookie in cookies) // Chrome is Blink based so it uses Blink.Cookie
{
    string cookieHostname = cookie.HostKey;
    string cookieName = cookie.Name;
    string cookieValue = cookie.EncryptedValue;
    Console.WriteLine($"{cookieHostname}: {cookieName} = {cookieValue}");
}

To collect browser information of any other Chromium/Blink-based browser just replace ChromeGrabber with OperaGxGrabber, BraveGrabber, or EdgeGrabber, and so on...

Grabbing Information from Gecko-based Browsers

Example that shows how to grab Chrome cookies using the FirefoxGrabber:

FirefoxGrabber grabber = new FirefoxGrabber(); // Create Grabber
var cookies = grabber.GetCookies(); // Collect all Cookies with GetCookies()

// Print Hostname, Name, and Value of every cookie:
foreach (Gecko.Cookie cookie in cookies) // Firefox is Gecko based so it uses Gecko.Cookie
{
    string cookieHostname = cookie.Host;
    string cookieName = cookie.Name;
    string cookieValue = cookie.Value;
    Console.WriteLine($"{cookieHostname}: {cookieName} = {cookieValue}");
}

CockyGrabber can also grab information like Logins, Downloads, Bookmarks and History:

(GRABBER) grabber = new (GRABBER); // Create Grabber

var bookmarks = grabber.GetBookmarks(); // Collect all Bookmarks with GetBookmarks()
var downloads = grabber.GetDownloads(); // Collect all Downloads with GetDownloads()
var logins = grabber.GetLogins(); // Collect all Logins with GetLogins()
var history = grabber.GetHistory(); // Collect all History with GetHistory()

Grabbing data from multiple Browsers

CockyGrabber provides a UniversalGrabber which can be used to grab Cookies, Logins, and such from multiple Browsers. Here is an example showing how to grab stuff from all Chromium/Blink-browsers:

UniversalGrabber grabber = new UniversalGrabber(); // Create Grabber

var cookies = grabber.GetAllBlinkCookies(); // Collect the Cookies from all Chromium/Blink based browsers
var logins = grabber.GetAllBlinkLogins(); // Collect the Logins from all Chromium/Blink based browsers
var bookmarks = grabber.GetAllBlinkBookmarks(); // Collect the Bookmarks from all Chromium/Blink based browsers
var history = grabber.GetAllBlinkHistory(); // Collect the History from all Chromium/Blink based browsers
var downloads = grabber.GetAllBlinkDownloads(); // Collect the Downloads from all Chromium/Blink based browsers

Gecko-based browsers are not very different from Chromium/Blink-based browsers, so you can use the same code to get data from them:

UniversalGrabber grabber = new UniversalGrabber(); // Create Grabber

var cookies = grabber.GetAllGeckoCookies(); // Collect the Cookies from all Gecko based browsers
var logins = grabber.GetAllGeckoLogins(); // Collect the Logins from all Gecko based browsers
var bookmarks = grabber.GetAllBlinkBookmarks(); // Collect the Bookmarks from all Gecko based browsers
var history = grabber.GetAllGeckoHistory(); // Collect the History from all Gecko based browsers
var downloads = grabber.GetAllBlinkDownloads(); // Collect the Downloads from all Gecko based browsers

Getting specific data by Headers

Say you want to grab the logins of a specific hostname/website; how would you do it? You use the GetLoginsBy() Method!

Here is an example with the EdgeGrabber:

EdgeGrabber grabber = new EdgeGrabber(); // Create Grabber

// Collect all Discord Logins:
var discord_logins = grabber.GetLoginsBy(Blink.LoginHeader.origin_url, "https://discord.com/login");

// Collect the Logins that have the same password as you specified:
var logins_by_pswd = grabber.GetLoginsBy(Blink.LoginHeader.password_value, "password123");

Obviously you can also grab other specific data:

// Collect all Instagram Cookies:
var instagram_cookies = grabber.GetCookiesBy(Blink.CookieHeader.host_key, ".instagram.com");

// Collect all Google Bookmarks:
var google_bookmarks = grabber.GetBookmarksBy(Blink.CookieHeader.url, "https://google.com");

// ...

There are more headers you can use, but the ones I have listed are the most common ones.

(A documentation for the Item Headers such as Blink.LoginHeader and Gecko.CookieHeader will come in near future)

Catching Exceptions

CockyGrabber also gives you the option to catch unexpected occurrences like errors:

try
{
    // Grab them Cookies and Logins:
    var c = grabber.GetCookies();
    var l = grabber.GetLogins();
}
catch (GrabberException e)
{
    // Check Error:
    switch (e.Error)
    {
        case GrabberError.CookiesNotFound: // Cookies weren't found
            Console.WriteLine("ERROR! The Cookie DB couldn't be found!");
            break;
        case GrabberError.LoginsNotFound: // Logins weren't found
            Console.WriteLine("ERROR! The Login DB couldn't be found!");
            break;
        case GrabberError.LocalStateNotFound: // Key wasn't found
            Console.WriteLine("ERROR! The 'Local State' file couldn't be found!");
            break;
    }
    Console.WriteLine("Original Exception: " + e);
}

Adding Custom Browsers

If you want to add support for a new browser, you can do it by adding a new grabber class that inherits from BlinkGrabber or GeckoGrabber. After crating the class you will need to specify the browser's paths to the databases and files.

CustomBlinkGrabber Example

public class CustomBlinkGrabber : BlinkGrabber
{
    public override string CookiePath
    {
        get
        {
            // This is the path to the Cookie Database
            return $"C:\\Users\\{Environment.UserName}\\AppData\\Local\\CustomBrowser\\Default\\Cookies";
        }
    }
    public override string LocalStatePath
    {
        get
        {
            // This is the path to the 'Local State' file of the browser
            return $"C:\\Users\\{Environment.UserName}\\AppData\\Local\\CustomBrowser\\Local State";
        }
    }
    public override string LoginDataPath
    {
        get
        {
            // This is the path to the Login Database
            return $"C:\\Users\\{Environment.UserName}\\AppData\\Local\\CustomBrowser\\Default\\Login Data";
        }
    }
    public override string HistoryPath
    {
        get
        {
            // This is the path to the History Database
            return $"C:\\Users\\{Environment.UserName}\\AppData\\Local\\CustomBrowser\\Default\\History";
        }
    }
    public override string BookmarkPath
    {
        get
        {
            // This is the path to the Bookmark Database
            return $"C:\\Users\\{Environment.UserName}\\AppData\\Local\\CustomBrowser\\Default\\Bookmarks";
        }
    }
}

CustomGeckoGrabber Example

public class CustomGeckoGrabber : BlinkGrabber
{
    public override string ProfilesPath
    {
        get
        {
            // This is the path to the Profiles folder of the browser
            return $"C:\\Users\\{Environment.UserName}\\AppData\\Local\\CustomBrowser\\Profiles";
        }
    }
}