From 4d758ff5be8caa8ee0f148cbd7983609331def1e Mon Sep 17 00:00:00 2001
From: Florian Streibelt <github@f-streibelt.de>
Date: Mon, 1 Mar 2021 19:28:07 +0100
Subject: [PATCH 01/14] fixing the automap color values for upper row of LEDs

---
 launchpad_py/launchpad.py | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/launchpad_py/launchpad.py b/launchpad_py/launchpad.py
index dd8abed..2da2104 100644
--- a/launchpad_py/launchpad.py
+++ b/launchpad_py/launchpad.py
@@ -511,12 +511,12 @@ def LedCtrlAutomap( self, number, red, green ):
 		if number < 0 or number > 7:
 			return
 
-		red   = min( 0, red )
-		red   = max( 7, red )
-		green = min( 0, green )
-		green = max( 7, green )
+		red   = max( 0, red )
+		red   = min( 3, red )
+		green = max( 0, green )
+		green = min( 3, green )
 		led = self.LedGetColor( red, green )
-		
+
 		self.midi.RawWrite( 176, 104 + number, led )
 
 

From b569c226c52eeadad3f8cd49cb4bbe161096551a Mon Sep 17 00:00:00 2001
From: FMMT666 <FMMT666@users.noreply.github.com>
Date: Fri, 23 Apr 2021 23:53:15 +0200
Subject: [PATCH 02/14] added Mk1 link to driver

---
 README.md | 11 ++++++++++-
 1 file changed, 10 insertions(+), 1 deletion(-)

diff --git a/README.md b/README.md
index 5ef62d2..33c48af 100644
--- a/README.md
+++ b/README.md
@@ -28,7 +28,7 @@ Now with full [Midi Fighter 64][23] support (8/2020).
 Finally! Hehe, say hello to the [Mk3 Pro][24] (8/2020)  
 
 ---
-## STATUS 2021/01/xx:
+## STATUS 2021/04/xx:
 
 ### Devices
 
@@ -86,6 +86,9 @@ Successfully tested with Ubuntu 18.04-LTS+. Requires compiling your own PyGame t
 ---
 ## NEWS
 
+### CHANGES 2021/04/XX:
+    - added link to driver for Mk1 Launchpad and Mini
+
 ### CHANGES 2021/01/XX:
     - fix for Python 3.9
     - updated documentation for raw LED and button codes (top row had wrong values)
@@ -755,6 +758,11 @@ name it once shipped the first red/green LED with!
 
 ### For Launchpad Mk1 users (the original "Classic" Launchpad):
 
+  Also valid for the Mk1 Mini.
+
+  (Most likely still) requires an USB driver for Windoze (7/10/...).  
+  Look out for the Novation [USB Driver 2.xx][26].  
+
       USE CLASS "Launchpad":
       
         lp = launchpad.Launchpad()
@@ -3175,3 +3183,4 @@ FMMT666(ASkr)
 [23]: https://twitter.com/FMMT666/status/1299842680533463043
 [24]: https://twitter.com/FMMT666/status/1299478117497688073
 [25]: https://www.midifighter.com/
+[26]: https://customer.novationmusic.com/en/support/downloads?brand=Novation&product_by_type=510&download_type=all

From 33c2f497afa161887a6cc0440307411fcf2beff4 Mon Sep 17 00:00:00 2001
From: FMMT666 <FMMT666@users.noreply.github.com>
Date: Sun, 25 Apr 2021 01:55:05 +0200
Subject: [PATCH 03/14] added fix note

---
 README.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/README.md b/README.md
index 33c48af..cbda67e 100644
--- a/README.md
+++ b/README.md
@@ -88,6 +88,7 @@ Successfully tested with Ubuntu 18.04-LTS+. Requires compiling your own PyGame t
 
 ### CHANGES 2021/04/XX:
     - added link to driver for Mk1 Launchpad and Mini
+    - fixed Mk1 Automap buttons always yellow; thx to mutax and Ferada
 
 ### CHANGES 2021/01/XX:
     - fix for Python 3.9

From 1f51f5db0df2bb9dc4a0ab3eccd8a3f006eb1a2c Mon Sep 17 00:00:00 2001
From: Jean-Marie Favreau <j-marie.favreau@uca.fr>
Date: Sun, 2 May 2021 19:37:31 +0200
Subject: [PATCH 04/14] Fix a script in case using a Luanchpad midi

---
 examples/buttons_raw.py | 1 +
 1 file changed, 1 insertion(+)

diff --git a/examples/buttons_raw.py b/examples/buttons_raw.py
index 346d2d4..2602836 100644
--- a/examples/buttons_raw.py
+++ b/examples/buttons_raw.py
@@ -81,6 +81,7 @@ def main():
 			mode = "F64"
 
 	else:
+		lp = launchpad.Launchpad()
 		if lp.Open():
 			print("Launchpad Mk1/S/Mini")
 			mode = "Mk1"

From f497ff2dacdf9099b675c3dd2453f0932a89c342 Mon Sep 17 00:00:00 2001
From: FMMT666 <FMMT666@users.noreply.github.com>
Date: Thu, 6 May 2021 23:59:49 +0200
Subject: [PATCH 05/14] added Midi Fighter 3D snippets

---
 README.md                 |   6 ++
 examples/buttons_raw.py   |  10 ++-
 launchpad_py/launchpad.py | 130 +++++++++++++++++++++++++++++++++++++-
 3 files changed, 143 insertions(+), 3 deletions(-)

diff --git a/README.md b/README.md
index cbda67e..21a6631 100644
--- a/README.md
+++ b/README.md
@@ -56,6 +56,8 @@ Finally! Hehe, say hello to the [Mk3 Pro][24] (8/2020)
 
     Midi Fighter 64    - class "MidiFighter64"      LEDs and buttons
 
+    Midi Fighter 3D    - class "MidiFighter63D      IN WORK
+
 
 > PRO MK3 USERS:  
 > You need to disable the Launchpad's "Transmit Clock" in the MIDI settings!  
@@ -86,6 +88,10 @@ Successfully tested with Ubuntu 18.04-LTS+. Requires compiling your own PyGame t
 ---
 ## NEWS
 
+### CHANGES 2021/05/XX:
+    - fixed Launchpad Mk1 code in buttons_raw.py demo; thx to jmtrivial
+    - added first Midi Mighter 3D code
+
 ### CHANGES 2021/04/XX:
     - added link to driver for Mk1 Launchpad and Mini
     - fixed Mk1 Automap buttons always yellow; thx to mutax and Ferada
diff --git a/examples/buttons_raw.py b/examples/buttons_raw.py
index 2602836..e17b81d 100644
--- a/examples/buttons_raw.py
+++ b/examples/buttons_raw.py
@@ -2,10 +2,10 @@
 #
 # Quick button test.
 # Works with these Launchpads: Mk1, Mk2, Mini Mk3, S/Mini, Pro, Pro Mk3
-# And these:                   Midi Figther 64
+# And these:                   Midi Fighter 64, Mifi Fighter 3D
 # 
 #
-# FMMT666(ASkr) 7/2013..8/2020
+# FMMT666(ASkr) 7/2013..5/2021
 # www.askrprojects.net
 #
 
@@ -80,6 +80,12 @@ def main():
 			print("Midi Fighter 64")
 			mode = "F64"
 
+	elif launchpad.MidiFighter3D().Check( 0 ):
+		lp = launchpad.MidiFighter3D()
+		if lp.Open( 0 ):
+			print("Midi Fighter 3D")
+			mode = "F3D"
+
 	else:
 		lp = launchpad.Launchpad()
 		if lp.Open():
diff --git a/launchpad_py/launchpad.py b/launchpad_py/launchpad.py
index 2da2104..af42ae1 100644
--- a/launchpad_py/launchpad.py
+++ b/launchpad_py/launchpad.py
@@ -4,7 +4,7 @@
 #
 # https://github.com/FMMT666/launchpad.py
 # 
-# FMMT666(ASkr) 01/2013..09/2019..08/2020..01/2021
+# FMMT666(ASkr) 01/2013..09/2019..08/2020..05/2021
 # www.askrprojects.net
 #
 #
@@ -3096,6 +3096,134 @@ def Reset( self ):
 
 
 
+########################################################################################
+### CLASS MidiFighter3D
+###
+### For Midi Fighter 3D Gedöns
+########################################################################################
+class MidiFighter3D( LaunchpadBase ):
+
+	#         
+	# LED AND BUTTON NUMBERS IN RAW MODE
+	#         
+	#         +---+---+---+---+ 
+	#         | XX|   |   | XX| 
+	#   +---+ +---+---+---+---+ +---+
+	#   | XX| | XX|   |   | XX| |XX |
+	#   | XX| +---+---+---+---+ |XX |
+	#   | XX| | XX|   |   | XX| |XX |
+	#   +---+ +---+---+---+---+ +---+
+	#         | XX|   |   | XX| 
+	#         +---+---+---+---+ 
+	#         +---+---+---+---+ 
+	#         | XX|   |   | XX| 
+	#         +---+---+---+---+ 
+	#
+	#
+	# LED AND BUTTON NUMBERS IN XY MODE (X/Y)
+	#
+	#         +---+---+---+---+ 
+	#         | XX|   |   | XX| 
+	#   +---+ +---+---+---+---+ +---+
+	#   | XX| | XX|   |   | XX| |XX |
+	#   | XX| +---+---+---+---+ |XX |
+	#   | XX| | XX|   |   | XX| |XX |
+	#   +---+ +---+---+---+---+ +---+
+	#         | XX|   |   | XX| 
+	#         +---+---+---+---+ 
+	#         +---+---+---+---+ 
+	#         | XX|   |   | XX| 
+	#         +---+---+---+---+ 
+
+
+	#-------------------------------------------------------------------------------------
+	#-- Add some LED mode "constants" for better usability.
+	#-------------------------------------------------------------------------------------
+	def __init__( self ):
+
+		# TODO TODO TODO
+
+		self.MODE_BRIGHT        = [ i+18 for i in range(16) ]
+		self.MODE_TOGGLE        = [ i+34 for i in range(8) ]
+		self.MODE_PULSE         = [ i+42 for i in range(8) ]
+		self.MODE_ANIM_SQUARE   = 50
+		self.MODE_ANIM_CIRCLE   = 51
+		self.MODE_ANIM_STAR     = 52
+		self.MODE_ANIM_TRIANGLE = 53
+
+		super( MidiFighter3D, self ).__init__( )
+
+
+
+	#-------------------------------------------------------------------------------------
+	#-- Opens one of the attached Launchpad MIDI devices.
+	#-- Uses search string "Fighter 3D", by default.
+	#-------------------------------------------------------------------------------------
+	# Overrides "LaunchpadBase" method
+	def Open( self, number = 0, name = "Fighter 3D" ):
+		return super( MidiFighter3D, self ).Open( number = number, name = name )
+
+
+	#-------------------------------------------------------------------------------------
+	#-- Checks if a device exists, but does not open it.
+	#-- Does not check whether a device is in use or other, strange things...
+	#-- Uses search string "Fighter 3D64", by default.
+	#-------------------------------------------------------------------------------------
+	# Overrides "LaunchpadBase" method
+	def Check( self, number = 0, name = "Fighter 3D" ):
+		return super( MidiFighter3D, self ).Check( number = number, name = name )
+
+
+	#-------------------------------------------------------------------------------------
+	#-- Returns the raw value of the last button change (pressed/unpressed) as a list
+	#-- [ <button>, <velocity> ], in which <button> is the raw number of the button and
+	#-- <velocity> the button state.
+	#--   >0 = button pressed; 0 = button released
+	#-------------------------------------------------------------------------------------
+	def ButtonStateRaw( self ):
+		if self.midi.ReadCheck():
+			a = self.midi.ReadRaw()
+
+			# The Midi Fighter 64 does not support velocities. For 500 bucks. Lol :'-)
+			# What we see here are either channel 3 or 2 NoteOn/NoteOff commands,
+			# the factory settings, depending on the "bank selection".
+			#   Channel 3 -> hold upper left  button for longer than 2s
+			#   Channel 2 -> hold upper right button for longer than 2s
+			#
+			#    [[[146, 81, 127, 0], 47365]]
+			#    [[[130, 81, 127, 0], 47443]]
+			#    [[[146, 82, 127, 0], 47610]]
+			#
+			#    [[[ <NoteOn/Off>, <button>, 127, 0], 47610]]
+			#
+			#    146/145 -> NoteOn
+			#    130/129 -> NoteOff
+			#    127     -> fixed velocity (as set by the Midi Fighter utility )
+
+			# Mhh, I guess it's about time to think about adding MIDI channels, isn't it?
+			# But for now, we just check ch 2 and 3:
+			if a[0][0][0] == 145 or a[0][0][0] == 146:
+				return [ a[0][0][1], a[0][0][2] ]
+			else:
+				if a[0][0][0] == 130 or a[0][0][0] == 129:
+					return [ a[0][0][1], 0 ]
+				else:
+					return []
+		else:
+			return []
+
+
+	#-------------------------------------------------------------------------------------
+	#-- Reset the Midi Fighter
+	#-- Well, at least turn off all its LEDs
+	#-------------------------------------------------------------------------------------
+	def Reset( self ):
+		# TODO
+		# self.LedAllOn( 0 ) 
+		pass
+
+
+
 ########################################################################################
 ### CLASS LaunchpadPROMk3
 ###

From 81981c93a51d9e10d592668278c5dbd069a0f97a Mon Sep 17 00:00:00 2001
From: FMMT666 <FMMT666@users.noreply.github.com>
Date: Fri, 7 May 2021 00:16:39 +0200
Subject: [PATCH 06/14] typos sock

---
 README.md | 58 +++++++++++++++++++++++++++++++++++++++++++++++++++++--
 1 file changed, 56 insertions(+), 2 deletions(-)

diff --git a/README.md b/README.md
index 21a6631..1c0e527 100644
--- a/README.md
+++ b/README.md
@@ -27,6 +27,8 @@ Now with full [Midi Fighter 64][23] support (8/2020).
 
 Finally! Hehe, say hello to the [Mk3 Pro][24] (8/2020)  
 
+And here comes the ***CENSORED SO FAR*** (5/2021)
+
 ---
 ## STATUS 2021/04/xx:
 
@@ -56,7 +58,7 @@ Finally! Hehe, say hello to the [Mk3 Pro][24] (8/2020)
 
     Midi Fighter 64    - class "MidiFighter64"      LEDs and buttons
 
-    Midi Fighter 3D    - class "MidiFighter63D      IN WORK
+    Midi Fighter 3D    - class "MidiFighter3D       IN WORK
 
 
 > PRO MK3 USERS:  
@@ -90,7 +92,7 @@ Successfully tested with Ubuntu 18.04-LTS+. Requires compiling your own PyGame t
 
 ### CHANGES 2021/05/XX:
     - fixed Launchpad Mk1 code in buttons_raw.py demo; thx to jmtrivial
-    - added first Midi Mighter 3D code
+    - added first Midi Fighter 3D code
 
 ### CHANGES 2021/04/XX:
     - added link to driver for Mk1 Launchpad and Mini
@@ -3159,6 +3161,58 @@ The mode keys return:
 
 
 
+---
+## (TODO) Led and Button codes, Midi Fighter 3D
+
+### RAW Mode
+
+  Button codes depend on the selected bank, the bottom row with the small buttons.
+  Indicated with a ```###``` in here.
+  
+           +---+---+---+---+               +---+---+---+---+      
+           | 39|   |   | 36|               | 55|   |   | 52|      
+     +---+ +---+---+---+---+ +---+   +---+ +---+---+---+---+ +---+
+     |   | | 43|   |   | 40| |   |   |   | | 59|   |   | 56| |   |
+     |   | +---+---+---+---+ |   |   |   | +---+---+---+---+ |   |
+     |   | | 47|   |   | 44| |   |   |   | | 63|   |   | 60| |   |
+     +---+ +---+---+---+---+ +---+   +---+ +---+---+---+---+ +---+
+           | 51|   |   | 48|               | 67|   |   | 64|      
+           +---+---+---+---+               +---+---+---+---+      
+           +---+---+---+---+               +---+---+---+---+      
+           |   |   |   |###|               |   |   |###|   |      
+           +---+---+---+---+               +---+---+---+---+      
+
+           +---+---+---+---+               +---+---+---+---+      
+           | 71|   |   | 68|               | 87|   |   | 84|      
+     +---+ +---+---+---+---+ +---+   +---+ +---+---+---+---+ +---+
+     |   | | 75|   |   | 72| |   |   |   | | 91|   |   | 88| |   |
+     |   | +---+---+---+---+ |   |   |   | +---+---+---+---+ |   |
+     |   | | 79|   |   | 76| |   |   |   | | 95|   |   | 92| |   |
+     +---+ +---+---+---+---+ +---+   +---+ +---+---+---+---+ +---+
+           | 83|   |   | 80|               | 99|   |   | 96|      
+           +---+---+---+---+               +---+---+---+---+      
+           +---+---+---+---+               +---+---+---+---+      
+           |   |###|   |   |               |###|   |   |   |      
+           +---+---+---+---+               +---+---+---+---+      
+  
+  
+### XY MODE
+  
+           +---+---+---+---+ 
+           |   |   |   |   | 
+     +---+ +---+---+---+---+ +---+
+     |   | |   |   |   |   | |   |
+     |   | +---+---+---+---+ |   |
+     |   | |   |   |   |   | |   |
+     +---+ +---+---+---+---+ +---+
+           |   |   |   |   | 
+           +---+---+---+---+ 
+           +---+---+---+---+ 
+           |   |   |   |   | 
+           +---+---+---+---+ 
+
+
+
 ---
 Have fun  
 FMMT666(ASkr)  

From 1033db3ddb907749fa3dfb2bc1ad83daa2768f32 Mon Sep 17 00:00:00 2001
From: FMMT666 <FMMT666@users.noreply.github.com>
Date: Sat, 8 May 2021 01:13:00 +0200
Subject: [PATCH 07/14] added some moar Tambourine 3D code

---
 README.md                 |  61 +++++++++-------
 launchpad_py/__init__.py  |   1 +
 launchpad_py/launchpad.py | 144 ++++++++++++++++++++------------------
 3 files changed, 112 insertions(+), 94 deletions(-)

diff --git a/README.md b/README.md
index 1c0e527..48d2bff 100644
--- a/README.md
+++ b/README.md
@@ -27,7 +27,7 @@ Now with full [Midi Fighter 64][23] support (8/2020).
 
 Finally! Hehe, say hello to the [Mk3 Pro][24] (8/2020)  
 
-And here comes the ***CENSORED SO FAR*** (5/2021)
+And here comes the [Midi Fighter 3D][27] (5/2021)
 
 ---
 ## STATUS 2021/04/xx:
@@ -42,11 +42,11 @@ And here comes the ***CENSORED SO FAR*** (5/2021)
 
     Launchpad Pro      - class "LaunchpadPro()"     LEDs and buttons (digitally only (yet))
 
-    Launchpad Pro Mk3  - class "LaunchpadProMk3()"  EXPERIMENTAL+++ as in "should be really ok"
+    Launchpad Pro Mk3  - class "LaunchpadProMk3()"  LEDs and buttons, pressure, everything; "should work"
 
     Launchpad Mini Mk3 - class "LaunchpadMiniMk3()" LEDs and buttons  *** RENAMED 5/2020 ***
 
-    Launchpad X        - class "LaunchpadLPX()"     EXPERIMENTAL+++ as in "should work really well"
+    Launchpad X        - class "LaunchpadLPX()"     LEDs and buttons and more
 
     Launch Control     - class "LaunchControl()"    EXPERIMENTAL
 
@@ -92,7 +92,10 @@ Successfully tested with Ubuntu 18.04-LTS+. Requires compiling your own PyGame t
 
 ### CHANGES 2021/05/XX:
     - fixed Launchpad Mk1 code in buttons_raw.py demo; thx to jmtrivial
-    - added first Midi Fighter 3D code
+    - added first Midi Fighter 3D code; derived from the MF64
+    - added MF3D LedCtrlRaw()
+    - added MF3D ButtonStateRaw()
+    - added MF3D LedCtrlXY()
 
 ### CHANGES 2021/04/XX:
     - added link to driver for Mk1 Launchpad and Mini
@@ -1190,7 +1193,7 @@ Functions requiring a color code have a "...ByCode" naming style.
 
 
 ---
-## Midi Fighter 64 class methods overview
+## Midi Fighter 64 and Midi Fighter 3D class methods overview
 
 *WORK IN PROGESS*
 
@@ -1218,7 +1221,6 @@ There is no possibility to control the RGB LEDs individually.
 ![RGB color palette](/images/mf64_colorcodes.png)
 
 
-
 ---
 ## Detailed description of common Launchpad methods
 
@@ -2394,8 +2396,8 @@ There is no possibility to control the RGB LEDs individually.
       PARAMS:
       RETURN: [ ]                        An empty list if no event occured, otherwise...
               [ <x> , <y>, <value> ]     ... a list with three fields:
-                                         <x>      0..7; x coordinate of button
-                                         <y>      0..7; y coordinate of button
+                                         <x>      0..7; x coordinate of button (0..3 for Midi Fighter 3D)
+                                         <y>      0..7; y coordinate of button (0..3 for Midi Fighter 3D)
                                          <value>  >0 = pressed; 0 = released
 
 
@@ -2432,6 +2434,7 @@ There is no possibility to control the RGB LEDs individually.
         MODE_ANIM_TRIANGLE
 
       PARAMS: <led>         36..99; number of the LED to control
+                            see tables at end of file
               <colorcode>   0..127; color code
               <mode>        [OPTIONAL] 18..53, see above
       RETURN:
@@ -2466,6 +2469,7 @@ There is no possibility to control the RGB LEDs individually.
         MODE_ANIM_TRIANGLE
 
       PARAMS: <led>         36..99; number of the LED to control
+                            see tables at end of file
               <mode>        18..53; see above
       RETURN:
 
@@ -2476,14 +2480,16 @@ There is no possibility to control the RGB LEDs individually.
     See table with coordinates at the end of this document.
     Color codes are somewhere above (see image).
 
-      PARAMS: <x>           0..7; x coordinate
-              <y>           0..7; y coordinate
+      PARAMS: <x>           0..7; x coordinate (0..3 for Midi Fighter 3D)
+              <y>           0..7; y coordinate (0..3 for Midi Fighter 3D)
               <colorcode>   0..127; color code
       RETURN:
 
 
 ### LedCtrlChar( char, color, [offsx = 0], [offsy = 0], [coloroff = 0] )
 
+    Only for Midi Fighter 64!
+
     Displays character <char> with a color of <color> and a
     lateral offset of <offsx> (-8..8) on the Midi Fighter.
     <offsy> does not have yet any function.
@@ -2513,6 +2519,8 @@ There is no possibility to control the RGB LEDs individually.
 
 ### LedCtrlString( string, color, [coloroff = 0], [direction = 0], [waitms = 150] )
 
+    Only for Midi Fighter 64!
+
     Scrolls <string> across the Midi Fighter's 8x8 matrix.
     <color> specifies the color of the string and <coloroff> the background.
     <direction> determines the direction of scrolling.
@@ -3166,46 +3174,50 @@ The mode keys return:
 
 ### RAW Mode
 
-  Button codes depend on the selected bank, the bottom row with the small buttons.
-  Indicated with a ```###``` in here.
+  Button and LED codes depend on the selected bank, the bottom row with the small buttons.  
+  Selected bank is indicated with a ```#x#``` here.
+
+  Notice that the side button codes 36-40 might overlap with the arcade buttons.  
+  This behaviour can be reprogrammed with the Midi Fighter Utility.
   
            +---+---+---+---+               +---+---+---+---+      
            | 39|   |   | 36|               | 55|   |   | 52|      
      +---+ +---+---+---+---+ +---+   +---+ +---+---+---+---+ +---+
-     |   | | 43|   |   | 40| |   |   |   | | 59|   |   | 56| |   |
-     |   | +---+---+---+---+ |   |   |   | +---+---+---+---+ |   |
-     |   | | 47|   |   | 44| |   |   |   | | 63|   |   | 60| |   |
+     | 23| | 43|   |   | 40| | 20|   | 29| | 59|   |   | 56| | 26|
+     | 24| +---+---+---+---+ | 21|   | 30| +---+---+---+---+ | 27|
+     | 25| | 47|   |   | 44| | 22|   | 31| | 63|   |   | 60| | 28|
      +---+ +---+---+---+---+ +---+   +---+ +---+---+---+---+ +---+
            | 51|   |   | 48|               | 67|   |   | 64|      
            +---+---+---+---+               +---+---+---+---+      
            +---+---+---+---+               +---+---+---+---+      
-           |   |   |   |###|               |   |   |###|   |      
+           | 3 | 2 | 1 |#0#|               | 3 | 2 |#1#| 0 |      
            +---+---+---+---+               +---+---+---+---+      
 
            +---+---+---+---+               +---+---+---+---+      
            | 71|   |   | 68|               | 87|   |   | 84|      
      +---+ +---+---+---+---+ +---+   +---+ +---+---+---+---+ +---+
-     |   | | 75|   |   | 72| |   |   |   | | 91|   |   | 88| |   |
-     |   | +---+---+---+---+ |   |   |   | +---+---+---+---+ |   |
-     |   | | 79|   |   | 76| |   |   |   | | 95|   |   | 92| |   |
+     | 35| | 75|   |   | 72| | 32|   | 41| | 91|   |   | 88| | 38|
+     | 36| +---+---+---+---+ | 33|   | 42| +---+---+---+---+ | 39|
+     | 37| | 79|   |   | 76| | 34|   | 43| | 95|   |   | 92| | 40|
      +---+ +---+---+---+---+ +---+   +---+ +---+---+---+---+ +---+
            | 83|   |   | 80|               | 99|   |   | 96|      
            +---+---+---+---+               +---+---+---+---+      
            +---+---+---+---+               +---+---+---+---+      
-           |   |###|   |   |               |###|   |   |   |      
+           | 3 |#2#| 1 | 0 |               |#3#| 2 | 1 | 0 |      
            +---+---+---+---+               +---+---+---+---+      
   
   
 ### XY MODE
   
+             0   1   2   3
            +---+---+---+---+ 
-           |   |   |   |   | 
+  0        |   |1/0|   |   |        0
      +---+ +---+---+---+---+ +---+
-     |   | |   |   |   |   | |   |
+  1  |   | |   |   |   |   | |   |  1
      |   | +---+---+---+---+ |   |
-     |   | |   |   |   |   | |   |
+  2  |   | |   |   |   |3/2| |   |  2
      +---+ +---+---+---+---+ +---+
-           |   |   |   |   | 
+  3        |0/3|   |   |   |        3
            +---+---+---+---+ 
            +---+---+---+---+ 
            |   |   |   |   | 
@@ -3245,3 +3257,4 @@ FMMT666(ASkr)
 [24]: https://twitter.com/FMMT666/status/1299478117497688073
 [25]: https://www.midifighter.com/
 [26]: https://customer.novationmusic.com/en/support/downloads?brand=Novation&product_by_type=510&download_type=all
+[27]: https://twitter.com/FMMT666/status/1390806661829386241
diff --git a/launchpad_py/__init__.py b/launchpad_py/__init__.py
index fa730a4..254a25c 100644
--- a/launchpad_py/__init__.py
+++ b/launchpad_py/__init__.py
@@ -9,5 +9,6 @@
 from launchpad_py.launchpad import LaunchpadMiniMk3
 from launchpad_py.launchpad import LaunchpadLPX
 from launchpad_py.launchpad import MidiFighter64
+from launchpad_py.launchpad import MidiFighter3D
 from launchpad_py.launchpad import LaunchpadProMk3
 from launchpad_py import charset
diff --git a/launchpad_py/launchpad.py b/launchpad_py/launchpad.py
index af42ae1..3e66e2a 100644
--- a/launchpad_py/launchpad.py
+++ b/launchpad_py/launchpad.py
@@ -3101,65 +3101,63 @@ def Reset( self ):
 ###
 ### For Midi Fighter 3D Gedöns
 ########################################################################################
-class MidiFighter3D( LaunchpadBase ):
+class MidiFighter3D( MidiFighter64 ):
 
 	#         
 	# LED AND BUTTON NUMBERS IN RAW MODE
-	#         
-	#         +---+---+---+---+ 
-	#         | XX|   |   | XX| 
-	#   +---+ +---+---+---+---+ +---+
-	#   | XX| | XX|   |   | XX| |XX |
-	#   | XX| +---+---+---+---+ |XX |
-	#   | XX| | XX|   |   | XX| |XX |
-	#   +---+ +---+---+---+---+ +---+
-	#         | XX|   |   | XX| 
-	#         +---+---+---+---+ 
-	#         +---+---+---+---+ 
-	#         | XX|   |   | XX| 
-	#         +---+---+---+---+ 
+	#
+	#   Button codes depend on the selected bank,
+	#   the bottom row with the small buttons.
+	#
+	#         +---+---+---+---+              +---+---+---+---+      
+	#         | 39|   |   | 36|              | 55|   |   | 52|      
+	#   +---+ +---+---+---+---+ +---+  +---+ +---+---+---+---+ +---+
+	#   |   | | 43|   |   | 40| |   |  |   | | 59|   |   | 56| |   |
+	#   |   | +---+---+---+---+ |   |  |   | +---+---+---+---+ |   |
+	#   |   | | 47|   |   | 44| |   |  |   | | 63|   |   | 60| |   |
+	#   +---+ +---+---+---+---+ +---+  +---+ +---+---+---+---+ +---+
+	#         | 51|   |   | 48|              | 67|   |   | 64|      
+	#         +---+---+---+---+              +---+---+---+---+      
+	#         +---+---+---+---+              +---+---+---+---+      
+	#         |   |   |   |###|              |   |   |###|   |      
+	#         +---+---+---+---+              +---+---+---+---+      
+	#
+	#         +---+---+---+---+              +---+---+---+---+      
+	#         | 71|   |   | 68|              | 87|   |   | 84|      
+	#   +---+ +---+---+---+---+ +---+  +---+ +---+---+---+---+ +---+
+	#   |   | | 75|   |   | 72| |   |  |   | | 91|   |   | 88| |   |
+	#   |   | +---+---+---+---+ |   |  |   | +---+---+---+---+ |   |
+	#   |   | | 79|   |   | 76| |   |  |   | | 95|   |   | 92| |   |
+	#   +---+ +---+---+---+---+ +---+  +---+ +---+---+---+---+ +---+
+	#         | 83|   |   | 80|              | 99|   |   | 96|      
+	#         +---+---+---+---+              +---+---+---+---+      
+	#         +---+---+---+---+              +---+---+---+---+      
+	#         |   |###|   |   |              |###|   |   |   |      
+	#         +---+---+---+---+              +---+---+---+---+      
 	#
 	#
 	# LED AND BUTTON NUMBERS IN XY MODE (X/Y)
 	#
-	#         +---+---+---+---+ 
-	#         | XX|   |   | XX| 
-	#   +---+ +---+---+---+---+ +---+
-	#   | XX| | XX|   |   | XX| |XX |
-	#   | XX| +---+---+---+---+ |XX |
-	#   | XX| | XX|   |   | XX| |XX |
-	#   +---+ +---+---+---+---+ +---+
-	#         | XX|   |   | XX| 
-	#         +---+---+---+---+ 
-	#         +---+---+---+---+ 
-	#         | XX|   |   | XX| 
-	#         +---+---+---+---+ 
-
-
-	#-------------------------------------------------------------------------------------
-	#-- Add some LED mode "constants" for better usability.
-	#-------------------------------------------------------------------------------------
-	def __init__( self ):
-
-		# TODO TODO TODO
-
-		self.MODE_BRIGHT        = [ i+18 for i in range(16) ]
-		self.MODE_TOGGLE        = [ i+34 for i in range(8) ]
-		self.MODE_PULSE         = [ i+42 for i in range(8) ]
-		self.MODE_ANIM_SQUARE   = 50
-		self.MODE_ANIM_CIRCLE   = 51
-		self.MODE_ANIM_STAR     = 52
-		self.MODE_ANIM_TRIANGLE = 53
-
-		super( MidiFighter3D, self ).__init__( )
-
+	#              0   1   2   3
+	#            +---+---+---+---+ 
+	#   0        |   |1/0|   |   | 
+	#      +---+ +---+---+---+---+ +---+
+	#   1  |   | |   |   |   |   | |   |
+	#      |   | +---+---+---+---+ |   |
+	#   2  |   | |   |   |   |3/2 | |   |
+	#      +---+ +---+---+---+---+ +---+
+	#   3        |0/3|   |   |   | 
+	#            +---+---+---+---+ 
+	#            +---+---+---+---+ 
+	#            |   |   |   |   | 
+	#            +---+---+---+---+ 
 
 
 	#-------------------------------------------------------------------------------------
 	#-- Opens one of the attached Launchpad MIDI devices.
 	#-- Uses search string "Fighter 3D", by default.
 	#-------------------------------------------------------------------------------------
-	# Overrides "LaunchpadBase" method
+	# Overrides "MidiFighter64" method
 	def Open( self, number = 0, name = "Fighter 3D" ):
 		return super( MidiFighter3D, self ).Open( number = number, name = name )
 
@@ -3167,9 +3165,9 @@ def Open( self, number = 0, name = "Fighter 3D" ):
 	#-------------------------------------------------------------------------------------
 	#-- Checks if a device exists, but does not open it.
 	#-- Does not check whether a device is in use or other, strange things...
-	#-- Uses search string "Fighter 3D64", by default.
+	#-- Uses search string "Fighter 3D", by default.
 	#-------------------------------------------------------------------------------------
-	# Overrides "LaunchpadBase" method
+	# Overrides "MidiFighter64" method
 	def Check( self, number = 0, name = "Fighter 3D" ):
 		return super( MidiFighter3D, self ).Check( number = number, name = name )
 
@@ -3180,32 +3178,24 @@ def Check( self, number = 0, name = "Fighter 3D" ):
 	#-- <velocity> the button state.
 	#--   >0 = button pressed; 0 = button released
 	#-------------------------------------------------------------------------------------
+	# Overrides "MidiFighter64" method
 	def ButtonStateRaw( self ):
 		if self.midi.ReadCheck():
 			a = self.midi.ReadRaw()
 
-			# The Midi Fighter 64 does not support velocities. For 500 bucks. Lol :'-)
-			# What we see here are either channel 3 or 2 NoteOn/NoteOff commands,
-			# the factory settings, depending on the "bank selection".
-			#   Channel 3 -> hold upper left  button for longer than 2s
-			#   Channel 2 -> hold upper right button for longer than 2s
-			#
-			#    [[[146, 81, 127, 0], 47365]]
-			#    [[[130, 81, 127, 0], 47443]]
-			#    [[[146, 82, 127, 0], 47610]]
-			#
 			#    [[[ <NoteOn/Off>, <button>, 127, 0], 47610]]
 			#
-			#    146/145 -> NoteOn
-			#    130/129 -> NoteOff
+			#    146/147 -> NoteOn
+			#    130/131 -> NoteOff
 			#    127     -> fixed velocity (as set by the Midi Fighter utility )
+			#
+			#    Top arcade buttons on channel 3    -> 146 ON, 130 OFF
+			#    Side and bank buttons on channel 4 -> 147 ON, 131 OFF
 
-			# Mhh, I guess it's about time to think about adding MIDI channels, isn't it?
-			# But for now, we just check ch 2 and 3:
-			if a[0][0][0] == 145 or a[0][0][0] == 146:
+			if a[0][0][0] == 146 or a[0][0][0] == 147:
 				return [ a[0][0][1], a[0][0][2] ]
 			else:
-				if a[0][0][0] == 130 or a[0][0][0] == 129:
+				if a[0][0][0] == 130 or a[0][0][0] == 131:
 					return [ a[0][0][1], 0 ]
 				else:
 					return []
@@ -3214,13 +3204,27 @@ def ButtonStateRaw( self ):
 
 
 	#-------------------------------------------------------------------------------------
-	#-- Reset the Midi Fighter
-	#-- Well, at least turn off all its LEDs
+	#-- Controls a grid LED by its <x>/<y> coordinates and a <color>.
+	#--  <x>/<y>  0..3
+	#--  <color>  0..127 from color table
 	#-------------------------------------------------------------------------------------
-	def Reset( self ):
-		# TODO
-		# self.LedAllOn( 0 ) 
-		pass
+	# overrides "MidiFighter64" method
+	def LedCtrlXY( self, x, y, color, mode = None ):
+
+		if x < 0 or x > 3:
+			return
+		if y < 0 or y > 3:
+			return
+		if color  < 0  or color  > 127:
+			return
+
+		number = 39 - x    # 36 - 4 + x
+		number += 4 * y
+
+		self.midi.RawWrite( 146, number, color )
+		# set the mode if required; faster than calling LedCtrlRawMode()
+		if mode is not None and mode > 17 and mode < 54:
+			self.midi.RawWrite( 147, number - 3*12, mode )
 
 
 

From 09c68a836cac76d24ff4b56ec0c5d8b1d2796d7a Mon Sep 17 00:00:00 2001
From: FMMT666 <FMMT666@users.noreply.github.com>
Date: Sat, 8 May 2021 01:16:58 +0200
Subject: [PATCH 08/14] make room for space *sigh*

---
 README.md | 26 +++++++++++++-------------
 1 file changed, 13 insertions(+), 13 deletions(-)

diff --git a/README.md b/README.md
index 48d2bff..ae14497 100644
--- a/README.md
+++ b/README.md
@@ -3209,19 +3209,19 @@ The mode keys return:
   
 ### XY MODE
   
-             0   1   2   3
-           +---+---+---+---+ 
-  0        |   |1/0|   |   |        0
-     +---+ +---+---+---+---+ +---+
-  1  |   | |   |   |   |   | |   |  1
-     |   | +---+---+---+---+ |   |
-  2  |   | |   |   |   |3/2| |   |  2
-     +---+ +---+---+---+---+ +---+
-  3        |0/3|   |   |   |        3
-           +---+---+---+---+ 
-           +---+---+---+---+ 
-           |   |   |   |   | 
-           +---+---+---+---+ 
+               0   1   2   3
+             +---+---+---+---+ 
+    0        |   |1/0|   |   |        0
+       +---+ +---+---+---+---+ +---+
+    1  |   | |   |   |   |   | |   |  1
+       |   | +---+---+---+---+ |   |
+    2  |   | |   |   |   |3/2| |   |  2
+       +---+ +---+---+---+---+ +---+
+    3        |0/3|   |   |   |        3
+             +---+---+---+---+ 
+             +---+---+---+---+ 
+             |   |   |   |   | 
+             +---+---+---+---+ 
 
 
 

From fb0dabc3f5b7150969e2f28a9b8b5b8fb283ce6f Mon Sep 17 00:00:00 2001
From: Jason <pix3l.icious@gmail.com>
Date: Tue, 28 Sep 2021 16:56:17 +0700
Subject: [PATCH 09/14] Add easier way to update pro mk3

because yes
---
 README.md | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/README.md b/README.md
index ae14497..d6e802c 100644
--- a/README.md
+++ b/README.md
@@ -67,6 +67,8 @@ And here comes the [Midi Fighter 3D][27] (5/2021)
 >  
 > The Pro Mk3 needs the latest Firmware to operate flawlessly. FW is only available  
 > via a Novation account- and product registration.
+>
+> Alternatively, visit https://fw.mat1jaczyyy.com on a Chromium-based browser to update the firmware of Pro Mk3.
 
 Please notice that the class "LaunchpadMk3()" was renamed to "LaunchpadMiniMk3()" in 5/2020.  
 This was necessary to avoid confusion with the device search string and the new "Pro-Mk3" Launchpad.  

From d365a34ad4f05f764d8b123c5b9c125181f65517 Mon Sep 17 00:00:00 2001
From: Jason <pix3l.icious@gmail.com>
Date: Thu, 30 Sep 2021 12:00:46 +0700
Subject: [PATCH 10/14] Update README.md

Now using reference ?
---
 README.md | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/README.md b/README.md
index d6e802c..52bc923 100644
--- a/README.md
+++ b/README.md
@@ -68,7 +68,7 @@ And here comes the [Midi Fighter 3D][27] (5/2021)
 > The Pro Mk3 needs the latest Firmware to operate flawlessly. FW is only available  
 > via a Novation account- and product registration.
 >
-> Alternatively, visit https://fw.mat1jaczyyy.com on a Chromium-based browser to update the firmware of Pro Mk3.
+> Alternatively, visit [mat1jaczyyy's Firmware Utility][28] on a Chromium-based browser to update the firmware of Pro Mk3.
 
 Please notice that the class "LaunchpadMk3()" was renamed to "LaunchpadMiniMk3()" in 5/2020.  
 This was necessary to avoid confusion with the device search string and the new "Pro-Mk3" Launchpad.  
@@ -3260,3 +3260,4 @@ FMMT666(ASkr)
 [25]: https://www.midifighter.com/
 [26]: https://customer.novationmusic.com/en/support/downloads?brand=Novation&product_by_type=510&download_type=all
 [27]: https://twitter.com/FMMT666/status/1390806661829386241
+[28]: https://fw.mat1jaczyyy.com

From f20122ad8a0c8ffeebb1a86fcb757e24adea30cf Mon Sep 17 00:00:00 2001
From: FMMT666 <FMMT666@users.noreply.github.com>
Date: Mon, 8 Nov 2021 23:46:40 +0100
Subject: [PATCH 11/14] added comment

---
 README.md | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/README.md b/README.md
index 52bc923..f806a8d 100644
--- a/README.md
+++ b/README.md
@@ -30,7 +30,7 @@ Finally! Hehe, say hello to the [Mk3 Pro][24] (8/2020)
 And here comes the [Midi Fighter 3D][27] (5/2021)
 
 ---
-## STATUS 2021/04/xx:
+## STATUS 2021/11/xx:
 
 ### Devices
 
@@ -68,7 +68,8 @@ And here comes the [Midi Fighter 3D][27] (5/2021)
 > The Pro Mk3 needs the latest Firmware to operate flawlessly. FW is only available  
 > via a Novation account- and product registration.
 >
-> Alternatively, visit [mat1jaczyyy's Firmware Utility][28] on a Chromium-based browser to update the firmware of Pro Mk3.
+> Alternatively, visit [mat1jaczyyy's Firmware Utility][28] on a Chromium-based browser to update the firmware of Pro Mk3.  
+> USE THIS AT YOUR OWN RISK!
 
 Please notice that the class "LaunchpadMk3()" was renamed to "LaunchpadMiniMk3()" in 5/2020.  
 This was necessary to avoid confusion with the device search string and the new "Pro-Mk3" Launchpad.  

From 70d32814930825b79a3caf9663a443a343b7e41f Mon Sep 17 00:00:00 2001
From: Seth Troisi <sethtroisi@google.com>
Date: Thu, 13 Jan 2022 14:24:57 -0800
Subject: [PATCH 12/14] Simplify SearchDevices

---
 launchpad_py/launchpad.py | 10 ++++------
 1 file changed, 4 insertions(+), 6 deletions(-)

diff --git a/launchpad_py/launchpad.py b/launchpad_py/launchpad.py
index 3e66e2a..72fd878 100644
--- a/launchpad_py/launchpad.py
+++ b/launchpad_py/launchpad.py
@@ -204,11 +204,10 @@ def __del__( self ):
 		#-------------------------------------------------------------------------------------
 		def SearchDevices( self, name, output = True, input = True, quiet = True ):
 			ret = []
-			i = 0
-			
-			for n in range( midi.get_count() ):
-				md = midi.get_device_info( n )
-				if str( md[1].lower() ).find( name.lower() ) >= 0:
+
+			for i in range( midi.get_count() ):
+				md = midi.get_device_info( i )
+				if name.lower() in str( md[1].lower() ):
 					if quiet == False:
 						print('%2d' % ( i ), md)
 						sys.stdout.flush()
@@ -216,7 +215,6 @@ def SearchDevices( self, name, output = True, input = True, quiet = True ):
 						ret.append( i )
 					if input == True and md[2] > 0:
 						ret.append( i )
-				i += 1
 
 			return ret
 

From 4d91bbeacab8a5c8af56db61ebbaa676eeaf21c0 Mon Sep 17 00:00:00 2001
From: FMMT666 <fmmt666@users.noreply.github.com>
Date: Wed, 2 Jul 2025 02:19:38 +0200
Subject: [PATCH 13/14] added Apple Silicon notes.

---
 README.md | 39 ++++++++++++++++++++++++++++++++++++---
 1 file changed, 36 insertions(+), 3 deletions(-)

diff --git a/README.md b/README.md
index f806a8d..8de9a9c 100644
--- a/README.md
+++ b/README.md
@@ -30,7 +30,7 @@ Finally! Hehe, say hello to the [Mk3 Pro][24] (8/2020)
 And here comes the [Midi Fighter 3D][27] (5/2021)
 
 ---
-## STATUS 2021/11/xx:
+## STATUS 2025/06/xx:
 
 ### Devices
 
@@ -61,6 +61,14 @@ And here comes the [Midi Fighter 3D][27] (5/2021)
     Midi Fighter 3D    - class "MidiFighter3D       IN WORK
 
 
+> APPLE SILICON:  
+> You most likely need to compile your own PyGame version.  
+> 6/2025: The PyPI version has a broken MIDI out path, the MacPorts version comes without MIDI at all.  
+> I do not use Homebrew - maybe you can try your luck with that one.  
+> Compiling PyGame though is acually easy. Usually. Hehe.  
+> The process is explained somewhere below. CTRL-F your way down to "compile" in the RPi section.  
+
+
 > PRO MK3 USERS:  
 > You need to disable the Launchpad's "Transmit Clock" in the MIDI settings!  
 > See section "For Launchpad Pro Mk3 users"  
@@ -93,6 +101,9 @@ Successfully tested with Ubuntu 18.04-LTS+. Requires compiling your own PyGame t
 ---
 ## NEWS
 
+### CHANGES 2025/06/XX:
+    - added notes for Apple Silicon
+
 ### CHANGES 2021/05/XX:
     - fixed Launchpad Mk1 code in buttons_raw.py demo; thx to jmtrivial
     - added first Midi Fighter 3D code; derived from the MF64
@@ -569,7 +580,7 @@ The licensor cannot revoke these freedoms as long as you follow the license term
 ## Requirements
 
   - [Python][2] 2, 3
-  - [Pygame][3] v1.9.1, (v1.9.2), v1.9.3, v1.9.4-XX, ...
+  - [Pygame][3] v1.9.1, (v1.9.2), v1.9.3, v1.9.4-XX, ..., v2.6.1 ...
 
 Some Pygame versions do not work on some OSes (e.g. v1.9.2 might cause trouble
 with Windows 7/10). I cannot tell you any more than just "try!".  
@@ -604,6 +615,7 @@ Previously, launchpad.py was tested under
   - Beagle Bone (Black)
   - Banana Pi (Pro/M2/R1)
   - pcDuino V3
+  - Apple Silicon (6/2025; you'll need to compile your own PyGame version)
   - ...
 
 Supported and tested red/green LED Launchpad devices, here referred  to as "Classic" or "Mk1":
@@ -634,6 +646,8 @@ name it once shipped the first red/green LED with!
 ---
 ## Compiling your own PyGame
 
+ As of 6/2025, I would recommend to build it the "compile via 'setup.py'" way, below.
+
  If you have problems with errors like "alsa.conf" or the ListAll() method
  not recognizing any attached Launchpads on newer systems, especially Ubuntu 17/18,
  you might consider compiling your own PyGame version.
@@ -693,6 +707,15 @@ name it once shipped the first red/green LED with!
  If you need a fully working PyGame, with all features, I leave it up to you,
  to resolve the remaining "not found" issues, but they're not required by Launchpad.py
 
+ In case Cython is missing, the 'setup.py' process will print the instructions to install it.  
+ Otherwise, simply install it via
+
+   pip3 install cython
+
+ Assuming your Python 3 pip is named pip3, of course. Otherwise, check your matching version with
+
+   pip --version
+
  Make sure PORTMIDI and PORTTIME are marked with "found", then continue the build process.
  After a hopfully error-free build, execute (Ubuntu example for superuser access)
 
@@ -705,7 +728,7 @@ name it once shipped the first red/green LED with!
  ...
 
 
-### Compile via "configure" (old)
+### Compile via "configure" (old, not recommended)
 
  Newer Python variants come with a fully functional setup.py (see above).  
  I just leave the old compiling instructions here...
@@ -756,6 +779,12 @@ name it once shipped the first red/green LED with!
 ---
 ## Random Notes
 
+### Botton events work, but LED methods fail (won't light up)
+
+ In case of Apple Silicon, pls compile your own PyGame version. Explained above.  
+ This also might me a solution on other rare or ARM platforms.
+
+
 ### Button, value and potentiometer polling
 
  Until now (6/2017), Launchpad.py does not have an event system built in. You need to poll the buttons' or
@@ -927,6 +956,10 @@ There is no easy fix for this (unless you wish to spend a lot of time completely
 
 ### For Mac users
 
+#### Apple Silicon
+
+You need to compile your own PyGame version. See above.
+
 #### Mac Python and Pygame
 
 Good news, everybody. It now works with macOS Sierra \o/  

From 94381e95186d8ae6d0708f76859890f3473d3bab Mon Sep 17 00:00:00 2001
From: FMMT666 <fmmt666@users.noreply.github.com>
Date: Thu, 3 Jul 2025 00:45:28 +0200
Subject: [PATCH 14/14] added MK2 update note

---
 README.md | 9 ++++++++-
 1 file changed, 8 insertions(+), 1 deletion(-)

diff --git a/README.md b/README.md
index 8de9a9c..29214e1 100644
--- a/README.md
+++ b/README.md
@@ -67,6 +67,7 @@ And here comes the [Midi Fighter 3D][27] (5/2021)
 > I do not use Homebrew - maybe you can try your luck with that one.  
 > Compiling PyGame though is acually easy. Usually. Hehe.  
 > The process is explained somewhere below. CTRL-F your way down to "compile" in the RPi section.  
+> Also, please update your Launchpads to the latest version.  
 
 
 > PRO MK3 USERS:  
@@ -103,6 +104,7 @@ Successfully tested with Ubuntu 18.04-LTS+. Requires compiling your own PyGame t
 
 ### CHANGES 2025/06/XX:
     - added notes for Apple Silicon
+    - added notes updating the MK2
 
 ### CHANGES 2021/05/XX:
     - fixed Launchpad Mk1 code in buttons_raw.py demo; thx to jmtrivial
@@ -351,7 +353,8 @@ Successfully tested with Ubuntu 18.04-LTS+. Requires compiling your own PyGame t
 
 ---
 ## Upcoming attractions, notes and thoughts
-
+ 
+  - "AP3": AKAI Professional APC mini MK2
   - "PK3": the Pro Mk3 has some issues; needs to be fixed
   - "All": optionally avoid resetting the X and Pro Mk3 to Live mode in Close(); (bc LEDs turn on)
   - "FNT": fix character set; e.g. "!", "0", "N" and probably many more
@@ -839,6 +842,9 @@ name it once shipped the first red/green LED with!
       
         lp = launchpad.LaunchpadMk2()
 
+  Instructions to safely update to the latest version [here][29].  
+  Especially for Apple Silicon!
+
 ### For Launchpad Mini Mk3 users
 
       USE CLASS "LaunchpadMiniMk3":
@@ -3295,3 +3301,4 @@ FMMT666(ASkr)
 [26]: https://customer.novationmusic.com/en/support/downloads?brand=Novation&product_by_type=510&download_type=all
 [27]: https://twitter.com/FMMT666/status/1390806661829386241
 [28]: https://fw.mat1jaczyyy.com
+[29]: https://support.novationmusic.com/hc/en-gb/articles/115003688729-My-Launchpad-MK2-Freezes-During-The-Firmware-Update