Short:        VGM/VGZ video game music player
Author:       Xanxi
Uploader:     hassani hakim gmail com (Xanxi)
Type:         mus/play
Version:      1.0
Requires:     MNT ZZ9000, XACP XX19c or later, AHI audio
Architecture: m68k-amigaos >= 3.0

ZZVGMPlay 1.0 - VGM/VGZ Music Player for AmigaOS 3.x
==================================================

ZZVGMPlay plays classic arcade, console and computer game music on
AmigaOS 3.x, using the MNT ZZ9000 and the XACP Cortex-A9 Core1.
The Amiga 68k handles the GadTools user interface, playlist, file
loading and AHI output. Sound-chip emulation and stereo mixing are
performed on the ZZ9000 ARM processor.

FEATURES
--------
- VGM and gzip-compressed VGZ playback.
- Native AmigaOS GadTools player and Workbench icon.
- Playlist, Previous/Next, Repeat and playback controls.
- Configurable default music drawer.
- Optional diagnostic counters, hidden by default.

SUPPORTED SYSTEMS
-----------------
- Arcade: Sega System 18, Neo Geo, and selected Sega, Konami and
  Capcom sound hardware.
- Sega: Mega Drive/Genesis, Master System and Master System FM.
- Nintendo: NES/Famicom and Game Boy.
- NEC: PC Engine/TurboGrafx-16.
- Computers: Atari ST, MSX/MSX2 and Apple IIGS.
- PC FM audio: AdLib and Sound Blaster OPL2/OPL3 music in VGM files.

SUPPORTED SOUND CHIPS
---------------------
- Yamaha YM3812 (OPL2), YMF262 (OPL3), YM2151, YM2203, YM2413,
  YM2612 and YM2610.
- SN76489, AY-3-8910/YM2149, Konami SCC/SCC+, HuC6280 PSG,
  Apple IIGS ES5503, NES APU and Game Boy APU.
- Sega RF5C68 and selected arcade PCM chips including QSound,
  K053260 and K054539.

Playback compatibility depends on the sound chips and VGM commands
used in each file; not every soundtrack is supported.

REQUIREMENTS AND INSTALLATION
-----------------------------
- AmigaOS 3.x on a compatible 68k Amiga.
- ZZ9000 with XACP firmware XX19c or later.
- Working AHI audio output.

Extract the archive to a drawer, keeping the files together:

  ZZVGMPlay         - AmigaOS 68k executable
  ZZVGMPlay.info    - Workbench icon
  zzvgm_core1.bin   - Cortex-A9 Core1 program
  README.txt        - Full user documentation

Double-click ZZVGMPlay in Workbench, or start it from Shell.
Do not mix the 68k executable and Core1 binary from different builds.

MUSIC FILES
-----------
Download VGM/VGZ soundtrack packs at https://vgmrips.net/ .
Music files are not included in the distribution.

SOURCE CODE
-----------
The corresponding source code, original third-party license notices,
and offline build scripts are available on GitHub:

https://github.com/Xanxi-Amiga/XACP-ZZ9000/tree/main/applications/ZZVGMPlay

Release page:
https://github.com/Xanxi-Amiga/XACP-ZZ9000/releases/tag/ZZVGMPlay-1.0

ZZVGMPlay (c) Xanxi 2026. Free software distribution; included
third-party components retain their respective copyright and license
terms. Refer to the GitHub sources and original notices for details.