Add ASCII art and make the instructions more user-friendly.

devilAPI · devilAPI · commit e8c7d641f504 · 2025-11-05T01:22:49.000+01:00
diff --git a/README.md b/README.md
@@ -1,6 +1,6 @@
 # abletonCracker - What is this?
 
-This is an open-source implementation of the R2R Patch and `R2RLIVE.dll` of Ableton Live, written in Python 3.
+This is an open-source implementation of the R2R patch and `R2RLIVE.dll` of Ableton Live, written in Python.
 
 Like `R2RLIVE.dll`, this script uses Team R2R's signing key only.
 
@@ -22,19 +22,24 @@ You can download the Ableton Installers directly from Ableton's servers. I made
 
 # How to use
 
-1. Install Python (3.12 upwards) at [python.org](https://www.python.org/downloads/)
+1. Install Python (3.10 upwards) at [python.org](https://www.python.org/downloads/)
 2. Open your Terminal and run `python -m pip install cryptography` to install dependencies
 3. Find your Ableton HWID, open Ableton, and press "Authorize Ableton offline". You will find your HWID.
 4. Open `config.json` and change the variables to fit your Ableton Live installation.
-5. Open your Ableton installation folder (for example: `C:\ProgramData\Ableton\Live 11 Suite\Program`)
-6. Copy the Ableton executable (.exe file) (for example: `Ableton Live 11 Suite.exe`) to the same folder where you downloaded abletonCracker.
-7. Run `patch_ableton.py`, your Ableton should be patched and the `Authorize.auz` file should generate.
-8. Copy your Ableton executable back to your installation folder
-9. Run Ableton, drag the `Authorize.auz` file into the Activation window
+5. Run `patch_ableton.py`, your Ableton should be patched and the `Authorize.auz` file should generate.
+6. Run Ableton, drag the `Authorize.auz` file into the Activation window
 
-Hooray, you're done!
+#### Hooray, you're done!
 
-If there are any permission erros, its recommended to move the Ableton.exe into the same folder where `patch_ableton.py` is located.
+# Troubleshooting
+#### I don't have administrator on my PC.
+1. Copy your Ableton executable to the same folder where patch_ableton.py is located.
+2. In config.json, change your file path from "auto" to the new file path of your Ableton exe.
+3. Retry
+4. It should work now. Then copy your Ableton exe back to the folder you got it from.
+
+# Support
+I do offer support on Discord (@devilAPI) and on Reddit (@devilAPIOnReddit)
 
 # Credits
 
diff --git a/patch_ableton.py b/patch_ableton.py
@@ -10,20 +10,24 @@
 from cryptography.hazmat.primitives.asymmetric import dsa
 from cryptography.hazmat.primitives.asymmetric.utils import decode_dss_signature
 from cryptography.hazmat.primitives.hashes import SHA1
+# Color support
+try:
+    from colorama import init, Fore, Style
+    init(autoreset=True)
+except ImportError:
+    class Dummy:
+        RESET = RED = WHITE = GREEN = LIGHTBLACK_EX = BRIGHT = ''
+    Fore = Style = Dummy()
 
 def is_admin():
-    """Check if the script is running with administrator privileges"""
     try:
         return ctypes.windll.shell32.IsUserAnAdmin() != 0
     except:
         return False
 
 def run_as_admin():
-    """Relaunch the script with administrator privileges"""
     script = os.path.abspath(sys.argv[0])
     params = subprocess.list2cmdline(sys.argv[1:])
-    
-    # Request UAC elevation
     ctypes.windll.shell32.ShellExecuteW(None, "runas", sys.executable, f'"{script}" {params}', None, 1)
     sys.exit(0)
 
@@ -32,7 +36,6 @@ def load_config(filename: str):
         with open(filename, 'r') as f:
             data = json.load(f)
 
-            # Extract values from JSON
             file_path = data.get("file_path")
             old_signkey = data.get("old_signkey")
             new_signkey = data.get("new_signkey")
@@ -42,7 +45,6 @@ def load_config(filename: str):
             authorize_file_output = data.get('authorize_file_output', 'Authorize.auz')
             dsa_params = data.get('dsa_parameters')
 
-            # Validate essential keys
             if not file_path or not old_signkey or not new_signkey:
                 raise ValueError("JSON file must contain 'file_path', 'old_signkey', and 'new_signkey'.")
             if len(hwid) == 24:
@@ -107,7 +109,6 @@ def replace_signkey_in_file(file_path, old_signkey, new_signkey):
             with open(file_path, 'wb') as file:
                 file.write(content)
 
-            # Verify replacement
             if old_signkey_bytes in content:
                 print("Error: The old signkey is still present in the file.")
             else:
@@ -187,22 +188,20 @@ def generate_all(k: dsa.DSAPrivateKey, edition: str, version: int, hwid: str) ->
     for i in range(0x8000, 0x80ff + 1):
         yield generate_single(k, i, 0x10, hwid)
 
-# Mapping for the editions
 EDITIONS = {
     "Lite": 4,
     "Intro": 3,
     "Standard": 0,
     "Suite": 2,
 }
 
-# Installation detection functions
 def get_user_config_dir():
     system = platform.system()
     if system == "Windows":
         return os.getenv('APPDATA')
     elif system == "Darwin":
         return os.path.join(os.path.expanduser("~"), "Library", "Application Support")
-    else:  # Linux and others
+    else: 
         return os.getenv('XDG_CONFIG_HOME', os.path.join(os.path.expanduser("~"), ".config"))
 
 def find_installations():
@@ -251,113 +250,120 @@ def find_installation_data():
     for entry in os.listdir(base_dir):
         entry_path = os.path.join(base_dir, entry)
         if os.path.isdir(entry_path) and "Live" in entry:
-            # Check if Unlock directory exists or can be created
             data_dirs.append((entry_path, entry))
     
     return data_dirs
 
 def main():
-    # Request admin on Windows if needed
+    # Colors
+    RED = Fore.RED + Style.BRIGHT
+    WHITE = Fore.WHITE + Style.BRIGHT
+    GREY = Fore.LIGHTBLACK_EX + Style.NORMAL
+    LIME = Fore.GREEN + Style.BRIGHT
+    RESET = Style.RESET_ALL
+
     if platform.system() == "Windows" and not is_admin():
-        print("\nThis operation requires administrator privileges on Windows.")
-        print("Relaunching with admin rights...")
+        print(RED + "\nThis operation requires administrator privileges on Windows." + RESET)
+        print(GREY + "Relaunching with admin rights..." + RESET)
         run_as_admin()
         return
+    # ASCII art in bright red
+    print(RED + r"""
+      ___.   .__          __                _________                       __                 
+_____ \_ |__ |  |   _____/  |_  ____   ____ \_   ___ \____________    ____ |  | __ ___________ 
+\__  \ | __ \|  | _/ __ \   __\/  _ \ /    \/    \  \/_  __ \__  \ _/ ___\|  |/ // __ \_  __ \
+ / __ \| \_\ \  |_\  ___/|  | (  <_> )   |  \     \____|  | \// __ \\  \___|    <\  ___/|  | \/
+(____  /___  /____/\___  >__|  \____/|___|  /\______  /|__|  (____  /\___  >__|_ \\___  >__|   
+     \/    \/          \/                 \/        \/            \/     \/     \/    \/    
+   """ + RESET)
+    print(LIME + "Made by devilAPI" + RESET)
+    print(GREY + "GitHub: " + LIME + "https://github.com/devilAPI/abletonCracker/" + RESET + "\n")
 
-    print("Ableton Live Patcher - Running with administrative privileges\n")
-
-    # Load configuration
     config_file = 'config.json'
     try:
         file_path, old_signkey, new_signkey, hwid, edition, version, authorize_file_output, dsa_params = load_config(config_file)
     except Exception as e:
-        print(f"Error loading configuration: {e}")
-        input("Press Enter to exit...")
+        print(RED + f"Error loading configuration: {e}" + RESET)
+        input(GREY + "Press Enter to exit..." + RESET)
         return
 
-    # Auto-detect installations if needed
     if file_path.lower() == "auto":
         installations = find_installations()
         if not installations:
-            print("\nNo Ableton Live installations found. Please specify the path manually.")
-            input("Press Enter to exit...")
+            print(RED + "\nNo Ableton Live installations found. Please specify the path manually." + RESET)
+            input(GREY + "Press Enter to exit..." + RESET)
             return
 
-        print("\nFound Ableton installations:")
+        print(LIME + "\nFound Ableton installations:" + RESET)
         for i, (path, name) in enumerate(installations):
-            print(f"{i+1}. {name} at {path}")
+            print(WHITE + f"{i+1}. " + LIME + f"{name}" + GREY + f" at {path}" + RESET)
 
         try:
-            selection = int(input("\nSelect installation to patch: ")) - 1
+            selection = int(input(LIME + "\nSelect installation to patch: " + RESET)) - 1
             if selection < 0 or selection >= len(installations):
-                print("Invalid selection. Using first installation.")
+                print(RED + "Invalid selection. Using first installation." + RESET)
                 selection = 0
             file_path = installations[selection][0]
-            print(f"Selected: {file_path}")
+            print(LIME + f"Selected: {file_path}" + RESET)
         except ValueError:
-            print("Invalid input. Using first installation found.")
+            print(RED + "Invalid input. Using first installation found." + RESET)
             file_path = installations[0][0]
 
-    # Auto-detect authorization file location if needed
     if authorize_file_output.lower() == "auto":
         data_dirs = find_installation_data()
         if not data_dirs:
-            # Create default location if none found
             config_dir = get_user_config_dir()
             default_dir = os.path.join(config_dir, "Ableton", f"Live {version} {edition}")
             unlock_dir = os.path.join(default_dir, "Unlock")
             os.makedirs(unlock_dir, exist_ok=True)
             authorize_file_output = os.path.join(unlock_dir, "Authorize.auz")
-            print(f"\nUsing default authorization file location: {authorize_file_output}")
+            print(LIME + f"\nUsing default authorization file location: " + WHITE + f"{authorize_file_output}" + RESET)
         else:
-            print("\nFound Ableton data directories:")
+            print(LIME + "\nFound Ableton data directories:" + RESET)
             for i, (path, name) in enumerate(data_dirs):
-                print(f"{i+1}. {name} at {path}")
+                print(WHITE + f"{i+1}. " + LIME + f"{name}" + GREY + f" at {path}" + RESET)
 
             try:
-                selection = int(input("\nSelect data directory: ")) - 1
+                selection = int(input(LIME + "\nSelect data directory: " + RESET)) - 1
                 if selection < 0 or selection >= len(data_dirs):
-                    print("Invalid selection. Using first directory.")
+                    print(RED + "Invalid selection. Using first directory." + RESET)
                     selection = 0
                 unlock_dir = os.path.join(data_dirs[selection][0], "Unlock")
                 os.makedirs(unlock_dir, exist_ok=True)
                 authorize_file_output = os.path.join(unlock_dir, "Authorize.auz")
-                print(f"Selected: {authorize_file_output}")
+                print(LIME + f"Selected: " + WHITE + f"{authorize_file_output}" + RESET)
             except ValueError:
-                print("Invalid input. Using first data directory found.")
+                print(RED + "Invalid input. Using first data directory found." + RESET)
                 unlock_dir = os.path.join(data_dirs[0][0], "Unlock")
                 os.makedirs(unlock_dir, exist_ok=True)
                 authorize_file_output = os.path.join(unlock_dir, "Authorize.auz")
 
-    # Construct the key from the loaded parameters
     try:
         team_r2r_key = construct_key(dsa_params)
     except Exception as e:
-        print(f"Error constructing DSA key: {e}")
-        input("Press Enter to exit...")
+        print(RED + f"Error constructing DSA key: {e}" + RESET)
+        input(GREY + "Press Enter to exit..." + RESET)
         return
 
-    # Generate keys and save the authorize file
-    print("\nGenerating authorization keys...")
+    print(LIME + "\nGenerating authorization keys..." + RESET)
     try:
         lines = list(generate_all(team_r2r_key, edition, version, hwid))
         with open(authorize_file_output, "w", newline="\n") as f:
             f.write("\n".join(lines))
-        print(f"Authorization file created: {authorize_file_output}")
+        print(LIME + "Authorization file created: " + WHITE + f"{authorize_file_output}" + RESET)
     except Exception as e:
-        print(f"Error generating authorization keys: {e}")
-        input("Press Enter to exit...")
+        print(RED + f"Error generating authorization keys: {e}" + RESET)
+        input(GREY + "Press Enter to exit..." + RESET)
         return
 
-    # Replace the signkey in the binary file
-    print("\nPatching executable...")
+    print(LIME + "\nPatching executable..." + RESET)
     try:
         replace_signkey_in_file(file_path, old_signkey, new_signkey)
-        print("\nPatch completed successfully!")
-        input("Press Enter to exit...")
+        print(LIME + "\nPatch completed successfully!" + RESET)
+        input(GREY + "Press Enter to exit..." + RESET)
     except Exception as e:
-        print(f"\nPatch failed: {e}")
-        input("Press Enter to exit...")
+        print(RED + f"\nPatch failed: {e}" + RESET)
+        input(GREY + "Press Enter to exit..." + RESET)
 
 if __name__ == "__main__":
     main()
diff --git a/undo_patch.py b/undo_patch.py
