OpenMPT Wiki - Recent changes [en]

Manual: MIDI Input / Output Plugin

Saga Musix — Wed, 01 Apr 2026 16:18:23 GMT

← Older revision		Revision as of 16:18, 1 April 2026
Line 22:		Line 22:

	=== Initial MIDI Dump ===		=== Initial MIDI Dump ===
	This allows you to configure specific MIDI messages to be sent either when the module plays for the first time or every time playback restarts. Typical use cases include sending device-specific SysEx configuration messages to external MIDI devices, or setting up initial patch changes and controller values.		This allows you to configure specific MIDI messages to be sent either when the module plays for the first time (with '''Only send once''' checked) or every time playback restarts. Typical use cases include sending device-specific SysEx configuration messages to external MIDI devices, or setting up initial patch changes and controller values.

	The '''Send Now''' button allows to test the entered MIDI messages immediately during playback.		The '''Send Now''' button allows to test the entered MIDI messages immediately during playback.

Manual: About OpenMPT

Saga Musix — Wed, 01 Apr 2026 16:17:36 GMT

← Older revision		Revision as of 16:17, 1 April 2026
Line 12:		Line 12:
	** Ability to customize the [[Manual: Setup/Display\|GUI colour]] (but no skins yet), including colour schemes and custom pattern fonts.		** Ability to customize the [[Manual: Setup/Display\|GUI colour]] (but no skins yet), including colour schemes and custom pattern fonts.
	** Optional global [[Manual: Setup/DSP\|DSP effects]] including an equalizer.		** Optional global [[Manual: Setup/DSP\|DSP effects]] including an equalizer.
	** Up to ~~127~~ channels for pattern data (each with their own volume, pan, and plugin settings, as well as customizable channel names), and separate volume controls for sample playback, instrument plugins, and overall global volume.		** Up to 128 channels for pattern data (each with their own volume, pan, and plugin settings, as well as customizable channel names), and separate volume controls for sample playback, instrument plugins, and overall global volume.
	** Customizable audio playback quality (sample and bit ~~rates~~), polyphony, and latency settings.		** Customizable audio playback quality (interpolation quality, sample rate and bit depth), polyphony, and latency settings.
	** Ability to [[Manual: Setup/Paths / Auto Save\|automatically save]] the current file at intervals — and to a location — of your choosing.		** Ability to [[Manual: Setup/Paths / Auto Save\|automatically save]] the current file at intervals — and to a location — of your choosing.
	** Ability to customize most actions with [[Manual: Setup/Keyboard\|keyboard shortcuts]], including navigation, input, and opening dialog boxes.		** Ability to customize most actions with [[Manual: Setup/Keyboard\|keyboard shortcuts]], including navigation, input, and opening dialog boxes.
Line 21:		Line 21:
	* It can extract instruments and samples from soundfonts, like the General MIDI soundfont that comes pre-installed with Windows (GM.DLS).		* It can extract instruments and samples from soundfonts, like the General MIDI soundfont that comes pre-installed with Windows (GM.DLS).
	* [[Manual: MIDI Input / Output Plugin\|MIDI input and output]] to record from and playback on external MIDI devices.		* [[Manual: MIDI Input / Output Plugin\|MIDI input and output]] to record from and playback on external MIDI devices.
	* It can make use of VST 1.x and VST 2.x plugins.		* It can make use of VST 1.x and VST 2.x plugins, as well as DirectX Media Objects.
	* It can output audio through many different sound drivers, including WASAPI (default), ASIO, WaveRT, and others.		* It can output audio through many different sound drivers, including WASAPI (default), ASIO, WaveRT, and others.
	* It can apply [[Manual: Tunings\|alternate tunings]] (including scales and temperaments) to sample playback.		* It can apply [[Manual: Tunings\|alternate tunings]] (including scales and temperaments) to sample playback.

Development: Formats/IT

Saga Musix — Sun, 22 Mar 2026 22:30:46 GMT

Edit History

← Older revision		Revision as of 22:30, 22 March 2026
Line 158:		Line 158:
	Information on how to decode the FAT date and time stamps can be found on the [https://msdn.microsoft.com/en-us/library/windows/desktop/ms724247%28v=vs.85%29.aspx MSDN].		Information on how to decode the FAT date and time stamps can be found on the [https://msdn.microsoft.com/en-us/library/windows/desktop/ms724247%28v=vs.85%29.aspx MSDN].

	Note: Many programs don’t write an edit history, but they set the edit history flag in the header and write the two zero bytes for the history length. Many of them also ignore the edit history flag when loading files and always read the two <tt>num</tt> ~~num~~ bytes (ignoring the special flag), so if you want to write out an IT file that does not have an edit history and do not mind about the two extra bytes, the safest (most compatible) way is to set the edit history flag and write two zero bytes for <tt>num</tt>.		Note: Many programs don’t write an edit history, but they set the edit history flag in the header and write the two zero bytes for the history length. Many of them also ignore the edit history flag when loading files and always read the two <tt>num</tt> bytes (ignoring the special flag), so if you want to write out an IT file that does not have an edit history and do not mind about the two extra bytes, the safest (most compatible) way is to set the edit history flag and write two zero bytes for <tt>num</tt>.

	Also note that none of this is really relevant if you are sure that you never write out the MIDI macro configuration or ModPlug extensions, since these are the only two things that could normally follow the edit history. So if you have no MIDI macros and no ModPlug extensions, it is always safe to not set the special flag and not write the two extra bytes.		Also note that none of this is really relevant if you are sure that you never write out the MIDI macro configuration or ModPlug extensions, since these are the only two things that could normally follow the edit history. So if you have no MIDI macros and no ModPlug extensions, it is always safe to not set the special flag and not write the two extra bytes.

Manual: System Setup

46.32.185.137 — Thu, 19 Mar 2026 12:19:36 GMT

Creating a permanent portable multi-architecture setup

← Older revision		Revision as of 12:19, 19 March 2026
Line 70:		Line 70:
	<li> If you want to import your previous configurations (like keyboard shortcuts, tunings, and other preferences), you will need to:		<li> If you want to import your previous configurations (like keyboard shortcuts, tunings, and other preferences), you will need to:
	<ol>		<ol>
	<li> Navigate to OpenMPT's ~~setting~~ folder (<code>%APPDATA%\OpenMPT</code>). This can be achieved by using the “Show Settings Folder” option from the [[Manual: Menus#Help\|Help menu]].		<li> Navigate to OpenMPT's settings folder (<code>%APPDATA%\OpenMPT</code>). This can be achieved by using the “Show Settings Folder” option from the [[Manual: Menus#Help\|Help menu]].
	<li> Copy all files into the folder you created. This includes <code>mptrack.ini</code>, <code>Keybindings.mkb</code>, <code>plugin.cache</code>, <code>SongSettings.ini</code> and the <code>tunings</code> folder.		<li> Copy all files into the folder you created. This includes <code>mptrack.ini</code>, <code>Keybindings.mkb</code>, <code>plugin.cache</code>, <code>SongSettings.ini</code> and the <code>tunings</code> folder.
	</ol>		</ol>

Development: Foreign Bugs

Manx — Mon, 16 Mar 2026 10:43:17 GMT

Foreign Bugs

← Older revision		Revision as of 10:43, 16 March 2026
Line 7:		Line 7:
	\|-		\|-
	! Project !! Status !! affects !! Description !! Link		! Project !! Status !! affects !! Description !! Link
			\|-
			\| Vorbis \|\| open \|\| OpenMPT \|\| Fix typos in tonal masking curve level adjustments \|\|https://gitlab.xiph.org/xiph/vorbis/-/merge_requests/41
	\|-		\|-
	\| GCC \|\| open \|\| libopenmpt \|\| [13/14/15/16 Regression] -Wlogical-op now warns about logical ‘and’ of equal expressions even when different types/sizeofs are involved \|\| https://gcc.gnu.org/bugzilla/show_bug.cgi?id=65891		\| GCC \|\| open \|\| libopenmpt \|\| [13/14/15/16 Regression] -Wlogical-op now warns about logical ‘and’ of equal expressions even when different types/sizeofs are involved \|\| https://gcc.gnu.org/bugzilla/show_bug.cgi?id=65891

Development: Formats/IT

Ruby — Mon, 16 Mar 2026 04:24:24 GMT

Tracker IDs: add Cwt/v for rosetracker

← Older revision		Revision as of 04:24, 16 March 2026
Line 19:		Line 19:
	* <tt>DAEB</tt> - spc2it (after commit d3d1b524032f668be8ee20d25339e1c635fb9bcf)		* <tt>DAEB</tt> - spc2it (after commit d3d1b524032f668be8ee20d25339e1c635fb9bcf)
	* <tt>D1CE</tt> - [https://github.com/chr15m/itwriter itwriter] JavaScript library (user can change this default)		* <tt>D1CE</tt> - [https://github.com/chr15m/itwriter itwriter] JavaScript library (user can change this default)
			* <tt>EFFF</tt> - rosetracker (in development)

	Are you a tracker developer and your tracker can save IT files? Please add your Tracker ID to this list!		Are you a tracker developer and your tracker can save IT files? Please add your Tracker ID to this list!

User:Ruby

Ruby — Mon, 16 Mar 2026 04:22:53 GMT

User account Ruby was created

Manual: Saving and exporting

46.32.185.137 — Fri, 13 Mar 2026 12:17:49 GMT

MIDI Export

← Older revision		Revision as of 12:17, 13 March 2026
Line 83:		Line 83:
	** On the percussion channel, this lets you choose a drum key instead. Choose '''Mapped''' to map pattern notes directly to the corresponding drum key instead (e.g. triggering a C-3 in the pattern with this instrument will trigger a bass drum — for instruments with a custom note map, the mapped note is used instead).<br/> '''Note''': Drum keys below 35 (Acoustic Bass Drum) and above 81 (Open Triangle) are not entirely standardized. Depending on the application or device used to play the exported MIDI file, they may or may not turn out as the desired percussion.		** On the percussion channel, this lets you choose a drum key instead. Choose '''Mapped''' to map pattern notes directly to the corresponding drum key instead (e.g. triggering a C-3 in the pattern with this instrument will trigger a bass drum — for instruments with a custom note map, the mapped note is used instead).<br/> '''Note''': Drum keys below 35 (Acoustic Bass Drum) and above 81 (Open Triangle) are not entirely standardized. Depending on the application or device used to play the exported MIDI file, they may or may not turn out as the desired percussion.
	* '''Allow instruments to overlap on same MIDI channel''': If enabled, instruments won′t be aware of other instruments on the same MIDI channel, i.e. there will be no MIDI program change messages and notes from more than one instrument may be playing at the same time. This mode is useful when there are more than 16 instruments playing concurrently and the result is imported into a <abbr title="Digital Audio Workstation">DAW</abbr> where each MIDI track can be routed to a different MIDI device or plugin.		* '''Allow instruments to overlap on same MIDI channel''': If enabled, instruments won′t be aware of other instruments on the same MIDI channel, i.e. there will be no MIDI program change messages and notes from more than one instrument may be playing at the same time. This mode is useful when there are more than 16 instruments playing concurrently and the result is imported into a <abbr title="Digital Audio Workstation">DAW</abbr> where each MIDI track can be routed to a different MIDI device or plugin.
	* In the '''Sub Songs''' section you can chose either ~~either export~~ '''all sub songs''' to individual files, or just one specific '''sub song'''.		* In the '''Sub Songs''' section you can chose to export either '''all sub songs''' to individual files, or just one specific '''sub song'''.

	== OPL Export ==		== OPL Export ==

Tutorial: Getting Started

46.32.185.137 — Fri, 13 Mar 2026 10:28:57 GMT

Working with the order list

← Older revision		Revision as of 10:28, 13 March 2026
(One intermediate revision by the same user not shown)
Line 153:		Line 153:
	Do the same 4 times with <kbd>Q</kbd> and <kbd>I</kbd>.		Do the same 4 times with <kbd>Q</kbd> and <kbd>I</kbd>.

	If you have done it right, you should have this nice dancy ~~baseline~~, so go ahead, play your pattern to find out.		If you have done it right, you should have this nice dancy bassline, so go ahead, play your pattern to find out.

	== Creating your first sample ==		== Creating your first sample ==
Line 275:		Line 275:
	Now we want to listen to our song. In the main toolbar below the main menu, click the play button. Now you can watch how the patterns play by checking the '''Follow Song''' checkbox.		Now we want to listen to our song. In the main toolbar below the main menu, click the play button. Now you can watch how the patterns play by checking the '''Follow Song''' checkbox.

	You can go on building your song from here. When you right-click an order list item, you can also choose '''Create New Pattern'''. This creates new, completely empty pattern. Sometimes, this is useful if you have made a transition and want to start with completely something new.		You can go on building your song from here. When you right-click an order list item, you can also choose '''Create New Pattern'''. This creates a new, completely empty pattern. Sometimes, this is useful if you have made a transition and want to start with completely something new.

	=== Keeping your order list tidy ===		=== Keeping your order list tidy ===

Manual: Patterns

46.32.185.137 — Thu, 12 Mar 2026 08:42:37 GMT

Overview

← Older revision		Revision as of 08:42, 12 March 2026
Line 107:		Line 107:
	[[Image:Pattern Layout.png\|right]]		[[Image:Pattern Layout.png\|right]]

	Every pattern ~~consist~~ of a number of rows and channels. Channels are divided into several columns: Note Column, Instrument Column, Volume Column, Effect Column. By default, the currently edited cell of the pattern is highlighted in black, and the respective row is highlighted in dark grey. If follow song is disabled and you have a song playing, the currently played row is highlighted in bright yellow. By default, the song’s time signature is indicated by light grey row highlights; the first row of each beat and measure is displayed in a darker colour.		Every pattern consists of a number of rows and channels. Channels are divided into several columns: Note Column, Instrument Column, Volume Column, Effect Column. By default, the currently edited cell of the pattern is highlighted in black, and the respective row is highlighted in dark grey. If follow song is disabled and you have a song playing, the currently played row is highlighted in bright yellow. By default, the song’s time signature is indicated by light grey row highlights; the first row of each beat and measure is displayed in a darker colour.

	At the top of the editor, you see the '''channel headers''', which display the channel name and, optionally, note volume. Several edit options are [[Manual: Patterns#Channel Header Context Menu\|available]]. Click the pattern number in the upper-left corner (reading ''#0'' or similar) to open the [[Manual: Pattern Properties\|Pattern Properties dialog]] if supported by the current module format.		At the top of the editor, you see the '''channel headers''', which display the channel name and, optionally, note volume. Several edit options are [[Manual: Patterns#Channel Header Context Menu\|available]]. Click the pattern number in the upper-left corner (reading ''#0'' or similar) to open the [[Manual: Pattern Properties\|Pattern Properties dialog]] if supported by the current module format.

Development: Foreign Bugs

Manx — Mon, 09 Mar 2026 13:07:42 GMT

Foreign Bugs

← Older revision		Revision as of 13:07, 9 March 2026
Line 59:		Line 59:
	\|-		\|-
	\| C++ \|\| open \|\| OpenMPT/libopenmpt \|\| lexically_relative on UNC drive paths (\\?\C:\...) results in a default-constructed value \|\| https://cplusplus.github.io/LWG/issue3699		\| C++ \|\| open \|\| OpenMPT/libopenmpt \|\| lexically_relative on UNC drive paths (\\?\C:\...) results in a default-constructed value \|\| https://cplusplus.github.io/LWG/issue3699
	\|-
	~~\| GitHub \|\| open \|\| libopenmpt \|\| Can we suppress 'Run cancelled' notifications? \|\| https://github.com/orgs/community/discussions/13015~~
	\|-		\|-
	\| GCC (Debian) \|\| open \|\| libopenmpt \|\| i686-w64-mingw32-gcc reports wrong version in __GNUC__ __GNUC_MINOR__ __GNUC_PATCHLEVEL__ \|\| https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=1028580		\| GCC (Debian) \|\| open \|\| libopenmpt \|\| i686-w64-mingw32-gcc reports wrong version in __GNUC__ __GNUC_MINOR__ __GNUC_PATCHLEVEL__ \|\| https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=1028580
Line 127:		Line 125:
	\|-		\|-
	\| --- \|\| --- \|\| --- \|\| --- \|\| ---		\| --- \|\| --- \|\| --- \|\| --- \|\| ---
			\|-
			\| GitHub \|\| fixed 2026-03-09 \|\| libopenmpt \|\| Can we suppress 'Run cancelled' notifications? \|\| https://github.com/orgs/community/discussions/13015
	\|-		\|-
	\| Premake \|\| wontfix / work-around 2025-11-27 \|\| OpenMPT/libopenmpt \|\| Regression: commit 5b3497937b81e135001ac5cfe9b41cdcefa57531 breaks premake5 package master source \|\| https://github.com/premake/premake-core/issues/2536		\| Premake \|\| wontfix / work-around 2025-11-27 \|\| OpenMPT/libopenmpt \|\| Regression: commit 5b3497937b81e135001ac5cfe9b41cdcefa57531 breaks premake5 package master source \|\| https://github.com/premake/premake-core/issues/2536