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, 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, 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/pesos/browser-history if you have any issues or want to help contribute