https://github.com/bengabay11/chpass

Gather information from Chrome 🔑
https://github.com/bengabay11/chpass

chrome passwords python recon

Last synced: 11 days ago
JSON representation

Gather information from Chrome 🔑

• Host: GitHub
• URL: https://github.com/bengabay11/chpass
• Owner: bengabay11
• License: mit
• Created: 2020-06-04T16:43:56.000Z (over 4 years ago)
• Default Branch: master
• Last Pushed: 2024-01-22T08:43:05.000Z (12 months ago)
• Last Synced: 2024-12-12T02:40:03.737Z (26 days ago)
• Topics: chrome, passwords, python, recon
• Language: Python
• Homepage: https://pypi.org/project/chpass/
• Size: 320 KB
• Stars: 0
• Watchers: 1
• Forks: 0
• Open Issues: 22
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# chpass

Gather information from Chrome 🔑

[![Unit Tests](https://github.com/bengabay11/chpass/actions/workflows/unit-tests.yml/badge.svg)](https://github.com/bengabay11/chpass/actions/workflows/unit-tests.yml)

[![Integration Tests](https://github.com/bengabay11/chpass/actions/workflows/integration-tests.yml/badge.svg)](https://github.com/bengabay11/chpass/actions/workflows/integration-tests.yml)

[![python](https://img.shields.io/badge/python-3.7%20%7C%203.8%20%7C%203.9%20%7C%203.10%20%7C%203.11-blue)](https://pypi.org/project/chpass/)

## Features

- import/export passwords

- history

- google account profile picture

- downloads

- top visited sites

## Installing

```console

$ pip install chpass

```

## Usage

```console

usage: chpass [-h] [-u USER] [-i FILE_ADAPTER] {import,export} ...

```

> Chrome must be closed during the whole process, because its database is locked while running.

### Export

```console

usage: chpass export [-h] [-d DESTINATION_FOLDER] {passwords,history,downloads,top_sites,profile_pic} ...

```

### Import

```console

usage: chpass import [-h] -f FROM_FILE

```

> In order to import the passwords successfully, Chrome must be restarted after the import to load the passwords from the database.

## File adapters

`chpass` support read/write functionality with `csv` and `json`.

the default export and import is done with `csv`.

you can change the file adapter with the flag:

```console

$ chpass -i json export

```

## License

This project is licensed under the terms of the MIT license.