Extract and display cookies from macOS browsers.
Decrypts Chrome's macOS Keychain entries and parses Safari's binary cookie store.
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 exact domain (
x.commatches.x.com, notapi.x.comordropbox.com). - 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
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.
1 maintainer
Metadata
1 maintainer
Release files for cookietuner 0.2.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| cookietuner-0.2.0.tar.gz | 8.4 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| cookietuner-0.2.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 19.3 kB
