pm4py.algo.connectors.variants.chrome_history module#

PM4Py – A Process Mining Library for Python Copyright (C) 2026 Process Intelligence Solutions GmbH

This program is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License as published by the Free Software Foundation, either version 3 of the License, or any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Affero General Public License for more details.

You should have received a copy of the GNU Affero General Public License along with this program. If not, see this software project’s root or visit <https://www.gnu.org/licenses/>.

Website: https://processintelligence.solutions Contact: info@processintelligence.solutions

class pm4py.algo.connectors.variants.chrome_history.Parameters(*values)[source]#

Bases: Enum

HISTORY_DB_PATH = 'history_db_path'#
pm4py.algo.connectors.variants.chrome_history.apply(parameters: Dict[Any, str] | None = None) → DataFrame[source]#

Extract a dataframe containing the navigation history of Google Chrome.

Event log semantics#

  • CASE ID (case:concept:name) browser profile name (e.g. “Profile 1”)

  • ACTIVITY (concept:name) full path of the visited page (“example.com/path”), without query parameters

  • TIMESTAMP (time:timestamp) local timestamp of the visit (start of the page view)

Additional attributes#

  • title page title as recorded by Chrome (empty if unavailable)

  • visit_duration seconds spent on the page (0 if unknown / Chrome <93)

  • transition human‑readable page transition (LINK, TYPED, …)

  • typed_count how many times the user manually typed this URL

  • visit_count how many total visits Chrome knows for this URL

  • referrer URL of the from_visit (previous page) if available

Parameters:

Parameters.HISTORY_DB_PATH (str, optional) – Path to the folder that contains the Chrome profile directories or to a single History SQLite file. Defaults to the standard Windows path of the current user (%LOCALAPPDATA%\Google\Chrome\User Data).

returns:

PM4Py‑compatible event log where each row is a page visit.

rtype:

pd.DataFrame