
Katana-MK2-FxFloorBoard Copyright (C) 2007~2024 Colin Willcocks (gumtownbassman@yahoo.com).
 All rights reserved.
======================================================================================

Katana-MK2-FxFloorBoard patch editor for the Boss Katana MKii Amp FIRMWARE level 2 - 
       version 20240515: 15 May 2024.(64 bit version)
*****************************************************
YOU MAY FREELY USE THIS SOFTWARE FOR NON-COMERCIAL USE, BUT PLEASE FEEL FREE TO DONATE, 
 JUST KEEP IN MIND THE 10,000's of HOURS SPENT OVER 15 YEARS GETTING IT HERE,
  I WOULD LOVE A BEER !!!. :-)  YOUR CONTRIBUTION WILL HELP WITH FUTURE UPDATES.
  I do this im my own time at my own cost, no one is paying me, but you can donate for future support.

DONATE PAYPAL LINK IN THE EDITOR, LOOK UNDER THE HELP MENU, PLEASE DONATE IF YOU DECIDE TO USE THIS SOFWARE.
***********************************************************************************
NoTE: If you paid for this software through a 3rd party reseller/retailer, then the reseller has
      illegally sold this software. This software is available for free download at the SourceForge
      sites only, and donations to the author are optional. 


 ********* LATEST FEATURES ADDED****************************************************
 * version
 * 
 * 20231223 Huge improvements and fixes, midi patch loader, added more Global assigns (now 32), visual updates. 
 *
 * 20220927 MK2 feature refinements, streamining, and bug fixes.
 *
 * beta 0.01 MK2 Firmware 2 total rebuild with many new features.
 *
 * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
 *
 * 20210107 MK2 re-instated deBug sysx messages.
 * 
 * 20201231 MK2 update added font manual resizing in preferences menu, new patch file audition and load. 
 * 
 *version
 * 20201007 MK2 update fixed midi port handler on Katana and midi controller device input, fixed Patch Loader midi channel Assigning.
 *
 * 20200917 MK2 update with bug fixes and feature updates.
 *
 * 20200330 MK2 version beta, new program name and install folder separated from the MK1 editor to allow both versions to co-exist,
 *  fixed patch naming, labels, and Clipboard. 
 *
 * 20200324 MKii version beta release.
 *
 * 20200311 MKii version alpha release.
 *
 * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *  
 * 20190820 Fixed *.tsl file saving format issues.
 *
 * 20190525 Bug fixes.
 *
 * 20190202 Bug fix, Main EQ effect not saving in *.tsl file.
 *
 * 20190108 Firmware 3 update. new effects and EXP/Panel Knob Assigns, many feature enhancements and bug fixes.
 *
 * 20180426 Font scaling dependant on screen DPI, smoothed upscale texturing, midi I/O tweaks for mac.
 *
 * 20180304 Fixed patch selection Tree and patch file alignment, added Kat model selection.
 *
 * 20180301 All Firmware Version 2 parameters added, GUI refinements, bug fixes.
 *
 * 20171222 Version 2 Firmware support.
 *
 * 20170803 Completed patch loader and assigns, auto save global assigns added, patch tree and patch write fixes.
 *
 * 20170720 Begun work on patch loader and assigns.
 *
 * 20170524 Fixed GT-8 file compatibility.
 *
 * 20170516 GOT A KATANA !!! Thank You to all who donated, very much appreciated. 
 *         Fixed patch write, channel selection, patch loading, system loading.
 *         
 * 20170428 removed unused time based BPM effect parameters, minor adjustments to patch file format.
 *
 * 20170424 added system settings, panel knobs and leds, moved S/R loop to system, restructured system file, glowing Katana logo. 
 *
 * 20170421 another slight adjustment to sysx patch file format, added 3 option controls associated with Knob Panel LED effects.
 *         added auto save of last received patch file while in deBug mode.
 *
 * 20170420 new layout with redundant effects removed, re-aligned sysx file structure to accomodate Katana pnel l.e.d.s
 *         fixed patch selection and channel naming.
 *         Still has legacy GT... file conversion for opening/loading GT-100, GT-001, GT-10, GT-10B, GT-8, GT6B, GT-1, ME-80 patch files.
 *         Patch file writing to Katana should work, still uncertain of file structure, as I do not have a Katana to use, but you can donate
 *         from the Donate link in the editor help menu if you want to contribute a little toward a Katana, 
 *         so i can quickly finish this free editor.
 *
 * 20170414 adjusted patch tree layout and patch request. 
 *         Removed preamp speaker caninets as they are confirmed not usable.
 *         Installed system data collection from File menu 'Save System data'. send saved systen file to gumtownbassman@yahoo.com thanks.
 *
 * 20170412 changed the Patch Tree layout to match the Katana patch structure, and should populate with Katana channel patches.
 *         Renamed some effect units to match the Katana.
 *
 * 20170411 modified the system eclusive data format and tweaked the read in of patch data.
 *
 * 20170408 added sysx ID for connection and fine tuned midi  I/O 
 *
 * 20170407 initial upload with GT-100 editor ported to send Katana format parameter data, 
 *         experiment to see if the Katana will respond to extra parameters hidden within the system exclusive data framework 
 *         which seems to be based on a common model of the GT-100, GT-001, GT1.
 *


********* FIRST USE CONNECTION HINTS ************** 

a.) Connect the KATANA via a USB cable, 
	ensure the Boss usb driver software is installed..
	or use a CME WIDI uHost or Airstep Bluetooth device

b.) Start the FxFloorBoard program, if the Katana does not initially "connect", 
open the Tools/Preferences Menu, select Midi/USB and select the "KATANA CTRL" USB midi device for midi input and output.

c.) Select the OK button, and the software will restart with the new settings applied,
     if all is well the "CONNECT" button should change to "CONNECTED" and remain lit green.

d.) Open the Patch-Tree side panel by clicking your mouse pointer on the 'yellow arrow' on the left side (if it is closed), 
the Patch-Tree has items which will expand when you click on the [+] symbols.
 When the tree items expand, you will see the patch names appear as the editor requests this information from the Katana.

e.) A single mouse pointer click on the Patch-Tree name will change the Katana to that selected patch,
	and the patch information from the Katana will load into the editor, 
	all the patch settings will update the editor GUI. 
   - sound played through the KATANA will have the sound of that patch.

f.) Any knob turning will change the sound of the effect being adjusted, 
when the desired sound is achieved, you can either save the patch to the Katana or save the patch to file on disk.

g.) To save the patch to the KATANA, press the "Write" button, and select a location to save, 
	or use the "Quick_Save" function which will save the patch with the same name as the name seen in the editor.  


KATANA FxFloorBoard: 
NOTE: THIS IS AN UN-PAID PROJECT, INVESTING MANY 10,000's HOURS OF MY TIME OVER 18 YEARS.
I am not employed by Roland/Boss, nor is Roland/Boss affiliated with the software.
 
I WILL NOT ACCEPT LIABILITY FOR ANY DATA LOSS, TO THE BEST OF MY KNOWLEDGE EVERYTHING SHOULD WORK CORRECTLY. 

This project is a continuing session of evolution.........

IF YOU FIND A BUG OR HAVE SOME ISSUES......
reply email to gumtownbassman@yahoo.com


This program is free software; you can redistribute it and/or modify it under 
the terms of the GNU General Public License as published by the Free Software 
Foundation; either version 2 of the License, or (at your option) any later 
version.

This program is distributed in the hope that it will be useful, but WITHOUT 
ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS 
FOR A PARTICULAR PURPOSE.  See the GNU General Public License for more 
details.

This software is not for sale - if you paid for it, there seller has comitted 
an act of piracy and is subject to software piracy laws. For commercial use, 
a commercial licence must be obtained from the software author.

You should have received a copy of the GNU General Public License along with 
this program; if not, write to the Free Software Foundation, Inc., 675 Mass 
Ave, Cambridge, MA 02139, USA.


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

To install:

BINARY:
------

WIN: Run KATANAFxFloorBoard.exe installer

OS/X: Run the installer DMG package, the App will install into the Applications folder, 
the patch data will be found in the Shared/Katana_Mk2_FxFloorBoard/folder.

LINUX: Unpackage/decompress to Desktop, launch from the command-line.


SOURCE:
------

WIN: Source code for all platforms is available on the FxFloorBoard SourceForge site.

OS/X:

LINUX:


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

CONTACT:
------

Colin Willcocks <gumtownbassman@yahoo.com>


DISCLAIMER:
------

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 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.


LEGAL:
------

KATANAFxFloorBoard Copyright (C)2007~2024 Colin Willcocks <gumtownbassman@yahoo.com>.
based on the GT8FxFloorBoard Copyright (C)2005~2007 Uco Mesdag.

Windows(TM) are Copyright (C)Microsoft Corporation. 
All rights reserved.

