What it does
The audio browser provides direct access to the game’s audio system:- Browse PCK files: Navigate through the game’s audio archives organized by language and category
- Preview audio: Play WEM files directly in the app with playback controls
- Search by ID or tag: Find specific audio files by ID number or community-tagged names
- Replace files: Import custom audio to replace in-game sounds, music, or voice lines
- Tag database: Download and use community-curated sound tags to identify audio files
- Audio matching: Automatically find which in-game file matches your custom audio
Interface layout
Language tabs
Switch between audio categories at the top:- SFX/Music: Sound effects, background music, UI sounds (Full folder)
- English: English voice lines
- Japanese: Japanese voice lines
- Korean: Korean voice lines
- Chinese: Chinese voice lines
Only languages with PCK files in your game installation are shown. The game typically includes all voice language packs.
File tree structure
The browser shows a three-level hierarchy:- PCK files: Game archive files (e.g.,
SoundBank_SFX_BGM.pck) - BNK soundbanks: Wwise sound banks containing embedded audio
- WEM audio files: Individual audio files with ID numbers
File information columns
- File Name: PCK, BNK, or WEM file name with ID
- ID: Numeric file identifier used by the game
- Size: File size in KB or MB
- Duration: Audio length (for WEM files)
- Tags: Community-assigned names and categories (when available)
- Type: File type (PCK, BNK, WEM, or WEM merged)
Audio playback
Playing audio
Double-click any WEM file to play it:- Play/Pause: Start or pause playback
- Stop: Stop and reset to beginning
- Volume slider: Adjust playback volume
- Progress bar: See current position and seek to different times
- Time display: Shows current position and total duration
WEM files are Wwise audio format files. The browser automatically converts them to WAV for playback using vgmstream or FFmpeg.
Streaming vs. embedded audio
The game stores audio in two ways:- Embedded WEMs: Small audio clips stored inside BNK soundbanks
- Streaming WEMs: Large audio files (music, long voice lines) stored separately in Streamed_SFX PCK files
Searching for audio
Use the search bar to find specific audio files:Search by file ID
Enter a numeric ID to find files:Search by tag or name
Enter text to search community tags:Search results
Search results show:- File ID
- Tag name (if available)
- PCK file location
- BNK parent (if embedded)
- File type
Tag database
The community maintains a database of tagged audio files to help identify sounds:Downloading tags
- Click Download Official Tag Database
- The browser fetches the latest tags from GitHub
- Click Apply to import the tags
- Tagged files now show names and categories in the Tags column
- Character names (“Nekomata”, “Billy”, “Anby”)
- Sound categories (“footstep”, “combat”, “UI”)
- Event names (“quest_prologue”, “cutscene_intro”)
Tag notifications
When new tags are available, a notification badge appears. Click to download and apply the latest tag database.Tags are stored in
~/.config/ZZAR/sound_database.json. The database is updated by the community as new sounds are identified.Replacing audio files
Manual replacement
- Find the audio file you want to replace in the tree
- Right-click and select Replace Audio
- Choose your custom audio file (MP3, WAV, FLAC, etc.)
- The converter automatically processes and stages the replacement
- Click Apply Changes to write the modified PCK
Audio matching
If you have audio files but don’t know which in-game files they replace:- Click Find Matching Sound
- Select your custom audio file
- The matcher analyzes your audio’s acoustic fingerprint
- It searches the game files for the best matches
- Results show match confidence and let you preview/navigate to matches
Supported formats
The audio converter supports:- Input formats: MP3, WAV, FLAC, OGG, M4A, AAC, OPUS, WMA
- Output format: WEM (Wwise audio format)
- FFmpeg for format conversion to WAV
- Loudness normalization (EBU R128 at -9 LUFS)
- Wwise Console for WAV to WEM conversion
Settings and options
Display options
Merge streaming WEMs (default: on): Combines embedded and streaming versions of the same audio file. Shows the streaming version when available. Hide empty BNKs (default: on): Hides BNK soundbanks that contain no audio files to reduce clutter. Hide useless PCKs (default: on): In language folders, hides PCK files that don’t contain voice lines (shows only SoundBank files). Normalize audio (default: on): Automatically adjusts volume when replacing audio to match game levels.File management
Click the folder icons to:- Open Streaming folder: View game’s original audio files
- Open Persistent folder: View generated modded PCK files
- Open Tag DB folder: Access the tag database file
Changes tracking
The Show Changes button displays all staged audio replacements:- File ID and name
- Source PCK file
- Replacement audio path
- Date modified
- Navigate: Jump to the file in the tree
- Play: Preview the original or replacement
- Remove: Delete individual replacements
- Reset All: Clear all staged changes
- Export as Mod: Create a shareable
.zzarmod package
Exporting mods
After making replacements, export them as a mod:- Click Export as Mod
- Fill in metadata (name, author, version, description)
- Optionally add a thumbnail image
- Choose save location
- The browser creates a
.zzarpackage
Performance tips
- Index caching: The browser caches PCK indexes for faster navigation. Indexes are rebuilt when you change display settings.
- Lazy loading: BNK contents are only loaded when you expand them in the tree.
- Audio caching: Recently played audio files are cached for instant replay.