ScriptBox: Your Complete Adobe Illustrator Productivity Hub·

    ScriptBox

    Extension for Adobe Illustrator (beta)

    ✦ Available exclusively on Patreon for Pro supporters.

    This powerful extension serves as a centralized hub for managing and executing various automation scripts, providing designers with quick access to over 200+ specialized tools. It’s designed to help you run scripts faster, stay organized, and customize your automation workflow—all in one panel.

    Key Features

    • 200+ Automation Scripts: Organized into 12specialized categories (Arrange, Artboard, Color, Games, Generator, Optimize, Path, Randomize, Rename, Select, Text, Transform, Utility) covering every aspect of Illustrator automation - from object positioning to text manipulation.

      Smart Search: Fast search functionality across scripts, panels, and features to find exactly what you need without browsing.

      Multiple View Modes: Switch between list, compact, and grid views across different tabs to match your workflow preferences and screen space.

    • Integrate your own custom script libraries or third-party scripts. Add entire folders of scripts and keep them separate from the built-in library.

      One-Click Execution: Run any script instantly with a single click - no complex menus or additional steps required.

    • One-click access to all Adobe Illustrator panels without navigating through menus. Quick search functionality to find any panel instantly.

    • Write, test, and run custom JSX scripts directly within the extension. Load scripts from URLs, save your work as .jsx files, and execute code with syntax highlighting support.

    • Organize your most-used scripts and panels in one convenient location with drag-and-drop reordering. Combines both scripts and panels for streamlined workflow.

    • Simple to-do list system for tracking design workflows and project tasks without leaving Illustrator.

    • Add and organize links to tutorial videos, music playlists, and learning resources for quick reference while working.

    • Visual moodboard for design inspiration with multiple view modes (grid, masonry, list). Drag-and-drop images, add folders, and place images directly into your document.

    • This tool helps you create beautifully balanced gradient combinations with ease.

    The All-in-One Solution

    ScriptBox


    Installation

    1. Download and install ZXPInstaller
    2. Drag and drop ScriptBox_0.1.8.9.zxp onto ZXPInstaller
    3. The extension will be installed automatically
    4. Restart Adobe Illustrator if it's already running
    5. Access extension via Window > Extensions > ScriptBox

    Troubleshooting

    ⚠︎ Since this extension is still in beta, it may not load properly for all users. If you run into this issue, you’ll need to enable Debug Mode in Adobe Illustrator. Debug Mode allows unsigned CEP extensions to run, which is required during testing. Don’t worry—it’s a safe and standard step for trying out beta extensions.

    ㅤㅤ

    How to Enable Debug Mode for CEP Extensions

    MacOS:

     

    1. Open Terminal
    2. Run the following command:
      defaults write com.adobe.CSXS.11 PlayerDebugMode 1

    3. Replace CSXS.11 with the actual CEP version used by your Illustrator. For Adobe Illustrator 2020 and some recent versions, it often corresponds to CSXS.9 or CSXS.10

    4. After enabling, restart Illustrator, and the extension will load in Window > Extensions > ScriptBox

    Windows:

     

    1. Press Win + R, type regedit, and hit Enter

    2. Navigate to:
      HKEY_CURRENT_USER\Software\Adobe\CSXS.11

    3. Look for a key called PlayerDebugMode (If it doesn’t exist, create a new String Value named PlayerDebugMode)

    4. Set its value to: 1

    5. After enabling, restart Illustrator, and the extension will load in Window > Extensions > ScriptBox

     ㅤ


    ☻ ScriptBox: Your Complete Adobe Illustrator Productivity Hub

    ScriptBox represents a revolutionary approach to Adobe Illustrator workflow enhancement, transforming your creative environment into a comprehensive productivity ecosystem. This powerful CEP extension goes far beyond simple script execution, offering an integrated suite of tools designed to streamline every aspect of your design process.

    The All-in-One Solution

    With over 200+ carefully curated scripts organized across 12 categories—from basic arrangement and color tools to advanced path manipulation and creative games—ScriptBox eliminates the need to hunt through multiple folders or remember complex file locations. The intuitive Toolbox provides instant access to professional-grade automation tools, while the External Scripts tab seamlessly integrates your existing script library.

    Beyond Scripts: A Complete Workspace

    ScriptBox's true power lies in its holistic approach to design productivity:

    • Panels Manager: Quick access to all Adobe Illustrator panels with favorites organization
    • Favorites System: Personalized collections of your most-used tools and resources
    • Code Editor: Built-in development environment for custom script creation
    • Task Management: Integrated to-do system with drag-and-drop prioritization
    • Video Library: Curated YouTube content for continuous learning and inspiration

    Designed for Modern Workflows

    Every script and feature in ScriptBox is crafted with the contemporary designer in mind. The drag-and-drop reordering capabilities, intelligent search functionality, and responsive interface adapt to your unique working style. Whether you're a freelancer managing multiple projects or part of a design team requiring consistent workflows, ScriptBox scales to meet your needs.

    Continuous Evolution

    ScriptBox isn't just a tool—it's a platform that grows with you. The extension's architecture supports ongoing updates, new script additions, and feature enhancements based on your feedback, ensuring your investment in productivity continues to pay dividends as your skills and projects evolve.

    Your Creative Command Center

    By consolidating scripts, panels, tasks, learning resources, and development tools into a single, elegant interface, ScriptBox transforms Adobe Illustrator from a design application into a complete creative command center. It's not just about working faster—it's about working smarter, learning continuously, and maintaining the creative flow that produces exceptional design work.

    Ready to revolutionize your Adobe Illustrator workflow? Install ScriptBox and experience the future of design productivity today

    Leave a comment

    Script Categories Include:

    • Advanced object positioning, distribution, and alignment tools including grid arrangers, radial arrangers, and smart object replacers:
      • Create multiple copies of selected objects with precise spacing and alignment options
      • Advanced alignment tools with additional spacing and distribution options
      • Arrange selected objects in a perfect grid with customizable rows and columns
      • Move or copy selected objects between layers
      • Sort and organize selected objects based on various criteria like position, size, or color
      • Replace selected objects with clipboard content while maintaining original positions
      • Proportionally move multiple selected objects closer together or farther apart by specifying a percentage value
      • Arrange objects in a circular or radial pattern around a center point
      • Create seamless repeating patterns from selected objects with customizable spacing and alignment
      • Randomly shuffle the positions of selected objects while maintaining their relative arrangement
      • Replace the selected objects with content from the clipboard, document symbols, or other selected objects, with options to match colors, opacity, and size
      • Instantly swap the positions of two selected objects
    • Comprehensive artboard management including batch operations, smart resizing, and content cropping:
    • Powerful color manipulation tools from randomizers to gradient managers and contrast checkers:
      • Randomly apply colors from your document's swatch library to the fills and strokes of selected objects
      • Modify the opacity of selected objects by a specific percentage value
      • Calculate and apply the average color values across selected objects, with options to average fills, strokes, gradients, and opacity
      • Batch Layer Color CustomizerBatch Layer Color Customizer

        Batch recolor selected layers—choose a custom color, use the active layer's color, randomize per layer, or apply a smooth top-to-bottom gradient to unlocked layers
      • Adjust individual color channels (RGB or CMYK) using percentage sliders for selected objects
      • Apply random colors to selected objects from current swatches
      • Randomly shuffle colors between selected objects while preserving their original color assignments
      • Convert color values between different color spaces (RGB, CMYK, HSB)
      • Analyze color contrast ratios between background and foreground elements according to WCAG accessibility standards
      • Convert Spot colors and Global colors to regular RGB colors
      • Evenly distribute gradient stops across selected gradients with customizable spacing options
      • Convert gradient fills to solid colors using the dominant or average color from the gradient
      • Generate random colors using HSL color model for better control
      • Adjust HSL values of selected objects with precise control
      • Invert colors of selected objects with live preview
      • Create random RGB colors with customizable value ranges
      • Extract colors from selected objects and create a customizable gradient swatch from them
      • Selection to SwatchesSelection to Swatches

        Create a gradient swatch from the selected objects’ fill or stroke colors
      • Shuffle, reverse, or mirror the color order of gradient stops in selected objects with gradient fills or strokes
      • Convert solid color fills to customizable gradients and transform selected objects with solid fills into gradient fills
      • Instantly swap fill and stroke colors of selected objects
      • Transfer selected color swatches between multiple open documents while preserving folder structure
      • Convert swatches between different color types (Global, Spot, or Solid colors) or delete selected swatches
      • Text Color RandomizerText Color Randomizer

        Apply random colors to selected text frames using RGB, CMYK, or HSL color modes, with options to randomize by text frames, sentences, lines, words, or individual characters
      • CheckerChecker

        Play a classic checkers game directly within Adobe Illustrator
      • ChessChess

        A fully-featured chess game that runs directly inside Adobe Illustrator
      • Connect FourConnect Four

        Enjoy the Connect Four game with a visual interface in Illustrator
      • MinesweeperMinesweeper

        Classic minesweeper puzzle game integrated into your design workspace
      • Simple tic-tac-toe game for quick breaks during design work
    • Create complex patterns and shapes including QR codes, barcodes, fractals, and geometric patterns
      • 10 Print Pattern Generator10 Print Pattern Generator

        Generate customizable \"10 Print\" maze-like patterns by creating a grid of randomly oriented lines
      • Archimedean Spiral GeneratorArchimedean Spiral Generator

        Create customizable Archimedean spirals with adjustable parameters including radius, angle, rotation count, stroke width, and color
      • Barcode GeneratorBarcode Generator

        Generate UPC-12 and EAN-13 barcodes with automatic check digit calculation, customizable fonts and tracking adjustment
      • Create modern bento-style grid layouts with customizable cells
      • Circle With N PointsCircle With N Points

        Create a perfect circle with a customizable number of evenly-spaced anchor points, adjustable radius, stroke weight, and color
      • Fractal Tree GeneratorFractal Tree Generator

        Generate customizable fractal trees with adjustable parameters like branching levels, divisions, angles, scaling, position, and stroke
      • Generate QR codes with custom text, URLs, and styling options
      • Sine Wave GeneratorSine Wave Generator

        Generate customizable sine wave patterns with adjustable size, repetitions, stroke properties, and color
      • Create squircle shapes (square-circle hybrids) with adjustable corner radius
      • Star Shape GeneratorStar Shape Generator

        Create customizable star and polygon shapes with adjustable parameters like number of sides, size, inner radius, rotation, colors, stroke width, and corner rounding
    • Document cleanup and optimization tools for streamlining files and managing symbols:
      • Break symbol links by converting symbol instances into regular editable artwork
      • Release, modify, or merge clipping masks with advanced options for fill/stroke styling and preview highlighting
      • Close open vector paths with precision and controlv
      • Convert Spot colors and Global colors to regular RGB colors
      • Remove unused swatches, styles, symbols and other document clutter automatically
      • Automatically group selected objects based on shared visual attributes like fill color, stroke color, stroke weight, opacity, and blending modes
      • Image Transform ResetImage Transform Reset

        Reset transform properties (position, rotation, scale, skew) of selected images to their original values
      • Merge LayersMerge Layers

        Select and merge multiple layers in your document.
      • Remove Redundant PointsRemove Redundant Points

        Remove redundant anchor points from selected paths by merging points that are closer together than a specified threshold distance
      • Selection to SymbolsSelection to Symbols

        Convert selected objects to symbols with options for naming, numbering, and replacing originals with instances
      • Smart Symbol ReplacerSmart Symbol Replacer

        Swap selected symbols with another across document/selection/layer, with optional scaling, rotation, and reference-point alignment
      • Unlock AssistantUnlock Assistant

        Identify and selectively unlock locked layers and objects through an interactive interface
      • Visibility ManagerVisibility Manager

        Find and unhide hidden layers and objects through an interactive panel with search functionality
    • Extensive path editing capabilities including corner effects, smart connectors, and bezier handle tools:
      • Add anchor points to paths at specified intervals or segments
      • Bezier Handle ConverterBezier Handle Converter

        Convert bezier handles on selected anchor points by either removing existing handles to create sharp corners or adding smooth handles to create curved transitions
      • Visualize and edit bezier curve handles with enhanced controls
      • CircumcircleCircumcircle

        Create a circumcircle that passes through all anchor points of selected paths
      • Corner EffectsCorner Effects

        Apply various corner bevel effects to selected path anchor points with customizable radius
      • Dash Solid ConverterDash Solid Converter

        Convert selected strokes between dashed and solid, with live preview and adjustable dash/gap settings
      • Convert dashed strokes into individual path objects for advanced editing
      • Distribute Along PathDistribute Along Path

        Place lines or symbol markers along selected Illustrator paths with controls for count, size, and rotation
      • Modify bezier handles with extension and rotation capabilities
      • Modify bezier handles with extension and rotation capabilities
      • Fine-tune bezier handles with precise numerical adjustments
      • Join PathsJoin Paths

        Intelligently connect multiple open paths into unified shapes
      • Metaball Shape ConnectorMetaball Shape Connector

        Create smooth, organic \"metaball\" connectors between two or more selected circles
      • Path Arrowhead MakerPath Arrowhead Maker

        Add customizable arrowheads to selected paths, choosing shape, size, arrow style, or a document symbol
      • Apply various deformation effects to selected paths and shapes
      • Path EffectsPath Effects

        Preview and apply a variety of adjustable path distortion effects to your selected paths
      • Smart ConnectorSmart Connector

        Connect selected objects by drawing lines between centers or anchor points with adjustable amount, stroke, opacity, and randomness
      • Intelligently round corners of paths with customizable radius settings
      • Smooth Round CornersSmooth Round Corners

        Interactively smooth and round selected path corners
      • Split PathSplit Path

        Split selected paths at chosen anchor points into separate segments
      • Stroke Dash TweakerStroke Dash Tweaker

        Adjust dash and gap lengths for dashed lines or convert solid strokes to dashed patterns with live preview
      • Stroke and Dash AveragerStroke and Dash Averager

        Average stroke weight of selected objects with optional averaging of dash/gap patterns and stroke color
      • TriangulatorTriangulator

        Convert selected Illustrator shapes into a low‑poly triangulated mesh with adjustable point distribution, colors, and strokes
      • Trim PathTrim Path

        Trim selected open paths by a specified amount from the start, end, or both
    • Add controlled randomness to colors, positions, rotations, scales, and more:
      • Randomly apply colors from your document's swatch library to the fills and strokes of selected objects
      • Apply random colors to selected objects from current swatches
      • Apply random dash patterns to selected strokes
      • Apply random fonts from available font families to selected text
      • Gradient Rotation RandomizerGradient Rotation Randomizer

        Randomly rotate linear gradients within selected objects using customizable angle ranges
      • Generate random colors using HSL color model for better control
      • Randomly adjust opacity values within specified ranges
      • Create random RGB colors with customizable value ranges
      • Apply random blending modes to selected objects
      • Randomly select a specified number or percentage of objects
      • Add random displacement to anchor points for organic effects
      • Random RecolorRandom Recolor

        Randomly recolor selected objects with customizable color schemes, adjustable value ranges, and options to recolor text by frames, words, or characters individually
      • Apply random rotation angles to selected objects within specified ranges
      • Random ScaleRandom Scale

        Randomly scale selected objects with customizable size ranges, adjustable reference points, and options to scale group items or compound path elements individually
      • Random ScatterRandom Scatter

        Randomly scatter selected objects by moving them to random positions within customizable horizontal and vertical ranges
      • Generate random placeholder text with customizable length and content
      • Randomly vary stroke widths within defined parameters
      • Text Baseline Shift RandomizerText Baseline Shift Randomizer

        Randomly vary the baseline shift of selected text within a specified range at character, word, line, or frame level
      • Text Color RandomizerText Color Randomizer

        Apply random colors to selected text frames using RGB, CMYK, or HSL color modes, with options to randomize by text frames, sentences, lines, words, or individual characters
      • Text Leading RandomizerText Leading Randomizer

        Randomize the line spacing (leading) of selected Illustrator text within a chosen range—per character, word, line, or entire frame
      • Text Rotation RandomizerText Rotation Randomizer

        Randomly rotate text in your selection—by character, word, line, or entire text frame
      • Text Scale RandomizerText Scale Randomizer

        Randomize the vertical and horizontal scale of selected Illustrator text—by character, word, line, or entire text frame
      • Text Size RandomizerText Size Randomizer

        Randomize the font size of selected Illustrator text using min/max sliders, choosing scope per character, word, line, or entire text frame
      • Text Tracking RandomizerText Tracking Randomizer

        Randomize the tracking of selected text within a chosen min/max range at the character, word, line, or entire text frame level
      • Type RandomizerType Randomizer

        Randomize font size, leading, tracking, scale, baseline shift, and rotation on selected text with adjustable ranges per character, word, line, or entire text frame
    • Batch renaming tools for layers, artboards, symbols, and swatches:
      • Rename multiple artboards using patterns, numbering, and prefixes
      • Graphic Styles Batch RenamerGraphic Styles Batch Renamer

        Rename multiple graphic styles efficiently
      • Batch rename selected objects with various naming conventions
      • Convert layer names between different case formats (uppercase, lowercase, title case)
      • Rename multiple layers using sequential numbering and custom patterns
      • Swatches Batch RenamerSwatches Batch Renamer

        Rename multiple swatches in your document at once
      • Symbols Batch RenamerSymbols Batch Renamer

        Rename multiple document symbols simultaneously
    • Advanced selection tools to find objects by any attribute imaginable:
      • Select objects across multiple layers with advanced filtering
      • Randomly select a specified number or percentage of objects
      • Select Linked Images by FormatSelect Linked Images by Format

        Quickly find, select, and optionally embed linked images by file format in the current document
      • Find and select objects positioned outside artboard boundaries
      • elect paths containing anchor points within specified ranges
      • Filter paths by their stroke cap and corner join settings
      • Select Similar ObjectsSelect Similar Objects

        Select all objects similar to the selected one by matching fill/stroke, size, opacity, blending mode, dash pattern, or geometry
      • Select text frames with similar formatting or properties
      • Find text frames containing specific text content
      • Select all objects within specific artboards
      • Select objects based on specific attributes like fill color, stroke weight
      • Filter selection by blending mode types
      • Select a specific number of objects using various criteria
      • Select by Dash PropertiesSelect by Dash Properties

        Select paths with dashed strokes whose dash and gap lengths fall within specified ranges
      • Select text objects using specific fonts or font families
      • Select objects based on their stacking order in layers
      • Select objects by matching names or name patterns
      • Select objects within specific opacity value ranges
      • Select by PercentageSelect by Percentage

        Select a chosen percentage or exact number of objects from the active document, selection, layer, or artboard
      • Select objects rotated within specified angle ranges
      • Select objects based on width, height, or area measurements
      • Select by Size MatchSelect by Size Match

        Select all objects that match the selected object's size (width, height, or area) within a chosen tolerance
      • Filter selection by stroke thickness values
      • Select objects using specific swatch colors
      • Select by Text SizeSelect by Text Size

        Select text frames by font size range
      • Analyze and display detailed information about current selection
      • Smart SelectorSmart Selector

        Quickly select Illustrator objects by type, appearance, attributes, and other properties
      • Select symbol instances based on their master symbol
      • Automatically zoom and center view on selected objects
    • Comprehensive text manipulation from randomizers to formatters and content swappers:
      • Bulleted List MakerBulleted List Maker

        Convert selected text frames into bulleted lists using your chosen bullet symbol
      • Dynamic Text BlockDynamic Text Block

        Transform multiple selected text frames into a professionally formatted, vertically stacked text block.
      • Apply random fonts from available font families to selected text
      • Edit multiple text objects simultaneously with batch operations
      • Page Number GeneratorPage Number Generator

        Automatically generate page numbers across multiple artboards in your document
      • Placeholder Text GeneratorPlaceholder Text Generator

        Generate customizable placeholder text wireframes—set lines, words, height, spacing, corner radius, alignment, and color
      • Generate random placeholder text with customizable length and content
      • Select text frames with similar formatting or properties
      • Find text frames containing specific text content
      • Select by Text SizeSelect by Text Size

        Select text frames by font size range
      • Sequential Text NumberingSequential Text Numbering

        Automatically add sequential numbers, letters (A-Z), or Roman numerals to selected text frames
      • Text AlignerText Aligner

        Align selected text frames without changing the position of point text objects
      • Text Baseline Shift RandomizerText Baseline Shift Randomizer

        Randomly vary the baseline shift of selected text within a specified range at character, word, line, or frame level
      • Text Color RandomizerText Color Randomizer

        Apply random colors to selected text frames using RGB, CMYK, or HSL color modes, with options to randomize by text frames, sentences, lines, words, or individual characters
      • Text Content SwapperText Content Swapper

        Swap text content between two selected text frames without altering the original frames' color, style, or position
      • Text Frame MergerText Frame Merger

        Merge multiple selected text frames into a single text frame
      • Text HighlighterText Highlighter

        Automatically create customizable highlight rectangles behind or in front of selected text
      • Text Leading RandomizerText Leading Randomizer

        Randomize the line spacing (leading) of selected Illustrator text within a chosen range—per character, word, line, or entire frame
      • Text Rotation RandomizerText Rotation Randomizer

        Randomly rotate text in your selection—by character, word, line, or entire text frame
      • Text Scale RandomizerText Scale Randomizer

        Randomize the vertical and horizontal scale of selected Illustrator text—by character, word, line, or entire text frame
      • Text Size RandomizerText Size Randomizer

        Randomize the font size of selected Illustrator text using min/max sliders, choosing scope per character, word, line, or entire text frame
      • Text SplitterText Splitter

        Split selected text frames into separate lines, words, or characters
      • Text Tracking RandomizerText Tracking Randomizer

        Randomize the tracking of selected text within a chosen min/max range at the character, word, line, or entire text frame level
      • Type RandomizerType Randomizer

        Randomize font size, leading, tracking, scale, baseline shift, and rotation on selected text with adjustable ranges per character, word, line, or entire text frame
      • Fine-tune typography with advanced spacing and positioning controls
    • Object transformation and scaling tools:
      • Modify stroke weights by percentage values while maintaining proportions
      • Adjust the aspect ratio of selected objects while keeping either width or height fixed
      • Modify bezier handles with extension and rotation capabilities
      • Fine-tune bezier handles with precise numerical adjustments
      • Convert flat objects to isometric perspective with customizable angles
      • Long ShadowLong Shadow

        Create stylish long shadow effects for your vector paths
      • Object SlicerObject Slicer

        Split the selected object into customizable angled slices with randomizable widths and offsets
      • Path EffectsPath Effects

        Preview and apply a variety of adjustable path distortion effects to your selected paths
      • Path GlitcherPath Glitcher

        Create a glitch effect by slicing the selected paths into adjustable horizontal/vertical fragments and randomly offsetting them
      • Progressive TransformProgressive Transform

        Progressively transform multiple selected objects relative to a chosen reference point—scaling, rotating, moving, and adjusting opacity/stroke with live preview and optional randomness
      • SkewSkew

        Apply precise shear transformations to selected objects with real-time preview
      • Resize objects intelligently while preserving important visual relationships
      • Smart ScaleSmart Scale

        Resize selected objects to exact dimensions, add/subtract values, or scale by percentage
      • Zig-Zag EffectZig-Zag Effect

        Transform ordinary paths into dynamic zig-zag patterns
    • Miscellaneous productivity tools:
      • Batch Layer Color CustomizerBatch Layer Color Customizer

        Batch recolor selected layers—choose a custom color, use the active layer's color, randomize per layer, or apply a smooth top-to-bottom gradient to unlocked layers
      • Bounding Box BuilderBounding Box Builder

        Create bounding boxes around selected objects with a precise control over box margins, appearance, and additional elements like grids, diagonals, and more
      • Built-in calculator for design measurements and calculations
      • Copy as PNGCopy as PNG

        Copy selected objects to the clipboard as a PNG with configurable scale, background (transparent/white/black), margin, and anti-aliasing
      • Cross-Document Layer DuplicatorCross-Document Layer Duplicator

        Copy selected layers (and their contents) from one document to one or more open documents, preserving structure, order, and positions, with optional name prefix/suffix
      • Document Grid VisualizerDocument Grid Visualizer

        Create visible grid lines on your artboards based on your document's grid settings
      • Documents SaverDocuments Saver

        View, filter, and selectively close multiple open documents with options to save or discard changes
      • Fill CanvasFill Canvas

        Set a custom canvas background color and opacity for the active document
      • Grid GeneratorGrid Generator

        Generate customizable artboard-aligned grids (standard, column, baseline, modular, isometric, hex, or dot) with controls for size, cell spacing, color, stroke, opacity, margins, and more
      • Count and analyze selected objects with detailed statistics and reporting
      • Sequential Object LabelerSequential Object Labeler

        Quickly add sequential number labels to selected objects with customizable text styling, offsets, and optional frames
      • Symbol TransferSymbol Transfer

        Copy selected symbols from one open document to one or more other open documents with search and filtering capabilities
      • Synchronize the zoom level and view center of the selected document across all other open documents
      • Track and manage design iterations with version history
      • Quickly locate and access specific tools and features

    User Guide

    • Welcome to ScriptBox! This section will guide you through the installation process and help you get up and running with your new productivity toolkit for Adobe Illustrator.

      System Requirements

      Before installing ScriptBox, ensure your system meets the following requirements:

      • Adobe Illustrator: Version 18.0 (CC 2014) or later
      • Operating System: Windows or macOS (any version compatible with your Illustrator version)
      • CEP Support: Your Illustrator installation must support CEP (Common Extensibility Platform) extensions

      ScriptBox is compatible with all modern versions of Adobe Illustrator CC and works seamlessly across both Windows and Mac platforms.

      Installation

      Follow these steps to install ScriptBox as a CEP extension:

      1. Download the Extension
        Obtain the ScriptBox extension package from your sourceExtract the files if they're in a compressed archive
      2. Locate Your CEP Extensions Folder
        The installation location depends on your operating system:
        Windows:
        C:\Program Files (x86)\Common Files\Adobe\CEP\extensions\
        macOS:
        /Library/Application Support/Adobe/CEP/extensions/
        If the extensions folder doesn't exist, create it manually.
      3. Copy the ScriptBox Folder
        Copy the entire ScriptBox folder into the CEP extensions directory
        Ensure all files and subfolders are included
      4. Enable Unsigned Extensions (if necessary)
        If you're using an unsigned version of ScriptBox, you may need to enable unsigned extensions:
        Windows:
        Open the Registry EditorNavigate to: HKEY_CURRENT_USER\Software\Adobe\CSXS.9
        Create a new String value named PlayerDebugMode with value 1
        Repeat for CSXS.10, CSXS.11, etc., depending on your Illustrator version
        macOS:
        Open TerminalRun: defaults write com.adobe.CSXS.9 PlayerDebugMode 1
        Repeat for CSXS.10, CSXS.11, etc., depending on your Illustrator version
      5. Restart Adobe Illustrator
        Close Illustrator completely if it's running
        Launch Illustrator again to load the extension

      Opening ScriptBox

      Once installed, you can access ScriptBox from within Adobe Illustrator:

      1. Open Adobe Illustrator
      2. Go to Window > Extensions > ScriptBox
      3. The ScriptBox panel will appear in your workspace

      You can dock the panel anywhere in your Illustrator workspace, resize it to your preference, or keep it floating for easy access.

      First Launch

      When you open ScriptBox for the first time, here's what you'll see:

      The Toolbox Tab

      • By default, ScriptBox opens to the Toolbox tab
      • You'll see a collection of folders representing different script categories
      • Each folder contains multiple scripts organized by function

      Quick Orientation:

      1. Explore the Categories - Click on any folder to expand it and see the scripts inside
      2. Try a Script - Hover over any script to see its description, then click to run it
      3. Check Out the Tabs - Notice the tab icons at the top of the panel (9 tabs total)
      4. Adjust Your View - Use the view mode icons to switch between list, compact, and grid views
      5. Search for Scripts - Use the search bar to quickly find specific scripts

      Verifying Successful Installation

      To confirm ScriptBox is working correctly:

      1. Panel Appears - You should see the ScriptBox panel when you navigate to Window > Extensions > ScriptBox
      2. Scripts Load - The Toolbox tab should display folders with script categories
      3. Test a Script - Try running a simple script like "Calculator" from the Utility category
      4. No Error Messages - If scripts run without errors, your installation is successful

      If you encounter any issues, refer to the Troubleshooting section at the end of this guide.

    • ScriptBox features a clean, intuitive interface designed to give you quick access to hundreds of scripts and tools. Understanding the interface layout will help you navigate efficiently and make the most of all available features.

      Tab Navigation

      ScriptBox organizes its features into 9 distinct tabs, each accessible via icon buttons at the top of the panel. The tab navigation system allows you to quickly switch between different areas of functionality.

      The 9 Tabs:

      1. Toolbox (Toolbox Icon)Your main hub for accessing the 200+ built-in scriptsScripts are organized into 11 categories (Arrange, Artboard, Color, etc.)This is the default tab that appears when you first open ScriptBoxPerfect for browsing and running automation scripts
      2. External Scripts (Folder Icon)Manage and run custom scripts from external foldersAdd your own script collections or third-party scriptsKeep your personal scripts separate from the built-in libraryIdeal for teams sharing custom automation tools
      3. Panels Manager (Panels Icon)Quick access to all Adobe Illustrator panelsOpen any Illustrator panel with a single clickNo more navigating through Window menusIncludes all native Illustrator panels (Layers, Swatches, Pathfinder, etc.)
      4. Favorites (Star Icon)Your personalized collection of most-used scripts and panelsCombines both scripts and panels in one convenient locationDrag-and-drop to reorder itemsSaves time by eliminating repetitive searching
      5. Code Editor (Code Icon)Built-in JSX script editor with syntax highlightingWrite, test, and run custom scripts directly in ScriptBoxLoad scripts from URLs or local filesSave your work as .jsx files for future use
      6. Tasks (Checklist Icon)Simple task manager for tracking your design workflowCreate to-do lists for projectsCheck off completed tasksKeep your work organized without leaving Illustrator
      7. Videos (Video Icon)Access tutorial videos and learning resourcesAdd links to your favorite ScriptBox tutorialsBuild a custom library of video referencesQuick access to visual learning materials
      8. Reference (Image Icon)Visual moodboard for design inspirationAdd reference images directly to the panelKeep inspiration close while you workOrganize visual references for current projects
      9. Info (Info Icon)View current version informationCheck for updatesAccess support resources and documentationSee special thanks and supporter credits

      Switching Between Tabs:

      • Simply click any tab icon at the top of the panel to switch views
      • The active tab is highlighted to show your current location
      • Each tab remembers your last settings (view mode, scroll position, etc.)

      View Modes

      ScriptBox offers three different view modes to match your workflow preferences and screen space. You can switch between these modes in most tabs (Toolbox, External Scripts, Panels Manager, and Favorites).

      View Mode Options:

      1. List View (Default)Displays items in a vertical list with full namesShows script/panel names clearly with iconsBest for: Detailed browsing and reading full namesIdeal when: You have plenty of vertical spaceProvides: Maximum readability and clarity
      2. Compact ViewCondensed list format with smaller spacingFits more items on screen at onceBest for: Quick scanning of many itemsIdeal when: You want to see more options without scrollingProvides: Efficient use of vertical space
      3. Grid ViewDisplays items as a grid of icons with labelsVisual, icon-focused layoutBest for: Visual recognition and browsingIdeal when: You have horizontal space and prefer iconsProvides: Quick visual identification of scripts/panels

      Switching View Modes:

      • Look for the view mode icons in the top-right corner of applicable tabs
      • Click the icon representing your preferred view (list, compact, or grid)
      • Your preference is saved per tab
      • Different tabs can use different view modes simultaneously

      View Mode Availability:

      • Available in: Toolbox, External Scripts, Panels Manager, Favorites
      • Not available in: Code Editor, Tasks, Videos, Reference, Info (these tabs have fixed layouts optimized for their specific functions)

      Search Functionality

      ScriptBox includes powerful search capabilities to help you quickly find exactly what you need without browsing through categories or lists.

      Where Search is Available:

      Search functionality is integrated into several tabs:

      • Toolbox Tab: Search through all 200+ built-in scripts
      • External Scripts Tab: Search your custom script collections
      • Panels Manager Tab: Find specific Illustrator panels quickly
      • Favorites Tab: Filter your favorite items

      How to Use Search:

      1. Locate the Search BarThe search field appears at the top of applicable tabsLook for the text input field with a search icon or placeholder text
      2. Enter Your Search TermStart typing any part of the script, panel, or item nameSearch is typically case-insensitiveResults filter in real-time as you type
      3. View Filtered ResultsOnly items matching your search term will displayFolders/categories containing matches remain visibleNon-matching items are hidden from view
      4. Clear Your SearchDelete your search text to see all items againOr click the clear button (X) if availableThe full list returns immediately

      Search Tips:

      • Be Specific: Type "align" to find alignment-related scripts
      • Use Partial Words: Typing "rand" will find all randomizer scripts
      • Search by Category: Type "color" to see all color-related tools
      • Quick Access: Search is faster than expanding multiple folders
      • Case Doesn't Matter: "GRID" and "grid" produce the same results

      Search Behavior by Tab:

      • Toolbox: Searches script names and can find items within collapsed folders
      • External Scripts: Searches through your custom script names
      • Panels Manager: Searches all Illustrator panel names
      • Favorites: Filters both scripts and panels in your favorites list

      Window Resizing and Responsive Behavior

      ScriptBox is designed to be flexible and adapt to your workspace needs. The panel can be resized and will adjust its layout accordingly.

      Resizing the Panel:

      1. Docked Panel ResizingWhen docked, drag the panel edges to resizeDrag horizontally to adjust widthDrag vertically to adjust heightThe panel will snap to other panels and workspace edges
      2. Floating Panel ResizingWhen floating, drag any corner or edge to resizeMaintain aspect ratio by dragging corners (if desired)Resize freely to fit your screen layout
      3. Minimum SizeScriptBox has a minimum width and height to ensure usabilityContent remains accessible even at smaller sizesSome elements may stack or adjust at smaller widths

      Responsive Layout Behavior:

      ScriptBox intelligently adapts to different panel sizes:

      • Wide Panels: Grid view can display more columns
      • Narrow Panels: Grid view adjusts to fewer columns or switches to single column
      • Tall Panels: More items visible without scrolling
      • Small Panels: Content remains accessible with scrolling
      • Tab Icons: Always visible regardless of panel size
      • Search Bar: Adjusts width to fit available space

      Best Practices for Panel Size:

      • For Grid View: Use a wider panel to see more items side-by-side
      • For List View: A narrower panel works well since items stack vertically
      • For Code Editor: Maximize width for comfortable code editing
      • For Reference Images: Larger panel size shows images in better detail
      • General Use: Find a size that balances ScriptBox with your other panels

      Docking Recommendations:

      • Dock ScriptBox alongside your Layers or Swatches panel for easy access
      • Keep it floating if you frequently move it between monitors
      • Dock vertically on the side of your screen for list-based tabs
      • Consider a horizontal dock at the bottom for grid view layouts

      The interface is designed to work efficiently at various sizes, so adjust it to fit your personal workflow and screen real estate.

    • The Toolbox tab is the heart of ScriptBox, providing instant access to over 200 automation scripts designed to streamline your Adobe Illustrator workflow. These scripts handle everything from simple object arrangement to complex path manipulation, saving you countless hours of manual work.

      Browsing Scripts

      ScriptBox organizes its extensive script library into a clean, hierarchical folder structure that makes finding the right tool intuitive and fast.

      Understanding the Folder Structure:

      When you open the Toolbox tab, you'll see 11 main category folders, each containing related scripts:

      • Arrange - Object positioning and distribution tools
      • Artboard - Artboard management and manipulation
      • Color - Color manipulation and management utilities
      • Games - Entertainment features for creative breaks
      • Generator - Pattern and shape creation tools
      • Optimize - Document cleanup and optimization
      • Path - Path editing and manipulation tools
      • Randomize - Tools for adding controlled randomness
      • Rename - Batch renaming utilities
      • Select - Advanced selection tools
      • Text - Text manipulation and formatting
      • Transform - Object transformation utilities
      • Utility - Miscellaneous productivity tools

      Expanding and Collapsing Folders:

      1. Expand a Category
        Click on any folder name or the arrow icon next to it
        The folder expands to reveal all scripts within that category
        Scripts appear as individual items with icons and names
      2. Collapse a Category
        Click the folder name or arrow icon again
        The folder collapses, hiding its contents
        This keeps your interface clean and focused
      3. Multiple Folders
        You can have multiple folders expanded simultaneously
        Expand only the categories you're currently working with
        Collapse folders you're not using to reduce scrolling

      Navigation Tips:

      • Use Search: If you know what you're looking for, use the search bar instead of browsing
      • Explore by Task: Think about what you want to accomplish, then open the relevant category
      • Learn Gradually: Start with one or two categories and expand your knowledge over time
      • Favorites: Once you find scripts you use often, add them to Favorites for instant access

      Folder Organization Logic:

      Scripts are grouped by their primary function:

      • Action-based: Arrange, Transform, Randomize (what the script does)
      • Target-based: Artboard, Path, Text, Color (what the script affects)
      • Purpose-based: Optimize, Select, Rename, Generator (the script's goal)
      • Utility: General productivity tools that don't fit other categories

      This logical organization helps you develop an intuitive sense of where to find specific tools as you become more familiar with ScriptBox.

      Running Scripts

      Running scripts in ScriptBox is designed to be as simple as possible—just one click and the script executes.

      The Click-to-Run Mechanism:

      1. Locate Your Script
        Browse to the category folder containing the script you need
        Or use the search function to find it quickly
      2. Click the Script
        Simply click once on the script name or icon
        The script executes immediately in Adobe Illustrator
        No need to double-click or use additional menus
      3. Script Execution
        Most scripts will open a dialog box with options and settings
        Some scripts execute immediately if they don't require user input
        Follow the on-screen prompts to configure the script's behavior
      4. Complete the Action
        Adjust settings in the script's dialog (if applicable)
        Click OK or Run to apply the script
        Or click Cancel to exit without making changes

      What Happens When You Run a Script:

      • Interactive Scripts: Open a dialog with options, sliders, checkboxes, and preview features
      • Instant Scripts: Execute immediately and apply their effect to your selection or document
      • Selection-Based Scripts: Work on currently selected objects (select objects first)
      • Document-Wide Scripts: Affect the entire document or all artboards
      • Generator Scripts: Create new objects or patterns in your document

      Before Running Scripts:

      • Save Your Work: Always save before running unfamiliar scripts
      • Read Descriptions: Hover over scripts to see what they do (see Script Descriptions below)
      • Check Selection: Many scripts require objects to be selected first
      • Understand Scope: Know whether the script affects selection, layer, artboard, or document

      After Running Scripts:

      • Undo if Needed: Use Cmd/Ctrl+Z to undo if results aren't what you expected
      • Adjust Settings: Run the script again with different settings to refine results
      • Save Favorites: If you use a script frequently, add it to your Favorites

      Script Execution Tips:

      • Test on Copies: For destructive operations, test on duplicated objects first
      • Batch Processing: Many scripts can process multiple objects simultaneously
      • Combine Scripts: Use multiple scripts in sequence for complex workflows
      • Learn Shortcuts: Some scripts have keyboard shortcuts you can assign in Illustrator

      Script Descriptions

      Every script in ScriptBox includes a helpful description that explains what it does, helping you choose the right tool for your task.

      Viewing Script Descriptions:

      1. Hover Over Any Script
        Move your mouse cursor over any script name in the Toolbox
        Wait a moment (approximately 1 second)
        A tooltip appears with the script's description
      2. Read the Description
        The tooltip provides a concise explanation of the script's function
        Descriptions include what the script does and often mention key features
        Some descriptions note whether selection is required
      3. Tooltip Behavior
        Tooltips appear automatically on hover
        They disappear when you move your mouse away
        No clicking required—just hover and read

      What Descriptions Tell You:

      • Primary Function: What the script does in simple terms
      • Key Features: Special capabilities or options the script offers
      • Input Requirements: Whether you need to select objects first
      • Output: What the script creates or modifies

      Using Descriptions Effectively:

      • Compare Similar Scripts: Hover over multiple scripts in a category to find the best fit
      • Learn New Tools: Read descriptions to discover scripts you didn't know existed
      • Verify Before Running: Confirm a script does what you expect before clicking
      • Explore Categories: Browse descriptions to understand what each category offers

      Example Descriptions:

      • "Create multiple copies of selected objects with precise spacing and alignment options"
      • "Automatically resize artboards to fit their contained artwork perfectly"
      • "Apply random colors to selected objects from current swatches"
      • "Generate QR codes with custom text, URLs, and styling options"

      Accessing Individual Script User Guides

      Many scripts include detailed user guides that provide in-depth instructions, examples, and tips for getting the most out of each tool.

      How to Access User Guides:

      1. Look for User Guide Files
        In your ScriptBox installation folder, navigate to the scripts directory
        Each category folder contains both script files (.jsx) and user guide files (.url)
        User guide files are named: "Script Name • User Guide.url"
      2. Open a User Guide
        Double-click the .url file to open the guide in your web browser
        Or right-click and select "Open" or "Open with Browser"
        The guide opens on the ScriptBox website with detailed documentation
      3. What User Guides Include
        Step-by-step instructions with screenshots
        Detailed explanations of all options and settings
        Usage examples and common workflows
        Tips and best practices
        Troubleshooting information

      When to Use User Guides:

      • Learning New Scripts: Read the guide before using complex scripts for the first time
      • Advanced Features: Discover hidden features and advanced options
      • Troubleshooting: Find solutions if a script isn't working as expected
      • Optimization: Learn tips for getting better results
      • Workflow Ideas: See examples of how to combine scripts effectively

      User Guide Availability:

      • Most scripts include user guides, especially complex or feature-rich tools
      • Simpler scripts may not have dedicated guides if their function is self-explanatory
      • User guides are continuously updated with new tips and examples

      Script Categories

      ScriptBox includes 11 main categories plus a bonus Games category, totaling over 200 scripts. Below is a detailed overview of each category with examples of what you can accomplish.

      Arrange

      The Arrange category focuses on positioning, distributing, and organizing objects in your workspace.

      What You Can Do:

      • Create precise grids and patterns with multiple copies
      • Arrange objects in circular or radial formations
      • Swap positions between objects
      • Distribute objects with proportional spacing
      • Replace objects while maintaining positions

      Featured Scripts:

      • Cloner: Create multiple copies of selected objects with precise spacing and alignment options. Perfect for creating grids, patterns, or repeated elements with exact control.
      • Grid Arranger: Arrange selected objects in a perfect grid with customizable rows and columns. Ideal for organizing icons, creating tile patterns, or laying out design elements systematically.
      • Radial Arranger: Arrange objects in a circular or radial pattern around a center point. Great for creating circular menus, clock faces, or decorative radial designs.
      • Seamless Pattern Maker: Create seamless repeating patterns from selected objects with customizable spacing and alignment. Essential for textile design, backgrounds, and repeating motifs.
      • Smart Object Replacer: Replace the selected objects with content from the clipboard, document symbols, or other selected objects, with options to match colors, opacity, and size.
      • Swap Two Objects: Instantly swap the positions of two selected objects. Simple but incredibly useful for quick layout adjustments.

      Common Use Cases:

      • Creating product grids for catalogs
      • Building icon sets with consistent spacing
      • Designing circular badges or seals
      • Organizing UI elements systematically
      • Creating repeating background patterns

      Artboard

      Artboard scripts help you manage, organize, and manipulate artboards efficiently, especially useful for multi-page documents.

      What You Can Do:

      • Automatically resize artboards to fit content
      • Create artboards from selected objects
      • Navigate between artboards quickly
      • Duplicate artboards with their contents
      • Organize and reindex artboards by position

      Featured Scripts:

      • Fit Artboards to Artwork Bounds: Automatically resize artboards to fit their contained artwork perfectly. Eliminates excess whitespace and ensures tight bounds around your designs.
      • Create Artboards from Selection: Generate artboards automatically based on selected objects. Each selected object gets its own artboard sized to fit.
      • Multi-Artboard Duplicator: Duplicate artboards along with their contents in bulk. Perfect for creating variations or multiple pages with similar layouts.
      • Re-index Artboards by Position: Automatically reorder the artboard indices based on their spatial positioning. Keeps your artboard numbering logical and organized.
      • Smart Artboard Aligner: Align selected objects to artboards with customizable positioning and optional resizing options. Ensures consistent placement across multiple artboards.
      • Artboard Content Cropper: Crop or mask artboard content to fit within artboard boundaries, with options to process all artboards, selected ones, or just selected objects.

      Common Use Cases:

      • Preparing multi-page documents for export
      • Creating social media template sets
      • Organizing presentation slides
      • Building design system documentation
      • Managing icon sets across multiple artboards

      Color

      Color scripts provide powerful tools for manipulating, analyzing, and managing colors throughout your designs.

      What You Can Do:

      • Randomize colors with various methods
      • Convert between color spaces (RGB, CMYK, HSL)
      • Create gradients from selections
      • Adjust opacity and color channels
      • Check color contrast for accessibility
      • Manage swatches and color libraries

      Featured Scripts:

      • Color Randomizer: Apply random colors to selected objects from current swatches. Great for exploring color combinations quickly.
      • Hue Saturation Lightness: Adjust HSL values of selected objects with precise control. More intuitive than RGB adjustments for many color modifications.
      • Contrast Checker: Analyze color contrast ratios between background and foreground elements according to WCAG accessibility standards. Essential for accessible design.
      • Selection to Gradient Swatch: Extract colors from selected objects and create a customizable gradient swatch from them. Perfect for creating harmonious gradients from existing designs.
      • Average Colors: Calculate and apply the average color values across selected objects, with options to average fills, strokes, gradients, and opacity.
      • Smart Swatch Randomizer: Randomly apply colors from your document's swatch library to the fills and strokes of selected objects.
      • Gradient to Solid Color: Convert gradient fills to solid colors using the dominant or average color from the gradient.
      • Swap Fill and Stroke Colors: Instantly swap fill and stroke colors of selected objects.

      Common Use Cases:

      • Exploring color variations quickly
      • Ensuring accessibility compliance
      • Creating cohesive color palettes
      • Converting between color modes for print/web
      • Managing document color libraries
      • Creating custom gradients from artwork

      Games

      A fun bonus category! Take creative breaks with classic games built right into Illustrator.

      What You Can Do:

      • Play classic board and puzzle games
      • Take mental breaks without leaving your workspace
      • Challenge yourself during rendering or processing time

      Available Games:

      • Checker: Play a classic checkers game directly within Adobe Illustrator
      • Connect Four: Enjoy the Connect Four game with a visual interface in Illustrator
      • Minesweeper: Classic minesweeper puzzle game integrated into your design workspace
      • Tic Tac Toe: Simple tic-tac-toe game for quick breaks during design work

      Why Games?

      • Mental breaks improve creativity and productivity
      • Stay in your workspace during processing time
      • Fun way to test ScriptBox's capabilities
      • Demonstrates the power of JSX scripting

      Generator

      Generator scripts create new shapes, patterns, and design elements from scratch with customizable parameters.

      What You Can Do:

      • Generate geometric patterns and shapes
      • Create barcodes and QR codes
      • Build fractal trees and spirals
      • Generate stars, squircles, and custom polygons
      • Create mathematical patterns and waves

      Featured Scripts:

      • QR Code Generator: Generate QR codes with custom text, URLs, and styling options. Perfect for adding scannable codes to designs, posters, or packaging.
      • Barcode Generator: Generate UPC-12 and EAN-13 barcodes with automatic check digit calculation, customizable fonts and tracking adjustment.
      • Star Shape Generator: Create customizable star and polygon shapes with adjustable parameters like number of sides, size, inner radius, rotation, colors, stroke width, and corner rounding.
      • Fractal Tree Generator: Generate customizable fractal trees with adjustable parameters like branching levels, divisions, angles, scaling, position, and stroke.
      • Sine Wave Generator: Generate customizable sine wave patterns with adjustable size, repetitions, stroke properties, and color.
      • Squircle Generator: Create squircle shapes (square-circle hybrids) with adjustable corner radius. Popular in modern UI design.
      • Bento Grid Generator: Create modern bento-style grid layouts with customizable cells. Perfect for contemporary web and app design layouts.

      Common Use Cases:

      • Adding functional codes to packaging design
      • Creating decorative patterns and backgrounds
      • Building geometric illustrations
      • Generating organic shapes for nature-themed designs
      • Creating modern UI elements
      • Producing mathematical visualizations

      Optimize

      Optimize scripts help clean up documents, manage complexity, and improve file performance.

      What You Can Do:

      • Remove unused swatches, symbols, and styles
      • Break symbol links and release clipping masks
      • Close open paths automatically
      • Group objects by attributes or artboards
      • Unlock and unhide hidden elements
      • Convert global and spot colors

      Featured Scripts:

      • Document Cleaner: Remove unused swatches, styles, symbols and other document clutter automatically. Essential for keeping files lean and organized.
      • Clipping Mask Manager: Release, modify, or merge clipping masks with advanced options for fill/stroke styling and preview highlighting.
      • Group by Attributes: Automatically group selected objects based on shared visual attributes like fill color, stroke color, stroke weight, opacity, and blending modes.
      • Visibility Manager: Find and unhide hidden layers and objects through an interactive panel with search functionality.
      • Unlock Assistant: Identify and selectively unlock locked layers and objects through an interactive interface.
      • Break Symbol Links: Break symbol links by converting symbol instances into regular editable artwork.
      • Detach Global Colors: Convert Spot colors and Global colors to regular RGB colors.

      Common Use Cases:

      • Preparing files for client handoff
      • Reducing file size before export
      • Cleaning up inherited or legacy files
      • Organizing complex documents
      • Troubleshooting file issues
      • Preparing files for print production

      Path

      The largest category! Path scripts provide extensive tools for editing, manipulating, and enhancing vector paths.

      What You Can Do:

      • Modify bezier handles and anchor points
      • Create connections between objects
      • Apply corner effects and rounding
      • Convert dashes to paths
      • Trim, split, and extend paths
      • Create arrowheads and decorative elements
      • Generate triangulated meshes

      Featured Scripts:

      • Smart Corner Rounder: Intelligently round corners of paths with customizable radius settings. Works on any path type with precise control.
      • Path Arrowhead Maker: Add customizable arrowheads to selected paths, choosing shape, size, arrow style, or a document symbol.
      • Metaball Shape Connector: Create smooth, organic "metaball" connectors between two or more selected circles. Perfect for creating blob-like organic shapes.
      • Triangulator: Convert selected Illustrator shapes into a low-poly triangulated mesh with adjustable point distribution, colors, and strokes.
      • Smart Connector: Connect selected objects by drawing lines between centers or anchor points with adjustable amount, stroke, opacity, and randomness.
      • Dash to Paths: Convert dashed strokes into individual path objects for advanced editing.
      • Path Effects: Preview and apply a variety of adjustable path distortion effects to your selected paths.
      • Bezier Handle Converter: Convert bezier handles on selected anchor points by either removing existing handles to create sharp corners or adding smooth handles to create curved transitions.

      Common Use Cases:

      • Creating technical diagrams with connectors
      • Designing infographics with arrows and flow lines
      • Building low-poly illustrations
      • Creating organic, flowing shapes
      • Refining path details and curves
      • Converting strokes for special effects
      • Adding decorative path elements

      Randomize

      Randomize scripts add controlled chaos to your designs, perfect for creating organic, natural-looking variations.

      What You Can Do:

      • Randomize colors, opacity, and blending modes
      • Add random rotation and scaling
      • Scatter objects randomly
      • Randomize stroke properties and dash patterns
      • Add jitter to anchor points
      • Randomize text properties

      Featured Scripts:

      • Random Scatter: Randomly scatter selected objects by moving them to random positions within customizable horizontal and vertical ranges.
      • Random Point Jitter: Add random displacement to anchor points for organic effects. Great for creating hand-drawn or natural looks.
      • Random Recolor: Randomly recolor selected objects with customizable color schemes, adjustable value ranges, and options to recolor text by frames, words, or characters individually.
      • Random Scale: Randomly scale selected objects with customizable size ranges, adjustable reference points, and options to scale group items or compound path elements individually.
      • Text Color Randomiser: Apply random colors to selected text frames using RGB, CMYK, or HSL color modes, with options to randomize by text frames, sentences, lines, words, or individual characters.
      • Gradient Rotation Randomizer: Randomly rotate linear gradients within selected objects using customizable angle ranges.

      Common Use Cases:

      • Creating natural-looking arrangements
      • Adding organic variation to patterns
      • Designing hand-drawn style illustrations
      • Creating dynamic text effects
      • Breaking up rigid, mechanical layouts
      • Generating unique variations quickly
      • Adding visual interest to repetitive elements

      Rename

      Rename scripts help you organize and manage your document by batch renaming layers, artboards, symbols, and other elements.

      What You Can Do:

      • Batch rename layers with patterns and numbering
      • Rename artboards systematically
      • Update symbol names in bulk
      • Rename swatches and graphic styles
      • Convert layer name case formats
      • Apply prefixes, suffixes, and sequential numbering

      Featured Scripts:

      • Layers Batch Renamer: Rename multiple layers using sequential numbering and custom patterns. Essential for organizing complex documents.
      • Artboards Batch Renamer: Rename multiple artboards using patterns, numbering, and prefixes. Perfect for multi-page documents.
      • Symbols Batch Renamer: Rename multiple document symbols simultaneously. Keeps symbol libraries organized.
      • Layer Name Case Converter: Convert layer names between different case formats (uppercase, lowercase, title case).
      • Items Batch Renamer: Batch rename selected objects with various naming conventions.

      Common Use Cases:

      • Organizing complex layer structures
      • Preparing files for development handoff
      • Standardizing naming conventions across projects
      • Managing large symbol libraries
      • Creating systematic artboard naming for exports
      • Cleaning up inherited files with poor naming

      Select

      The second-largest category! Select scripts provide powerful selection tools that go far beyond Illustrator's native capabilities.

      What You Can Do:

      • Select by color, size, opacity, rotation, and more
      • Filter by stroke properties and dash patterns
      • Select by font, text size, or text content
      • Choose objects by layer order or artboard
      • Select random objects or specific percentages
      • Find similar objects automatically
      • Select by blending mode or attributes

      Featured Scripts:

      • Smart Selector: Quickly select Illustrator objects by type, appearance, attributes, and other properties. A powerful all-in-one selection tool.
      • Select by Attribute: Select objects based on specific attributes like fill color, stroke weight. Highly customizable filtering.
      • Select Similar Objects: Select all objects similar to the selected one by matching fill/stroke, size, opacity, blending mode, dash pattern, or geometry.
      • Select by Font: Select text objects using specific fonts or font families. Essential for font management and updates.
      • Select Off-Artboard Objects: Find and select objects positioned outside artboard boundaries. Great for cleaning up documents.
      • Random Objects Selector: Randomly select a specified number or percentage of objects. Useful for creating varied effects.
      • Select by Size Match: Select all objects that match the selected object's size (width, height, or area) within a chosen tolerance.
      • Selection Inspector: Analyze and display detailed information about current selection.

      Common Use Cases:

      • Finding all objects with specific properties
      • Selecting elements for batch modifications
      • Cleaning up documents by finding stray objects
      • Managing typography across documents
      • Creating selection sets for complex operations
      • Analyzing document composition
      • Preparing objects for specific treatments

      Text

      Text scripts provide extensive tools for manipulating, formatting, and managing text in your designs.

      What You Can Do:

      • Randomize text properties (size, color, spacing, rotation)
      • Generate placeholder text and page numbers
      • Split and merge text frames
      • Create bulleted lists
      • Add sequential numbering
      • Swap text content between frames
      • Fine-tune typography with advanced controls

      Featured Scripts:

      • Sequential Text Numbering: Automatically add sequential numbers, letters (A-Z), or Roman numerals to selected text frames. Perfect for numbered lists or page elements.
      • Text Splitter: Split selected text frames into separate lines, words, or characters. Essential for creating animated text or individual text elements.
      • Placeholder Text Generator: Generate customizable placeholder text wireframes—set lines, words, height, spacing, corner radius, alignment, and color.
      • Multi-Text Editor: Edit multiple text objects simultaneously with batch operations. Saves time when updating repeated text.
      • Type Randomizer: Randomize font size, leading, tracking, scale, baseline shift, and rotation on selected text with adjustable ranges per character, word, line, or entire text frame.
      • Text Frame Merger: Merge multiple selected text frames into a single text frame.
      • Page Number Generator: Automatically generate page numbers across multiple artboards in your document.

      Common Use Cases:

      • Creating dynamic text effects
      • Building wireframes and mockups
      • Managing multi-page documents
      • Creating kinetic typography
      • Batch updating text properties
      • Generating numbered lists and sequences
      • Fine-tuning typography across selections

      Transform

      Transform scripts provide advanced transformation capabilities beyond Illustrator's standard transform tools.

      What You Can Do:

      • Scale objects to exact dimensions
      • Adjust aspect ratios precisely
      • Create isometric projections
      • Apply progressive transformations
      • Create glitch and slice effects
      • Modify stroke weights proportionally
      • Apply zig-zag effects to paths

      Featured Scripts:

      • Smart Scale: Resize selected objects to exact dimensions, add/subtract values, or scale by percentage. More flexible than native scaling.
      • Progressive Transform: Progressively transform multiple selected objects relative to a chosen reference point—scaling, rotating, moving, and adjusting opacity/stroke with live preview and optional randomness.
      • Isometrify: Convert flat objects to isometric perspective with customizable angles. Perfect for creating isometric illustrations and diagrams.
      • Path Glitcher: Create a glitch effect by slicing the selected paths into adjustable horizontal/vertical fragments and randomly offsetting them.
      • Object Slicer: Split the selected object into customizable angled slices with randomizable widths and offsets.
      • Aspect Ratio Tweaker: Adjust the aspect ratio of selected objects while keeping either width or height fixed.
      • Adjust Stroke Weight by Percentage: Modify stroke weights by percentage values while maintaining proportions.

      Common Use Cases:

      • Creating precise technical drawings
      • Building isometric illustrations
      • Designing progressive patterns and sequences
      • Creating glitch art and digital effects
      • Adjusting designs to specific dimensions
      • Creating sliced and fragmented effects
      • Maintaining proportions during scaling

      Utility

      Utility scripts include miscellaneous productivity tools that don't fit neatly into other categories but are incredibly useful.

      What You Can Do:

      • Manage multiple open documents
      • Create custom grids and layouts
      • Copy objects as PNG images
      • Transfer symbols and layers between documents
      • Count and analyze objects
      • Add labels and annotations
      • Manage tasks and notes
      • Access scripts folder quickly

      Featured Scripts:

      • Grid Generator: Generate customizable artboard-aligned grids (standard, column, baseline, modular, isometric, hex, or dot) with controls for size, cell spacing, color, stroke, opacity, margins, and more.
      • Copy as PNG: Copy selected objects to the clipboard as a PNG with configurable scale, background (transparent/white/black), margin, and anti-aliasing.
      • Objects Counter: Count and analyze selected objects with detailed statistics and reporting. Great for inventory and documentation.
      • Cross-Document Layer Duplicator: Copy selected layers (and their contents) from one document to one or more open documents, preserving structure, order, and positions, with optional name prefix/suffix.
      • Symbol Transfer: Copy selected symbols from one open document to one or more other open documents with search and filtering capabilities.
      • Sequential Object Labeler: Quickly add sequential number labels to selected objects with customizable text styling, offsets, and optional frames.
      • Documents Saver: View, filter, and selectively close multiple open documents with options to save or discard changes.
      • Calculator: Built-in calculator for design measurements and calculations.

      Common Use Cases:

      • Creating layout grids for design systems
      • Sharing assets between documents
      • Exporting quick previews
      • Managing complex multi-document projects
      • Documenting designs with labels
      • Organizing workspace and files
      • Performing design calculations
      • Tracking project tasks

      Tips for Using Scripts Effectively

      Start Simple:

      • Begin with straightforward scripts like "Swap Two Objects" or "Calculator"
      • Gradually explore more complex tools as you become comfortable
      • Read descriptions before trying unfamiliar scripts

      Combine Scripts:

      • Many workflows benefit from using multiple scripts in sequence
      • Example: Use "Select by Color" then "Random Scatter" for varied layouts
      • Example: Use "Grid Arranger" then "Color Randomizer" for colorful patterns

      Use Favorites:

      • Add your most-used scripts to Favorites for instant access
      • Build custom collections for specific project types
      • Organize favorites by workflow rather than category

      Experiment Safely:

      • Always save before trying destructive operations
      • Test on duplicated objects first
      • Use Cmd/Ctrl+Z to undo unwanted results

      Learn Gradually:

      • Focus on one category at a time
      • Master a few scripts before moving to the next category
      • Revisit categories as your skills grow—you'll discover new uses

      With over 200 scripts at your fingertips, ScriptBox transforms Adobe Illustrator into an even more powerful design tool. Take time to explore, experiment, and discover which scripts best fit your unique workflow.

    • The Script Launcher tab allows you to extend ScriptBox beyond its built-in library by adding your own custom scripts or third-party script collections. This powerful feature lets you integrate personal automation tools, team-shared scripts, or community-developed utilities directly into your ScriptBox workflow.

      Why Use External Scripts?

      • Expand Your Toolkit: Add unlimited custom scripts without modifying ScriptBox's core library
      • Team Collaboration: Share script collections across your team by pointing to a shared folder
      • Personal Automation: Keep your custom workflow scripts separate from built-in tools
      • Third-Party Integration: Use scripts from the Illustrator community or marketplace
      • Organized Workflow: Maintain different script collections for different projects or clients

      The External Scripts tab works just like the Toolbox tab—browse folders, search for scripts, and run them with a single click. The key difference is that you control what scripts appear here by choosing which folder to load.

      Adding Custom Script Folders

      To use external scripts, you first need to tell ScriptBox where your custom scripts are located. ScriptBox can load any folder containing .jsx or .js script files.

      Method 1: Using the Folder Button

      1. Open the External Scripts TabClick the External Scripts tab icon (folder icon) at the top of the ScriptBox panelYou'll see a drop hint message if no folder is currently set
      2. Click the Folder ButtonLook for the folder icon button in the top-right corner of the search bar
        Click this button to open a folder selection dialog
      3. Select Your Scripts FolderNavigate to the folder containing your custom scriptsSelect the folder (not individual files)
        Click "Select Folder" or "Choose" to confirm
      4. Scripts Load AutomaticallyScriptBox immediately scans the selected folder
        All .jsx, .js, and .jsfl files are detected and listedSubfolders are displayed as collapsible categories
        Your scripts are now ready to use

      Method 2: Drag and Drop

      For even faster setup, you can drag a folder directly into the External Scripts tab:

      1. Open the External Scripts TabClick the External Scripts tab icon
      2. Locate Your Scripts FolderOpen your file system (Finder on Mac, File Explorer on Windows)
        Navigate to the folder containing your scripts
      3. Drag the FolderClick and hold on the folderDrag it over the ScriptBox panelDrop it anywhere in the External Scripts tab area
      4. Folder Loads InstantlyScriptBox automatically sets this as your external scripts folder
        All scripts are loaded and displayed immediately

      What Happens After Adding a Folder:

      • Folder Structure Preserved: Subfolders in your scripts folder appear as collapsible categories in ScriptBox
      • Automatic Organization: Scripts are automatically organized by their folder structure
      • Folder Name Displayed: The main folder name appears at the top of the scripts list
      • Persistent Setting: Your folder path is saved—you don't need to set it again each time you open Illustrator
      • Search Enabled: You can immediately search through your external scripts
      • Favorites Compatible: External scripts can be added to your Favorites tab

      Supported File Types:

      ScriptBox recognizes and loads the following script file types:

      • .jsx - ExtendScript files (most common for Illustrator scripts)
      • .js - JavaScript files

      Folder Organization Tips:

      • Use Subfolders: Organize scripts into subfolders by category (e.g., "Text Tools", "Color Scripts", "Path Utilities")
      • Clear Naming: Use descriptive folder and file names for easy identification
      • Remove Extensions: ScriptBox automatically removes file extensions from display names
      • Consistent Structure: Maintain a consistent folder structure across projects or team members

      This structure would appear in ScriptBox with "My Custom Scripts" as the main folder, containing three collapsible subfolders (Text Tools, Color Utilities, Path Tools), each with their respective scripts.

      Managing External Scripts

      Once you've added a custom scripts folder, ScriptBox provides several tools for managing and working with your external scripts.

      Browsing External Scripts

      The External Scripts tab functions similarly to the Toolbox tab:

      1. View Your Scripts
        The main folder name appears at the top
        Subfolders are displayed as collapsible categoriesIndividual scripts are listed within their folders
      2. Expand and Collapse Folders
        Click any folder name to expand and see its contentsClick again to collapse and hide the scriptsMultiple folders can be expanded simultaneously
      3. View Modes
        External Scripts supports List View and Compact View
        The view mode syncs with your Toolbox view preferenceSwitch between views using the Toolbox tab's view toggleGrid view is not available for External Scripts

      Running External Scripts

      Running external scripts works exactly like running built-in scripts:

      1. Click to Run
        Simply click any script name to execute it
        The script runs immediately in Adobe IllustratorFollow any on-screen prompts or dialogs
      2. Script Behavior
        Scripts may open dialog boxes with options
        Some scripts execute instantly without dialogsSelection-based scripts work on currently selected objectsResults depend on the individual script's functionality

      Searching External Scripts

      The search functionality helps you quickly find specific scripts in large collections:

      1. Use the Search Bar
        Type any part of a script name in the search field at the top
        Results filter in real-time as you typeSearch is case-insensitive
      2. Search Behavior
        Only matching scripts are displayed
        Folders containing matches remain visible
        Non-matching items are hiddenClear the search to see all scripts again
      3. Search Tips
        Search works across all subfolders
        Partial words work (e.g., "text" finds "Text Formatter")
        Faster than manually browsing through folders

      Adding External Scripts to Favorites

      External scripts can be added to your Favorites tab for even quicker access:

      1. Hover Over a Script
        Move your mouse over any external script
        A star icon (favorite icon) appears on the right
      2. Click the Star Icon
        Click the star to add the script to Favorites
        The script is now accessible from the Favorites tab
        External scripts in Favorites show a placeholder icon
      3. Access from Favorites
        Switch to the Favorites tab to see all your favorite scripts
        External scripts appear alongside built-in scripts and panels
        Click to run directly from Favorites

      Refreshing the Scripts Folder

      If you add, remove, or modify scripts in your external folder while ScriptBox is open, use the Refresh button to update the list:

      1. Locate the Refresh Button
        Look at the bottom of the External Scripts tab
        The Refresh button shows a circular arrow icon
      2. Click Refresh
        Click the Refresh button
        ScriptBox rescans your external scripts folder
        The scripts list updates to reflect any changes
      3. When to Refresh
        After adding new scripts to your folder
        After removing scripts from your folder
        After renaming scripts or folders
        After reorganizing your folder structure, scripts don't appear as expected

      Removing Individual Scripts from the List

      You can temporarily hide specific scripts from the External Scripts list without deleting them from your folder:

      1. Hover Over a Script
        Move your mouse over the script you want to hide
        A close icon (X) appears on the right side
      2. Click the Close IconClick the X icon
        The script is removed from the ScriptBox list
        The script file remains in your folder (not deleted)
      3. Restore Hidden ScriptsClick the Refresh button to restore all hidden scripts
        Or remove and re-add the entire folderHidden scripts reappear in the list

      Managing Multiple Script Sources

      While ScriptBox supports one external scripts folder at a time, you can manage multiple script collections:

      Switching Between Folders:

      1. Remove Current Folder
        Click the X icon next to the main folder name at the top
        Or click the "Remove" button at the bottom
      2. Add Different Folder
        Use the folder button or drag-and-drop methodSelect a different scripts folder
        The new folder's scripts replace the previous list

      Organizing Multiple Collections:

      • Master Folder Approach: Create a master folder with subfolders for different collections
        Point ScriptBox to "All My Scripts" to access everything at once
      • Project-Based Switching: Keep separate folders for different projects and switch between them as needed
      • Symbolic Links: Use symbolic links (shortcuts) to combine multiple script locations into one folder that ScriptBox can read

      Best Practices for Managing External Scripts:

      • Regular Backups: Keep backups of your custom scripts folder
      • Version Control: Consider using Git or similar tools for script version management
      • Documentation: Include README files in your script folders to document what each script does
      • Testing: Test new scripts on non-critical documents before using them in production
      • Organization: Maintain a clear folder structure for easy navigation
      • Naming Conventions: Use consistent, descriptive names for scripts and folders

      Removing Scripts

      ScriptBox provides two levels of script removal: removing individual scripts from the list or removing the entire external scripts folder.

      Removing Individual Scripts

      To temporarily hide specific scripts without deleting them from your computer:

      1. Locate the Script
        Browse or search for the script you want to remove
        The script must be visible in the list
      2. Hover Over the Script
        Move your mouse over the script name
        A close icon (X) appears on the right side of the script
      3. Click the Close Icon
        Click the X icon
        The script immediately disappears from the ScriptBox list
      4. What Happens:
        The script is hidden from ScriptBox's interface
        The actual script file remains in your folder (not deleted)
        The script is added to a "removed scripts" list
        The script won't appear even after refreshing
      5. Restore Individual Scripts:
        To restore a hidden script, you must remove and re-add the entire folder
        Or manually edit the removed scripts list (advanced users only)
        The Refresh button alone won't restore individually removed scripts

      When to Remove Individual Scripts:

      • Scripts you don't use but want to keep in your folder
      • Duplicate scripts with similar functionality
      • Scripts that aren't compatible with your Illustrator version
      • Experimental scripts you're not ready to delete permanently
      • Scripts that clutter your list but might be useful later

      Removing the External Scripts Folder

      To completely disconnect your external scripts folder from ScriptBox:

      Method 1: Using the Folder Name Close Icon

      1. Locate the Main Folder NameLook at the top of the External Scripts listYou'll see your main folder name with an X icon next to it
      2. Click the X Icon
        Click the X icon next to the folder name
        A confirmation may appear (depending on your version)
      3. Folder Removed
        All external scripts disappear from the list
        The drop hint message reappearsYour folder path is cleared from ScriptBox

      Method 2: Using the Remove Button

      1. Locate the Remove ButtonScroll to the bottom of the External Scripts tabLook for the "Remove" button with an X icon
      2. Click Remove
        Click the "Remove" button
        The external scripts folder is disconnected
      3. Folder Removed
        All scripts are cleared from the interface
        The tab returns to its initial state

      What Happens When You Remove the Folder:

      • Scripts Cleared: All external scripts disappear from the ScriptBox interface
      • Favorites Updated: External scripts are automatically removed from your Favorites tab
      • Files Untouched: Your actual script files and folders remain on your computer (nothing is deleted)
      • Settings Cleared: The folder path is removed from ScriptBox's settings
      • Removed Scripts List Cleared: The list of individually removed scripts is reset
      • Ready for New Folder: You can immediately add a different folder if desired

      After Removing the Folder:

      • The External Scripts tab shows the drop hint message again
      • The Refresh button becomes disabled (grayed out)
      • The Remove button becomes disabled
      • You can add a new folder using the folder button or drag-and-drop

      Re-adding the Same Folder:

      If you remove a folder and later re-add it:

      • All scripts reappear in the list
      • Previously hidden individual scripts reappear (the removed scripts list was cleared)
      • You'll need to hide unwanted scripts again if desired
      • Favorites must be re-added manually

      Important Notes:

      • No File Deletion: Removing scripts or folders in ScriptBox never deletes files from your computer
      • Safe Operation: You can safely remove and re-add folders without risk of data loss
      • Favorites Impact: Removing the external scripts folder removes those scripts from Favorites
      • No Undo: There's no undo button, but you can simply re-add the folder to restore the list

      Troubleshooting Script Removal:

      • Script Won't Remove: Ensure you're clicking the correct close icon (individual script, not folder)
      • Folder Won't Remove: Try using the Remove button at the bottom instead of the folder name icon
      • Scripts Reappear: If you only want to hide scripts temporarily, use individual script removal, not the Refresh button
      • Favorites Not Updating: Manually remove external scripts from Favorites if they don't clear automatically

    • The Panel Manager tab provides instant access to all Adobe Illustrator panels with a single click. Instead of navigating through the Window menu repeatedly, you can browse, search, and open any Illustrator panel directly from ScriptBox. This feature dramatically speeds up your workflow by eliminating the need to hunt through menus for the panels you need.

      Opening Panels

      The Panels Manager gives you quick access to every native Adobe Illustrator panel, from commonly used ones like Layers and Swatches to specialized panels like Flattener Preview and SVG Interactivity.

      Browsing Available Panels:

      When you open the Panels Manager tab, you'll see a comprehensive list of all available Illustrator panels:

      1. View All PanelsThe Panels Manager displays every native Illustrator panelPanels are listed alphabetically for easy browsingEach panel shows its name and an iconThe list includes both common and specialized panels
      2. Panel CategoriesThe Panels Manager includes all Illustrator panels across various categories:Essential Panels: Layers, Swatches, Color, Stroke, Gradient, TransparencyTypography Panels: Character, Paragraph, Glyphs, OpenType, TabsObject Panels: Align, Pathfinder, Transform, Appearance, Graphic StylesColor Management: Color Guide, Kuler (Adobe Color Themes), Recolor ArtworkSymbols & Libraries: Symbols, Brushes, Swatches, Graphic Styles, CC LibrariesDocument Panels: Artboards, Links, Document Info, AttributesAdvanced Panels: Flattener Preview, Separations Preview, SVG InteractivityWorkflow Panels: Actions, Navigator, Info, Asset Export
      3. View ModesLike other ScriptBox tabs, the Panels Manager supports multiple view modes:List View: Displays panels in a vertical list with full names and iconsCompact View: Shows more panels on screen with reduced spacingGrid View: Displays panels as a grid of icons with labelsSwitch between view modes using the view toggle icons in the top-right corner of the tab.

      The Click-to-Open Mechanism:

      Opening panels is incredibly simple—just one click and the panel appears in your Illustrator workspace:

      1. Locate the Panel You Need
        Browse through the alphabetical list
        Or use the search function (see Searching Panels below)
      2. Click the Panel Name
        Simply click once on any panel name or icon
        The panel opens immediately in Adobe Illustrator
        No need to navigate through Window menus
      3. Panel Behavior
        If the panel is already open, clicking it brings it to the front
        If the panel is closed, clicking it opens it in your workspace
        Panels open in their last-used position and size
        Panels can be docked or left floating as you prefer
      4. Multiple Panels
        Open as many panels as you need
        Click multiple panels in succession to open them all
        Arrange panels in your workspace as desired
        ScriptBox remains accessible while panels are open

      Common Panels and Their Uses:

      Here are some of the most frequently accessed panels available through the Panels Manager:

      • Layers: Manage layer hierarchy, visibility, and locking
      • Swatches: Access and manage color swatches and patterns
      • Color: Adjust fill and stroke colors with various color models
      • Pathfinder: Combine shapes using boolean operations
      • Align: Align and distribute objects precisely
      • Transform: View and modify object transformations numerically
      • Appearance: Manage multiple fills, strokes, and effects
      • Stroke: Customize stroke weight, caps, joins, and dashes
      • Gradient: Create and edit gradient fills
      • Transparency: Adjust opacity and blending modes
      • Character/Paragraph: Format text with precise typography controls
      • Artboards: Manage multiple artboards in your document
      • Symbols: Create and manage reusable symbol instances
      • Brushes: Access and customize brush libraries
      • Graphic Styles: Apply and manage saved appearance styles

      Benefits of Using Panels Manager:

      • Speed: Open panels with one click instead of navigating menus
      • Discovery: Browse all available panels to discover ones you didn't know existed
      • Efficiency: Combine with Favorites for instant access to your most-used panels
      • Workflow: Keep ScriptBox open and access panels without interrupting your flow
      • Consistency: Always know where to find any panel, regardless of Illustrator version

      Searching Panels

      When you know which panel you need, the search function helps you find it instantly without scrolling through the entire list.

      How to Search for Panels:

      1. Locate the Search Bar
        The search field appears at the top of the Panels Manager tab
        Look for the text input field with a search icon or placeholder text
      2. Enter Your Search Term
        Start typing any part of the panel nameFor example, type "lay" to find "Layers"
        Or type "path" to find "Pathfinder"
        Search is case-insensitive, so "LAYERS" and "layers" work the same
      3. View Filtered Results
        Results filter in real-time as you type
        Only panels matching your search term are displayed
        Non-matching panels are hidden from view
        The list updates instantly with each keystroke
      4. Clear Your Search
        Delete your search text to see all panels again
        Or click the clear button (X) if available
        The complete panel list returns immediately

      Search Tips and Tricks:

      • Partial Matching: Type just a few letters to find panels quickly"char" finds "Character""trans" finds both "Transform" and "Transparency""art" finds both "Artboards" and "Appearance"
      • Common Abbreviations: Try common abbreviations"cc" finds "CC Libraries""svg" finds "SVG Interactivity"
      • Multiple Results: If your search returns multiple panels, refine your search term"trans" shows both Transform and Transparency"transf" narrows it down to just Transform
      • Fast Access: For frequently used panels, searching is often faster than scrollingType "sw" and hit Enter to open Swatches instantlyType "lay" and click to open Layers immediately

      When to Use Search:

      • You Know the Panel Name: Searching is faster than browsing when you know what you want
      • Large Lists: When viewing all panels feels overwhelming, search narrows it down
      • Muscle Memory: Once you learn panel names, searching becomes second nature
      • Speed Workflows: Combine search with Favorites for lightning-fast panel access

      Search Behavior:

      • Real-Time Filtering: Results appear as you type, no need to press Enter
      • Substring Matching: Searches anywhere in the panel name, not just the beginning
      • Case Insensitive: Uppercase and lowercase letters are treated the same
      • Instant Reset: Clearing the search immediately restores the full list
      • No Results: If no panels match, the list appears empty—try a different search term

      Panel Favorites

      Just like scripts, you can add your most frequently used Illustrator panels to your Favorites tab for instant access. This eliminates the need to search or browse for panels you use constantly.

      Adding Panels to Favorites:

      1. Hover Over a Panel
        In the Panels Manager tab, move your mouse over any panel name
        A star icon (favorite icon) appears on the right side of the panel
      2. Click the Star Icon
        Click the star to add the panel to your Favorites
        The star fills in or changes color to indicate it's been favorited
        The panel is now accessible from the Favorites tab
      3. Confirmation
        The panel immediately appears in your Favorites tab
        You can continue adding more panels to Favorites
        There's no limit to how many panels you can favorite

      Accessing Favorite Panels:

      1. Switch to the Favorites Tab
        Click the Favorites tab icon (star icon) at the top of ScriptBox
        Your favorite panels appear alongside favorite scripts
        Panels and scripts are mixed together in the order you added them
      2. Open from Favorites
        Click any favorite panel to open it in IllustratorWorks, exactly like clicking from the Panels Manager
        Faster because you don't need to search or browse
      3. Organize Your Favorites
        Drag and drop to reorder favorite panels
        Place your most-used panels at the top
        Group related panels together for efficient workflows

      Removing Panels from Favorites:

      1. From the Favorites Tab:
        Hover over the favorite panel you want to remove
        Click the star icon or remove icon that appears
        The panel is removed from Favorites but remains in Panels Manager
      2. From the Panels Manager Tab:
        Hover over a favorited panel (indicated by a filled star)
        Click the star icon to unfavorite it
        The panel is removed from your Favorites tab

      Best Practices for Panel Favorites:

      • Start with Essentials: Add panels you use in every project firstLayers, Swatches, Pathfinder, Align are common choicesAdd typography panels if you work with text frequentlyInclude color panels if color work is central to your workflow
      • Keep It Focused: Don't favorite every panel—just the ones you truly use often
        Too many favorites defeats the purpose of quick accessAim for 5-10 favorite panels for optimal efficiency
        Less frequently used panels can stay in Panels Manager
      • Organize by Workflow: Arrange favorite panels in the order you typically use themPlace panels for your most common tasks at the top
        Group related panels together (e.g., all color panels, all text panels)
        Adjust the order as your workflow evolves
      • Combine with Script Favorites: Mix panels and scripts in Favorites for complete workflow optimizationExample: Favorite the Pathfinder panel alongside shape-related scripts
        Example: Favorite Character panel with text manipulation scriptsCreate a one-stop location for all your most-used tools
      • Review Regularly: Periodically review your favorites and adjust
        Remove panels you no longer use frequently
        Add new panels as your workflow changes
        Keep your Favorites tab lean and relevant

      Common Panel Favorites Combinations:

      Different workflows benefit from different favorite panels:

      For Illustration Work:

      • Layers
      • Swatches
      • Pathfinder
      • Stroke
      • Appearance

      For Typography Projects:

      • Character
      • Paragraph
      • Glyphs
      • OpenType
      • Swatches

      For UI/UX Design:

      • Layers
      • Align
      • Transform
      • Artboards
      • Asset Export

      For Logo Design:

      • Pathfinder
      • Align
      • Swatches
      • Appearance
      • Graphic Styles

      For Print Production:

      • Swatches
      • Separations Preview
      • Flattener Preview
      • Links
      • Document Info

      View Modes in Favorites:

      The Favorites tab supports the same view modes as other tabs:

      • List View: See full names of favorite panels and scripts
      • Compact View: Fit more favorites on screen at once
      • Grid View: Visual, icon-based layout for quick recognition

      Choose the view mode that works best for your favorite panels and scripts collection.

    • The Favorites system is one of ScriptBox's most powerful productivity features, allowing you to create a personalized collection of your most-used scripts and panels. Instead of searching through categories or navigating menus repeatedly, you can access your essential tools instantly from a single, customized tab.

      Why Use Favorites?

      • Save Time: Access frequently-used scripts and panels with one click
      • Reduce Searching: No more browsing through categories for common tools
      • Personalize Your Workflow: Build a collection that matches your specific needs
      • Combine Resources: Keep both scripts and panels together in one place
      • Stay Organized: Arrange items in the order that makes sense for your workflow
      • Boost Productivity: Eliminate repetitive navigation and focus on creating

      Whether you're a designer who uses the same 10 scripts daily or someone who frequently switches between specific panels, the Favorites system adapts to your unique workflow.

      Adding to Favorites

      Adding scripts and panels to your Favorites is quick and intuitive—just click the star icon next to any item you want to save.

      Adding Scripts to Favorites:

      1. Navigate to the Toolbox Tab
        Open the Toolbox tab to browse the built-in script library
        Or use the External Scripts tab for custom scripts
      2. Locate the Script You Want
        Browse through categories or use the search function
        Expand folders to see individual scripts
      3. Click the Star Icon
        Hover over the script you want to add
        Look for the star icon (☆) next to the script nameClick the star icon once
        The star fills in (★) to indicate the script is now favorited
      4. Confirmation
        The script is immediately added to your Favorites
        No additional confirmation needed
        The filled star remains visible whenever you see that script

      Adding Panels to Favorites:

      1. Navigate to the Panels Manager Tab
        Click the Panels Manager tab icon at the top of ScriptBox
        You'll see a list of all available Adobe Illustrator panels
      2. Find the Panel You Want
        Browse the list of panels
        Or use the search function to find specific panels quickly
      3. Click the Star Icon
        Hover over the panel nameClick the star icon (☆) next to the panel
        The star fills in (★) to show it's been favorited
      4. Instant Access
        The panel is now available in your Favorites tab
        You can still open it from the Panels Manager as well

      Tips for Adding Favorites:

      • Start Small: Begin with 5-10 items you use most frequently
      • Add as You Go: Favorite items when you notice you're using them repeatedly
      • Don't Overdo It: Too many favorites defeats the purpose—keep it focused
      • Mix Scripts and Panels: Combine both for a complete workflow toolkit
      • Review Regularly: Periodically assess whether favorited items are still useful

      What Can Be Favorited:

      • ✓ Built-in scripts from the Toolbox tab
      • ✓ External scripts from custom folders
      • ✓ Adobe Illustrator panels from the Panels Manager
      • ✗ Tasks, videos, or reference images (these have their own dedicated tabs)

      Accessing the Favorites Tab

      Once you've added items to your Favorites, accessing them is simple and fast.

      Opening the Favorites Tab:

      1. Locate the Favorites Icon
        Look at the tab icons at the top of the ScriptBox panel
        Find the star icon (★) among the 9 tabsIt's typically the 4th tab from the left
      2. Click the Favorites Tab
        Click once on the star icon
        The Favorites tab opens, displaying all your favorited items
      3. View Your Collection
        All favorited scripts and panels appear in one unified listItems are displayed with their icons and names
        Both scripts and panels are shown together

      Using Items from Favorites:

      • Run Scripts: Click any script in your Favorites to execute it immediately
      • Open Panels: Click any panel in your Favorites to open it in Illustrator
      • Quick Access: No need to remember which category a script is in
      • One-Click Workflow: Your most common actions are always one click away

      Favorites Tab Features:

      • Unified View: Scripts and panels together in one place
      • Visual Icons: Each item displays its distinctive icon for quick recognition
      • Search Function: Filter your favorites if your collection grows large
      • View Modes: Switch between list, compact, and grid views
      • Persistent: Your favorites are saved and persist between Illustrator sessions

      When to Use Favorites:

      • Daily Workflow: Start your day by opening your Favorites tab
      • Repetitive Tasks: When performing the same actions multiple times
      • Project-Specific Work: Favorite tools relevant to your current project
      • Learning Phase: Keep new scripts you're learning in Favorites for easy practice
      • Client Work: Favorite tools specific to recurring client needs

      Organizing Favorites

      The Favorites system includes powerful organization features, allowing you to arrange items in the exact order that matches your workflow.

      Reordering Favorites with Drag-and-Drop:

      1. Open the Favorites Tab
        Navigate to the Favorites tab to see your collection
      2. Click and Hold
        Click on any item you want to move
        Hold down the mouse button
      3. Drag to New Position
        While holding the mouse button, drag the item up or down
        You'll see a visual indicator showing where the item will be placed
        Other items shift to make room for the dragged item
      4. Release to Drop
        Release the mouse button when the item is in the desired position
        The item locks into its new location
        The new order is automatically saved
      5. Repeat as Needed
        Continue rearranging items until your Favorites are organized perfectly
        There's no limit to how many times you can reorder

      Organization Strategies:

      By Frequency:

      • Place most-used items at the top
      • Less frequent items toward the bottom
      • Ensures fastest access to common tools

      By Workflow Stage:

      • Group items by when you use them in your process
      • Example: Setup tools first, then editing tools, then export tools
      • Mirrors your natural workflow progression

      By Project Type:

      • Organize by the type of work you're doing
      • Example: Logo design tools together, illustration tools together
      • Switch focus by scrolling to the relevant section

      By Category:

      • Keep similar items grouped together
      • Example: All color scripts together, all text scripts together
      • Maintains logical organization even in Favorites

      Mixed Approach:

      • Combine strategies that work for you
      • Example: Most-used items at top, then organized by category
      • Personalize to match your unique workflow

      Visual Organization Tips:

      • Use View Modes: Switch to grid view for visual organization by icon
      • Recognize Patterns: Notice which items you always use together
      • Seasonal Adjustment: Reorder based on current project needs
      • Keep It Fresh: Don't be afraid to reorganize as your workflow evolves

      Managing Favorites

      Managing your Favorites collection is simple, allowing you to add, remove, and maintain an optimal set of tools.

      Removing Items from Favorites:

      There are two ways to unfavorite items:

      Method 1: From the Favorites Tab

      1. Open the Favorites tab
      2. Locate the item you want to remove
      3. Click the filled star icon (★) next to the item
      4. The star becomes unfilled (☆)
      5. The item is immediately removed from your Favorites
      6. The item still exists in its original location (Toolbox or Panels Manager)

      Method 2: From the Original Location

      1. Navigate to where the item originally appears (Toolbox or Panels Manager)
      2. Find the favorited item (it will have a filled star ★)
      3. Click the filled star icon
      4. The star becomes unfilled (☆)
      5. The item is removed from your Favorites tab

      Both methods work identically—use whichever is more convenient.

      Maintaining Your Favorites:

      Regular Review:

      • Periodically review your Favorites (monthly or quarterly)
      • Remove items you no longer use frequently
      • Add new items you've discovered
      • Keep your collection lean and relevant

      Quality Over Quantity:

      • Aim for 10-20 favorites rather than 50+
      • Too many favorites reduces their effectiveness
      • Focus on truly frequent items
      • Use search for occasionally-used scripts

      Adapt to Projects:

      • Adjust favorites based on current project types
      • Remove project-specific tools when projects end
      • Add new tools as you start new types of work
      • Keep core tools that apply to all projects

      Learn and Evolve:

      • As you master scripts, you may need them less in Favorites
      • Add newly discovered scripts you want to practice
      • Your Favorites should evolve with your skill level
      • Don't be attached to old favorites if they're no longer useful

      View Modes for Favorites:

      The Favorites tab supports all three view modes, allowing you to choose the display that works best for your collection:

      List View:

      • Default view with full item names
      • Best for: Reading full script/panel names clearly
      • Ideal when: You have a moderate number of favorites (10-30)
      • Shows: Icon, full name, and star icon for each item

      Compact View:

      • Condensed spacing fits more items on screen
      • Best for: Larger collections of favorites (20-40)
      • Ideal when: You want to see many items without scrolling
      • Shows: Same information as list view but with tighter spacing

      Grid View:

      • Visual grid layout with icons and labels
      • Best for: Visual recognition and icon-based navigation
      • Ideal when: You recognize items by their icons
      • Shows: Larger icons in a grid pattern with names below

      Switching View Modes in Favorites:

      1. Open the Favorites tab
      2. Look for view mode icons in the top-right corner
      3. Click your preferred view mode icon
      4. The display updates immediately
      5. Your preference is saved for future sessions

      Choosing the Right View Mode:

      • Use List View if: You prefer reading names and have moderate favorites
      • Use Compact View if: You have many favorites and want to minimize scrolling
      • Use Grid View if: You're a visual person who recognizes icons quickly
      • Experiment: Try different views to see which feels most natural
      • Switch Freely: Change views anytime based on your current needs

      Favorites Best Practices:

      ✓ Do:

      • Keep your collection focused and relevant
      • Reorder items to match your workflow
      • Remove items you haven't used in months
      • Add items as soon as you notice repeated use
      • Use view modes that match your working style

      ✗ Don't:

      • Favorite everything "just in case"
      • Let your Favorites become cluttered
      • Forget to remove outdated items
      • Ignore the organization features
      • Stick with one view mode if another works better

      Troubleshooting Favorites:

      Item Won't Add to Favorites:

      • Ensure you're clicking the star icon, not the item name
      • Check that the item type supports favorites (scripts and panels only)
      • Try refreshing ScriptBox by closing and reopening the panel

      Can't Reorder Items:

      • Ensure you're clicking and holding on the item itself
      • Try dragging more slowly and deliberately
      • Check that you're in the Favorites tab (not another tab)

      Favorites Not Saving:

      • Ensure ScriptBox has write permissions to its settings folder
      • Try closing and reopening Illustrator
      • Check that your ScriptBox installation is complete

      Star Icon Not Visible:

      • Hover over items to ensure the star icon appears
      • Check your view mode—some views show stars differently
      • Ensure you're using a recent version of ScriptBox

      The Favorites system is designed to grow and adapt with you, becoming more valuable the longer you use ScriptBox. Take a few minutes to set up your initial favorites, and you'll quickly wonder how you ever worked without this personalized toolkit.

    • The Script Launcher tab allows you to extend ScriptBox beyond its built-in library by adding your own custom scripts or third-party script collections. This powerful feature lets you integrate personal automation tools, team-shared scripts, or community-developed utilities directly into your ScriptBox workflow.

      Why Use External Scripts?

      • Expand Your Toolkit: Add unlimited custom scripts without modifying ScriptBox's core library
      • Team Collaboration: Share script collections across your team by pointing to a shared folder
      • Personal Automation: Keep your custom workflow scripts separate from built-in tools
      • Third-Party Integration: Use scripts from the Illustrator community or marketplace
      • Organized Workflow: Maintain different script collections for different projects or clients

      The External Scripts tab works just like the Toolbox tab—browse folders, search for scripts, and run them with a single click. The key difference is that you control what scripts appear here by choosing which folder to load.

      Adding Custom Script Folders

      To use external scripts, you first need to tell ScriptBox where your custom scripts are located. ScriptBox can load any folder containing .jsx or .js script files.

      Method 1: Using the Folder Button

      1. Open the External Scripts TabClick the External Scripts tab icon (folder icon) at the top of the ScriptBox panelYou'll see a drop hint message if no folder is currently set
      2. Click the Folder ButtonLook for the folder icon button in the top-right corner of the search bar
        Click this button to open a folder selection dialog
      3. Select Your Scripts FolderNavigate to the folder containing your custom scriptsSelect the folder (not individual files)
        Click "Select Folder" or "Choose" to confirm
      4. Scripts Load AutomaticallyScriptBox immediately scans the selected folder
        All .jsx, .js, and .jsfl files are detected and listedSubfolders are displayed as collapsible categories
        Your scripts are now ready to use

      Method 2: Drag and Drop

      For even faster setup, you can drag a folder directly into the External Scripts tab:

      1. Open the External Scripts TabClick the External Scripts tab icon
      2. Locate Your Scripts FolderOpen your file system (Finder on Mac, File Explorer on Windows)
        Navigate to the folder containing your scripts
      3. Drag the FolderClick and hold on the folderDrag it over the ScriptBox panelDrop it anywhere in the External Scripts tab area
      4. Folder Loads InstantlyScriptBox automatically sets this as your external scripts folder
        All scripts are loaded and displayed immediately

      What Happens After Adding a Folder:

      • Folder Structure Preserved: Subfolders in your scripts folder appear as collapsible categories in ScriptBox
      • Automatic Organization: Scripts are automatically organized by their folder structure
      • Folder Name Displayed: The main folder name appears at the top of the scripts list
      • Persistent Setting: Your folder path is saved—you don't need to set it again each time you open Illustrator
      • Search Enabled: You can immediately search through your external scripts
      • Favorites Compatible: External scripts can be added to your Favorites tab

      Supported File Types:

      ScriptBox recognizes and loads the following script file types:

      • .jsx - ExtendScript files (most common for Illustrator scripts)
      • .js - JavaScript files

      Folder Organization Tips:

      • Use Subfolders: Organize scripts into subfolders by category (e.g., "Text Tools", "Color Scripts", "Path Utilities")
      • Clear Naming: Use descriptive folder and file names for easy identification
      • Remove Extensions: ScriptBox automatically removes file extensions from display names
      • Consistent Structure: Maintain a consistent folder structure across projects or team members

      This structure would appear in ScriptBox with "My Custom Scripts" as the main folder, containing three collapsible subfolders (Text Tools, Color Utilities, Path Tools), each with their respective scripts.

      Managing External Scripts

      Once you've added a custom scripts folder, ScriptBox provides several tools for managing and working with your external scripts.

      Browsing External Scripts

      The External Scripts tab functions similarly to the Toolbox tab:

      1. View Your Scripts
        The main folder name appears at the top
        Subfolders are displayed as collapsible categoriesIndividual scripts are listed within their folders
      2. Expand and Collapse Folders
        Click any folder name to expand and see its contentsClick again to collapse and hide the scriptsMultiple folders can be expanded simultaneously
      3. View Modes
        External Scripts supports List View and Compact View
        The view mode syncs with your Toolbox view preferenceSwitch between views using the Toolbox tab's view toggleGrid view is not available for External Scripts

      Running External Scripts

      Running external scripts works exactly like running built-in scripts:

      1. Click to Run
        Simply click any script name to execute it
        The script runs immediately in Adobe IllustratorFollow any on-screen prompts or dialogs
      2. Script Behavior
        Scripts may open dialog boxes with options
        Some scripts execute instantly without dialogsSelection-based scripts work on currently selected objectsResults depend on the individual script's functionality

      Searching External Scripts

      The search functionality helps you quickly find specific scripts in large collections:

      1. Use the Search Bar
        Type any part of a script name in the search field at the top
        Results filter in real-time as you typeSearch is case-insensitive
      2. Search Behavior
        Only matching scripts are displayed
        Folders containing matches remain visible
        Non-matching items are hiddenClear the search to see all scripts again
      3. Search Tips
        Search works across all subfolders
        Partial words work (e.g., "text" finds "Text Formatter")
        Faster than manually browsing through folders

      Adding External Scripts to Favorites

      External scripts can be added to your Favorites tab for even quicker access:

      1. Hover Over a Script
        Move your mouse over any external script
        A star icon (favorite icon) appears on the right
      2. Click the Star Icon
        Click the star to add the script to Favorites
        The script is now accessible from the Favorites tab
        External scripts in Favorites show a placeholder icon
      3. Access from Favorites
        Switch to the Favorites tab to see all your favorite scripts
        External scripts appear alongside built-in scripts and panels
        Click to run directly from Favorites

      Refreshing the Scripts Folder

      If you add, remove, or modify scripts in your external folder while ScriptBox is open, use the Refresh button to update the list:

      1. Locate the Refresh Button
        Look at the bottom of the External Scripts tab
        The Refresh button shows a circular arrow icon
      2. Click Refresh
        Click the Refresh button
        ScriptBox rescans your external scripts folder
        The scripts list updates to reflect any changes
      3. When to Refresh
        After adding new scripts to your folder
        After removing scripts from your folder
        After renaming scripts or folders
        After reorganizing your folder structure, scripts don't appear as expected

      Removing Individual Scripts from the List

      You can temporarily hide specific scripts from the External Scripts list without deleting them from your folder:

      1. Hover Over a Script
        Move your mouse over the script you want to hide
        A close icon (X) appears on the right side
      2. Click the Close IconClick the X icon
        The script is removed from the ScriptBox list
        The script file remains in your folder (not deleted)
      3. Restore Hidden ScriptsClick the Refresh button to restore all hidden scripts
        Or remove and re-add the entire folderHidden scripts reappear in the list

      Managing Multiple Script Sources

      While ScriptBox supports one external scripts folder at a time, you can manage multiple script collections:

      Switching Between Folders:

      1. Remove Current Folder
        Click the X icon next to the main folder name at the top
        Or click the "Remove" button at the bottom
      2. Add Different Folder
        Use the folder button or drag-and-drop methodSelect a different scripts folder
        The new folder's scripts replace the previous list

      Organizing Multiple Collections:

      • Master Folder Approach: Create a master folder with subfolders for different collections
        Point ScriptBox to "All My Scripts" to access everything at once
      • Project-Based Switching: Keep separate folders for different projects and switch between them as needed
      • Symbolic Links: Use symbolic links (shortcuts) to combine multiple script locations into one folder that ScriptBox can read

      Best Practices for Managing External Scripts:

      • Regular Backups: Keep backups of your custom scripts folder
      • Version Control: Consider using Git or similar tools for script version management
      • Documentation: Include README files in your script folders to document what each script does
      • Testing: Test new scripts on non-critical documents before using them in production
      • Organization: Maintain a clear folder structure for easy navigation
      • Naming Conventions: Use consistent, descriptive names for scripts and folders

      Removing Scripts

      ScriptBox provides two levels of script removal: removing individual scripts from the list or removing the entire external scripts folder.

      Removing Individual Scripts

      To temporarily hide specific scripts without deleting them from your computer:

      1. Locate the Script
        Browse or search for the script you want to remove
        The script must be visible in the list
      2. Hover Over the Script
        Move your mouse over the script name
        A close icon (X) appears on the right side of the script
      3. Click the Close Icon
        Click the X icon
        The script immediately disappears from the ScriptBox list
      4. What Happens:
        The script is hidden from ScriptBox's interface
        The actual script file remains in your folder (not deleted)
        The script is added to a "removed scripts" list
        The script won't appear even after refreshing
      5. Restore Individual Scripts:
        To restore a hidden script, you must remove and re-add the entire folder
        Or manually edit the removed scripts list (advanced users only)
        The Refresh button alone won't restore individually removed scripts

      When to Remove Individual Scripts:

      • Scripts you don't use but want to keep in your folder
      • Duplicate scripts with similar functionality
      • Scripts that aren't compatible with your Illustrator version
      • Experimental scripts you're not ready to delete permanently
      • Scripts that clutter your list but might be useful later

      Removing the External Scripts Folder

      To completely disconnect your external scripts folder from ScriptBox:

      Method 1: Using the Folder Name Close Icon

      1. Locate the Main Folder NameLook at the top of the External Scripts listYou'll see your main folder name with an X icon next to it
      2. Click the X Icon
        Click the X icon next to the folder name
        A confirmation may appear (depending on your version)
      3. Folder Removed
        All external scripts disappear from the list
        The drop hint message reappearsYour folder path is cleared from ScriptBox

      Method 2: Using the Remove Button

      1. Locate the Remove ButtonScroll to the bottom of the External Scripts tabLook for the "Remove" button with an X icon
      2. Click Remove
        Click the "Remove" button
        The external scripts folder is disconnected
      3. Folder Removed
        All scripts are cleared from the interface
        The tab returns to its initial state

      What Happens When You Remove the Folder:

      • Scripts Cleared: All external scripts disappear from the ScriptBox interface
      • Favorites Updated: External scripts are automatically removed from your Favorites tab
      • Files Untouched: Your actual script files and folders remain on your computer (nothing is deleted)
      • Settings Cleared: The folder path is removed from ScriptBox's settings
      • Removed Scripts List Cleared: The list of individually removed scripts is reset
      • Ready for New Folder: You can immediately add a different folder if desired

      After Removing the Folder:

      • The External Scripts tab shows the drop hint message again
      • The Refresh button becomes disabled (grayed out)
      • The Remove button becomes disabled
      • You can add a new folder using the folder button or drag-and-drop

      Re-adding the Same Folder:

      If you remove a folder and later re-add it:

      • All scripts reappear in the list
      • Previously hidden individual scripts reappear (the removed scripts list was cleared)
      • You'll need to hide unwanted scripts again if desired
      • Favorites must be re-added manually

      Important Notes:

      • No File Deletion: Removing scripts or folders in ScriptBox never deletes files from your computer
      • Safe Operation: You can safely remove and re-add folders without risk of data loss
      • Favorites Impact: Removing the external scripts folder removes those scripts from Favorites
      • No Undo: There's no undo button, but you can simply re-add the folder to restore the list

      Troubleshooting Script Removal:

      • Script Won't Remove: Ensure you're clicking the correct close icon (individual script, not folder)
      • Folder Won't Remove: Try using the Remove button at the bottom instead of the folder name icon
      • Scripts Reappear: If you only want to hide scripts temporarily, use individual script removal, not the Refresh button
      • Favorites Not Updating: Manually remove external scripts from Favorites if they don't clear automatically

    • Beyond scripts and panels, ScriptBox includes several productivity features designed to enhance your workflow and keep you organized. These supplementary tools help you manage tasks, access learning resources, gather inspiration, and stay informed about updates.

      Tasks Manager

      The Tasks Manager is a simple, integrated to-do list that helps you track design tasks, project milestones, and workflow steps without leaving Adobe Illustrator.

      Why Use the Tasks Manager?

      • Stay Focused: Keep your task list visible while you work
      • No Context Switching: Manage tasks without opening external apps
      • Project Organization: Track multiple projects and their tasks
      • Quick Reference: See what's next without breaking your creative flow
      • Simple and Lightweight: No complex features—just straightforward task tracking

      Accessing the Tasks Manager:

      1. Click the Tasks tab icon (checklist icon) at the top of the ScriptBox panel
      2. The Tasks interface appears with your task list
      3. The tab displays all your current tasks and completed items

      Creating Tasks:

      To Add a New Task:

      1. Open the Tasks tab
      2. Look for the input field or "Add Task" button at the top
      3. Type your task description
      4. Press Enter or click the Add button
      5. Your task appears in the list immediately

      Task Creation Tips:

      • Be Specific: Write clear, actionable tasks like "Export artboards as PNG" instead of "Export stuff"
      • Break Down Projects: Create multiple tasks for complex projects
      • Use Action Verbs: Start tasks with verbs: "Create," "Design," "Export," "Review"
      • Keep It Short: Aim for one-line task descriptions
      • Add Context: Include relevant details like "for client presentation" or "version 2"

      Managing Tasks:

      Checking Off Completed Tasks:

      1. Locate the task you've completed
      2. Click the checkbox next to the task
      3. The task is marked as complete
      4. Completed tasks may move to a separate section or show a strikethrough

      Unchecking Tasks:

      • If you accidentally check a task or need to redo it
      • Click the checkbox again to uncheck it
      • The task returns to your active task list

      Editing Tasks:

      Depending on the implementation:

      • Click on the task text to edit it
      • Or use an edit button/icon next to the task
      • Make your changes and save

      Deleting Tasks:

      1. Locate the task you want to remove
      2. Look for a delete button (trash icon or X) next to the task
      3. Click to delete the task
      4. The task is permanently removed from your list

      Organizing Your Tasks:

      Task Organization Strategies:

      By Priority:

      • Add priority indicators to task names: "[HIGH]", "[MEDIUM]", "[LOW]"
      • Or reorder tasks manually with most important at the top
      • Focus on high-priority items first

      By Project:

      • Group related tasks together
      • Use project names as prefixes: "Logo Project: Create sketches"
      • Keep all tasks for one project consecutive in the list

      By Workflow Stage:

      • Organize tasks by design phase: Concept, Design, Refine, Export
      • Move tasks through stages as you progress
      • See your workflow progression at a glance

      By Due Date:

      • Add dates to task descriptions: "Export files (due Friday)"
      • Keep urgent tasks at the top
      • Review and reorder daily

      Tracking Your Progress:

      View Completed Tasks:

      • Completed tasks typically remain visible (with strikethrough or in a separate section)
      • Review what you've accomplished
      • Provides motivation and progress tracking

      Clear Completed Tasks:

      • Periodically clean up your completed tasks
      • Look for a "Clear Completed" button or similar option
      • Keeps your task list focused on active work

      Task Count:

      • Some implementations show task counts (e.g., "5 of 12 tasks completed")
      • Provides quick progress overview
      • Helps you gauge workload

      Best Practices for Task Management:

      ✓ Do:

      • Review your task list at the start of each work session
      • Add tasks as soon as you think of them
      • Check off tasks immediately when completed
      • Keep your active task list under 20 items
      • Break large tasks into smaller, manageable steps
      • Clear completed tasks regularly

      ✗ Don't:

      • Let your task list become overwhelming with too many items
      • Write vague tasks that don't specify clear actions
      • Forget to update your list as priorities change
      • Use tasks for long-term planning (use project management tools instead)
      • Leave completed tasks checked indefinitely

      Common Use Cases:

      • Daily Workflow: "Open reference images," "Create color palette," "Design 3 variations," "Export finals"
      • Project Checklist: "Client approval," "Revise logo," "Create business card," "Prepare print files"
      • Learning Goals: "Watch gradient tutorial," "Practice pen tool," "Try new script"
      • Maintenance Tasks: "Clean up layers," "Organize artboards," "Update symbols"
      • Client Deliverables: "Export web assets," "Package for print," "Send proofs"

      Integration with Your Workflow:

      The Tasks Manager works best when integrated into your daily routine:

      1. Morning Review: Start each session by reviewing your task list
      2. Add as You Go: Create tasks when you think of them during work
      3. Check Off Progress: Mark tasks complete as you finish them
      4. End-of-Day Cleanup: Review completed tasks and plan tomorrow's priorities
      5. Weekly Reset: Clear completed tasks and plan the week ahead

      The Tasks Manager is intentionally simple—it's not meant to replace full project management software, but rather to provide quick, accessible task tracking right where you're working.

    • The Video Player feature provides quick access to learning resources, helping you master ScriptBox features and discover new techniques through visual instruction.

      Why Use Video Tutorials?

      • Visual Learning: See scripts in action with step-by-step demonstrations
      • Quick Access: No need to search YouTube or documentation sites
      • Curated Content: Access tutorials specifically about ScriptBox features
      • Custom Library: Build your own collection of helpful videos
      • Learn While You Work: Watch tutorials without leaving Illustrator

      Accessing Video Tutorials:

      1. Click the Videos tab icon (video camera icon) at the top of the ScriptBox panel
      2. The Videos interface displays available tutorial links
      3. Browse the list of video resources

      Viewing Tutorial Videos:

      To Watch a Tutorial:

      1. Open the Videos tab
      2. Browse the list of available tutorials
      3. Click on any video link
      4. The video opens in your default web browser
      5. Watch the tutorial and return to Illustrator to apply what you learned

      Adding Custom Video Links:

      One of the most powerful features is the ability to add your own video links, building a personalized learning library.

      To Add a Video Link:

      1. Open the Videos tab
      2. Look for an "Add Video" button or input field
      3. Enter the video URL (YouTube, Vimeo, or other video platforms)
      4. Optionally add a title or description
      5. Save the link
      6. The video appears in your list

      What Videos to Add:

      ScriptBox-Related:

      • Official ScriptBox tutorials you find helpful
      • Community-created script demonstrations
      • Workflow videos featuring ScriptBox
      • Tips and tricks from other users

      General Illustrator:

      • Illustrator technique tutorials
      • Design principle videos
      • Tool demonstrations
      • Workflow optimization tips

      Project-Specific:

      • Client reference videos
      • Style inspiration videos
      • Technique demonstrations for current projects
      • Industry-specific tutorials

      Managing Your Video Library:

      Organizing Videos:

      Depending on the implementation, you may be able to:

      • Reorder videos by dragging
      • Categorize videos with naming conventions
      • Add descriptions or notes to video links
      • Create sections for different topics

      Removing Videos:

      1. Locate the video you want to remove
      2. Look for a delete button (trash icon or X) next to the video
      3. Click to remove the video from your library
      4. The video link is deleted (the actual video online remains unchanged)

      Best Practices for Video Tutorials:

      ✓ Do:

      • Add videos immediately when you find helpful content
      • Watch tutorials relevant to your current projects
      • Revisit videos when you need a refresher
      • Share useful video links with team members
      • Organize videos with clear, descriptive names
      • Remove outdated or no-longer-relevant videos

      ✗ Don't:

      • Add every video you come across (be selective)
      • Let your library become cluttered with too many links
      • Forget to test links before saving them
      • Add videos you'll never watch again
      • Ignore organization—it matters as your library grows

      Learning Workflow Suggestions:

      For Beginners:

      1. Start with overview videos covering ScriptBox basics
      2. Watch tutorials for the script categories you use most
      3. Follow along with the video in Illustrator
      4. Practice each technique multiple times
      5. Add videos for scripts you want to learn next

      For Intermediate Users:

      1. Focus on workflow optimization videos
      2. Learn advanced features of scripts you already use
      3. Watch videos about combining multiple scripts
      4. Explore categories you haven't used yet
      5. Add technique videos for specific design challenges

      For Advanced Users:

      1. Watch advanced technique demonstrations
      2. Learn creative applications of familiar scripts
      3. Explore edge cases and unusual uses
      4. Add videos about scripting and customization
      5. Share your own tutorials with the community

      Common Use Cases:

      • Onboarding: New team members can access training videos
      • Skill Development: Build expertise in specific script categories
      • Problem Solving: Find solutions to specific design challenges
      • Inspiration: Discover creative uses of scripts
      • Reference: Keep technique videos handy for occasional tasks
      • Client Work: Store style reference videos for specific projects

      Video Tutorial Tips:

      • Take Notes: Jot down key points while watching
      • Practice Immediately: Apply techniques right after watching
      • Bookmark Timestamps: Note specific sections for quick reference
      • Watch at Different Speeds: Speed up for review, slow down for complex techniques
      • Repeat as Needed: Don't hesitate to watch videos multiple times

      The Video Player feature transforms ScriptBox from just a tool into a learning platform, helping you continuously improve your skills and discover new possibilities.

    • The Image Gallery feature turns ScriptBox into a visual moodboard, allowing you to keep inspiration and reference materials right in your workspace while you design.

      Why Use Reference Images?

      • Visual Inspiration: Keep reference images visible while you work
      • No App Switching: View references without leaving Illustrator
      • Project Context: Maintain visual context for current projects
      • Color Reference: Sample colors directly from reference images
      • Style Consistency: Ensure your work matches reference materials
      • Client Assets: Keep client-provided references accessible

      Accessing Reference Images:

      1. Click the Reference tab icon (image icon) at the top of the ScriptBox panel
      2. The Reference interface displays your moodboard
      3. View all added reference images in a visual grid or gallery

      Adding Reference Images:

      To Add an Image:

      1. Open the Reference tab
      2. Look for an "Add Image" button or drag-and-drop area
      3. Choose your method:Drag and Drop: Drag image files directly into the Reference tabBrowse: Click "Add Image" and browse your computer for filesPaste: Some implementations may support pasting images from clipboard
      4. The image appears in your reference collection

      Supported Image Formats:

      Typically supports common image formats:

      • JPEG/JPG - Photos and complex images
      • PNG - Images with transparency
      • GIF - Animated or simple graphics
      • SVG - Vector graphics (if supported)
      • TIFF - High-quality images

      What Images to Add:

      Design Inspiration:

      • Style references for current projects
      • Color palette inspiration
      • Typography examples
      • Layout references
      • Texture and pattern samples

      Client Materials:

      • Client-provided reference images
      • Brand guidelines screenshots
      • Approved design directions
      • Product photos
      • Logo references

      Technical References:

      • Dimension specifications
      • Technical drawings
      • Measurement guides
      • Grid systems
      • Template layouts

      Mood and Style:

      • Mood board images
      • Artistic inspiration
      • Photography references
      • Illustration styles
      • Design trends

      Viewing and Using Reference Images:

      Viewing Images:

      1. Open the Reference tab
      2. Browse your image collection
      3. Click on any image to view it larger (if supported)
      4. Zoom or pan to see details
      5. Keep the panel open while you work for constant reference

      Using References While Designing:

      • Side-by-Side: Dock ScriptBox alongside your canvas to see references while working
      • Color Sampling: Use Illustrator's Eyedropper tool to sample colors from reference images
      • Style Matching: Compare your work to references in real-time
      • Proportion Reference: Check sizing and proportions against references
      • Detail Checking: Zoom into reference images to see fine details

      Organizing Reference Images:

      Organization Strategies:

      By Project:

      • Keep references for each project separate
      • Remove old project references when projects complete
      • Add new references as projects begin

      By Type:

      • Group color references together
      • Keep typography references separate
      • Organize by style or mood

      By Priority:

      • Place most important references first
      • Keep frequently referenced images easily accessible
      • Archive less critical references

      Managing Reference Images:

      Removing Images:

      1. Locate the image you want to remove
      2. Look for a delete button (trash icon or X) on or near the image
      3. Click to remove the image
      4. The image is deleted from your reference collection (original file remains on your computer)

      Updating References:

      • Remove outdated references regularly
      • Add new references as projects evolve
      • Replace low-quality images with better versions
      • Update references when client provides new materials

      Clearing All References:

      • Some implementations may offer a "Clear All" option
      • Use this when starting a new project
      • Or when you want to completely refresh your moodboard

      Best Practices for Reference Images:

      ✓ Do:

      • Keep your reference collection focused on current projects
      • Remove references when projects are complete
      • Use high-quality images when possible
      • Organize references logically
      • Update references as projects evolve
      • Keep the collection manageable (10-20 images)

      ✗ Don't:

      • Add every image you find interesting
      • Let old project references clutter your collection
      • Use extremely large image files (they may slow performance)
      • Forget to remove references when they're no longer relevant
      • Ignore organization as your collection grows

      Workflow Integration:

      Project Start:

      1. Clear previous project references
      2. Add client-provided materials
      3. Add style and mood references
      4. Add color palette inspiration
      5. Add technical specifications

      During Design:

      1. Keep Reference tab visible while working
      2. Refer to images frequently for consistency
      3. Add new references as you discover them
      4. Remove references that aren't helpful

      Project Completion:

      1. Review final work against references
      2. Ensure all requirements are met
      3. Clear references when project is delivered
      4. Archive important references externally if needed

      Common Use Cases:

      • Logo Design: Keep brand references, competitor logos, and style inspiration visible
      • Illustration: Reference photos, style examples, and color palettes
      • Web Design: Layout references, UI patterns, and responsive examples
      • Print Design: Template specifications, bleed guides, and approved designs
      • Icon Design: Style consistency references and size specifications
      • Packaging: Product photos, dimension specs, and approved mockups

      Tips for Effective Reference Use:

      • Quality Over Quantity: 5 perfect references beat 50 mediocre ones
      • Specific References: Choose images that directly relate to your current task
      • Update Regularly: Refresh references as your design direction evolves
      • Multiple Angles: Include different perspectives of the same concept
      • Technical + Creative: Balance inspirational images with technical specifications

      Performance Considerations:

      • Image Size: Use reasonably sized images (under 5MB each) for better performance
      • Total Images: Keep your collection under 30 images for optimal performance
      • File Formats: JPEGs typically perform better than large PNGs
      • Resolution: Use screen-resolution images (72-150 DPI) rather than print-resolution

      The Reference Images feature transforms ScriptBox into a visual workspace companion, ensuring your inspiration and requirements are always just a glance away.

    • The Gradient Generator is a powerful tool for creating smooth, perceptually uniform color gradients with advanced interpolation modes. Unlike standard gradients, this tool uses color science to create natural-looking transitions that avoid muddy colors and maintain visual harmony.

      Why Use the Gradient Generator?

      • Perceptually Uniform: Creates gradients that look smooth to the human eye
      • Avoid Muddy Colors: Advanced interpolation prevents dull, gray transitions
      • Multiple Color Modes: Choose from RGB, LAB, LCH, HSV, and HSL interpolation
      • Flexible Color Stops: Use 2-10 color stops for complex gradients
      • Generate Swatches: Extract individual colors from your gradient
      • Direct Integration: Add gradients and swatches directly to Illustrator
      • Drag and Drop: Drag gradients and colors directly to your canvas

      Accessing the Gradient Generator:

      1. Click the Gradient Generator tab icon (gradient icon) at the top of the ScriptBox panel
      2. The Gradient Generator interface displays with a live preview
      3. Adjust settings and see results in real-time

      Understanding Interpolation Modes:

      The interpolation mode determines how colors blend between stops. Each mode produces different results:

      RGB (Red, Green, Blue):

      • Linear interpolation in RGB color space
      • Simple and predictable
      • Can produce muddy colors in the middle of gradients
      • Best for: Technical applications, simple two-color gradients

      LAB (Lightness, A, B):

      • Perceptually uniform color space
      • Smoother transitions than RGB
      • Maintains brightness consistency
      • Best for: Natural-looking gradients, avoiding muddy colors

      LCH (Lightness, Chroma, Hue) - Recommended:

      • LAB with cylindrical coordinates
      • Most perceptually uniform option
      • Produces the smoothest, most natural gradients
      • Excellent hue transitions
      • Best for: Professional design work, vibrant gradients, color harmony

      HSV (Hue, Saturation, Value):

      • Hue-based interpolation
      • Can create rainbow-like transitions
      • Maintains saturation better than RGB
      • Best for: Colorful, vibrant gradients with hue shifts

      HSL (Hue, Saturation, Lightness):

      • Similar to HSV but with different lightness handling
      • Smooth hue transitions
      • More predictable lightness than HSV
      • Best for: UI design, consistent lightness gradients

      Creating a Gradient:

      Step 1: Choose Your Interpolation Mode

      1. Open the Gradient Generator tab
      2. Look for the interpolation mode chips at the top
      3. Click your preferred mode (LCH is recommended for best results)
      4. The gradient preview updates immediately

      Step 2: Set the Number of Color Stops

      1. Find the "Number of Stops" input field
      2. Enter a value between 2 and 10
      3. More stops allow for more complex, multi-color gradients
      4. The color stops section updates with your chosen number

      Step 3: Choose Your Colors

      For each color stop, you can:

      Pick a Color:

      • Click the color preview square
      • A color picker opens
      • Choose your desired color
      • The gradient updates in real-time

      Enter a Hex Code:

      • Type directly in the hex input field
      • Format: #RRGGBB (e.g., #FF5733)
      • Press Enter to apply
      • The gradient updates automatically

      Randomize a Color:

      • Click the shuffle icon next to any color stop
      • A random color is generated
      • Great for exploration and inspiration

      Lock a Color:

      • Click the lock icon to prevent changes
      • Locked colors won't change when randomizing all colors
      • Useful for keeping brand colors while exploring variations

      Delete a Color Stop:

      • Click the trash icon (only available when you have more than 2 stops)
      • The color stop is removed
      • The gradient recalculates with remaining colors

      Step 4: Reorder Color Stops (Optional)

      1. Click and hold the drag handle (≡) on any color stop
      2. Drag the color stop up or down
      3. Release to drop it in the new position
      4. The gradient updates with the new color order

      Using the Gradient Preview:

      The gradient preview at the top shows your gradient in real-time with smooth color transitions.

      Preview Features:

      • Live Updates: Changes to colors or modes update instantly
      • Smooth Rendering: Shows 20+ interpolation points for accuracy
      • Visual Feedback: See exactly what your gradient will look like
      • Drag to Canvas: Drag the preview directly to your artboard

      Quick Actions:

      Mirror Gradient:

      • Click the mirror icon (⇄) in the preview header
      • Reverses the order of all color stops
      • Useful for flipping gradient direction
      • Locked colors move with their positions

      Randomize All Colors:

      • Click the shuffle icon in the preview header
      • Generates random colors for all unlocked stops
      • Locked colors remain unchanged
      • Great for discovering new color combinations

      Adding Gradients to Illustrator:

      Add to Swatches:

      1. Click the "Add to Swatches" button below the preview
      2. The gradient is added to Illustrator's Swatches panel
      3. Access it anytime from the Swatches panel
      4. Apply to any object using the Gradient tool

      Add to Canvas:

      1. Click the "Add to Canvas" button below the preview
      2. A square with the gradient is placed on your active artboard
      3. The square appears at the center of the artboard
      4. Resize, reshape, or apply to other objects as needed

      Drag to Canvas:

      1. Click and drag the gradient preview
      2. Drag it over your Illustrator canvas
      3. Release to drop
      4. A gradient square appears where you dropped it

      Generating Color Swatches:

      The Gradient Generator can extract individual colors from your gradient, creating a color palette.

      Setting the Number of Swatches:

      1. Find the "Number of Swatches" input in the Color Swatches panel
      2. Enter a value between 2 and 50
      3. The swatches update to show evenly distributed colors from your gradient
      4. More swatches = more color options, fewer swatches = more distinct colors

      Viewing Swatches:

      • Swatches appear as a grid of color squares
      • Each swatch shows the hex color code below it
      • Colors are evenly distributed across the gradient
      • Updates automatically when you change the gradient

      Using Color Swatches:

      Add All Swatches to Swatches Panel:

      1. Click "Add to Swatches" in the Color Swatches section
      2. All colors are added to Illustrator's Swatches panel
      3. Access them anytime for consistent color use
      4. Perfect for creating color palettes

      Add All Swatches to Canvas:

      1. Click "Add to Canvas" in the Color Swatches section
      2. Color squares are placed on your active artboard
      3. Arranged in a row for easy reference
      4. Use as a color palette reference

      Drag Individual Colors:

      1. Click and drag any individual swatch color
      2. Drag it over your Illustrator canvas
      3. Release to drop
      4. A color square appears where you dropped it

      Workflow Tips and Best Practices:

      For Brand Color Palettes:

      1. Start with your brand colors as color stops
      2. Lock the brand colors
      3. Use LCH interpolation for smooth transitions
      4. Generate 5-7 swatches for a complete palette
      5. Add swatches to Illustrator for consistent use

      For Background Gradients:

      1. Use 2-3 color stops for subtle backgrounds
      2. Choose LCH or LAB interpolation
      3. Keep colors in similar hue families
      4. Add gradient to canvas and resize to fit
      5. Adjust opacity in Illustrator if needed

      For Vibrant Designs:

      1. Use HSV or LCH interpolation
      2. Choose contrasting hues for color stops
      3. Experiment with 3-4 color stops
      4. Use the randomize feature for inspiration
      5. Lock colors you like and randomize the rest

      For UI Design:

      1. Use HSL or LCH for consistent lightness
      2. Generate 5-10 swatches for tints and shades
      3. Add swatches to Illustrator's Swatches panel
      4. Use for buttons, backgrounds, and UI elements
      5. Maintain accessibility with sufficient contrast

      For Exploration:

      1. Start with 2 random colors
      2. Try different interpolation modes
      3. Add more color stops gradually
      4. Use the mirror function to see variations
      5. Lock colors you like and randomize others

      Common Use Cases:

      • Logo Design: Create harmonious color variations for logo elements
      • Web Design: Generate consistent color palettes for UI components
      • Illustration: Create smooth sky gradients or color transitions
      • Infographics: Generate data visualization color scales
      • Branding: Develop extended color palettes from brand colors
      • Print Design: Create smooth gradients for backgrounds and effects
      • Icon Design: Generate color families for icon sets
      • Packaging: Develop cohesive color schemes for product lines

      Keyboard and Mouse Tips:

      • Quick Color Change: Click color preview for instant color picker
      • Fast Randomization: Use randomize buttons for quick exploration
      • Drag Reordering: Reorder stops by dragging for different effects
      • Lock Strategy: Lock key colors before randomizing for controlled variation
      • Swatch Extraction: Generate many swatches to see all gradient colors

      Troubleshooting:

      Gradient Looks Muddy:

      • Switch from RGB to LCH or LAB interpolation
      • Reduce the number of color stops
      • Choose colors with similar lightness values
      • Avoid complementary colors (red-green, blue-orange)

      Colors Don't Match Preview:

      • Ensure your Illustrator color mode matches (RGB vs CMYK)
      • Check your monitor calibration
      • Preview shows RGB colors; CMYK conversion may shift colors

      Can't Add to Swatches:

      • Ensure you have an Illustrator document open
      • Check that Illustrator is not in a modal dialog
      • Try adding to canvas first, then create swatch from object

      Drag and Drop Not Working:

      • Ensure you're dragging over the Illustrator canvas
      • Try using the "Add to Canvas" button instead
      • Check that no modal dialogs are blocking Illustrator

      Settings Not Saving:

      • Settings save automatically to browser localStorage
      • Clear browser cache may reset settings
      • Each workspace may have separate settings

      The Gradient Generator transforms color gradient creation from guesswork into a scientific, predictable process, ensuring your gradients always look smooth, professional, and visually harmonious.

    • The Info tab is your central hub for version information, updates, support resources, and community acknowledgments.

      Why Use the Info Tab?

      • Stay Current: Check for the latest ScriptBox updates
      • Version Tracking: Know which version you're running
      • Get Support: Access help resources and contact information
      • Learn More: Find links to documentation and tutorials
      • Community: See supporters and contributors

      Accessing the Info Tab:

      1. Click the Info tab icon (information icon) at the top of the ScriptBox panel
      2. The Info interface displays version and support information
      3. Browse available resources and information

      Version Information:

      What You'll See:

      • Current Version Number: The version of ScriptBox you're currently running (e.g., 0.2.3.9)
      • Release Date: When this version was released
      • Build Information: Technical details about the build (if applicable)

      Why Version Numbers Matter:

      • Troubleshooting: Support may ask for your version number
      • Feature Availability: Some features are only in newer versions
      • Bug Reports: Include version info when reporting issues
      • Compatibility: Ensure compatibility with your Illustrator version
      • Update Decisions: Know if you're running the latest version

      Checking for Updates:

      How to Check for Updates:

      1. Open the Info tab
      2. Look for an "Check for Updates" button or link
      3. Click to check if a newer version is available
      4. Follow prompts if an update is available

      Update Information:

      When updates are available, you may see:

      • What's New: List of new features and improvements
      • Bug Fixes: Issues resolved in the new version
      • Download Link: Where to get the latest version
      • Installation Instructions: How to update

      Update Best Practices:

      ✓ Do:

      • Check for updates monthly
      • Read release notes before updating
      • Backup your favorites and settings before major updates
      • Update when you have time to test the new version
      • Report any issues you encounter after updating

      ✗ Don't:

      • Update in the middle of critical projects
      • Skip reading what's new in updates
      • Ignore update notifications indefinitely
      • Update without backing up custom scripts

      Accessing Support Resources:

      Available Resources:

      The Info tab typically provides links to:

      Documentation:

      • User Guide (this document)
      • Script documentation
      • Video tutorials
      • FAQ and troubleshooting guides

      Community:

      • Official website (Samolevsky.com)
      • Support forums or discussion boards
      • Social media channels
      • Community script libraries

      Contact:

      • Support email address
      • Bug report submission
      • Feature request process
      • General inquiries

      Getting Help:

      When You Need Support:

      1. Check Documentation First: Most questions are answered in the User Guide
      2. Search for Solutions: Look for similar issues in forums or FAQs
      3. Gather Information: Note your version number, Illustrator version, and OS
      4. Describe the Issue: Be specific about what's not working
      5. Contact Support: Use the contact information in the Info tab

      What to Include in Support Requests:

      • ScriptBox Version: From the Info tab
      • Illustrator Version: Help > About Adobe Illustrator
      • Operating System: Windows or macOS version
      • Issue Description: What you were trying to do
      • Error Messages: Exact text of any errors
      • Steps to Reproduce: How to recreate the issue
      • Screenshots: Visual documentation of the problem

      Special Thanks and Supporters:

      Community Acknowledgments:

      The Info tab often includes:

      • Supporters: People who have supported ScriptBox development
      • Contributors: Community members who contributed scripts or ideas
      • Testers: Beta testers who helped improve ScriptBox
      • Translators: Contributors who helped with localization
      • Special Thanks: Acknowledgments to key community members

      Why This Matters:

      • Community Recognition: Celebrates those who make ScriptBox better
      • Transparency: Shows the collaborative nature of the project
      • Inspiration: Encourages others to contribute
      • Gratitude: Acknowledges the community's role in development

      Additional Information:

      What Else You Might Find:

      • License Information: Terms of use and licensing details
      • Credits: Development team and contributors
      • Third-Party Libraries: Acknowledgment of open-source components
      • Privacy Policy: How ScriptBox handles data (if applicable)
      • Changelog: Detailed history of updates and changes

      Staying Informed:

      Best Practices:

      ✓ Do:

      • Check the Info tab when you first install ScriptBox
      • Review update information when new versions are released
      • Bookmark the official website for easy access
      • Subscribe to update notifications if available
      • Read release notes to discover new features

      ✗ Don't:

      • Ignore version information when seeking support
      • Skip reading update notes
      • Forget to check for updates regularly
      • Overlook support resources when you have questions

      Quick Reference:

      Common Info Tab Actions:

      1. Check Version: Open Info tab, note version number
      2. Check for Updates: Click "Check for Updates" button
      3. Get Support: Click support link or copy email address
      4. Visit Website: Click official website link
      5. View Supporters: Scroll to see community acknowledgments
      6. Read Changelog: Review what's new in recent updates

      When to Use the Info Tab:

      • After Installation: Verify version and explore resources
      • Before Reporting Issues: Gather version information
      • Monthly Check-In: Look for updates and new resources
      • When Stuck: Access support and documentation links
      • Curiosity: Learn about the community and contributors

      The Info tab ensures you always have access to the information and resources you need to get the most out of ScriptBox, while staying connected to the community and keeping your installation up to date.

    Release Notes

    • AUG 2025

      • Public Beta release.

      • New Scripts:

        • Page Number Generator 1.0.0
        • Re-index Artboards by Position 1.0.0
        • Swatches Batch Renamer 1.0.0
        • Graphic Styles Batch Renamer 1.0.0

        Updated Scripts:

        • 10 Print Pattern Generator → 1.0.1
        • Archimedean Spiral Generator → 1.0.1
        • Circle With N Points → 1.0.2
        • Fractal Tree Generator → 1.0.1
        • Sine Wave Generator → 1.0.1
        • Star Shape Generator → 1.0.1
        • Artboards Batch Renamer → 1.0.8
        • Items Batch Renamer → 1.0.3
        • Layers Batch Renamer → 1.0.4

      • New Scripts:

        • Move Objects to Layer 1.0.0
        • Symbols Batch Renamer 1.0.0

        Updated Scripts:

        • Corner Effects → 1.0.2
        • Random Point Jitter → 1.0.8
        • Selection to Symbols → 1.0.2

      • New Features:

        Added the Reference tab that serves as a visual moodboard and media library that allows users to collect, organize, and manage reference images:

        • Add Images: Import individual images via file picker.
        • Add Folder: Import all images from a selected folder.
        • Remove Images: Delete individual images from the gallery.
        • Clear All: Remove all images with confirmation.
        • Grid View: Responsive image grid with hover overlays.
        • List View: Detailed list with thumbnails.
      • New Features:

        + List View - Compact vertical list display for efficient browsing.

        + Drag and Drop Reordering - Reorganize your images within the Reference tab by dragging them.

        Bug Fixes:

        • Fixed issue preventing both Reference and Videos lists from being scrollable.

    • SEP 2025

      • New Features:

        + Horizontal Masonry Grid - Dynamic grid that adapts to image dimensions.

        + Vertical Masonry Grid - Pinterest-style layout with horizontal flow.

        Bug Fixes:

        • Added the clear input ✖︎ icon functionality to all input fields.
        • Improved visual feedback during drag and drop operations.

      • New Features:

        + Fullscreen Zoom Controls - Zoom in/out capabilities in fullscreen image viewer

        + Images can now be placed from the Reference tab directly into Illustrator document when their names are clicked.

        New Scripts:

        • Image Transform Reset 1.0.0

        Updated Scripts:

        • Sequential Object Labeler → 1.0.2
        • Sticky Note → 1.0.3

      • New Features

        We've added a heartfelt "Special thanks to:" section in the Info tab to recognize our amazing supporters who help make ScriptBox possible.

        New Scripts:

        • Circumcircle 1.0.0
        • Close Open Paths 1.0.0
        • Join Paths 1.0.0
        • Zig-Zag Effect 1.0.0

    • OCT 2025

      • Bug Fixes:

        • Minor UI Improvements and bug fixes.
        • Fixed bug preventing user to add scripts and panels to favourites in the compact list mode.

        New Features:

        • Users can now type in the search bar to instantly filter their Video Player list.
        • Added End User License Agreement text.
        • Added the toggle view functionality to the Video Player tab.
        • The new Grid view shows beautiful large thumbnails in a multi-column layout with video information below and action buttons appearing on hover.

        New Scripts:

        Text Highlighter 1.0.0
        • Long Shadow 1.0.0
        • Merge Layers 1.0.0

        Updated Scripts:

        • Re-index Artboards by Position → 1.0.1
        • Average Color → 1.0.2
        • Bezier Handle Visualizer → 1.2.5

      • New Scripts:

        • Bounding Box Builder
        • Dynamic Text Block
        • Image Selector

        Updated Scripts:

        • Adjust Opacity by Percentage → 1.0.2
        • Color Randomizer → 1.1.4
        • Detach Global Colors → 1.0.1
        • HSL Color Randomizer → 1.0.9
        • Hue Saturation Lightness → 1.1.0
        • Proportional Spacing Adjuster → 1.0.1
        • Radial Arranger → 1.0.2
        • Random Objects Selector → 1.0.4
        • Random Rotate → 1.0.2
        • RGB Color Randomizer → 1.0.8
        • Select by Attribute → 1.1.9
        • Select by Blending Mode → 1.0.3
        • Select by Size → 1.0.3
        • Smart Selector → 1.0.2
        • Text Baseline Shift Randomizer → 1.0.3
        • Text Scale Randomizer → 1.0.4
        • Text Size Randomizer → 1.0.2
        • Text Tracking Randomizer → 1.0.5
        • Type Randomizer → 1.0.1
        • Type Tweaker → 1.1.2

      • Updated Scripts:

        • Artboard Navigator → 1.0.4
        • Distribute Gradient Stops → 1.0.2
        • Shuffle Gradient Stops → 1.0.6
        • Smart Swatch Randomizer → 1.0.2
        • Solid Color to Gradient → 1.0.3

        New Scripts:

        • Document Grid Visualizer
        • Invert Colors
        • Stroke Dash Tweaker

    • NOV 2025

      • New Features:

        Gradient Generator Tab

        This powerful new tool helps you create beautifully balanced gradient combinations with ease. Perfect for designers who want to explore harmonious color transitions and build cohesive gradient palettes for their projects.

        • Take full control of your Toolbox layout! You can now:

        • Rename sections to match your workflow and terminology
        • Reorder sections by dragging them to your preferred arrangement
        • Drag and drop tools between sections to create your perfect custom setup

        New Scripts:

        • Chess
        • Skew

        Updated Scripts:

        • Clipping Mask Manager → 1.0.1
        • Close Open Paths → 1.0.1
        • Group by Attributes → 1.0.2
        • Proportional Spacing Adjuster → 1.0.2

    ScriptBox

    Version: 0.2.6.0

    Updated:

    • Supported Versions:

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

      Operating Systems:

      • Works on both macOS and Windows platforms.
      1. Download and install ZXPInstaller
      2. Drag and drop ScriptBox.zxp onto ZXPInstaller
      3. The extension will be installed automatically
      4. Restart Adobe Illustrator if it's already running
      5. Access extension via Window > Extensions > ScriptBox

      Troubleshooting

      ⚠︎ Since this extension is still in beta, it may not load properly for all users. If you run into this issue, you’ll need to enable Debug Mode in Adobe Illustrator. Debug Mode allows unsigned CEP extensions to run, which is required during testing. Don’t worry—it’s a safe and standard step for trying out beta extensions.

      How to Enable Debug Mode for CEP Extensions

      MacOS: 

      1. Open Terminal
      2. Run the following command:
        defaults write com.adobe.CSXS.11 PlayerDebugMode 1
      3. Replace CSXS.11 with the actual CEP version used by your Illustrator. For Adobe Illustrator 2020 and some recent versions, it often corresponds to CSXS.9 or CSXS.10
      4. After enabling, restart Illustrator, and the extension will load in Window > Extensions > ScriptBox

      Windows:

       ㅤ

      1. Press Win + R, type regedit, and hit Enter
      2. Navigate to:
        HKEY_CURRENT_USER\Software\Adobe\CSXS.11
      3. Look for a key called PlayerDebugMode (If it doesn’t exist, create a new String Value named PlayerDebugMode)
      4. Set its value to: 1
      5. After enabling, restart Illustrator, and the extension will load in Window > Extensions > ScriptBox

    • 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

    1. Explore Group by Attributes
      Group by Attributes

      Group by Attributes

      An Adobe Illustrator script that automatically groups objects based on their visual appearance attributes such as fill color, stroke color, stroke weight, opacity, and blending mode.

      Explore
    2. Explore Group by Artboard
      Group by Artboard

      Group by Artboard

      Group by Artboard is an Adobe Illustrator script that automatically groups all objects on selected artboards.

      Explore
    3. Explore Close Open Paths
      Close Open Paths

      Close Open Paths

      An Adobe Illustrator script that intelligently closes open paths with smooth or straight segments, giving you precise control over how your paths are completed.

      Explore

    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.

    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!