Skip to content

unixatch/tui-7z-archive-manager

Repository files navigation

TUI 7zip Archive Manager

This is a manager that uses 7zip for managing archives.

NOTE: 7z must be globally available on your terminal for it to work, more on that here.

Why does it exist?

7zip is surely nice on the terminal but sometimes you want it a bit easier. Maybe you want to extract or deleting specific files and typing/copy-pasting can be time consuming, with this tool you can see what's inside and quickly do different things without creating a mess of a terminal.

Installation

To install it you'll need installed:

  • NodeJS;
  • 7zip and it being globally visible (more on that here);
  • A terminal (Termux or whatever);

then type:

npm install -g tui-7z-archive-manager

How 7zip should be installed?

7zip needs to be visible globally for this tool to work, that is:

  • On Windows: Put your 7z.exe's folder path inside %path% variable and if that isn't enough try putting it inside the system's %path% one. You can view and modify variables by going Control Panel > User Accounts > Change my environment variables;
  • On Unix: Just install it with a package manager (or App Store/Software Manager) and it should be already available globally, if that's not enough go find the 7z binary file path and add it to the $PATH variable permanently;

How to use it?

You'll need to either type tui7zArchiveM in the terminal or node tui-7z-archive-manager.mjs in the same folder of where the package is installed

Read COMMAND LINE PARAMETERS for more information about the available parameters

What changes have been made?

Check out the CHANGELOG file for more information.

It will include all changes being made in each version.

Keyboard shortcuts

Pressing enter will show all the available commands

  • d → delete command;
  • c → move command;
  • a → add command;
  • Ctrl + a → skips to the selector for adding 📂/📄s;
  • Meta (alt key) + a → skips to the file creation;
  • Shift + a → skips to the folder creation;
  • e → extract command;
  • Ctrl + e → skips to the "same place of archive" extraction;
  • Shift + e → skips to the "different location" extraction;
  • r → rename command;
  • n → change archive command;

Options

  1. inquirerPagePrompsSize → the amount of things that prompts can show at once (e.g the list of the archive)

Credits

Inquirer.js for the library of prompts

anc95's inquirer-file-tree-selection-prompt for the file selector

leonsilicon's inquirer-press-to-continue for the pause prompt

insightfuls' inquirer-tree-prompt for generating the list prompt of the archive