Skip to content

alltuner/cookietuner

Repository files navigation

cookietuner

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

GitHub · Sponsor

PyPI License Stars


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.

About

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

Topics

Resources

License

Code of conduct

Security policy

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages