--------------------------------------------------------------------------------------------------------

- MIDI2MV - (MIDI to Master Volume) 

--------------------------------------------------------------------------------------------------------

 This tool allows you to control your Audio Out device volume (including muting) and 
 to set the default Audio device dynamically by using a MIDI controller.
 This includes rotary knobs, faders, pads and keys (MIDI CC and SysEx data).
 It runs in the background (system tray).

  
- USAGE -

 MIDI Controllers can be mapped to various parameters of the current Audio Out device via the MIDI MAP button.
 Audio Out and MIDI In can be muted via their associated MUTE buttons.
 A global hotkey can also be set in the Setup dialog to mute/unmute MIDI In.
 MIDI Thru device can be set which can be useful with a MIDI loopback device/port so the incoming MIDI data can be used in other applications
 (Each MIDI port in Windows is only available for one application at a time).
 Pressing the [ESC] key minimizes the tool to the system tray.
 Settings (settings.dat) will be saved in same directory where the executable resides.
 
 
- INSTALLATION -

 The executable can be run from anywhere you like.
 No installation required.
 
  
- REQUIREMENTS -

 Windows Vista/7 +
 .NET 4.5
 Audio Interface
 MIDI In capable device
 
 
--------------------------------------------------------------------------------------------------------  
- CHANGES -

 v2021.1.1   : 	  - added support for SysEx data for MIDI Mapping
				  - mappable parameters : Volume, Mute (Toggle), Default device (Cycle)

 v2020.1.1   : 	  - detect plugged in USB MIDI devices 

 v2019.10.2  : 	  - fixed silent crash which happened when unplugging a USB MIDI device

 v2019.10.1  : 	  - added MIDI Thru :
					since in Windows a MIDI port can only be opened by one application at a time,
					you can set MIDI Thru to a virtual MIDI port and use it as MIDI input 
					in another application:
					
					MIDI IN (device A) -> MIDI2MV -> MIDI Thru (device B)  |  MIDI IN (device B) -> DAW  

				  - added selectable OSD duration (in setup screen)

 v2017.1.4.5 :    - fixed crash which happened when a USB device was plugged in and
						  unplugged immediately
 
 v2016.34.4.5 :  - fixed crash which happened on systems using Realtek onboard sound
						- added : the tool now always controls the default audio device and
						  detects if the device was changed
 
 v2015.4.4.5 : - support for .NET 4.5 clients
 
 v2015.4.4.0 : - support for .NET 4.0 clients
					  - added optional OSD
 
 v2015.1 : - reworked UI
				- switched to managed code
 
 v1.4  : - set hotkey combination from systray icon to dis-/enable MIDI input
		 - indicate state in systray icon
		 - remember selected MIDI device
		 - check if default audio device has changed
		 
 v1.3  : - added "per Channel" mode which is useful for MIDI devices which send multiple 
		   CC IDs with one controller
		
 v1.2  : - autostart and "start minimized" added
 v1.1  : - bugfixes
 v1.0  : - initial release


--------------------------------------------------------------------------------------------------------
   
- CONTACT -

 http://dev.strobotone.de
 md@strobotone.de
 https://soundcloud.com/strobotone
 
-------------------------------------------------------------------------------------------------------- 

- LICENCE -

 If like this software and use it a lot please consider donating a small amount to
 support it. Many thanks !

 This program is freeware. This means you can use it as you wish, and distribute it 
 as long as all the contents of the archive including this text file and 
 the directory structure remain unmodified. 
 You are not allowed to charge any fee for redistributing this archive.

 This archive and all the contained programs are (C) Martin Dombrowa [strobotone],
 all rights reserved. 


 DISCLAIMER:

 BECAUSE THE PROGRAM IS LICENSED FREE OF CHARGE, THERE IS NO WARRANTY
 FOR THE PROGRAM, TO THE EXTENT PERMITTED BY APPLICABLE LAW.  EXCEPT WHEN
 OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR OTHER PARTIES
 PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED
 OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
 MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.  THE ENTIRE RISK AS
 TO THE QUALITY AND PERFORMANCE OF THE PROGRAM IS WITH YOU.  SHOULD THE
 PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY SERVICING,
 REPAIR OR CORRECTION.

 IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING
 WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY AND/OR
 REDISTRIBUTE THE PROGRAM, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY 
 GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE 
 USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED TO LOSS OF 
 DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD 
 PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER PROGRAMS), 
 EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF 
 SUCH DAMAGES.