Command Line Interface

This package provides a command line tool named browser-history that is automatically added to path when installed through pip.

Help page for the CLI is given below. It can also be accessed using browser-history --help.

CLI Help Page

A tool to retrieve history from (almost) any browser on (almost) any platform

██████╗ ██████╗ ██████╗ ██╗ ██╗███████╗███████╗██████╗ ██╗ ██╗██╗███████╗████████╗ ██████╗ ██████╗ ██╗ ██╗ ██╔══██╗██╔══██╗██╔═══██╗██║ ██║██╔════╝██╔════╝██╔══██╗ ██║ ██║██║██╔════╝╚══██╔══╝██╔═══██╗██╔══██╗╚██╗ ██╔╝ ██████╔╝██████╔╝██║ ██║██║ █╗ ██║███████╗█████╗ ██████╔╝█████╗███████║██║███████╗ ██║ ██║ ██║██████╔╝ ╚████╔╝ ██╔══██╗██╔══██╗██║ ██║██║███╗██║╚════██║██╔══╝ ██╔══██╗╚════╝██╔══██║██║╚════██║ ██║ ██║ ██║██╔══██╗ ╚██╔╝ ██████╔╝██║ ██║╚██████╔╝╚███╔███╔╝███████║███████╗██║ ██║ ██║ ██║██║███████║ ██║ ╚██████╔╝██║ ██║ ██║ ╚═════╝ ╚═╝ ╚═╝ ╚═════╝ ╚══╝╚══╝ ╚══════╝╚══════╝╚═╝ ╚═╝ ╚═╝ ╚═╝╚═╝╚══════╝ ╚═╝ ╚═════╝ ╚═╝ ╚═╝ ╚═╝

usage: browser-history [-h] [-t TYPE] [-b BROWSER] [-f FORMAT] [-o OUTPUT]
                       [-p PROFILE] [--show-profiles BROWSER] [-v]

Named Arguments

-t, --type

argument to decide whether to retrieve history or bookmarks. Should be one of history, bookmarks. Default is history.

Default: “history”

-b, --browser

browser to retrieve history or bookmarks from. Should be one of all, default, Chromium, Chrome, Edge, Opera, OperaGX, Brave, Vivaldi, Epic, Firefox, LibreWolf, Safari. Default is all (gets history or bookmarks from all browsers).

Default: “all”

-f, --format

Format to be used in output. Should be one of csv, json, jsonl. Default is infer (format is inferred from the output file’s extension. If no output file (-o) is specified, it defaults to csv)

Default: “infer”

-o, --output

File where history output or bookmark output is to be written. If not provided, standard output is used.

-p, --profile

Specify the profile from which to fetch history or bookmarks. If not provided all profiles are fetched

--show-profiles

List all available profiles for a given browser where browser can be one of default, Chromium, Chrome, Edge, Opera, OperaGX, Brave, Vivaldi, Epic, Firefox, LibreWolf, Safari. The browser must always be provided.

-v, --version

show program’s version number and exit

Checkout the GitHub repo https://github.com/browser-history/browser-history if you have any issues or want to help contribute