Metadata-Version: 2.1
Name: tt7zcrack
Version: 0.2.0
Summary: Fast 7zip crack assistant tool which support GPU/CPU.
Home-page: https://github.com/tp7309/tt7zcrack
Author: tp7309
Author-email: yiyou7309@gmail.com
License: Apache License Version 2.0
Keywords: 7z 7zip password crack hashcat jtr john gpu
Classifier: Programming Language :: Python :: 3
Requires-Python: >=3.5
Description-Content-Type: text/markdown
License-File: LICENSE

# tt7zcrack

[![build](https://github.com/tp7309/tt7zcrack/actions/workflows/build.yaml/badge.svg)](https://github.com/tp7309/tt7zcrack/actions/workflows/build.yaml)
[![codecov](https://codecov.io/gh/tp7309/tt7zcrack/branch/master/graph/badge.svg?token=lyEWTqfeb9)](https://codecov.io/gh/tp7309/tt7zcrack)
<!-- [![DeepSource](https://deepsource.io/gh/tp7309/tt7zcrack.svg/?label=active+issues&show_trend=true)](https://deepsource.io/gh/tp7309/tt7zcrack/?ref=repository-badge) -->

README i18n: [中文说明](https://github.com/tp7309/tt7zcrack/blob/master/README_zh_CN.md)

Fast 7zip crack assistant tool which support GPU/CPU.

# Requirements

Python 3.5 or later.
[python install](https://docs.python-guide.org/starting/install3/osx/)

# Install

`tt7zcrack` can be easily installed using pip:

```
pip install tt7zcrack
```

# Quick Start

## Mac

Make sure [brew](https://brew.sh/index_zh-cn) is installed.

Create **pwds.txt** to store possible passwords, one password occupies one line. you can also use [TTPassGen](https://github.com/tp7309/TTPassGen) to generate a large amount of passwords.

```bash
# use passwords from pwds.txt to crack file
tt7zcrack --wordlist pwds.txt crack.7z
```

When the crack is complete, password will be shown like this:
![image](https://github.com/tp7309/tt7zcrack/blob/master/asserts/result.png)

## Linux/Windows

Currently not supported.

# Usage

```bash
tt7zcrack --help
usage: tt7zcrack.py [-h] [--wordlist [WORDLIST]] [--engine {hashcat,jtr}] [--clean] [file]

7z GPU/CPU crack tool

positional arguments:
  file                  7z file path (default: None)

optional arguments:
  -h, --help            show this help message and exit
  --wordlist [WORDLIST]
                        wordlist dict path, you can use 'ttpaasgen' to
                        generate. (default: )
  --engine {hashcat,jtr}
                        password recovery engine (default: hashcat)
  --clean               clean related secure files (default: False)
```

**if the hash file cannot generated correctly, you can use `jtr` engine to try again.**

The cracked password will be saved locally by the password cracking tool for next query. Use the following command to delete it. Note that this will delete all cracked results!

```bash
tt7zcrack --clean
```

# 7z commands

```bash
# install 7z on Mac
brew install p7zip

# compress with password
7z a -p456 test.7z test.txt
# extract with password
7z x -p456 test.7z

# compress without password
7z a test.7z test.txt
# extract without password
7z x test.7z
```

# Thanks

[7zhashcat](https://github.com/philsmd/7z2hashcat)
