cookietuner 0.1.4

Extract and display cookies from macOS browsers (Chrome, Safari)

Extract and display cookies from macOS browsers.
Decrypts Chrome's macOS Keychain entries and parses Safari's binary cookie store.

GitHub · Sponsor

---

Get Started

Run without installing:

uvx cookietuner

Or install permanently:

uv tool install cookietuner

---

What is cookietuner?

A command-line tool that reads cookies straight from your local macOS browser stores. It decrypts Chrome's encrypted cookie database via the macOS Keychain (Chrome 130+ format) and parses Safari's binary Cookies.binarycookies file directly. No browser automation, no extensions.

Features

• Chrome support — decrypts cookies using macOS Keychain, Chrome 130+ format.
• Safari support — parses the binary cookies format with SameSite detection.
• Multiple output formats — table, short, line, and JSON.
• Domain filtering — filter by partial domain match.
• Profile selection — choose which browser profile to read from.
• Cookie metadata — expiration, Secure, HttpOnly, and SameSite flags.

Usage

List cookies

# Chrome cookies (browser flag is required)
cookietuner cookies -b chrome

# Safari cookies
cookietuner cookies -b safari

# Filter by domain
cookietuner cookies -b chrome -d google.com

# Pick a Chrome profile
cookietuner cookies -b chrome -p "Profile 1"

Output formats

Format	Flag	Use case
Full table (default)	-o table	Browsing all cookie details
Short table	-o short	Just domain, name, value
Line	-o line	Space-separated, for shell scripting
JSON	-o json	Piping into jq or another tool

List browser profiles

# All profiles
cookietuner profiles

# Filter by browser
cookietuner profiles -b chrome

Requirements

• macOS (the tool reads macOS-specific cookie stores).
• Python 3.14+.
• Chrome and/or Safari.

Development

git clone https://github.com/alltuner/cookietuner.git
cd cookietuner
uv sync
uv run pytest
uv run cookietuner

License

MIT

Support the project

cookietuner is an open source project built by David Poblador i Garcia through All Tuner Labs.

If this project was useful to you, consider supporting its development.

---

Built by David Poblador i Garcia with the support of All Tuner Labs.
Made with ❤️ in Poblenou, Barcelona.