GNMIDI User Tools

GNMIDI user tools

are Win32 DLL libraries that can be used as plugin inside GNMIDI application for converting single files or batch converting folders.
GNMIDI contains a demo user tool that demonstrates the usage of a tool in menu convert and batch conversions.
GNMIDI screenshot

New user tools can be programmed for your special needs.
Some user tools are directly available as standard tools.
Contact the author if you want to order a new programmed tool or a standard MIDI tool to get the price.
Price might depend on work time for new tools and commercial (company) or noncommercial private use.
The user tools can also be used within GNMIDI 3 Professional application (requires a GNMIDI 3 Professional license).
The tools also work without GNMIDI using tool gnbatchdialog (is included).

Standard user tool toolreplacetext

Mighty search and replace text in one or many MIDI files. It supports simple text replacing and regular expression searching and replacing and special programming conditions to reduce the matches to the wanted ones.
License for toolreplacetext costs 18 Euro (incl. vat).

Options
Text type	combo box	search and replace in all MIDI META text types or only in MIDI events with certain META text type (e.g. trackname, lyric, marker ...). copyright events are not replaced (for safety of copyright owners).
Pattern	edit box	the text (or part) that must be found in original text. When regular expression option is used then the box must contain a regular expression (e.g. [A-Z]+[0-9]+).
Replace	edit box	the text (or part) that replaces the matching pattern.When regular expression option is used then the box must contain a regular expression (e.g. [A-Z]+[0-9]+).
Ignore case	check box	When ignore case option is used the letters in pattern are also matching if the case is different (e.g. AEIOU matches aeiou).
whole match only	check box	Using whole match only option the pattern must match the whole text of a MIDI event. If pattern matches only a part of the text then it is ignored.
whole words only	check box	Using whole words only option the pattern must match whole words of text. If pattern matches a part inside a word it is ignored.
line by line	check box	each line is searched and replaced independent (is default). Otherwise the whole text is searched and replaced by one step (e.g. useful for multiple line search and replacing). The whole match only option has therefore sometimes meaning whole line or whole text.
Regular expressions (for experts)	check box	When using regular expressions then the pattern and replace option fields must contain regular expressions that allow mighty searching and replacing. The regular expressions support also groups using (...) inside pattern and referencing groups by number e.g. \1 inside pattern and also using the found text matching by a group inside replace text by number e.g. $1 . The option should be used by experts. It requires some experimenting with regular expressions (hint: use option confirm to see the results directly on screen)
confirm every possible match	check box	Using confirm option the tool will show a message box dialog for every found matching text and how it would be changed. The user must answer with yes or no or can abort the tool with cancel.
encodenotascii	check box	using this option converts characters 80-FF to hexadecimal text Q_xHH_E before searching and these code patterns back to characters in replaced result text. Since regular expression \xHH only allows smaller ASCII code values 00-7F and some character might be difficult to enter into the edit box this option gives possible access to these characters e.g. Q_xC3_EQ_x84_E is utf-8 sequence C3 84 for utf-8 character encoded Ä Only use this option if your patterns or replace field uses these coding.
no changes	check box	Using no changes option the MIDI file will not be changed after having found matching patterns. It shows the matches and replacements only in the log file.
condition (for programmers)	edit box	The tool allows access to information about current matching MIDI text event and use expressions similar to C programming language in this field e.g. ev.startms >= 22000 && ev.startms <= 25000 (that limits matches to the given time range in milliseconds). e.g. ev.text.toupper().containstext('COLD') (this limits matches to text that contain text part COLD independent on letter case). If the condition is not matching then the match is not replaced. If the condition has invalid syntax then the tool aborts with an error message in log file. The condition expressions are very mighty (including regular expressions operators). By default no condition is checked (option is empty).
Documentation	PDF (English)	(including example expressions)

Standard user tool toolreplacetextinfile

Mighty search and replace text in one or many Text files (e.g. *.txt, *.csv, *.ini). It supports simple text replacing and regular expression searching and replacing and special programming conditions to reduce the matches to the wanted ones.
License for toolreplacetextinfile costs 18 Euro (incl. vat).

Options
Pattern	edit box	the text (or part) that must be found in original text. When regular expression option is used then the box must contain a regular expression (e.g. [A-Z]+[0-9]+).
Replace	edit box	the text (or part) that replaces the matching pattern.When regular expression option is used then the box must contain a regular expression (e.g. [A-Z]+[0-9]+).
Ignore case	check box	When ignore case option is used the letters in pattern are also matching if the case is different (e.g. AEIOU matches aeiou).
whole match only	check box	Using whole match only option the pattern must match the whole text of a line or full text. If pattern matches only a part of the text then it is ignored.
whole words only	check box	Using whole words only option the pattern must match whole words of text. If pattern matches a part inside a word it is ignored.
Regular expressions (for experts)	check box	When using regular expressions then the pattern and replace option fields must contain regular expressions that allow mighty searching and replacing. The regular expressions support also groups using (...) inside pattern and referencing groups by number e.g. \1 inside pattern and also using the found text matching by a group inside replace text by number e.g. $1 . The option should be used by experts. It requires some experimenting with regular expressions (hint: use option confirm to see the results directly on screen)
confirm every possible match	check box	Using confirm option the tool will show a message box dialog for every found matching text and how it would be changed. The user must answer with yes or no or can abort the tool with cancel.
encodenotascii	check box	using this option converts characters 80-FF to hexadecimal text Q_xHH_E before searching and these code patterns back to characters in replaced result text. Since regular expression \xHH only allows smaller ASCII code values 00-7F and some character might be difficult to enter into the edit box this option gives possible access to these characters e.g. Q_xC3_EQ_x84_E is utf-8 sequence C3 84 for utf-8 character encoded Ä Only use this option if your patterns or replace field uses these coding.
no changes	check box	Using no changes option the text file will not be changed after having found matching patterns. It shows the matches and replacements only in the log file.
verbose	check box	All replacements to the text files are listed in the log file.
condition (for programmers)	edit box	(default: empty, no condition) allows to specify a condition in which case the match is accepted. condition can check linenumber or line or filename. e.g. line.toupper().containstext('COLD') && linenumber >= 10
Documentation	PDF (English)	(including example expressions)

Standard user tool toolmidinote

converts a MIDI file to easy readable text by user (example result text) and machines/software (example result text).
License for toolmidinote costs 18 Euro (incl. vat).

Standard user tool toolnote2mid

converts a text file generated by toolmidinote back to a MIDI file.
License for toolnote2mid costs 18 Euro (incl. vat).

Standard user tool toolmididmp

converts a MIDI file to easy readable text by user (example result text) and machines/software (example result text).
License for toolmididmp costs 18 Euro (incl. vat).

Standard user tool tooldmp2midi

converts a text file generated by toolmididmp back to a MIDI file.
License for tooldmp2midi costs 18 Euro (incl. vat).

Standard user tool syx2midi

converts a .syx binary file that contains MIDI commands from MIDI protocol to a MIDI file.
Can also convert a hex dump text file that contains hexadecimal MIDI commands to a MIDI file.
Optionally insert pause with given duration after each sysex comand.
License for toolsyx2midi costs 18 Euro (incl. vat).

Standard user tool midi2syx

converts a .mid file to a binary .syx file.
License for toolmidi2syx costs 18 Euro (incl. vat).

Standard user tool for programmers (MIDI files programming)

modifies, converts, analyses MIDI files using a mighty programming language gnmidiscript (same syntax as our programming language gnscript extended by MIDI file operations and full access to MIDI commands of a MIDI song).
Single file and batch conversion inside GNMIDI Professional 3 menus. Including commandline interpreter gnmidiscript.exe for programming, debugging, profiling, testing your new tool with your test MIDI files.
Example scripts and language description can be found here.
A single user license for toolgnmidiscript costs 300 Euro (incl. vat).
For nonprogrammers who need an own MIDI tool should contact us. Probably we can program a MIDI tool using this script language for you.

www.gnmidi.com

Contact