ZZMIDI 1.01

General MIDI SoundFont synthesizer

Short:        General MIDI SoundFont synthesizer
Author:       Xanxi
Uploader:     Xanxi <hassani hakim gmail com>
Type:         mus/midi
Version:      1.01
Requires:     MNT ZZ9000 with XACP v1.7 / XX19c+ or explicitly XACP-compatible firmware, AHI, camd.library
Architecture: m68k-amigaos >= 3.1

ZZMIDI turns the ARM coprocessor of the MNT ZZ9000 into a General MIDI
SoundFont synthesizer for the Amiga. CAMD applications -- OpenDune,
DarkForces, DoomAttack, MIDIKeys, sequencers and players -- can use it
with almost no 68k CPU cost: synthesis runs on the graphics card.

Firmware XX19c:
  https://github.com/Xanxi-Amiga/XACP-ZZ9000/releases/tag/XX19c
NOT compatible with official MNT firmware 1.13 or BlitterStudio firmware.

IMPORTANT CAMD SETUP:
camd.library must be installed. Get the standard CAMD package from:
  https://aminet.net/mus/midi/camd.lha
Then run the included MidiPorts preferences editor and associate the
standard CAMD clusters out.0 and in.0 with the Amiga serial port.
Installing camd.library alone is not the complete setup.

IMPORTANT AHI SETUP FOR GAMES:
If a game uses AHI for sound effects or speech in addition to ZZMIDI
music, set AHI Unit 0 to 2 channels, not 1. A single channel makes the
game audio and ZZMIDI compete for the output and can cause audio bugs.

Features:
- SoundFont 2 banks up to 10 MiB, 64 voices, 16-bit stereo via AHI
- realtime CAMD service with preferences panel or pure Shell control
- ZZDoom music through CAMD while the game runs on ZZ9000 Core1
- ZZMIDIPlay standalone MIDI player / SoundFont audition tool
- ZZSF2Info SoundFont weight analyser
- a few percent of 68060 CPU while playing

IMPORTANT FOR ZZDOOM:
Firmware XX19c fixes the Core0/Core1 startup/cache-coherency conflict
which could occur when launching ZZDoom while ZZMIDI realtime was active.
With ZZMIDI 1.01 and XX19c, ZZDoom can be launched normally while ZZMIDI
realtime is running. No pause, gate or special launch sequence is required.
The old ZZMIDIGate helper was only a workaround for XX19a/XX19b and is no
longer included in ZZMIDI 1.01.

Users intentionally remaining on XX19a or XX19b should continue using
ZZMIDI 1.0 together with ZZMIDIGate.

SoundFont paths must contain NO SPACES and stay under 250 characters
(file name under 30 characters on classic FFS). See README.

1.01 (10/2026): maintenance release for XX19c / XACP v1.7. Removes
ZZMIDIGate because the historical Core0/Core1 startup conflict is fixed
in firmware. Updated ZZDoom/Core1 and firmware compatibility documentation.

1.0 (08/2026): first public release. XACP v1.6 protocol, chunked
uploads, hardened service lifecycle, validated on A4000/68060.

License: the Amiga-side ZZMIDI programs are proprietary freeware. The
original unmodified release archive may be redistributed freely.
Third-party applications may use the documented CAMD/CLI interfaces.
Developers wishing to embed or bundle ZZMIDI itself are welcome to
contact the author for permission. XX19c/XACP firmware is distributed
separately under its own licensing terms.

ZZ9000 is a product of MNT Research GmbH.
TinySoundFont by Bernhard Schelling -- MIT License.
TinyMidiLoader by Bernhard Schelling -- zlib License.
TimGM6mb.sf2 is distributed under GPL-2; see the included license files.