Binary Cookies Reader

This project provides a CLI tool to read and interpret binary cookie files. The project is based on the cookie reader written by Satishb3

Requirements

• Python 3.8 or higher

Installation

pip install binary-cookies-parser

If you want to use the parser as CLI, it's recommended to use pipx to install the package in an isolated environment.

Usage

After installation, you can use the command-line interface to read a binary cookies file:

bcparser <path_to_binary_cookies_file>

Replace <path_to_binary_cookies_file> with the path to the binary cookie file you want to read.

Or use it in Python:

from binary_cookies_parser.parser import read_binary_cookies_file

cookies = read_binary_cookies_file("path/to/cookies.binarycookies")

Output Types

The bcparser CLI supports two output types: json (default) and ascii.

JSON Output

The json output type formats the cookies as a JSON array, making it easy to parse and manipulate programmatically.

Example usage:

bcparser path/to/cookies.binarycookies --output json

example output:

[
  {
    "name": "session_id",
    "value": "abc123",
    "url": "https://example.com",
    "path": "/",
    "create_datetime": "2023-10-01T12:34:56+00:00",
    "expiry_datetime": "2023-12-31T23:59:59+00:00",
    "flag": "Secure"
  },
  {
    "name": "user_token",
    "value": "xyz789",
    "url": "https://example.com",
    "path": "/account",
    "create_datetime": "2023-10-01T12:34:56+00:00",
    "expiry_datetime": "2023-12-31T23:59:59+00:00",
    "flag": "HttpOnly"
  }
]

ASCII Output

The ascii output type formats the cookies in a simple, line-by-line text format, making it easy to read and pipe to other command-line tools.

Example usage:

bcparser path/to/cookies.binarycookies --output ascii

Example output:

Name: session_id
Value: abc123
URL: https://example.com
Path: /
Created: 2023-10-01T12:34:56+00:00
Expires: 2023-12-31T23:59:59+00:00
Flag: Secure
----------------------------------------
Name: user_token
Value: xyz789
URL: https://example.com
Path: /account
Created: 2023-10-01T12:34:56+00:00
Expires: 2023-12-31T23:59:59+00:00
Flag: HttpOnly
----------------------------------------