Skip to content

A simple, zero-dependencies, developer-friendly Python package to retrieve web browser history

License

Notifications You must be signed in to change notification settings

uditphoolwani/browser-history

 
 

Repository files navigation

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")

About

A simple, zero-dependencies, developer-friendly Python package to retrieve web browser history

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Python 100.0%