Skip to content

README.md

Latest commit

 

History

History
36 lines (27 loc) · 1.29 KB

README.md

File metadata and controls

36 lines (27 loc) · 1.29 KB
Raw

uni-extract (ext)

A robust universal archive extractor for zsh that focuses on safety, predictability, and clean extraction.

Unlike simple case *.zip aliases, ext is designed to handle real-world archives:

  • Path traversal protection
  • Clean output directories
  • Collision-free extraction
  • Fallback detection for wrong or missing file extensions
  • No cd hacks, no side effects

Features

  • Supports: tar, tar.gz, tar.xz, tar.zst, zip, 7z, rar, gz, bz2, xz, zst
  • Detects archive type even with incorrect or missing extensions (file fallback)
  • Path traversal (Zip-Slip) protection — blocks ../ and absolute paths
  • Automatically extracts into a dedicated directory
  • Collision-safe output (foo, foo_2, foo_3, …)
  • Optional flags:
    • --list → show archive contents without extracting
    • --no-dir → extract into the current directory
    • --flat → flatten directory structure (zip clean, 7z best-effort)
    • --force → reuse existing output directory
  • No global shell side effects (emulate -L zsh)
  • Clear error handling and exit codes

Installation

curl -fsSL https://raw.githubusercontent.com/gitclonexx/uni-extract/main/ext.zsh -o ~/.zsh/ext.zsh
echo 'source ~/.zsh/ext.zsh' >> ~/.zshrc