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.
- 🖥️ 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.
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
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
- Extract the contents of VAE.
- 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.
- SteamCMD Path:
Upon launching the program, you will be presented with two options:
- This option 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.
- Navigate to the
-
This option 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
and.bin
and archives to free up some space.
Please refer to the build instructions for details on building VAE from source.
Contributions are welcome! Please submit a pull request or open an issue to discuss changes.
This project is licensed under the GNU General Public License v3.0.
- 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!!)