Vermeil's Addon Extractor (VAE)

VAE is a command-line tool for players of Garry's Mod who need to extract content from addon files. This utility supports both modern .gma addons and legacy .bin addons, a tool for players who download addons from sources such as SteamCMD, third-party programs, websites, or for those using cracked versions of the game.

Features

• 🖥️ Cross-Platform: Works on Windows, macOS, and Linux.
• 📦 Addon Extraction: Extract both modern .gma and legacy .bin addon formats.
• 🔄 Archive Extraction: Supports archive formats (.zip, .rar, .7z, .tar, .tar.gz, .tar.xz and .tar.bz2).
• ⚡ Multithreading: Utilizes concurrent processing to speed up extraction.
• 🛠️ Easy to Use: A simple command-line interface.
• 🔄 GWTool Replacement: Drop-in replacement for GWTool.

Requirements

Operating System	Supported Versions	Architecture
Windows	11, 10, 8.1, 8	64-bit
Linux	Debian 12, Ubuntu 22.04, Fedora 41, Arch Linux, OpenSUSE	64-bit
macOS	macOS 15, 14, 13, 12, 11, 10.15	ARM64

• RAM Usage: 20MB
• Disk Space: 25MB

Installation

To install VAE, download the latest release.

• Windows: VAE-2.x.x-Windows-x64.7z
• Linux: VAE-2.x.x-Linux-x64.tar.xz
• macOS: VAE-2.x.x-macOS-Arm64.zip

Usage

Step 1: Extract the Downloaded Archive

1. Extract the contents of VAE.
2. Copy the extracted content to the directory where your addons are located. For example:

• SteamCMD Path: path-to-steamcmd/steamapps/workshop/content/4000
• 3rd Party Websites/Programs: Place VAE in the directory containing your archives or folders. VAE will scan the current directory and any subdirectories.

Step 2: Run the Program

Upon launching the program, you will be presented with two options:

Option 1: Extract Addons

• Scans the current directory and subdirectories for .gma and .bin files and extracts them.
  • Navigate to the Extracted-Addons folder and copy the folders to your Garry's Mod Addon directory.

Option 2: Extract Archives

• Scans the current directory for archive files (.zip, .rar, .7z, .tar, .tar.xz, .xz, and .bz2) and extracts them.
  • You can remove the Leftover folder, which contains the .gma, .bin, and archives to free up space.

Building VAE

Please refer to the build instructions for details on building VAE from source.

Contributing

Contributions are welcome! Please submit a pull request or open an issue to discuss changes.

License

This project is licensed under the GNU General Public License v3.0.

Credits

• Adamizo: The dumbest person I know. (the main reason why this program exist in first place)
• PyInstaller: For creating standalone executables.
• Py7zr: For 7z file extraction.
• RarFile: For rar file extraction.
• FastGMAD: Fast reimplementation of gmad. (Forked)
• 7-zip: For extracting .bin files.
• Program Icon: From Neon Genesis Evangelion (Adam). (Peak anime!!)