Installation

Follow these steps to set up the Colour Stepper Scripts:

1. Download the Scripts
   • Download the ZIP archive containing the scripts, here.
2. Create a Folder
   • Create a folder (e.g. aseprite_colour_steppers) inside your Aseprite’s to store the script scripts, usually found at C:\Users<username>\AppData\Roaming\Aseprite\scripts
3. Unzip the Scripts
   • Extract the contents of the ZIP file into the folder you created.
     • You can safely remove the README.md file
4. Move the Folder
   • Copy the folder (aseprite_colour_steppers) into your Aseprite scripts directory:

     C:\Users\<username>\AppData\Roaming\Aseprite\scripts
     

5. Rescan Scripts
   • In Aseprite, go to File > Scripts > Rescan Scripts Folder to load the new scripts.

Assigning Keyboard Shortcuts

1. Open the Keyboard Shortcuts editor:
   • Go to Edit > Keyboard Shortcuts.
2. Search for the scripts:
   • Type colour_stepper_scripts or the specific script name in the search bar.
3. Map shortcuts:
   • Assign a key combination to each script (e.g.,rwfgo[ikdfopewidfiiuopipuirpoewiorewopweooewwriowier] map decrease_hue to CTRL + SHIFT + Q).

Configuration (Optional)

If you want to customize the step increments.

1. Go to File > Scripts > aseprite_colour_steppers > hsl_config_dialog.
2. Adjust the steps for hue, saturation, value and alpha (values range from 0 to 100).
3. Ensure you have write access to allow the configuration file to be updated.

Usage

Use your newly assigned keyboard shortcuts in Aseprite 😀

Example Of My Key Bindings

Here’s a suggested setup for shortcuts:

• Increase Hue: CTRL + SHIFT + Q
• Decrease Hue: CTRL + SHIFT + A
• Increase Saturation: CTRL + SHIFT + W
• Decrease Saturation: CTRL + SHIFT + S
• Increase Value: CTRL + SHIFT + E
• Decrease Value: CTRL + SHIFT + D
• Increase Alpha: CTRL + SHIFT + R
• Decrease Alpha: CTRL + SHIFT + F