A C++17 command-line compression tool with an archive browser TUI.

English | 简体中文

• Detects archive formats by file signature instead of filename extension.
• Uses one command for compression, extraction, verification, and archive browsing.
• Includes a TUI archive browser for listing, searching, previewing, extracting, and editing archive entries.
• Supports tar, gzip, bzip2, xz, zip, 7z, rar, lz4, zstd, and xar.
• Supports password-protected zip, 7z, and rar extraction where the underlying tool supports it.
• Uses FTXUI for the terminal interface; a vendored static FTXUI copy is included.

# Ubuntu/Debian runtime and build dependencies
sudo apt install -y tar unrar gzip bzip2 xz-utils zip unzip p7zip-full lz4 zstd g++ cmake make

git clone https://github.com/Hitmux/hitpag.git
cd hitpag
mkdir -p build
cd build
cmake ..
make
sudo make install

FTXUI is resolved during CMake configuration. hitpag prefers a compatible system static FTXUI package and falls back to third_party/ftxui/.

cmake .. -DHITPAG_FORCE_VENDORED_FTXUI=ON
cmake .. -DHITPAG_FORCE_SYSTEM_FTXUI=ON

Open an archive directly in the TUI:

hitpag --tui archive.zip
hitpag archive.tar.gz

When a single supported archive path is provided without a target path, hitpag opens the TUI automatically.

Core TUI actions:

• Up / Down: move through entries.
• Right / Enter: open a directory or move into preview.
• Left: return to the parent directory or file list.
• /: search entries.
• x: extract the selected entry.
• e: edit the selected file through an external editor.
• s: configure the editor command.
• ?: open help.
• q or Esc: quit or close the current dialog.

# Extract
hitpag archive.tar.gz ./output/
hitpag backup.zip ./extracted/
hitpag data.7z ./data/

# Compress
hitpag ./my_folder/ backup.zip
hitpag ./documents/ archive.tar.gz

# Password
hitpag -pMySecret secure.7z ./sensitive/
hitpag -p encrypted.zip ./output/

# Performance and verification
hitpag -l9 -t8 --benchmark data.tar.xz ./large_files/
hitpag --verify ./documents/ archive.zip

hitpag --include='*.cpp' --include='*.h' code.7z ./project/
hitpag --exclude='*.tmp' --exclude='node_modules/*' clean.tar.gz ./project/

• Issues
• Pull Requests

GNU Affero General Public License v3.0

Developer: Hitmux