foo_midi

foo_midi is a foobar2000 component that adds playback of MIDI files to foobar2000.

It is based on foo_midi by kode54.

Features

• Decodes General MIDI files (.MID, .MIDI, .RMI, .KAR) and several MIDI based formats. (.MIDS, .MDS, .HMI, .HMP, .MUS, .XMI, .XFM, .LDS, .RCP, .R36, .G18, .G36).
• Supports several synthesizers, several of which do not require any additional files to play back music. The bundled synthesizers which do not require additional files may sound rather basic, though.
• Supports FluidSynth SoundFont (.sf2) based synthesizer, including support for the newer compressed format. (.sf3). SoundFonts may be loaded in a simple, or even complex setup, using either basic .sflist text files encoded in UTF-8 format, but for now, it only supports a bare list of files.
• Supports 32 and 64-bit VST instruments.
• Supports dark mode.

Requirements

• foobar2000 v2.0 or later (32 or 64-bit).
• Tested on Microsoft Windows 10 and later.

Getting started

• Double-click foo_midi.fbk2-component.

or

• Import foo_midi.fbk2-component into foobar2000 using the "File / Preferences / Components / Install..." menu item.

Usage

Loops

The component supports 6 loop modes:

• Never loop
  • The song will be played once ignoring any loop information.
• Never loop. Use decay time
  • The song will be played once ignoring any loop information with a customizable decay period at the end for the sound to die down.
• Loop and fade when detected
  • The song will be played and any defined loop will be repeated a customizable number of times (defined in Advanced Preferences by "Loop count"). At the end of the last loop the song will fade out over the period defined by the "Fade time" settings in Advanced Preferences.
• Loop and fade always
  • The song will be played and looped a customizable number of times (defined in Advanced Preferences by "Loop count"). At the end of the last loop the song will fade out over the period defined by the "Fade time" settings in Advanced Preferences.
• Play indefinitely when detected
  • The song will be played and the loop will play until stopped.
• Play indefinitely
  • The song will be played and loop until stopped.

Developing

Requirements

To build the code you need:

• Microsoft Visual Studio 2022 Community Edition or later
• foobar2000 SDK 2024-08-07
• Windows Template Library (WTL) 10.0.10320

The following libraries are included in the code:

• BASS 2.4.17
  • BASSFLAC 2.4.5.5
  • BASSMIDI 2.4.14.1
  • BASSWV 2.4.7.4
  • BASSOPUS 2.4.3.0
  • BASSMPC 2.4.1.2
• LibADLMIDI 1.5.1, Yamaha YMF262 (OPL3)
• LibOPNMIDI 1.5.1, Yamaha YM2612 (OPN2)
• Nuke.YKT
  • WinOPL3Driver
  • Nuked-OPL3 Yamaha YMF262 and CT1747 (OPL3)
  • Nuked-OPLL Yamaha YM2413 and VRC7 (OPLL)
  • Nuked-OPM Yamaha YM2151
  • Nuked-OPN2 Yamaha YM3438 (YM2612) 1.0.9
  • Nuked-OPNB Yamaha YM2610
  • Nuked-PSG Yamaha YM7101
• emu2149 Yamaha YM2149 (PSG)
• emu2212 Konami SCC
• emu8950 Yamaha Y8950, YM3526 and YM3812
• emu76489 SN76489
• Munt win32drv Roland MT-32, CM-32L and LAPC-I synthesiser modules 1.8.1
• FluidSynth 2.3.6

To create the deployment package you need:

• PowerShell 7.2 or later

Setup

Create the following directory structure:

3rdParty
    WTL10_10320
bin
    x86
foo_midi
out
sdk

• 3rdParty/WTL10_10320 contains WTL 10.0.10320.
• bin contains a portable version of foobar2000 64-bit for debugging purposes.
• bin/x86 contains a portable version of foobar2000 32-bit for debugging purposes.
• foo_midi contains the Git repository.
• out receives a deployable version of the component.
• sdk contains the foobar2000 SDK.

Building

Open foo_midi.sln with Visual Studio and build the solution.

Packaging

To create the component first build the x86 configuration and next the x64 configuration.

Change Log

v2.15.1.0, 2024-09-18

• Fixed: The selected player now only gets overriden to BASSMIDI/FluidSynth when an embedded or a soundfont is found with the same basename as the MIDI file.
• Fixed: The BASS MIDI Resampling combo box was not always enabled correctly when switching player types.

v2.15.0.0, 2024-09-14

• New: Support for embedded DLS sound fonts in RMI files. Works only with the FluidSynth player.
• New: Support for the DBNK chunk in RMI files.
• New: Support for SoundFont layering without using SFList files. Not perfect yet but usable.
• Improved: Tweaked the player type override logic.
• Improved: Increased the number of MIDI ports supported by the BASS MIDI player.
• Fixed: A very old bug in the MIDI parsing code when Pitch Bend control change messages were encountered.
• Fixed: Some preferences were not reset when the Reset button was clicked.

v2.14.0.0, 2024-08-17

• New: Support for embedded artwork (IPIC) and encoding (IENC) chunks in RMI files.

v2.13.2.0, 2024-08-16

• Fixed: The Apply button remained active again even if nothing was changed.

v2.13.1.0, 2024-08-15

• Fixed: 0-byte *.tmp files were not deleted after playing an RMI file with an embedded SoundFont.

v2.13.0.0, 2024-08-14

• Improved: An All Notes Off channel mode message will be sent when a channel gets disabled. The overall filtering has been fine-tuned.
• Improved: Channels can be disabled per port.
• Improved: Only sets the MIDI player to BASSMIDI with SoundFonts if FluidSynth is not used.
• Builds with foobar2000 SDK 2024-08-07.

v2.12.0.0, 2024-08-10

• New: Added support for embedded sound fonts in RMI files.
• New: MIDI channels can be enabled and disabled during playback.
  • See MSKB article 84817 Using the MIDI Mapper for an explanation of the 1 - 10 and 11 - 16 buttons.
• Changed: Dropped support for foobar2000 1.x.

v2.11.0.0, 2024-06-23

• New: Recomposer support (.RCP, .R36, .G18, .G36). Some files may still have issues.
• New: Preferences page to configure Recomposer and HMI/HMP settings. (alpha7)
• New: HMI/HMP default tempo can be configured. (alpha7)
• New: Support for LeapFrog loop markers (CC 110 and 111). (alpha8)
• Improved: Added support for Unicode paths to RCP converter (alpha3)
• Improved: Detection of mixed-encoding text in metadata (alpha5)
• Fixed: RPG Maker loops should work again.
• Fixed: Recomposer files with strange tempo changes crashed the component. (alpha4)
• Fixed: HMI conversion added a second Note On event after every note instead of a Note Off event. (alpha7)
• Fixed: The Apply button remained active even if nothing was changed. (alpha7)

v2.10.0.0, 2024-05-07, "It's been a while"

• New: The volume of BASS MIDI can be tweaked independently of the overall volume. Defaults to 0.15, determined experimentally to align with the other players.
• Improved: Added detection of EUC-JP encoded meta data.
• Improved: Added Shift-JIS and EUC-JP detection and conversion for lyrics.
• Fixed: Mixed ANSI and Shift-JIS wasn't detected (anymore?).
• Fixed: The BASS MIDI voice count was not initialized correctly when using a preset.
• Fixed: Emu de MIDI sysex recognition.
• Fixed: Emu de MIDI potential buffer overflow during rendering.

v2.9.2.0, 2023-12-24, "Merry Christmas"

• New: Compatible with foo_vis_midi v0.1.0.
• Fixed: Crash in Emu de MIDI because dynamic synthesis rate was not initialized in time.
• Fixed: Loop type was not respected when converting to other audio formats.
• Builds with foobar2000 SDK 2023-09-23.

v2.9.1.3, 2023-11-02, "Loop de loop"

• New: You can specify the path of an ADLMIDI bank (*.wopl or any of the other supported formats) in the Advanced branch of the Preferences dialog.
  • The bank in the file overrides any selection in the bank drop down list in Preferences.
  • The file path is not yet saved as part of a preset.
  • Only file paths with Latin-1 characters are supported (limitation of the library).
• New: Made Opal and Java OPL3 emulator core from LibADLMIDI selectable in the Advanced Preferences.
• Improved: The decay time is now configurable. The default is still 1s (1000ms).
• Improved: Looping, fading and decay has been tweaked.
• Improved: The song duration is now always calculated without taking into account the selected loop mode. So it's the absolute length of the song without any looping or decay time.
• Improved: Made the parsing of the MIDI data more robust.
• Improved: LDS file detection is more robust.
• Fixed: FluidSynth did not respect the preferred sample rate.
• Fixed: FluidSynth did not save two settings in a preset.
• Fixed: Invalid embedded karaoke lyrics were not handled correctly.
• Builds with foobar2000 SDK 2023-09-06.

v2.9.0.0, 2023-08-02, "Revenge of the FluidSynth"

• New: Added FluidSynth player again.
  • It can be selected after setting the path to the directory that contains the FluidSynth libraries. You can download FluidSynth here. Make sure you download the version that has the same CPU architecture as foobar2000 (x64 or x86).
• New: Added .XFM as an alternative file extension for XMI files.
• Improved: Added FluidSynth settings to preferences page.
• Improved: MIDI standard detection
  • Some XG files were not recognized as such if the file contained any GS messages first.
  • GM 2 detection.
• Changed: Renamed dynamic info tags bassmidi_voices and bassmidi_voices_max to midi_active_voices and midi_peak_voices. The FluidSynth player also sets those tags while playing.
• Fixed: An old bug in the XMI parser prevented some XMI files from loading.

v2.8.5.0, 2023-07-23, ""

• New: Added a configuration option to always use Super Munt when playing an MT-32 file. Default is on.
• New: Added an configuration option to always use a VSTi to play an XG file. Default is off.
  • Don't forget to specify the path name of the VSTi in the Advanced preferences.
• Fixed: Saving MIDI presets was broken.
• Fixed: Loop detection was broken for some files.

v2.8.4.0, 2023-06-26, "Beat the Drum"

• New: A new Info tag "MIDI_PLAYER" contains the name of the MIDI player playing the current track.
• New: Added detection of an extra percussion channel in Standard MIDI Files (*.MID). When meta data messages of type Text, Track Name or Instrument Name containing the word "drum" preceed the first message for channel 16 it will be used as an extra percussion channel in addition to channel 10.
• New: A new Info tag "MIDI_EXTRA_PERCUSSION_CHANNEL" contains the (1-based) number of the channel that acts as an additional percussion channel (only channel 16 for now).
• Improved: Error reporting in general and in case of parsing MIDI files with problems.
• Fixed: Playing loops did not always work. (Regression)

v2.8.3.1, 2023-06-03, "Do you want lyrics with that? Redux"

• Fixed: The user selection of the MIDI player was no longer honored. (Regression) A SOLID bug...

v2.8.3.0, 2023-06-01, "Do you want lyrics with that?"

• Cue Marker, Lyrics, Time Signature and Key Signature meta events are now converted to tags.
  • Soft Karaoke lyrics are stored in an SYNCEDLYRICS tag; other lyrics in a LYRICS tag. The tags can be edited but will not be written back to the MIDI file.
  • Info tag MIDI_LYRICS_TYPE contains the name of the Karaoke standard. For now, only Soft Karaoke format is recognized.
• Fixed: vshost process was not stopped when checking for presets. (Regression)

v2.8.2.0, 2023-05-20, "Spring Cleaning"

• Fixed: MIDI files with malformed tracks caused a crash.
• Fixed: MIDI files with malformed SysEx events caused a crash.
• Fixed: Work-around for weird rendering problem in Dark mode.
• Fixed: Restored access to the Preferences page from the Decoding page in the Preferences dialog.
• Improved: Tweaked the size of some of the labels of the Preferences dialog.
• Improved: Added a message to re-open the Preferences dialog after any of the paths were changed.
• Improved: Changed Shift-JIS detection in meta data. A copyright sign (©) was interpreted as Shift-JIS.

v2.8.1.0, 2023-05-01, "A New Beginning...? Redux"

• Fixed: The dialog now properly resizes on systems with High DPI settings (> 100% scaling)

v2.8.0.0, 2023-04-30, "A New Beginning...?"

• Major refactoring of the source code.
• Builds with foobar2000 SDK 2023-04-18.
• Tried to make the preferences page a bit more accessible to new users.
  • Moved all the path controls to a separate preferences page.
  • Added the configuration of the VTSi plugin path to the preferences page (in addition of the Advanced Preferences, for backwards compatibility).
  • Added the configuration of the Secret Sauce path to the preferences page (in addition of the Advanced Preferences, for backwards compatibility).

v2.7.4.4, 2022-11-21, "I'm SoundFont of it"

• Fixed: The new scpipe32 and scpipe64 in the previous version had issues. Secret Sauce is back.
• Added support for compressed SoundFonts (.sf3) to BASS MIDI player.
• Updated Munt (MT32 emulator) to v2.7.0.
• Reduced the component package size a bit. Only one copy of each vsthost and scpipe executable is included.

v2.7.4.3, 2022-11-20, "Returning to BASS."

• Re-added missing BASS libraries.
• Re-added recompiled versions of scpipe32 and scpipe64.
• Upgraded JSON parser and build to latest version.
• Started fixing compiler warnings.
• No added functionality.

v2.7.4.2, 2022-11-14, "The Temple of VeSTa"

• Added 32-bit and 64-bit VST instrument support for foobar2000 v2.0.
• Fixed 64-bit VST instrument support for foobar2000 v1.6.13.

v2.7.4.1, 2022-11-04, "The Dark Side"

• Added Dark Mode support for foobar2000 v2.0.
• Fixed 32-bit build.
• Updated BASS to v2.4.17.

v2.7.4, 2022-11-03, "Scratchin' the itch"

• Initial release of x64 version for foobar2000 v2.0.

Acknowledgements / Credits

• Peter Pawlowski for the foobar2000 audio player.
• kode54 for the original foo_midi component.
• Un4seen Developments for the BASS audio library.
• Munt for a multi-platform software synthesiser emulating pre-GM MIDI devices such as the Roland MT-32, CM-32L, CM-64 and LAPC-I.
• Alexey Khokholov (Nuke.YKT) for Nuked OPL3.
• Vitaly Novichkov for libADLMIDI and libOPNMIDI.
• Mitsutaka Okazaki for Emu de MIDI.
• arch21 for testing and pointing me in the right direction with Secret Sauce and SF3 SoundFonts.
• Tom Moebert for FluidSynth.
• Valley Bell for MidiConverters.

Reference Material

foobar2000

• foobar2000 Development

Windows User Interface

• Desktop App User Interface
• Windows User Experience Interaction Guidelines
• Windows Controls
• Control Library
• Resource-Definition Statements
• Visuals, Layout

Electronic Music

• Electronic Music Wiki
• File format samples

SoundFonts

• SoundFont, Musical Artifacts

FluidSynth

• FluidSynth Documentation

MIDI

• Introduction to Computer Music: MIDI, Jeffrey Hass
• MIDI is the language of the gods, Teragon Audio
• Standards in Music, Recording Blogs
• Comparison of MIDI standards, Wikipedia
• Yamaha XG Programming, Studio 4 All

GMF (Game Music Format)

• GMF

HMI (Human Machine Interface)

• HMI

HMP (Human Machine Interface P)

• HMP

LDS (Loudness Sound System)

• LDS

MDS (MIDI Stream)

• MDS

MUS (DMX)

• MUS (DMX)
• MUS Format

RMI

• About RMIDI
• Official SF2 RMIDI Specification

RPC (Recomposer)

• Recomposer Format

XMI (Extended Multiple Instrument Digital Interface)

• XMI
• XMI Format

Links

• Home page: https://github.com/stuerp/foo_midi
• Repository: https://github.com/stuerp/foo_midi.git
• Issue tracker: https://github.com/stuerp/foo_midi/issues

License