Skip to main content

​
Installation

ZZAR can be installed using pre-built releases or run directly from source. Choose the method that works best for you. The easiest way to get started is to download a pre-built release.
1

Download the latest release

Visit the ZZAR Releases page and download the appropriate file for your platform:
  • Windows: ZZAR-Windows.zip
  • Linux: ZZAR-Linux.tar.gz
  • Linux (Flatpak): ZZAR.flatpak
2

Extract the archive

Right-click the .zip file and select Extract All. Choose a location like C:\Program Files\ZZAR\.
3

Launch ZZAR

Double-click ZZAR.exe to launch the application.

​
Option 2: Run from source

If you want to contribute to development or run the latest code, you can run ZZAR directly from source.

​
Prerequisites

Before running from source, make sure you have:
  • Python 3.14 or newer
  • Git for cloning the repository
  • PyQt5 and other Python dependencies (installed in the next step)
Download Python from python.org and make sure to check Add Python to PATH during installation.

​
Installation steps

1

Clone the repository

git clone https://github.com/Pucas01/ZZAR.git
cd ZZAR
2

Install dependencies

ZZAR’s Python dependencies are listed in requirements.txt:
pip install -r requirements.txt
This installs:
  • PyQt5 - GUI framework
  • requests - For downloading updates and tag databases
  • pydub - Audio processing
  • numpy and scipy - Audio analysis and fingerprinting
  • Pillow - Image processing
3

Launch ZZAR

python ZZAR.py

​
First launch setup

When you launch ZZAR for the first time, you’ll need to complete a few setup steps:
1

Game path detection

ZZAR will try to auto-detect your Zenless Zone Zero installation. If it can’t find it, you’ll need to manually point it to your ZenlessZoneZero_Data folder.The typical location is:
HoYoPlay/games/ZenlessZoneZero Game/ZenlessZoneZero_Data
ZZAR needs access to the game’s audio files to browse sounds and apply mods.
2

Wwise setup

ZZAR will prompt you to install Wwise Console, which is required for converting audio to the WEM format the game uses.
ZZAR can automatically download and install Wwise Console for you. Just click Install Wwise when prompted.
3

FFmpeg and vgmstream setup

ZZAR uses FFmpeg for general audio conversion and vgmstream for WEM playback.
ZZAR can automatically download and install both tools. Click Install Audio Tools when prompted.The setup script (setup_windows_audio_tools.py) will:
  • Download FFmpeg
  • Download vgmstream
  • Configure ZZAR to use them
If you skip the Wwise setup, you won’t be able to convert audio to WEM format. You can still install and manage mods, but you won’t be able to create new ones.

​
Verify installation

After completing the setup, verify that ZZAR is working correctly:
  1. Check the Audio Browser: Click on the Audio Browser tab. You should see a list of PCK files from your game installation.
  2. Check audio tools: Go to Settings and verify that Wwise, FFmpeg, and vgmstream paths are all detected.
  3. Test audio playback: In the Audio Browser, select a WEM file and click the play button. You should hear the audio.
If everything works, you’re ready to start using ZZAR!

​
Troubleshooting

  • Windows: Make sure you extracted the entire .zip file, not just the .exe
  • Linux: Make sure the file is executable: chmod +x ZZAR
  • From source: Make sure all dependencies are installed: pip install -r requirements.txt
If ZZAR can’t find your game installation:
  1. Go to Settings → Game Path
  2. Click Browse and navigate to your game folder
  3. Select the ZenlessZoneZero_Data folder (NOT the game executable)
  4. Click Save
Check these common locations:
  • Steam: C:\Program Files (x86)\Steam\steamapps\common\ZenlessZoneZero\ZenlessZoneZero_Data
  • HoYoPlay: C:\HoYoPlay\games\ZenlessZoneZero Game\ZenlessZoneZero_Data
If the automatic Wwise installation fails:
  1. Download Wwise Launcher from audiokinetic.com
  2. Install Wwise 2022.1 or newer
  3. In ZZAR, go to Settings → Wwise Path
  4. Point to the WwiseConsole.exe file (usually in C:\Program Files (x86)\Audiokinetic\Wwise\Authoring\x64\Release\bin\WwiseConsole.exe)
If you can’t play WEM files:
  • Make sure vgmstream is installed
  • On Linux, check that vgmstream is in your PATH: which vgmstream-cli
  • Try converting a WEM to WAV first using the Audio Converter to test the tools

​
Next steps

Quick start

Install your first mod

Setup & Configuration

Configure advanced settings

Build docs developers (and LLMs) love

Get started for freeTalk to us