ADLMIDI: OPL3 MIDI player for Linux and Windows


0. Contents

    1. Purpose
    2. Key features
    3. 1. Usage
    4. Copying and contributing
    5. Downloading

1. Purpose

adlmidi screenshot
This screenshot shows ADLMidi running on Linux, seen through a SSH session that runs in Cygwin XTerm on Windows 7.
The lovely dithering pattern is generated by animmerger, another one of my pet projects…(The image above has only 16 colors)
AdlMIDI is a commandline program that plays MIDI files using software OPL3 emulation (FM synthesis).

2. Key features

  • OPL3 emulation with four-operator mode support
  • FM patches from a number of known PC games, copied from files typical to AIL = Miles Sound System / DMX / HMI = Human Machine Interfaces / Creative IBK.
  • Stereo sound
  • Reverb filter based on code from SoX, based on code from Freeverb. A copy of either project is not needed.
  • Number of simulated soundcards can be specified as 1-100 (maximum channels 1800!)
  • xterm-256color support
  • WIN32 console support (also tested with HXRT / MS-DOS)
  • Pan (binary panning, i.e. left/right side on/off)
  • Pitch-bender with adjustable range
  • Vibrato that responds to RPN/NRPN parameters
  • Sustain enable/disable
  • MIDI and RMI file support
  • loopStart / loopEnd tag support (Final Fantasy VII)
  • Use automatic arpeggio with chords to relieve channel pressure
  • Support for multiple concurrent MIDI synthesizers (per-track device/port select FF 09 message), can be used to overcome 16 channel limit
  • Support for ScummVM, Doom, IMF and CMF files

This project is developed in C++, but a GW-BASIC version is also provided (MIDIPLAY.BAS). This player was first implemented in GW-BASIC for a Youtube demonstration video! With alterations that take 15 seconds to implement, it can be run in QBasic and QuickBASIC too. Note: The GW-BASIC version does not contain all of the same features that the C++ version does.

3. 1. Usage

Usage: adlmidi <midifilename> [ <options> ] [ <banknumber> [ <numcards> [ <numfourops>] ] ]
					adlmidi <midifilename> -1   To enter instrument tester
					-p Enables adlib percussion instrument mode (use with CMF files)
					-t Enables tremolo amplification mode
					-v Enables vibrato amplification mode
					-s Enables scaling of modulator volumes
					-nl Quit without looping
					-w Write WAV file rather than playing
					Banks: 0 = AIL (Star Control 3, Albion, Empire 2, Sensible Soccer, Settlers 2, many others)
					1 = Bisqwit (selection of 4op and 2op)
					2 = HMI (Descent, Asterix)
					3 = HMI (Descent:: Int)
					4 = HMI (Descent:: Ham)
					5 = HMI (Descent:: Rick)
					6 = HMI (Descent 2)
					7 = HMI (Normality)
					8 = HMI (Shattered Steel)
					9 = HMI (Theme Park)
					10 = HMI (3d Table Sports, Battle Arena Toshinden)
					11 = HMI (Aces of the Deep)
					12 = HMI (Earthsiege)
					13 = HMI (Anvil of Dawn)
					14 = DMX (Doom           :: partially pseudo 4op)
					15 = DMX (Hexen, Heretic :: partially pseudo 4op)
					16 = DMX (MUS Play       :: partially pseudo 4op)
					17 = AIL (Discworld, Grandest Fleet, Pocahontas, Slob Zone 3d, Ultima 4, Zorro)
					18 = AIL (Warcraft 2)
					19 = AIL (Syndicate)
					20 = AIL (Guilty, Orion Conspiracy, Terra Nova Strike Force Centauri :: 4op)
					21 = AIL (Magic Carpet 2)
					22 = AIL (Nemesis)
					23 = AIL (Jagged Alliance)
					24 = AIL (When Two Worlds War :: 4op, MISSING INSTRUMENTS)
					25 = AIL (Bards Tale Construction :: MISSING INSTRUMENTS)
					26 = AIL (Return to Zork)
					27 = AIL (Theme Hospital)
					28 = AIL (National Hockey League PA)
					29 = AIL (Inherit The Earth)
					30 = AIL (Inherit The Earth, file two)
					31 = AIL (Little Big Adventure :: 4op)
					32 = AIL (Wreckin Crew)
					33 = AIL (Death Gate)
					34 = AIL (FIFA International Soccer)
					35 = AIL (Starship Invasion)
					36 = AIL (Super Street Fighter 2 :: 4op)
					37 = AIL (Lords of the Realm :: MISSING INSTRUMENTS)
					38 = AIL (SimFarm, SimHealth :: 4op)
					39 = AIL (SimFarm, Settlers, Serf City)
					40 = AIL (Caesar 2 :: partially 4op, MISSING INSTRUMENTS)
					41 = AIL (Syndicate Wars)
					42 = AIL (Bubble Bobble Feat. Rainbow Islands, Z)
					43 = AIL (Warcraft)
					44 = AIL (Terra Nova Strike Force Centuri :: partially 4op)
					45 = AIL (System Shock :: partially 4op)
					46 = AIL (Advanced Civilization)
					47 = AIL (Battle Chess 4000 :: partially 4op, melodic only)
					48 = AIL (Ultimate Soccer Manager :: partially 4op)
					49 = AIL (Air Bucks, Blue And The Gray, America Invades, Terminator 2029)
					50 = AIL (Ultima Underworld 2)
					51 = AIL (Kasparov's Gambit)
					52 = AIL (High Seas Trader :: MISSING INSTRUMENTS)
					53 = AIL (Master of Magic, Master of Orion 2 :: 4op, std percussion)
					54 = AIL (Master of Magic, Master of Orion 2 :: 4op, orchestral percussion)
					55 = SB (Action Soccer)
					56 = SB (3d Cyberpuck :: melodic only)
					57 = SB (Simon the Sorcerer :: melodic only)
					58 = OP3 (The Fat Man 2op set)
					59 = OP3 (The Fat Man 4op set)
					60 = OP3 (JungleVision 2op set :: melodic only)
					61 = OP3 (Wallace 2op set, Nitemare 3D :: melodic only)
					62 = TMB (Duke Nukem 3D)
					63 = TMB (Shadow Warrior)
					64 = DMX (Raptor)
					65 = TMB (Blood)
					Use banks 2-5 to play Descent "q" soundtracks.
					Look up the relevant bank number from descent.sng.

					<numfourops> can be used to specify the number
					of four-op channels to use. Each four-op channel eats
					the room of two regular channels. Use as many as required.
					The Doom & Hexen sets require one or two, while
					Miles four-op set requires the maximum of numcards*6.

					When playing Creative Music Files (CMF), try the
					-p and -v options if it sounds wrong otherwise.

4. Copying and contributing

ADLMIDI is distributed under the terms of the General Public License version 3 (GPL3).
The OPL3 emulator within is from DOSBox is licensed under GPL2+.
The FM soundfonts (patches) used in the program are imported from various PC games without permission from their respective authors. The question of copyright, when it comes to sets of 11 numeric bytes, is somewhat vague, especially considering that most of those sets are simply descendants of the patch sets originally published by AdLib Inc. for everyone's free use.

Patches (as in source code modifications) and other related material can be submitted to the primary author by e-mail at:yJoelY YliCluomSaCa <bitsqwi0Jet@ikWCi.fi>

The author also wishes to hear if you use adlmidi, and for what you use it and what you think of it.

5. Downloading

Downloading help

  • Do not download everything - you only need one file (newest version for your platform)!
  • Do not use download accelerators or you will be banned from this server before your download is complete!

The most recent source code (bleeding edge) for adlmidi can also be downloaded by cloning the Git repository by:

Date (Y-md-Hi) acc        Size Name                
					2016-0917-1931 r--      398401 adlmidi-1.2.5.tar.bz2
					2016-0902-2128 r--      396944 adlmidi-1.2.4.tar.bz2
					2014-0622-1047 r--      393901 adlmidi-1.2.3.tar.bz2
					2014-0425-1948 r--      390289 adlmidi-1.2.2.tar.bz2
					2013-1003-1519 r--      389465 adlmidi-1.2.1.1.tar.bz2
					2013-0612-1348 r--      391429 adlmidi-1.2.1.tar.bz2
					2012-0626-0120 r--      327066 adlmidi-1.2.0.tar.bz2
					2011-1125-1903 r--      325331 adlmidi-1.1.2.tar.bz2
					2011-0111-1458 r--      321312 adlmidi-1.1.1.tar.bz2
					2010-1230-0035 r--      315259 adlmidi-1.1.0.tar.bz2
					2010-1223-0112 r--      309310 adlmidi-1.0.3.tar.bz2
				
Back to the source directory index at Bisqwit's homepage