A command-line tool to create, add, remove, list, extract, read, and verify MPQ archives using the StormLib library.
⚠️ Warning: This project is under active development and will change functionality between released versions until version 1.0.0.
This is a command-line tool, designed for automation and built with the Unix philosophy in mind. It is designed to work seamlessly with other command-line tools, supporting piping, redirection, and integration into shell scripts and workflows. For example:
- Run one command to create an MPQ archive from a directory of files or a single file
- Run one command to list all files in an MPQ archive
- Pipe the output to
grepor other tools to search, filter, or process files - Redirect output to files or other commands for further automation
If you require an MPQ tool with a graphical interface (GUI) and explicit support for more MPQ archive versions — I would recommend using Ladik's MPQ Editor.
Pre-built binaries are available for Linux and Windows on GitHub releases.
Docker images are available on GitHub packages.
curl -fsSL https://raw.githubusercontent.com/thegraydot/mpqcli/main/scripts/install.sh | bash
...
mpqcli list <some-mpq-archive>Microsoft Windows:
irm https://raw.githubusercontent.com/thegraydot/mpqcli/main/scripts/install.ps1 | iex
...
mpqcli.exe list <some-mpq-archive>Please see mpqcli.thegraydot.com for full documentation.
Please see the CONTRIBUTING.md document.