Skip to main content

Recursive archive extractor with password detection

Project description

๐Ÿ” Recursive Archive Extractor

 โ–„โ–„โ–„ โ–—โ–žโ–€โ–šโ––โ–—โ–žโ–€โ–˜โ–ˆ  โ–โ–Œ โ–„โ–„โ–„ โ–„โ–„โ–„ โ–„ โ–„   โ–„ โ–—โ––  โ–—โ––
โ–ˆ    โ–โ–›โ–€โ–€โ–˜โ–โ–šโ–„โ––โ–€โ–„โ–„โ–žโ–˜โ–ˆ   โ–€โ–„โ–„  โ–„ โ–ˆ   โ–ˆ  โ–โ–šโ–žโ–˜ 
โ–ˆ    โ–โ–šโ–„โ–„โ––         โ–ˆ   โ–„โ–„โ–„โ–€ โ–ˆ  โ–€โ–„โ–€    โ–โ–Œ  
                            โ–ˆ       โ–—โ–žโ–˜โ–โ–šโ––

A powerful Python tool that recursively extracts nested archive files, logs password-protected ZIPs, and handles multiple compression formats with style.


๐Ÿ“ฆ Supported Formats

  • .zip (with password detection)
  • .xz
  • .bz2
  • .gz
  • .tar

๐Ÿš€ Features

  • ๐Ÿ“‚ Recursively unpacks deeply nested archive layers.
  • ๐Ÿง  Auto-detects archive types based on file headers.
  • ๐Ÿ›ก๏ธ Detects and logs password-protected ZIPs.
  • ๐Ÿชต Writes extraction logs per layer.
  • ๐Ÿ“ Copies final locked ZIP layer for further analysis.
  • ๐Ÿ–ผ๏ธ Clean structure and modular design.

๐Ÿ› ๏ธ Installation

git clone https://github.com/Paul00/recursivX.git
cd recursivX
python3 -m venv venv
source venv/bin/activate
pip install -r requirements.txt  # Currently, no third-party modules required

๐Ÿงช Usage

python recursivX.py input_archive.ext -o output_folder

Example:

python recursivX.py sample.zip -o unpacked_layers

๐Ÿ“ Output Structure

extracted/
โ”œโ”€โ”€ layer_1/
โ”‚   โ””โ”€โ”€ ...
โ”œโ”€โ”€ layer_2/
โ”‚   โ””โ”€โ”€ ...
โ”œโ”€โ”€ final_locked_layer.zip  โ† If password-protected
โ””โ”€โ”€ extraction_log.txt      โ† Full extraction log

๐Ÿ““ Log Format

Each extraction layer is logged with detected archive type and filename. If password protection is found, you'll see:

[Layer 3] sample_protected.zip requires password
  โ†’ Encapsulated files: secret.txt, data.json

๐Ÿ™ Credits

Crafted with care by Paul00


๐Ÿ“œ License

MIT License โ€“ do whatever you want, just donโ€™t claim you wrote it ๐Ÿ˜‰

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

recursivx-1.0.1.tar.gz (5.1 kB view details)

Uploaded Source

Built Distribution

recursivx-1.0.1-py3-none-any.whl (5.9 kB view details)

Uploaded Python 3

File details

Details for the file recursivx-1.0.1.tar.gz.

File metadata

  • Download URL: recursivx-1.0.1.tar.gz
  • Upload date:
  • Size: 5.1 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.12.8

File hashes

Hashes for recursivx-1.0.1.tar.gz
Algorithm Hash digest
SHA256 4d7502b5062a0628f6c16503bb5273841eef0910ea3aba651686670f0fa30eab
MD5 c164c6ee85705a73b5f0ad9b1b3e1e81
BLAKE2b-256 8070b4cf72f3e14b4ca17e18a30c379cbfafb3114fe7e678b26d78705f633422

See more details on using hashes here.

File details

Details for the file recursivx-1.0.1-py3-none-any.whl.

File metadata

  • Download URL: recursivx-1.0.1-py3-none-any.whl
  • Upload date:
  • Size: 5.9 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.12.8

File hashes

Hashes for recursivx-1.0.1-py3-none-any.whl
Algorithm Hash digest
SHA256 c3643d882f89d4ccc37f572d72fd57491ef96b366e16f01584438aa6bee08ed2
MD5 2e49b159dd90f7bec51a2a9f29f9196b
BLAKE2b-256 ad8ad1b21335c14e9bca05ee465a83fb377207668d3325261d32741b8cf85601

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page