chiptune3 0.7.4

package/LICENSE

@@ -0,0 +1,11 @@
+All code in this project is MIT (X11) licensed. The only exception are the compiled libopenmpt parts which remain under the OpenMPT project BSD license.
+
+License text below:
+
+Copyright © 2013-2024 The chiptune2.js and chiptune3 contributers.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

package/README.md

@@ -0,0 +1,102 @@
+# Chiptune.js
+#### Version 3
+Modernized ES6 module version with libopenmpt AudioWorklet backend
+
+See: https://DrSnuggles.github.io/chiptune
+
+Modland demo player: https://DrSnuggles.github.io/chiptune/demo.html
+
+Drop in your favorite songs.
+
+## Build
+Docker was used to build the library
+
+Exported_Functions: '_malloc','_free','stackAlloc','stackSave','stackRestore','UTF8ToString'
+
+CD into docker and run build.bat (Win) or build.sh (Linux)
+
+Afterwards you can minify by "npm run minify"
+
+## History
+- 2024-03-13: Bumped to 0.7.4
+- 2024-02-04: Metadata contains song, bugfixes and minify
+- 2024-01-24: Added config object, Modland player
+- 2024-01-23: Drag'n'Drop files. Build library using Docker.
+- 2024-01-22: Libopenmpt 0.7.3 compiled with Emscripten 3.1.51
+
+#### Version 2
+This is a javascript library that can play module music files. It is based on the [libopenmpt](https://lib.openmpt.org/libopenmpt) C/C++ library. To translate libopenmpt into Javascript [emscripten](https://github.com/kripken/emscripten) was used. For audio output inside the browser WebAudio API is used.
+
+**Please note**: The compiled `libopenmpt.js` in this repository is based on an outdated version of libopenmpt. Newer versions contain bugfixes and other improvements. Download the latest version from the libopenmpt developers [here](https://lib.openmpt.org/libopenmpt/download/) and replace `libopenmpt.js.mem` and `libopenmpt.js`.  
+If you prefer to compile `libopenmpt.js` yourself (to save space or make custom changes) follow the instructions in the "Development" section.
+
+## Features
+
+* Play all tracker formats supported by libopenmpt (including mod, xm, s3m, it)
+* Simple Javascript API
+* Pause/Resume
+* Tested with Google Chrome and Firefox
+* Play local (HTML5) and remote files (XHR)
+* Stereo playback
+* Module metadata
+* Looping mode
+ 
+## To do
+
+* Playback information (e.g. position, speed, bpm)
+* Mixer settings (e.g. sampling rate, resolution)
+* Seekbar support
+ 
+## Demo
+
+See it in action [here](https://deskjet.github.io/chiptune2.js/).
+
+Just drop a module (e.g. from [modarchive.org](https://modarchive.org)) on the demo page and enjoy.
+
+## Development
+Download the latest [emscripten](https://emscripten.org/) SDK. Follow the instructions for your OS. Make sure `emcc` and `em++` commands are available in the PATH.  
+Next download and extract the libopenmpt source code (unix like) from https://lib.openmpt.org/libopenmpt/.  
+Use this command inside the libopenmpt source folder to build:
+
+    make CONFIG=emscripten
+
+If it compiles successfully these files (and a few more) will be created in the `bin` directory:
+
+1. `libopenmpt.js` is libopenmpt compiled to JavaScript.
+2. `libopenmpt.js.mem` is the memory initialization file `libopenmpt.js` will download/require it when loaded.
+3. `libopenmpt_test.js` (and `libopenmpt_test.j.mem`) is the libopenmpt test suite and can be run in NodeJS.
+
+Only the first two files are needed for chiptune2.js.
+
+### Building Stylesheet
+The stylesheet is built with [SASS+Compass](http://compass-style.org/). To build this yourself, follow the Compass [installation instructions](http://compass-style.org/install/), then change into the chiptune2.js directory and use this command:
+
+    compass watch
+
+The stylesheet .css file with rebuild every time you make a change to the source file in the `sass` folder.
+
+## Contributers (in order of appearance)
+- [deskjet](https://github.com/deskjet)
+- [manx](https://github.com/manxorist)
+- [nyov](https://github.com/nyov)
+- [DanialOaks](https://github.com/DanielOaks)
+- [onikienko](https://github.com/onikienko)
+- [okaybenji](https://github.com/okaybenji)
+- [photonstorm](https://github.com/photonstorm)
+
+Thanks to everyone!
+
+## License
+
+All code in this project is MIT (X11) licensed. The only exception are the compiled libopenmpt parts which remain under the OpenMPT project BSD license.
+
+License text below:
+
+>Copyright © 2013-2024 The chiptune2.js contributers.
+>
+>Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+>
+>The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+>
+>THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+

package/chiptune3.js

@@ -0,0 +1,127 @@
+/*
+	chiptune3 (worklet version)
+	based on: https://deskjet.github.io/chiptune2.js/
+*/
+
+const defaultCfg = {
+	repeatCount: -1,		// -1 = play endless, 0 = play once, do not repeat
+	stereoSeparation: 100,	// percents
+	interpolationFilter: 0,	// https://lib.openmpt.org/doc/group__openmpt__module__render__param.html
+	context: false,
+}
+
+export class ChiptuneJsPlayer {
+	constructor(cfg) {
+		this.config = {...defaultCfg, ...cfg}
+
+		if (this.config.context) {
+			if (!this.config.context.destination) {
+				//console.error('This is not an audio context.')
+				throw('ChiptuneJsPlayer: This is not an audio context')
+			}
+			this.context = this.config.context
+			this.destination = false
+		} else {
+			this.context = new AudioContext()
+			this.destination = this.context.destination	// output to speakers
+		}
+		delete this.config.context	// remove from config, just used here and after init not changeable
+
+		// make gainNode
+		this.gain = this.context.createGain()
+		this.gain.gain.value = 1
+
+		this.handlers = []
+
+		// worklet
+		this.context.audioWorklet.addModule( new URL('./chiptune3.worklet.js', import.meta.url) )
+		.then(()=>{
+			this.processNode = new AudioWorkletNode(this.context, 'libopenmpt-processor', {
+				numberOfInputs: 0,
+				numberOfOutputs: 1,
+				outputChannelCount: [2]
+			})
+			// message port
+			this.processNode.port.onmessage = this.handleMessage_.bind(this)
+			this.processNode.port.postMessage({cmd:'config', val:this.config})
+			this.fireEvent('onInitialized')
+
+			// audio routing
+			this.processNode.connect(this.gain)
+			if (this.destination) this.gain.connect(this.destination)	// also connect to output if no gainNode was given
+		})
+		.catch(e=>console.error(e))
+	}
+
+	// msg from worklet
+	handleMessage_(msg) {
+		switch (msg.data.cmd) {
+			case 'meta':
+				this.meta = msg.data.meta
+				this.duration = msg.data.meta.dur
+				this.fireEvent('onMetadata', this.meta)
+				break
+			case 'pos':
+				//this.meta.pos = msg.data.pos
+				this.currentTime = msg.data.pos
+				this.order = msg.data.order
+				this.pattern = msg.data.pattern
+				this.row = msg.data.row
+				this.fireEvent('onProgress', msg.data)
+				break
+			case 'end':
+				this.fireEvent('onEnded')
+				break
+			case 'err':
+				this.fireEvent('onError', {type: msg.data.val})
+				break
+			default:
+				console.log('Received unknown message',msg.data)
+		}
+	}
+
+	// handlers
+	fireEvent(eventName, response) {
+		const handlers = this.handlers
+		if (handlers.length) {
+			handlers.forEach(function (handler) {
+				if (handler.eventName === eventName) {
+					handler.handler(response)
+				}
+			})
+		}
+	}
+	addHandler(eventName, handler) { this.handlers.push({eventName: eventName, handler: handler}) }
+	onInitialized(handler) { this.addHandler('onInitialized', handler) }
+	onEnded(handler) { this.addHandler('onEnded', handler) }
+	onError(handler) { this.addHandler('onError', handler) }
+	onMetadata(handler) { this.addHandler('onMetadata', handler) }
+	onProgress(handler) { this.addHandler('onProgress', handler) }
+
+	// methods
+	postMsg(cmd, val) {
+		if (this.processNode)
+			this.processNode.port.postMessage({cmd:cmd,val:val})
+	}
+	load(url) {
+		fetch(url)
+		.then(response => response.arrayBuffer())
+		.then(arrayBuffer => this.play(arrayBuffer))
+		.catch(e=>{this.fireEvent('onError', {type: 'Load'})})
+	}
+	play(val) { this.postMsg('play', val) }
+	stop() { this.postMsg('stop') }
+	pause() { this.postMsg('pause') }
+	unpause() { this.postMsg('unpause') }
+	togglePause() { this.postMsg('togglePause') }
+	setRepeatCount(val) { this.postMsg('repeatCount', val) }
+	setPitch(val) { this.postMsg('setPitch', val) }
+	setTempo(val) { this.postMsg('setTempo', val) }
+	setPos(val) { this.postMsg('setPos', val) }
+	setOrderRow(o,r) { this.postMsg('setOrderRow', {o:o,r:r}) }
+	setVol(val) { this.gain.gain.value = val }
+	selectSubsong(val) { this.postMsg('selectSubsong', val) }
+	// compatibility
+	seek(val) { this.setPos(val) }
+	getCurrentTime() { return this.currentTime }
+}

package/chiptune3.worklet.js

@@ -0,0 +1,335 @@
+/*
+	AudioWorklet: DrSnuggles
+*/
+
+import libopenmptPromise from './libopenmpt.worklet.js'
+
+// consts
+const OPENMPT_MODULE_RENDER_STEREOSEPARATION_PERCENT = 2
+const OPENMPT_MODULE_RENDER_INTERPOLATIONFILTER_LENGTH = 3
+
+// vars
+let libopenmpt
+
+// init
+libopenmptPromise()
+.then(res => {
+	libopenmpt = res
+
+	if (!libopenmpt.stackSave) return
+	// set libopenmpt version to display later
+	let stack = libopenmpt.stackSave()
+	libopenmpt.version = libopenmpt.UTF8ToString(libopenmpt._openmpt_get_string(asciiToStack('library_version')))
+	libopenmpt.build = libopenmpt.UTF8ToString(libopenmpt._openmpt_get_string(asciiToStack('build')))
+	libopenmpt.stackRestore(stack)
+})
+.catch(e => console.error(e))
+
+//
+// Helpers
+//
+function asciiToStack(str) {
+	const stackStr = libopenmpt.stackAlloc(str.length + 1)			// DrS: needed to export in emscripten
+	writeAsciiToMemory(str, stackStr)					// no longer in Emscripten, see below
+	return stackStr
+}
+function writeAsciiToMemory(str,buffer,dontAddNull){for(let i=0;i<str.length;++i){libopenmpt.HEAP8[buffer++>>0]=str.charCodeAt(i)}if(!dontAddNull)libopenmpt.HEAP8[buffer>>0]=0}
+
+
+//
+// Processor
+//
+class MPT extends AudioWorkletProcessor {
+	constructor() {
+		super()
+		this.port.onmessage = this.handleMessage_.bind(this)
+		this.paused = false
+		this.config = {
+			repeatCount: -1,		// -1 = play endless, 0 = play once, do not repeat
+			stereoSeparation: 100,	// percents
+			interpolationFilter: 0,	// https://lib.openmpt.org/doc/group__openmpt__module__render__param.html
+		}
+		this.channels = 0
+	}
+
+	process(inputList, outputList, parameters) {
+		if (!this.modulePtr || !this.leftPtr || !this.rightPtr || this.paused) return true	//silence
+
+		const left = outputList[0][0]
+		const right = outputList[0][1]
+
+		const actualFramesPerChunk = libopenmpt._openmpt_module_read_float_stereo(this.modulePtr, sampleRate, left.length, this.leftPtr, this.rightPtr)
+		if (actualFramesPerChunk == 0) {
+			//this.paused = true
+			// modulePtr will be 0 on openmpt: error: openmpt_module_read_float_stereo: ERROR: module * not valid or other openmpt error
+			const error = !this.modulePtr
+			if (error) {
+				this.port.postMessage({cmd:'err',val:'Process'})
+			} else {
+				this.port.postMessage({cmd:'end'})
+			}
+			return true
+		}
+
+		left.set(libopenmpt.HEAPF32.subarray(this.leftPtr / 4, this.leftPtr / 4 + actualFramesPerChunk))
+		right.set(libopenmpt.HEAPF32.subarray(this.rightPtr / 4, this.rightPtr / 4 + actualFramesPerChunk))
+
+		// post progress
+		// 	openmpt_module_get_current_order
+
+		let msg = {
+			cmd: 'pos',
+			pos: libopenmpt._openmpt_module_get_position_seconds(this.modulePtr),
+			// pos in song
+			order: libopenmpt._openmpt_module_get_current_order(this.modulePtr),
+			pattern: libopenmpt._openmpt_module_get_current_pattern(this.modulePtr),
+			row: libopenmpt._openmpt_module_get_current_row(this.modulePtr),
+			// channel volumes
+			//chVol: [], // ch0Left, ch0Right, ch1Left, ...
+		}
+		/*
+		for (let i = 0; i < this.channels; i++) {
+			msg.chVol.push( {
+				left: libopenmpt._openmpt_module_get_current_channel_vu_left(this.modulePtr, i),
+				right: libopenmpt._openmpt_module_get_current_channel_vu_right(this.modulePtr, i),
+			})
+		}
+		*/
+
+		this.port.postMessage( msg )
+
+		return true // def. needed for Chrome
+	}
+
+	handleMessage_(msg) {
+		//console.log('[Processor:Received]',msg.data)
+		const v = msg.data.val
+		switch (msg.data.cmd) {
+			case 'config':
+				this.config = v
+				break
+			case 'play':
+				this.play(v)
+				break
+			case 'pause':
+				this.paused = true
+				break
+			case 'unpause':
+				this.paused = false
+				break
+			case 'togglePause':
+				this.paused = !this.paused
+				break
+			case 'stop':
+				this.stop()
+				break
+			case 'meta':
+				this.meta()
+				break
+			case 'repeatCount':
+				this.config.repeatCount = v
+				if (!this.modulePtr) return
+				libopenmpt._openmpt_module_set_repeat_count(this.modulePtr, this.config.repeatCount)
+				break
+			case 'setPitch':
+				if (!libopenmpt.stackSave || !this.modulePtr) return
+				libopenmpt._openmpt_module_ctl_set(this.modulePtr, asciiToStack('play.pitch_factor'), asciiToStack(v.toString()))
+				break
+			case 'setTempo':
+				if (!libopenmpt.stackSave || !this.modulePtr) return
+				libopenmpt._openmpt_module_ctl_set(this.modulePtr, asciiToStack('play.tempo_factor'), asciiToStack(v.toString()))
+				break
+			case 'selectSubsong':
+				if (!this.modulePtr) return
+				libopenmpt._openmpt_module_select_subsong(this.modulePtr, v)
+				//this.meta()
+				break
+			case 'setPos':
+				if (!this.modulePtr) return
+				libopenmpt._openmpt_module_set_position_seconds(this.modulePtr, v)
+				break
+			case 'setOrderRow':
+				if (!this.modulePtr) return
+				libopenmpt._openmpt_module_set_position_order_row(this.modulePtr, v.o, v.r)
+				break
+			/*
+			case 'toggleMute'
+				// openmpt_module_ext_get_interface(mod_ext, interface_id, interface, interface_size)
+				// openmpt_module_ext_interface_interactive
+				// set_channel_mute_status
+				// https://lib.openmpt.org/doc/group__libopenmpt__ext__c.html#ga0275a35da407cd092232a20d3535c9e4
+				if (!this.modulePtr) return
+				//const extPtr = libopenmpt.openmpt_module_ext_get_interface(mod_ext, interface_id, interface, interface_size)
+				break
+			*/
+			default:
+				console.log('Received unknown message',msg.data)
+		}
+	} // handleMessage_
+
+	play(buffer) {
+		this.stop()
+		
+		const maxFramesPerChunk = 128	// thats what worklet is using
+		const byteArray = new Int8Array(buffer)
+		const ptrToFile = libopenmpt._malloc(byteArray.byteLength)
+		libopenmpt.HEAPU8.set(byteArray, ptrToFile)
+		this.modulePtr = libopenmpt._openmpt_module_create_from_memory(ptrToFile, byteArray.byteLength, 0, 0, 0)
+
+		if(this.modulePtr === 0) {
+			// could not create module
+			this.port.postMessage({cmd:'err',val:'ptr'})
+			return
+		}
+
+		if (libopenmpt.stackSave) {
+			const stack = libopenmpt.stackSave()
+			libopenmpt._openmpt_module_ctl_set(this.modulePtr, asciiToStack('render.resampler.emulate_amiga'), asciiToStack('1'))
+			libopenmpt._openmpt_module_ctl_set(this.modulePtr, asciiToStack('render.resampler.emulate_amiga_type'), asciiToStack('a1200'))
+			//libopenmpt._openmpt_module_ctl_set('play.pitch_factor', e.target.value.toString());
+
+			libopenmpt.stackRestore(stack)
+		}
+		
+		this.paused = false
+		this.leftPtr = libopenmpt._malloc(4 * maxFramesPerChunk)	// 4x = float
+		this.rightPtr = libopenmpt._malloc(4 * maxFramesPerChunk)
+
+		// set config options on module
+		libopenmpt._openmpt_module_set_repeat_count(this.modulePtr, this.config.repeatCount)
+		libopenmpt._openmpt_module_set_render_param(this.modulePtr, OPENMPT_MODULE_RENDER_STEREOSEPARATION_PERCENT, this.config.stereoSeparation)
+		libopenmpt._openmpt_module_set_render_param(this.modulePtr, OPENMPT_MODULE_RENDER_INTERPOLATIONFILTER_LENGTH, this.config.interpolationFilter)
+
+		// post back tracks metadata
+		this.meta()
+	}
+	stop() {
+		if (!this.modulePtr) return
+		if (this.modulePtr != 0) {
+			libopenmpt._openmpt_module_destroy(this.modulePtr)
+			this.modulePtr = 0
+		}
+		if (this.leftBufferPtr != 0) {
+			libopenmpt._free(this.leftBufferPtr)
+			this.leftBufferPtr = 0
+		}
+		if (this.rightBufferPtr != 0) {
+			libopenmpt._free(this.rightBufferPtr)
+			this.rightBufferPtr = 0
+		}
+		this.channels = 0
+	}
+	meta() {
+		this.port.postMessage({cmd: 'meta', meta: this.getMeta()})
+	}
+	getSong() {
+		if (!libopenmpt.UTF8ToString || !this.modulePtr) return false
+
+		// https://lib.openmpt.org/doc/
+		let song = {
+			channels: [],
+			instruments: [],
+			samples: [],
+			orders: [],
+			numSubsongs: libopenmpt._openmpt_module_get_num_subsongs(this.modulePtr),
+			patterns: [],
+		}
+		// channels
+		const chNum = libopenmpt._openmpt_module_get_num_channels(this.modulePtr)
+		this.channel = chNum
+		for (let i = 0; i < chNum; i++) {
+			song.channels.push( libopenmpt.UTF8ToString(libopenmpt._openmpt_module_get_channel_name(this.modulePtr, i)) )
+		}
+		// instruments
+		for (let i = 0, e = libopenmpt._openmpt_module_get_num_instruments(this.modulePtr); i < e; i++) {
+			song.instruments.push( libopenmpt.UTF8ToString(libopenmpt._openmpt_module_get_instrument_name(this.modulePtr, i)) )
+		}
+		// samples
+		for (let i = 0, e = libopenmpt._openmpt_module_get_num_samples(this.modulePtr); i < e; i++) {
+			song.samples.push( libopenmpt.UTF8ToString(libopenmpt._openmpt_module_get_sample_name(this.modulePtr, i)) )
+		}
+		// orders
+		for (let i = 0, e = libopenmpt._openmpt_module_get_num_orders(this.modulePtr); i < e; i++) {
+			song.orders.push( {
+				name: libopenmpt.UTF8ToString(libopenmpt._openmpt_module_get_order_name(this.modulePtr, i)),
+				pat: libopenmpt._openmpt_module_get_order_pattern(this.modulePtr, i),
+			})
+		}
+		// patterns
+		for (let patIdx = 0, patNum = libopenmpt._openmpt_module_get_num_patterns(this.modulePtr); patIdx < patNum; patIdx++) {
+			const pattern = {
+				name: libopenmpt.UTF8ToString(libopenmpt._openmpt_module_get_pattern_name(this.modulePtr, patIdx)),
+				rows: [],
+			}
+			// rows
+			for(let rowIdx = 0, rowNum = libopenmpt._openmpt_module_get_pattern_num_rows(this.modulePtr, patIdx); rowIdx < rowNum; rowIdx++) {
+				const row = []
+				// channels
+				for (let chIdx = 0; chIdx < chNum; chIdx++) {
+					const channel = []
+					for (let comIdx = 0; comIdx < 6; comIdx++) {
+						/* commands
+						OPENMPT_MODULE_COMMAND_NOTE = 0
+						OPENMPT_MODULE_COMMAND_INSTRUMENT = 1
+						OPENMPT_MODULE_COMMAND_VOLUMEEFFECT = 2
+						OPENMPT_MODULE_COMMAND_EFFECT = 3
+						OPENMPT_MODULE_COMMAND_VOLUME = 4
+						OPENMPT_MODULE_COMMAND_PARAMETER = 5
+						*/
+						channel.push( libopenmpt._openmpt_module_get_pattern_row_channel_command(this.modulePtr, patIdx, rowIdx, chIdx, comIdx) )
+					}
+					row.push( channel )
+				}
+				pattern.rows.push( row )
+			}
+			song.patterns.push( pattern )
+		}
+
+
+		return song
+	}
+	getMeta() {
+		if (!libopenmpt.UTF8ToString || !this.modulePtr) return false
+
+		const data = {}
+		data.dur = libopenmpt._openmpt_module_get_duration_seconds(this.modulePtr)
+		if (data.dur == 0) {
+			// looks like an error occured reading the mod
+			this.port.postMessage({cmd:'err',val:'dur'})
+		}
+		const keys = libopenmpt.UTF8ToString(libopenmpt._openmpt_module_get_metadata_keys(this.modulePtr)).split(';')
+		for (let i = 0; i < keys.length; i++) {
+			const keyNameBuffer = libopenmpt._malloc(keys[i].length + 1)
+			writeAsciiToMemory(keys[i], keyNameBuffer)
+			data[keys[i]] = libopenmpt.UTF8ToString(libopenmpt._openmpt_module_get_metadata(this.modulePtr, keyNameBuffer))
+			libopenmpt._free(keyNameBuffer)
+		}
+		data.song = this.getSong()
+		data.totalOrders = data.song.orders.length	// libopenmpt._openmpt_module_get_num_orders(this.modulePtr)
+		data.totalPatterns = data.song.patterns.length// libopenmpt._openmpt_module_get_num_patterns(this.modulePtr)
+		data.songs = this.getSongs()
+		data.libopenmptVersion = libopenmpt.version
+		data.libopenmptBuild = libopenmpt.build
+		return data
+	}
+	getSongs() {
+		if (!libopenmpt.UTF8ToString) return ''	// todo: ?? why string here
+
+		const subsongs = libopenmpt._openmpt_module_get_num_subsongs(this.modulePtr)
+		const names = []
+		for (let i = 0; i < subsongs; i++) {
+			const namePtr = libopenmpt._openmpt_module_get_subsong_name(this.modulePtr, i)
+			const name = libopenmpt.UTF8ToString(namePtr)
+			if(name != "") {
+				names.push(name)
+			} else {
+				names.push("Subsong " + (i + 1))
+			}
+			libopenmpt._openmpt_free_string(namePtr)
+		}
+		return names
+	}
+
+}
+
+registerProcessor('libopenmpt-processor', MPT)