# History Exporter
## 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": null,
"docs_url": null,
"requires_python": ">=3.7",
"maintainer_email": null,
"keywords": "history, browser, chromium, export, downloads, URLs",
"author": "Mario Nascimento",
"author_email": "mario@whitehathacking.tech",
"download_url": null,
"platform": null,
"description": "# History Exporter\n\n\n\n\n\n## Table of Contents\n\n- [Introduction](#introduction)\n- [Prerequisites](#prerequisites)\n- [Installation](#installation)\n- [Usage](#usage)\n - [Command Line Interface](#command-line-interface)\n- [Data Extraction](#data-extraction)\n- [Output Formats](#output-formats)\n- [Logging](#logging)\n- [License](#license)\n\n## Introduction\n\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.\n\n## Prerequisites\n\n- Python 3.7+\n\n## Installation\n\n### Method 1: Using pip\n\nYou can install `histexport` directly using pip:\n ```\n pip install histexport\n ``` \n\n### Method 2: From GitHub Repository\n\n1. Clone the GitHub repository.\n ```\n git clone https://github.com/darkarp/histexport.git\n ```\n2. Navigate to the project directory.\n ```\n cd histexport\n ```\n3. Install the required Python packages.\n ```\n pip install -e .\n ``` \n\nEither of these methods will install the required Python packages and make `histexport` available for use.\n\n## Usage\n\n### Command Line Interface\n\n1. Basic extraction of URLs and Downloads in `txt`:\n ```\n histexport -i path/to/history/history_file -o output_file\n ```\n\n2. Specify output directory and formats:\n ```\n histexport -i path/to/history/history_file -o output_file -d path/to/output -f csv xlsx\n ```\n\n3. Enable logging (`-l`):\n ```\n histexport -i path/to/history/history_file -o output_file -l\n ``` \n\n4. Extract from a folder of SQLite files:\n ```\n histexport -i path/to/history_folder -t folder -o output_file -d path/to/output -f csv xlsx -e urls downloads\n ```\n\n#### Arguments\n\n- `-i`, `--input`: Path to the SQLite history file. (required)\n- `-t`, `--type`: Type of the input: file or folder. Default is file\n- `-o`, `--output`: Base name for output files. (required)\n- `-d`, `--dir`: Output directory. (optional, default is `./`)\n- `-f`, `--formats`: Output formats (csv, xlsx, txt). (optional, default is `txt`)\n- `-e`, `--extract`: Data to extract (urls, downloads). (optional, default is both)\n- `-l`, `--log`: Enable logging. (optional, default is disabled. \n - `-l 1`: CRITICAL\n - `-l 2`: ERROR\n - `-l 3`: WARNING\n - `-l 4`: INFO\n - `-l 5`: DEBUG\n- `-v`, `--version`: Show version.\n\n## Data Extraction\n\nThe tool allows extraction of:\n\n- URLs: Fetches `URL`, `Title`, `Visit_Count`, and `Last_Visit_Time`.\n- Downloads: Extracts `Target_Path`, `Start_Time`, `End_Time`, `Total_Bytes`, `Received_Bytes`, and `URL`.\n\n## Output Formats\n\nYou can export the data into:\n\n- CSV\n- XLSX (Excel)\n- TXT (Pretty printed text file)\n\n## License\n\nThis project is licensed under the MIT License - see the [LICENSE.md](LICENSE) file for details.\n\n\n\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "A Python utility to export Chromium-based browser history and downloads to various formats.",
"version": "0.3.0",
"project_urls": {
"Homepage": "https://github.com/darkarp/histexport"
},
"split_keywords": [
"history",
" browser",
" chromium",
" export",
" downloads",
" urls"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "4be593b13f8cab5b3c8dabc52f196af278bdfbab0d012848778b9754269c0ae2",
"md5": "6ac5949d47e8da388d56ffcc407e55dd",
"sha256": "7fd8268d8a76d83648ba25845fc4dec40446ed07523fbb5117b3e714736c1135"
},
"downloads": -1,
"filename": "histexport-0.3.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "6ac5949d47e8da388d56ffcc407e55dd",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.7",
"size": 7953,
"upload_time": "2024-10-22T10:15:10",
"upload_time_iso_8601": "2024-10-22T10:15:10.788588Z",
"url": "https://files.pythonhosted.org/packages/4b/e5/93b13f8cab5b3c8dabc52f196af278bdfbab0d012848778b9754269c0ae2/histexport-0.3.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-10-22 10:15:10",
"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"
}
JSON
