HSL Color Randomizer

HSL Color Randomizer

Script for Adobe Illustrator

Description

HSL Color Randomizer is a powerful Adobe Illustrator script that allows you to create random color variations within specified ranges for selected objects.

Using the HSL (Hue, Saturation, Lightness) color model, it provides precise control over color randomization while maintaining the relationship between colors.

The script works with fills, strokes, and even complex objects like gradients and text, making it an invaluable tool for creating color variations, exploring color schemes, and generating unique color combinations.

Key Features

  • Independent control over Hue, Saturation, and Lightness adjustments.
  • Real-time preview functionality.
  • Support for both RGB and CMYK document color modes.
  • Handles multiple selected objects.
  • Works with solid colors, gradients, and text objects.
  • Ability to revert to original colors.

Installation

1. Download the Script:

  • Save the HSL Color Randomizer.jsx file to your computer.

2. Place in Scripts Folder:

  • For Mac: Copy the file to 
    /Applications/Adobe Illustrator [Version]/Presets/<Language>/Scripts/
  • For Windows: Copy the file to
    C:\Program Files\Adobe\Adobe Illustrator [Version]\Presets\<Language>\Scripts\

3. Restart Illustrator:

  • If Illustrator was running during installation, restart it to recognize the new script.

Using the script

  • Launch the Script: Go to File > Scripts > HSL Color Randomizer
  • Configure Randomization Settings: The dialog box offers the following options:

 

 

➊ Hue Adjustment

1.1 Set the minimum hue shift value:

  • Use the slider or input field (-180° to 180°).
  • Negative values shift towards cooler colors.
  • Positive values shift towards warmer colors.

1.2 Set the maximum hue shift value:

  • This creates the range for random hue variations.

Hue Adjustment

 

 


➋ Saturation Adjustment

2.1 Set the minimum saturation change:

  • Use the slider or input field(-100 to 100).
  • Negative values decrease saturation.
  • Positive values increase saturation.

2.2 Set the maximum saturation change:

  • This creates the range for random saturation variations.

Saturation Adjustment

 

 


➌ Lightness Adjustment

3.1 Set the minimum lightness change:

  • Use the slider or input field (-100 to 100).
  • Negative values darken colors.
  • Positive values lighten colors.

3.2 Set the maximum lightness change:

  • This creates the range for random lightness variations.

Lightness Adjustment

 

 


➍ Finalizing Changes

  • Click OK button to apply the current adjustments.
  • Click Cancel button to revert to original colors.

Tips for Best Results:

  • Start with smaller ranges to maintain color cohesion.
  • Use Preview mode to check results before applying.
  • For subtle variations, keep ranges within 20-30 units.
  • For dramatic changes, expand ranges to their maximum.
  • When working with gradients, adjust ranges carefully to maintain smooth transitions.

Limitations:

⚠︎ The script does not apply adjustments to:

✖ Raster Images.
✖ Pattern Swatches.
✖ Effects/Appearances.
✖ Freeform Gradients.
✖ Gradient Meshes


➎ Additional Features

🅰 Preview Mode:

  • Toggle the Preview checkbox to see changes in real-time.
  • Uncheck to view original colors.
  • Re-check to view adjusted colors.

🅱 User Guide:

  • Click the icon ⏼ in the bottom right corner to access the user guide.

Fine-Tuning:

  • Use arrow keys in input fields for precise adjustments:
  • Up/Down: Adjust by 1 unit.
  • Shift + Up/Down: Adjust by 10 units.

Technical Notes:

  • The script automatically handles color mode conversion between RGB and CMYK.
  • Original colors are preserved until OK button is clicked.
  • All adjustments are non-destructive until finalized.
  • Works with grouped objects and compound paths.
  • Supports multiple selection of different object types.


☻ㅤWrap-Up

The HSL Color Randomizer empowers you to break creative ruts and discover unexpected color harmonies in seconds.

By balancing precise control with playful randomness, it’s perfect for adding subtle color variations to your artwork,  generating branding palettes, gradient variations, or creating dynamic experimental designs.

Leave a comment

HSL Color Randomizer

Version: 1.0.0

Updated:

  • 1.0.0 – Initial release.

    Tested on MacOS:

    • Adobe Illustrator 2023 (27.0)
    • Adobe Illustrator 2024 (28.1)
    • Adobe Illustrator 2025 (29.0)
  • Supported Versions:

    • Compatible with Adobe Illustrator CS6 and later, including Adobe Illustrator CC versions.

    Operating Systems:

    • Works on both macOS and Windows platforms.
  • End User License Agreement (EULA)

    Last Updated: 21.12.2024

    This End User License Agreement (“Agreement”) is a legal agreement between you (“User” or “Licensee”) and Samolevsky.com (“Licensor”) regarding the use of the Adobe Illustrator scripts (“Software”). By downloading, installing, or using the Software, you agree to be bound by the terms of this Agreement.

    1. Grant of License

    Licensor grants the User a non-exclusive, non-transferable, and revocable license to use the Software in accordance with this Agreement.

    • Free Software: If the Software is provided for free, you may use it for personal or commercial purposes without payment, subject to the restrictions outlined in this Agreement.
    • Paid Software: If the Software is provided for a fee, you may use it only after payment has been made in full.

    2. Usage Rights

    You are permitted to:

    • Install and use the Software on devices you own or control.
    • Use the Software in your personal or commercial projects, subject to compliance with this Agreement.

    3. Restrictions

    You may NOT:

    • Reverse engineer, decompile, or otherwise attempt to discover the source code, underlying ideas, or algorithms of the Software.
    • Reuse, incorporate, or integrate any portion of the Software into any other software, product, or project, except as expressly permitted by the Licensor in writing.
    • Resell, redistribute, or share the Software, whether in its original or modified form, without prior written consent from the Licensor.
    • Claim ownership of the Software or its underlying code.
    • Use the Software in any way that violates applicable laws or regulations.

    4. Ownership

    The Software and all intellectual property rights therein remain the exclusive property of the Licensor. This Agreement does not transfer ownership of the Software or any intellectual property rights to the User.

    5. Disclaimer of Warranties

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

    6. Limitation of Liability

    To the maximum extent permitted by law, Licensor shall not be liable for any damages, including but not limited to direct, indirect, incidental, special, or consequential damages, arising out of or related to the use or inability to use the Software.

    7. Termination

    This Agreement is effective until terminated. Licensor may terminate this Agreement immediately if you breach any term of this Agreement. Upon termination, you must cease all use of the Software and destroy any copies in your possession.

    8. Updates and Support

    Licensor is not obligated to provide updates, support, or maintenance for the Software. However, updates may be provided at the sole discretion of the Licensor.

    9. Governing Law

    This Agreement shall be governed by and construed in accordance with the laws of the State of New York, without regard to its conflict of law principles.

    10. Entire Agreement

    This Agreement constitutes the entire agreement between you and the Licensor concerning the Software and supersedes all prior or contemporaneous understandings regarding such subject matter.

    By using the Software, you acknowledge that you have read this Agreement, understand it, and agree to be bound by its terms.

    For any questions or concerns regarding this Agreement, please contact us at hello@samolevsky.com

Required Software

Adobe Illustrator

Adobe Illustrator is a professional vector graphics software developed by Adobe Inc. It is widely used by designers, illustrators, and artists for creating a variety of digital artwork, including logos, icons, illustrations, typography, and complex design layouts. Illustrator is known for its precision and scalability, allowing users to create high-quality graphics that can be resized without losing clarity. Its features include powerful drawing tools, customizable brushes, advanced typography options, and seamless integration with other Adobe Creative Cloud applications. Illustrator is a go-to tool for creative professionals working on projects for print, web, and multimedia platforms.

  • 🅰 Locating the Scripts Folder

    To install a HSL Color Randomizer.jsx script in Adobe Illustrator, you need to place it in the correct directory where Illustrator
can recognize it. Follow these steps to locate the Scripts folder:

    1. MacOS:
      Open Finder and navigate to:
      Applications/Adobe Illustrator <Version>/Presets/<Language>/Scripts.
    2. Windows:
      Open File Explorer and navigate to:
      C:\Program Files\Adobe\Adobe Illustrator <Version>\Presets\<Language>\Scripts
    3. Replace <Version> with your Adobe Illustrator version (e.g., 2025).
    4. Replace <Language> with your language folder (e.g., "de_DE" for German, "en_US" for English).

    🅱 Installing the Script

    1. Copy the Script File: Copy the HSL Color Randomizer.jsx file to the Scripts folder located in the path above.
    2. On some systems, you may need administrator permissions to modify the Scripts folder.
    3. Restart Adobe IllustratorTo refresh the scripts menu, close and reopen Adobe Illustrator.

    Explore our complete guide to mastering Adobe Illustrator scripts.

    1. Open Adobe Illustrator and ensure a document is active.
    2. Go to the top menu bar and select File > Scripts.
    3. If the script is installed in the Scripts folder, it will appear in the dropdown list.
    4. Click the HSL Color Randomizer script to run it.
    5. The HSL Color Randomizer script will execute, and any dialog boxes or results will appear based on the script’s functionality.

    ☻ Before running any scripts, it’s strongly advised to save your work — especially when working with complex or large documents.

Got questions?

Need help or have an idea to share? We’d love to hear from you! Whether you have questions, found a bug, have a feature request, or just want to share your feedback, reach out to us—we’re here for you! 

Browse More Scripts

  1. Read more: Select Off-Artboard Objects
    Select Off-Artboard Objects

    Select Off-Artboard Objects

    This script for Adobe Illustrator helps you easily select objects that are either inside or outside the boundaries of your artboards. It's particularly useful for cleaning up designs by finding and managing stray objects outside your active work area.

    Read more
  2. Read more: Create Artboards from Selection
    Create Artboards from Selection

    Create Artboards from Selection

    This advanced Adobe Illustrator script automates the creation of artboards from selected objects. It's designed to streamline your workflow when you need to create multiple artboards based on existing design elements.

    Read more
  3. Read more: Paste to Replace
    Paste to Replace

    Paste to Replace

    The Paste to Replace script for Adobe Illustrator enables users to replace selected objects with clipboard content efficiently. It provides a user-friendly interface with options to maintain the original size, fit proportionally, or stretch to fit.

    Read more