CookiesTool

This is a maintained fork of BinaryCookies.

Convert cookies between:

• BinaryCookies (Apple)
• EditThisCookie (JSON)
• Perl::LWP
• Netscape HTTP Cookie File (Mozilla, curl).
• JSON
• Property List (XML)

Supports macOS 10.15 and above, iOS 13.0 and above.

TODOs

• Unit Tests
• Framework Target & SPM Support

Usage

Usage: CookiesTool [OPTIONS]... [FILE]...
Convert between Apple BinaryCookies, EditThisCookie (JSON), Perl::LWP and Netscape HTTP Cookie File.

Command options are (-l is the default):
  -h | --help               show this message and exit
  -l | --lint               check the cookies file for syntax errors
  -c | --convert FORMAT     rewrite cookies file in format
  -o | --output PATH        specify file path name for result;
                            the -o option is used with -c, and is only useful
                            with one file argument;
  -r | --readable           if writing JSON, output in human-readable form

FORMAT is one of: binarycookies edit-this-cookie netscape perl-lwp

File Format

File

Field	Endianness	Type	Size	Description
Magic	BE	UTF-8	4	"cook", no terminator
Number of pages	BE	Unsigned Int	4
Page N size	BE	Unsigned Int	4	Repeat for N pages
Page N			Page N size	Page N content
Checksum	BE	Unsigned Int	4	Sum every 4th byte for each page
Footer	BE		8	0x071720050000004b
Metadata		Binary Property List		Contains NSHTTPCookieAcceptPolicy value

Page

Field	Endianness	Type	Size	Description
Header	BE		4	0x00000100
Number of cookies	LE	Unsigned Int	4
Cookie N offset	LE	Unsigned Int	4	Repeat for N cookies
Footer			4	0x00000000
Cookie N			Cookie N size	Cookie N content

Cookie

Field	Endianness	Type	Size	Description
Size	LE	Unsigned Int	4	Size in bytes
Version	LE	Unsigned Int	4	0 or 1
Flags	LE	Bit field	4	isSecure = 1, isHTTPOnly = 1 << 2, unknown1 = 1 << 3, unknown2 = 1 << 4
Has port	LE	Unsigned Int	4	0 or 1
URL Offset	LE	Unsigned Int	4	Offset from the start of the cookie
Name Offset	LE	Unsigned Int	4	Offset from the start of the cookie
Path Offset	LE	Unsigned Int	4	Offset from the start of the cookie
Value Offset	LE	Unsigned Int	4	Offset from the start of the cookie
Comment Offset	LE	Unsigned Int	4	Offset from the start of the cookie, 0x00000000 if not present
Comment URL Offset	LE	Unsigned Int	4	Offset from the start of the cookie, 0x00000000 if not present
Expiration	LE	Double	8	Number of seconds since 00:00:00 UTC on 1 January 2001
Creation	LE	Double	8	Number of seconds since 00:00:00 UTC on 1 January 2001
Port	LE	Unsigned Int	2	Only present if the "Has port" field is 1
Comment	LE	String		Null-terminated, optional
Comment URL	LE	String		Null-terminated, optional
URL	LE	String		Null-terminated
Name	LE	String		Null-terminated
Path	LE	String		Null-terminated
Value	LE	String		Null-terminated