MPQ

MPQ archive codec

Report Bug · Request Feature

About

This package provides a MPQ archive codec, for compressing and decompressing MoPaQ archives.

This package also contains command-line and graphical applications for working with MPQ image files.

More about the MoPaQ archive file format can be found here.

Project Structure

• pkg/ - This directory contains the core MPQ transcoder library. This is the directory to import if you want to write new golang applications using this library.

  import (
      mpq "github.com/OpenDiablo2/mpq/pkg"
  )

• cmd/ - This directory contains command-line and graphical applications, each having their own sub-directory.
• assets/ - This directory contains files, like the images displayed in this README, or test mpq file data.

Getting Started

Prerequisites

You need to install Go 1.16, as well as set up your go environment. In order to install the applications inside of cmd/, you will need to make sure that $GOBIN is defined and points to a valid directory, and this will also need to be added to your $PATH environment variable.

export GOBIN=$HOME/.gobin
mkdir -p $GOBIN
PATH=$PATH:$GOBIN

Installation

As long as $GOBIN is defined and on your $PATH, you can build and install all apps inside of cmd/ by running these commands:

# clone the repo, enter the dir
git clone http://github.com/OpenDiablo2/mpq
cd mpq

# build and install inside of $GOBIN
go build ./cmd/...
go install ./cmd/...

At this point, you should be able to run the apps inside of cmd/ from the command-line, like mpq-view.

Contributing

I've set up all of the repos with a similar project structure. ~/pkg/ is where the actual transcoder library is, and ~/cmd/ has subdirectories for each CLI/GUI application that can be compiled.

Any contributions are greatly appreciated.

1. Fork the Project
2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
3. Commit your Changes (git commit -m 'Add some AmazingFeature')
4. Push to the Branch (git push origin feature/AmazingFeature)
5. Open a Pull Request