Skip to content

Latest commit

 

History

History
87 lines (59 loc) · 2.97 KB

README.md

File metadata and controls

87 lines (59 loc) · 2.97 KB

browser-history

tests Documentation Status PyPI version codecov Code style: black Maintainability

browser-history is a simple, zero-dependencies, developer-friendly python package to retrieve (almost) any browser's history on (almost) any platform.

Features

  • Supports most popular browsers. See this for a full list.
  • Supports all major platforms - Windows, Mac and Linux.
  • A command-line tool: simply run browser-history --help from your terminal.
  • History: browsing history with exact timestamp and URL.
  • Bookmarks: browser bookmarks with timestamp, URL, title and folder.
  • Developer friendly: you can add support for new browsers or add a new feature very easily.
  • Fully open source: this project is developed by PES Open Source and will always be open source, with the Apache License.

Quick Start

Installation

pip install browser-history

Usage

History

To get history from all installed browsers:

from browser_history import get_history

outputs = get_history()

# his is a list of (datetime.datetime, url) tuples
his = outputs.histories

If you want history from a specific browser:

from browser_history.browsers import Firefox

f = Firefox()
outputs = f.fetch_history()

# his is a list of (datetime.datetime, url) tuples
his = outputs.histories

Bookmarks

To get bookmarks from all installed browsers:

from browser_history import get_bookmarks

outputs = get_bookmarks()

# bms is a list of (datetime.datetime, url, title, folder) tuples
bms = outputs.bookmarks

To get bookmarks from a specific browser:

from browser_history.browsers import Firefox

f = Firefox()
outputs = f.fetch_bookmarks()

# bms is a list of (datetime.datetime, url, title, folder) tuples
bms = outputs.bookmarks

Check out the documentation for more details.

Supported Browsers

Read the documentation

License

Licensed under the Apache License, Version 2.0 (the "License")