Skip to content

Installation

The easiest way to run cookietuner is with uv:

uvx cookietuner

This downloads and runs cookietuner in an isolated environment without installing it permanently.

Permanent installation

To install cookietuner as a tool:

uv tool install cookietuner

Then run it directly:

cookietuner cookies -b chrome

From source

# Clone the repository
git clone https://github.com/alltuner/cookietuner.git
cd cookietuner

# Install dependencies
uv sync

# Run the CLI
uv run cookietuner

Requirements

macOS only

cookietuner only works on macOS. It reads browser cookie databases that are specific to macOS file paths and encryption methods.

  • macOS
  • Python 3.14+
  • Chrome and/or Safari browser installed