# History Exporter
![Build Status](https://img.shields.io/badge/build-passing-green)
![GitHub release](https://img.shields.io/github/release/darkarp/histexport.svg)
![License](https://img.shields.io/github/license/darkarp/histexport.svg)
## Table of Contents
- [Introduction](#introduction)
- [Prerequisites](#prerequisites)
- [Installation](#installation)
- [Usage](#usage)
- [Command Line Interface](#command-line-interface)
- [Data Extraction](#data-extraction)
- [Output Formats](#output-formats)
- [Logging](#logging)
- [License](#license)
## Introduction
HistoryExtractor is a Python utility aimed at exporting Chromium-based browser history and downloads data to various formats such as CSV, XLSX, and TXT. Designed with a focus on user flexibility, this tool provides customizable extraction options to suit different needs.
## Prerequisites
- Python 3.7+
## Installation
### Method 1: Using pip
You can install `histexport` directly using pip:
```
pip install histexport
```
### Method 2: From GitHub Repository
1. Clone the GitHub repository.
```
git clone https://github.com/darkarp/histexport.git
```
2. Navigate to the project directory.
```
cd histexport
```
3. Install the required Python packages.
```
pip install -e .
```
Either of these methods will install the required Python packages and make `histexport` available for use.
## Usage
### Command Line Interface
1. Basic extraction of URLs and Downloads in `txt`:
```
histexport -i path/to/history/history_file -o output_file
```
2. Specify output directory and formats:
```
histexport -i path/to/history/history_file -o output_file -d path/to/output -f csv xlsx
```
3. Enable logging (`-l`):
```
histexport -i path/to/history/history_file -o output_file -l
```
4. Extract from a folder of SQLite files:
```
histexport -i path/to/history_folder -t folder -o output_file -d path/to/output -f csv xlsx -e urls downloads
```
#### Arguments
- `-i`, `--input`: Path to the SQLite history file. (required)
- `-t`, `--type`: Type of the input: file or folder. Default is file
- `-o`, `--output`: Base name for output files. (required)
- `-d`, `--dir`: Output directory. (optional, default is `./`)
- `-f`, `--formats`: Output formats (csv, xlsx, txt). (optional, default is `txt`)
- `-e`, `--extract`: Data to extract (urls, downloads). (optional, default is both)
- `-l`, `--log`: Enable logging. (optional, default is disabled.
- `-l 1`: CRITICAL
- `-l 2`: ERROR
- `-l 3`: WARNING
- `-l 4`: INFO
- `-l 5`: DEBUG
- `-v`, `--version`: Show version.
## Data Extraction
The tool allows extraction of:
- URLs: Fetches `URL`, `Title`, `Visit_Count`, and `Last_Visit_Time`.
- Downloads: Extracts `Target_Path`, `Start_Time`, `End_Time`, `Total_Bytes`, `Received_Bytes`, and `URL`.
## Output Formats
You can export the data into:
- CSV
- XLSX (Excel)
- TXT (Pretty printed text file)
## License
This project is licensed under the MIT License - see the [LICENSE.md](LICENSE) file for details.
Raw data
{
"_id": null,
"home_page": "https://github.com/darkarp/histexport",
"name": "histexport",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.7",
"maintainer_email": "",
"keywords": "history,browser,chromium,export,downloads,URLs",
"author": "Mario Nascimento",
"author_email": "mario@whitehathacking.tech",
"download_url": "https://files.pythonhosted.org/packages/91/38/d8625561a54c78acaf7e5bac69e2fcfd2071e8fb04f409255daeb494651d/histexport-0.2.9.tar.gz",
"platform": null,
"description": "# History Exporter\r\n\r\n![Build Status](https://img.shields.io/badge/build-passing-green)\r\n![GitHub release](https://img.shields.io/github/release/darkarp/histexport.svg)\r\n![License](https://img.shields.io/github/license/darkarp/histexport.svg)\r\n\r\n## Table of Contents\r\n\r\n- [Introduction](#introduction)\r\n- [Prerequisites](#prerequisites)\r\n- [Installation](#installation)\r\n- [Usage](#usage)\r\n - [Command Line Interface](#command-line-interface)\r\n- [Data Extraction](#data-extraction)\r\n- [Output Formats](#output-formats)\r\n- [Logging](#logging)\r\n- [License](#license)\r\n\r\n## Introduction\r\n\r\nHistoryExtractor is a Python utility aimed at exporting Chromium-based browser history and downloads data to various formats such as CSV, XLSX, and TXT. Designed with a focus on user flexibility, this tool provides customizable extraction options to suit different needs.\r\n\r\n## Prerequisites\r\n\r\n- Python 3.7+\r\n\r\n## Installation\r\n\r\n### Method 1: Using pip\r\n\r\nYou can install `histexport` directly using pip:\r\n ```\r\n pip install histexport\r\n ``` \r\n\r\n### Method 2: From GitHub Repository\r\n\r\n1. Clone the GitHub repository.\r\n ```\r\n git clone https://github.com/darkarp/histexport.git\r\n ```\r\n2. Navigate to the project directory.\r\n ```\r\n cd histexport\r\n ```\r\n3. Install the required Python packages.\r\n ```\r\n pip install -e .\r\n ``` \r\n\r\nEither of these methods will install the required Python packages and make `histexport` available for use.\r\n\r\n## Usage\r\n\r\n### Command Line Interface\r\n\r\n1. Basic extraction of URLs and Downloads in `txt`:\r\n ```\r\n histexport -i path/to/history/history_file -o output_file\r\n ```\r\n\r\n2. Specify output directory and formats:\r\n ```\r\n histexport -i path/to/history/history_file -o output_file -d path/to/output -f csv xlsx\r\n ```\r\n\r\n3. Enable logging (`-l`):\r\n ```\r\n histexport -i path/to/history/history_file -o output_file -l\r\n ``` \r\n\r\n4. Extract from a folder of SQLite files:\r\n ```\r\n histexport -i path/to/history_folder -t folder -o output_file -d path/to/output -f csv xlsx -e urls downloads\r\n ```\r\n\r\n#### Arguments\r\n\r\n- `-i`, `--input`: Path to the SQLite history file. (required)\r\n- `-t`, `--type`: Type of the input: file or folder. Default is file\r\n- `-o`, `--output`: Base name for output files. (required)\r\n- `-d`, `--dir`: Output directory. (optional, default is `./`)\r\n- `-f`, `--formats`: Output formats (csv, xlsx, txt). (optional, default is `txt`)\r\n- `-e`, `--extract`: Data to extract (urls, downloads). (optional, default is both)\r\n- `-l`, `--log`: Enable logging. (optional, default is disabled. \r\n - `-l 1`: CRITICAL\r\n - `-l 2`: ERROR\r\n - `-l 3`: WARNING\r\n - `-l 4`: INFO\r\n - `-l 5`: DEBUG\r\n- `-v`, `--version`: Show version.\r\n\r\n## Data Extraction\r\n\r\nThe tool allows extraction of:\r\n\r\n- URLs: Fetches `URL`, `Title`, `Visit_Count`, and `Last_Visit_Time`.\r\n- Downloads: Extracts `Target_Path`, `Start_Time`, `End_Time`, `Total_Bytes`, `Received_Bytes`, and `URL`.\r\n\r\n## Output Formats\r\n\r\nYou can export the data into:\r\n\r\n- CSV\r\n- XLSX (Excel)\r\n- TXT (Pretty printed text file)\r\n\r\n## License\r\n\r\nThis project is licensed under the MIT License - see the [LICENSE.md](LICENSE) file for details.\r\n\r\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "A Python utility to export Chromium-based browser history and downloads to various formats.",
"version": "0.2.9",
"project_urls": {
"Homepage": "https://github.com/darkarp/histexport"
},
"split_keywords": [
"history",
"browser",
"chromium",
"export",
"downloads",
"urls"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "134d306a0896bd2d2b98efc31c2c7f39935cb0c2f484b6336153ee8edc50547b",
"md5": "70e46d918c30caa59e13d97c1629e753",
"sha256": "c62bfc7825f796c97213ddb205e3d069b1a65746181248ede3bf929372c6ac7e"
},
"downloads": -1,
"filename": "histexport-0.2.9-py3-none-any.whl",
"has_sig": false,
"md5_digest": "70e46d918c30caa59e13d97c1629e753",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.7",
"size": 7968,
"upload_time": "2023-09-13T23:55:50",
"upload_time_iso_8601": "2023-09-13T23:55:50.619461Z",
"url": "https://files.pythonhosted.org/packages/13/4d/306a0896bd2d2b98efc31c2c7f39935cb0c2f484b6336153ee8edc50547b/histexport-0.2.9-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "9138d8625561a54c78acaf7e5bac69e2fcfd2071e8fb04f409255daeb494651d",
"md5": "69e7fdb9eb7a25c51db76a7fe62f9edf",
"sha256": "faa5940bd7433090dbd5eba8b78c30a8a2657d9c169d56ec126bfd5f16e833e7"
},
"downloads": -1,
"filename": "histexport-0.2.9.tar.gz",
"has_sig": false,
"md5_digest": "69e7fdb9eb7a25c51db76a7fe62f9edf",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.7",
"size": 7629,
"upload_time": "2023-09-13T23:55:52",
"upload_time_iso_8601": "2023-09-13T23:55:52.945286Z",
"url": "https://files.pythonhosted.org/packages/91/38/d8625561a54c78acaf7e5bac69e2fcfd2071e8fb04f409255daeb494651d/histexport-0.2.9.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-09-13 23:55:52",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "darkarp",
"github_project": "histexport",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"requirements": [],
"lcname": "histexport"
}