Converts file formats supported by AdPlug to VGM format.

This tool is originally designed to work with the RetroWave OPL3 Sound Card.

Currently it doesn't produce files that's 100% compatible with the VGMPlay software.

VGM is the next universal format for various vintage sound chips. It's well documented and extensible.

If one wants to build a player that uses/emulates these vintage sound chips, using VGM format will make things much easier.

It's almost impossible to directly integrate AdPlug into a modern C++ project that uses CMake & self-contained dependency management.

See the releases section.

Currently built targets:

• Linux x86_64 (glibc 2.28+)
• Windows x86_64 (Windows 7+)

• C++17 compatible compiler
• CMake 3.14+
• POSIX compatible environment
• zlib 1.3

Windows users please use WSL or Cygwin, or maybe try Linux a bit ;-)

Compile:

git clone https://github.com/SudoMaker/adlib2vgm
cd adlib2vgm
mkdir build
cd build
cmake ..
make -j `nproc`

or if you have ninja installed and prefer to use it:

git clone https://github.com/SudoMaker/adlib2vgm
cd adlib2vgm
mkdir build
cd build
cmake -G 'Ninja' ..
ninja

Install:

sudo cp adlib2vgm /usr/bin

Test:

cd ../tools
./test-all.sh

All checks should report to be identical.

• A2M: AdLib Tracker 2
• AGD: HERAD Herbulot AdLib Player
• AMD: AMUSIC AdLib Tracker
• AS3M: Scream Tracker 3 AdLib
• BAM: Bob's Adlib Music Player
• BMF: Easy AdLib 1.0 (aka FMPlay) by The Brain
• CFF: Boom Tracker
• CMF: Creative Music File Format by Creative Technology
• CMF2: SoundFX Macs Opera CMF Player
• D00: EdLib by Vibrants
• DRO: DOSBox Raw OPL Format
• DRO2: DOSBox Raw OPL Format
• DTM: DeFy AdLib Tracker
• GOT: God Of Thunder Player
• HSC: HSC Adlib Composer / HSC-Tracker
• IMF: Apogee (id/3D Realms) Music File
• JBM: Johannes Bjerregaard's JBM Adlib Music Format
• KSM: Ken Silverman Music (requires insts.dat)
• LAA: Lucas Arts Adlib Music
• LDS: Loudness Sound System by Andras Molnar
• MAD: Mlat Adlib Tracker
• MDI: AdLib Visual Composer MIDIPlay File
• MID: MIDI Audio File Format
• MKF: Softstar RIX OPL Music Format in MKF container
• MUS: AdLib MIDI Music Format by Ad Lib Inc.
• PIS: Beni Tracker PIS module
• RAD: Reality ADlib Tracker by Reality
• RAW: Raw AdLib Capture
• RIX: Softstar RIX OPL Music Format
• ROL: AdLib Visual Composer by Ad Lib Inc. (needs standard.bnk)
• S3M: Scream Tracker 3 AdLib
• SA2: Surprise AdLib Tracker
• SAT: Surprise AdLib Tracker
• SCI: Sierra AdLib Music
• SDB: HERAD Herbulot AdLib Player
• SNG: AdLib Tracker 1.0
• SNG2: Faust Music Tracker
• SNG3: SNGPlay File Format
• SOP: Note Sequencer v1.0 by sopepos
• SQX: HERAD Herbulot AdLib Player
• U6M: Ultima 6 Music
• WLF: Wolfenstein 3D Music File
• XAD: Lunatic Flash/Logic Design Player
• XAD2: Hybrid MiG-29M Player by Domark
• XAD3: Hyp LKCC/SAC Player
• XAD4: Psi/Future Crew PGRID Player
• XAD5: Ratt/GRIF Player

adlib2vgm -i ~/Downloads/ALLOYRUN.RAD -o ALLOYRUN.vgm
adlib2vgm.exe -i D:\Downloads\ALLOYRUN.RAD -o ALLOYRUN.vgm
adlib2vgm -i ~/Vibrants/Metal/Pop_Syndrom.d00 -o Pop_Syndrom.vgm
adlib2vgm -m opl3 -i ~/Downloads/ALLOYRUN.RAD -o ALLOYRUN_OPL3.vgm
adlib2vgm -f DRO2 -i some_dro2_file.dro -o foo.vgm
adlib2vgm -z -i ./pal1/30.乐逍遥.RIX -o 30.乐逍遥.vgz
adlib2vgm -L -z -i funkyou.wfl -o funkyou.vgz
adlib2vgm -f detect -i somefile.ext -o outfile.vgm
adlib2vgm --mode opl3 --gzipped --loop --subsong 6 --in mus.mkf --out subsong6.vgz

Contributions are welcomed!

It's important to preserve the original files because most of them contains additional valuable information not representable by the VGM format.

AGPLv3

If you see a possible license violation, don't hesitate to tell us.

This project makes use of the following open source software:

• AdPlug
• cxxopts
• utfcpp
• zstr
• zlib