GuideMi User Manual

Overview

GuideMi is a guide management plugin designed for Photoshop. The name combines "Guide" (the Photoshop feature) with "Mi", similar to the naming convention of WesternBo. The plugin provides a comprehensive set of tools for creating, managing, and organizing guides. Whether you need simple border guides or complex grid layouts, GuideMi helps you set up guides quickly and precisely.

The plugin supports multiple units (pixels, percent, centimeters, millimeters, inches, points, picas), intelligently positions guides based on selections, layers, or document boundaries, and offers real-time preview functionality for more intuitive layout design. GuideMi also features a comprehensive multilingual interface supporting 17 languages, making it accessible to users worldwide.

Main Features

Smart Boundary Detection

All guide functions in GuideMi support smart boundary detection, determining the guide positioning area in the following priority order:

  1. Selection First: If a selection exists, guides will be created based on the selection bounds
  2. Layer Bounds: If there's no selection but a layer is selected, guides will be based on the selected layer's bounds
  3. Document Bounds: If there's neither a selection nor a selected layer, guides will be based on the entire document bounds

Quick Actions

The Quick Actions area is located at the top of the plugin, providing the most commonly used guide functions arranged in an 8-column, 4-row layout.

Row 1: Single-Edge Guides and Basic Layouts

IconButtonFunctionDetailed Description
TopTop GuideAdd a horizontal guide at the top edge of the target area. Right-click to set layer mode (Combined/Individual), which applies to all buttons in this row
BottomBottom GuideAdd a horizontal guide at the bottom edge of the target area. Shares the layer mode setting from the Top button
LeftLeft GuideAdd a vertical guide at the left edge of the target area. Shares the layer mode setting from the Top button
RightRight GuideAdd a vertical guide at the right edge of the target area. Shares the layer mode setting from the Top button
H-CenterHorizontal CenterAdd a horizontal guide at the vertical center of the target area. Shares the layer mode setting from the Top button
V-CenterVertical CenterAdd a vertical guide at the horizontal center of the target area. Shares the layer mode setting from the Top button
BorderBorder GuidesAdd border guides around all four edges of the target area. Shares the layer mode setting from the Top button
MidlinesCenter CrossAdd both horizontal and vertical center guides simultaneously. Shares the layer mode setting from the Top button

Multi-Layer Behavior (Right-Click Menu)

Right-click the Top button to set how guides are created when multiple layers are selected. This setting is global — it applies to all buttons in the first row and all guide creation functions throughout the plugin:

Row 2: Grid Presets and Composition Guides

IconButtonFunctionDetailed Description
2×22×2 GridQuickly create a 2-row, 2-column evenly divided grid
3×33×3 GridQuickly create a 3-row, 3-column evenly divided grid (rule of thirds)
4×44×4 GridQuickly create a 4-row, 4-column evenly divided grid
5×55×5 GridQuickly create a 5-row, 5-column evenly divided grid
6×66×6 GridQuickly create a 6-row, 6-column evenly divided grid. Right-click to select 7×7, 8×8, 9×9, or 10×10 grids
φ Golden RatioGolden RatioAdd golden ratio guides (two lines each in horizontal and vertical directions, positioned at 38.2% and 61.8%). Right-click to select different variants
4:34:34:3 Aspect RatioCreate a 4:3 aspect ratio guide frame based on the target area. Right-click to set custom aspect ratio
16:916:916:9 Aspect RatioCreate a 16:9 aspect ratio guide frame based on the target area. Right-click to set custom aspect ratio

Golden Ratio Variants (Right-Click Menu)

Custom Aspect Ratio (Right-Click Menu)

Right-clicking on the 4:3 or 16:9 button opens a custom aspect ratio panel where you can:

Row 3: Units, Tools, and Display Controls

IconButtonFunctionDetailed Description
pxUnitUnit ToggleClick to cycle through units: px → % → cm → mm → in → pt → pica. Scroll wheel for bidirectional switching, long-press to reset to pixels, right-click to show full unit list. On first launch, the unit automatically syncs with Photoshop's current ruler unit setting
CrosshairCrosshair PlacementClick to enter crosshair placement mode, then click anywhere on the canvas to place crosshair guides. The mode automatically cancels after 30 seconds of inactivity. Right-click to select placement method
SpotlightSpotlight ModeAutomatically create guides at the current layer's boundaries, updating automatically when switching layers. Click to cycle: Off → Edge Mode → Midline Mode → Off. Right-click to directly select a mode
LockLock GuidesToggle the lock state of guides; when locked, guides cannot be moved
Toggle GuidesShow/HideToggle the visibility of guides
Layer EdgesLayer EdgesToggle Photoshop's layer edges display feature
Guide ColorGuide ColorClick to cycle through preset colors, scroll wheel for bidirectional switching, long-press to reset to default light blue, right-click to open RGB custom color panel
Guide StyleGuide StyleToggle guide style: Solid / Dashed. Right-click to select from menu

Spotlight Mode

Spotlight is a dynamic guide feature particularly useful for the following scenarios:

When Spotlight is enabled, guides will continuously track the currently selected layer until manually turned off.

Right-Click Menu: Right-click the Spotlight button to directly choose a mode (Off / Edge Guides / Midlines) without cycling through states.

Crosshair Placement Methods (Right-Click Menu)

The selected method is saved and persists between sessions.

Auto-Cancel: Crosshair placement mode automatically cancels after 30 seconds of inactivity to prevent the polling from running indefinitely.

Preset Color List

Light Blue (default) → Light Red → Green → Medium Blue → Yellow → Magenta → Cyan → Light Gray → Black

Row 4: Clear Guides and Global Controls

IconButtonFunctionDetailed Description
ClearClear AllClear all guides in the document. Shortcut: Delete
Clear H-GuidesClear HorizontalClear only horizontal guides
Clear V-GuidesClear VerticalClear only vertical guides
Clear OutsideClear Outside CanvasClear guides located outside the canvas boundaries
Clear on CanvasClear on CanvasClear guides located within the canvas boundaries
Clear on SelectionClear on SelectionClear guides that overlap with the current selection or selected layer. Right-click to access additional options
Keep/Clear ToggleKeep/Clear ToggleToggle Quick Actions behavior: ✓ (green) keeps existing guides, ✗ (red) clears before creating
Collapse AllCollapse/ExpandCollapse or expand all function panels

Clear on Selection Options (Right-Click Menu)

Clear Button Status Indicators

Clear buttons dynamically display status based on whether corresponding guide types exist:

Margin-Go-Round

Margin-Go-Round takes its name from "Merry-Go-Round" (Carousel), suggesting guides that surround the target area. This tool creates guides with margins around target areas, perfect for quickly setting up safe margins or padding layouts.

Workflow

  1. Define Target Area: Create a selection, select a layer, or use the entire document
  2. Set Margin Values: Enter margin values for top, bottom, left, and right
  3. Execute: Click the button to create margin guides

Control Descriptions

Margin Inputs

ControlFunction
Left IconLeft margin label, supports drag-to-adjust value
Left InputLeft margin value
Right IconRight margin label, supports drag-to-adjust value
Right InputRight margin value
Top IconTop margin label, supports drag-to-adjust value
Top InputTop margin value
Bottom IconBottom margin label, supports drag-to-adjust value
Bottom InputBottom margin value

Action Buttons

IconButtonFunction
Create margin guides
LinkLink/unlink all four margin values. When linked (chain icon connected), changing any margin value updates all four margins to the same value
PreviewEnter/exit preview mode for real-time guide preview. Red = inactive, green = previewing. Press Esc to exit
Keep/ClearToggle whether to keep existing guides when creating new ones
ResetReset all margin values to 0

Link Margins

The Link button (chain icon) controls whether margin values are synchronized:

This is useful when you need equal margins on all sides — simply link them and adjust any one value.

Margin Value Explanation

Value Adjustment Methods

Grid-and-Go

Grid-and-Go takes its name from "Grab-and-Go," suggesting quick grid layout creation. This tool creates custom grid guides with support for row/column counts and gutters, and can create corresponding rectangular frames or shapes.

Workflow

  1. Define Target Area: Create a selection, select a layer, or use the entire document
  2. Set Grid Parameters: Enter column count, row count, column gutter, and row gutter
  3. Execute: Click the button to create grid guides

Control Descriptions

Grid Parameters

ControlFunction
Rows IconRow count label. Click to increment by 1, Alt+click to decrement by 1, long-press to reset to default. Also supports drag-to-adjust value
Rows InputNumber of rows (1-50)
Col. IconColumn count label. Click to increment by 1, Alt+click to decrement by 1, long-press to reset to default. Also supports drag-to-adjust value
Columns InputNumber of columns (1-50)
Row Gutter IconRow gutter label, supports drag-to-adjust value
Row Gutter InputSpacing between rows
Col. Gutter IconColumn gutter label, supports drag-to-adjust value
Column Gutter InputSpacing between columns

Action Buttons

IconButtonFunction
FramesCreate rectangular path frames in each grid cell. Click to execute current mode, right-click to switch modes
Consider MarginToggle whether to apply Margin-Go-Round margins when creating the grid. When enabled, the grid is created within the margin area
Save PresetSave current settings as a preset
Import PresetImport presets from JSON file
Load PresetLoad a saved preset. Click ★ to set a default preset that loads on startup and when Reset is clicked
PreviewEnter/exit preview mode for real-time guide preview. Red = inactive, green = previewing. Press Esc to exit
Keep/ClearToggle whether to keep existing guides when creating new ones
ResetReset all grid parameters to default values
Create grid guides

Frames and Shapes

The Frames button creates rectangular path frames or shapes in each grid cell. Right-click on this button to switch between modes:

These two features are primarily used for quickly creating image layout templates, particularly suitable for scenarios requiring batch image processing (such as microscope photos or experimental results in scientific papers):

Typical workflow: Set grid parameters → Click Frames/Shapes button (or right-click to switch mode) to create template → Batch place or replace images → Layout complete

Consider Margin Toggle

Load Preset Button

Click the Load Preset button to show the preset menu:

In the preset menu:

Preview Mode

  1. Click the Preview button to enter preview mode (button turns green, eye icon opens)
  2. Adjust any parameter to see guides update in real-time
  3. Click the button to confirm creation, or click Preview again to cancel
  4. Press Esc to quickly exit preview mode

Some Guides Like You

Some Guides Like You takes its name from the Adele song "Someone Like You," playfully reimagined for guides. This tool captures the current guide layout as a snapshot, allowing you to save, export, import, and reapply guide arrangements across documents — perfect for maintaining consistent layouts across multiple files or sharing guide templates with your team.

Workflow

  1. Set up guides in your document (manually or using other GuideMi tools)
  2. Set the Scope (Canvas Only / All Guides) and Direction Filter (H+V / Horizontal / Vertical) to control which guides are captured. These settings are saved with the preset
  3. Click Save Layout to capture and store the current guide arrangement as a named preset
  4. Later, use Load Layout to reapply a saved or recent layout, or Import Layout to load from a file

Control Buttons

ButtonFunctionDescription
Apply to AllBatch applyCaptures guides from the current document (filtered by scope and direction) and applies them to all other open documents. Keep/Clear toggle controls whether existing guides in each target document are preserved or cleared. Requires at least two open documents
ScopeToggle scopeSwitch between Canvas Only (ignore guides outside canvas bounds) and All Guides (include off-canvas guides). Applies to save and apply-to-all operations; when loading or importing, the preset's stored scope is used instead and this button is updated automatically. The button icon dynamically reflects the current guide color and line style (solid/dashed): in Canvas Only mode, only the inner crosshair lines match the guide appearance; in All Guides mode, the entire icon (border and crosshair) matches
Direction FilterToggle directionCycle through H + V (all guides), Horizontal Only, and Vertical Only. Click to cycle, long-press to reset to H + V, right-click for direct selection. Applies to save and apply-to-all operations; when loading or importing, the preset's stored direction filter is used instead and this button is updated automatically
Save LayoutCapture & saveCaptures guides from the current document (filtered by scope and direction) and saves as a named preset. The current Scope and Direction Filter settings are stored with the preset. Optionally exports to a JSON file for sharing
Import LayoutImport from fileOpens a JSON file, saves it as a preset, and immediately applies the layout. Uses the scope and direction filter stored in the file
Load LayoutLoad presetOpens the preset list to select and apply a saved or recent layout. Click ★ to set a default preset that loads on startup and when Reset is clicked. The Scope and Direction Filter buttons are automatically updated to match the preset's stored settings
Keep/ClearToggle modeGreen (✓): Keep existing guides when applying. Red (✗): Clear all guides before applying
ResetReset settingsResets all SGLY settings to defaults: Scope → Canvas Only, Direction Filter → H + V, Keep/Clear → Keep

Scope and Direction Filter

The Scope and Direction Filter buttons control which guides are included in each operation:

This means each saved layout remembers its own scope and direction filter. For example, a layout saved with "Horizontal Only" will always apply only horizontal guides when loaded, regardless of the current button state.

Preset Management

The preset dropdown (accessed via Load Layout) contains two sections:

Both sections support:

Pixel-Perfect Mode

When the target document has the same dimensions as the source document (where guides were captured), guides are applied at their exact pixel positions. When dimensions differ, guides are repositioned proportionally based on percentage.

Geek-Set-Go

Geek-Set-Go takes its name from "Ready, Set, Go," designed for power users who need advanced unequal grid layouts. This tool allows you to create guides with custom ratios or absolute values, offering maximum flexibility for complex layout requirements.

Workflow

  1. Define Target Area: Create a selection, select a layer, or use the entire document
  2. Enter Values: Input ratio or absolute values in the text field
  3. Configure Options: Set mode, direction, and other options
  4. Execute: Click the button to create guides

Input Syntax

Ratio Mode (Default)

In Ratio Mode, values represent proportional divisions of the target area:

InputResult
3Divides into 3 equal parts (like 1;1;1)
1;2;1Divides in 1:2:1 ratio (25%, 50%, 25%)
1;1;2Divides in 1:1:2 ratio (25%, 25%, 50%)
1;2;3Divides in 1:2:3 ratio

Absolute Mode

In Absolute Mode, values represent actual distances in the current unit:

InputResult
50Creates a guide every 50 units, repeating until space runs out
50;100Alternates between 50 and 100 unit segments
50;*;5050 units from start, remaining space in middle (*), 50 units at end
100;*;100;*;100Three 100-unit segments with flexible space between
50;*;*;5050 units at start, remaining space divided equally into 2 parts, 50 units at end
100;*;*;*;100100 units at each end, remaining space divided equally into 3 parts

The * (asterisk) acts as a wildcard for "remaining space" and is only available in Absolute Mode. Multiple asterisks divide the remaining space equally among them.

Control Buttons

IconButtonFunction
ModeToggle between Ratio Mode (pizza icon) and Absolute Mode (grid icon)
MarginToggle whether to consider Margin-Go-Round margins when calculating guide positions
DirectionSet guide direction. Click to cycle, scroll wheel for quick switching, long-press to reset to LTR, right-click for full menu
Save PresetSave current configuration as a named preset
Import PresetImport preset from JSON file
Load PresetLoad a saved preset. Click ★ to set a default preset that loads on startup and when Reset is clicked
Keep/ClearToggle whether to keep or clear existing guides before creating new ones
ResetReset all settings to defaults
Apply the guides

Direction Options

Single-axis directions:

Combined directions (for 2D layouts):

Preset Management

Geek-Set-Go has its own preset system, separate from Grid-and-Go:

Examples

Example 1: Magazine Layout (Ratio)

Example 2: Fixed Margins (Absolute)

Example 3: Equal Divisions (Ratio)

Example 4: Multiple Flexible Spaces (Absolute)

Flyout Menu

Click the hamburger menu icon (☰) in the top-right corner of the plugin panel to access the Flyout Menu.

Menu Items

ItemFunction
HelpOpens the user manual in the system default browser (automatically selects Chinese or English version based on the current interface language)
About GuideMiShows version information, author credits, and copyright notice
Cite This PluginCopies a ready-to-use citation sentence to the clipboard for your legends and Materials & Methods sections
Check for UpdatesConnects to the SciSuite server to check whether a newer version is available. If a new version is found, the release notes are displayed and the download page opens automatically in your browser
Join UsLearn how to contribute to this project; the contact email is automatically copied to clipboard
Deactivate LicenseUnbind the license from this device so it can be activated on another computer. Requires an internet connection. After deactivation, the nag screen will reappear
LanguageSelect interface language from 17 available options

Available Languages

  1. 简体中文
  2. 繁體中文(中國台灣)
  3. 繁體中文(中國香港)
  4. 日本語
  5. 한국어
  6. العربية
  7. Deutsch
  8. English
  9. Español
  10. Español (Latinoamérica)
  11. Français
  12. Indonesia
  13. Italiano
  14. Português (Brasil)
  15. Português (Portugal)
  16. Русский
  17. Türkçe

Language selection is saved and persists between sessions.

License & Activation

GuideMi is a shareware plugin. You can use the fully functional unregistered version with a 30-day trial period. After the trial, please purchase a license to continue using GuideMi.

Nag Screen

Each time Photoshop starts, unregistered users will see a nag screen. To dismiss it:

  1. Read and accept the Terms of Service and Privacy Policy by checking the checkbox
  2. Click the correct button as instructed (e.g., "Please click P greater than 0.05")

The nag screen will not appear once a valid license is activated.

Purchasing a License

Click one of the Registration buttons on the nag screen to open the purchase page in your default browser. Three pricing plans are available:

After completing the purchase, you will receive a license key via email.

Activating a License

  1. Click the Activate button on the nag screen
  2. Enter the email address used for purchase
  3. Enter the license key received via email
  4. Click Activate to verify and bind the license to this device

Once activated, the nag screen will no longer appear, and your license is bound to this device's hardware (MAC address).

Deactivating a License

To transfer your license to another computer:

  1. Open the Flyout Menu (☰) in the top-right corner
  2. Click Deactivate License
  3. The license will be unbound from this device
  4. You can then activate the same license key on a different computer

Note: Deactivation requires an internet connection.

General Operation Guide

Button Interaction Modes

Many buttons in this plugin support multiple interaction methods:

Drag-to-Adjust Values

Icon buttons for grid and margin parameters support drag adjustment:

Scroll Wheel Value Adjustment

When hovering over numeric input fields, use scroll wheel to adjust values:

Unit System

GuideMi supports the following units; all margin and gutter values are converted based on the current unit:

UnitNameStep Value
pxPixels1
%Percent1
cmCentimeters0.1
mmMillimeters1
inInches0.125
ptPoints1
picaPicas0.5

Percentage units are calculated based on the current target area (selection/layer/document) dimensions.

On first launch (when no unit preference has been saved), GuideMi automatically reads Photoshop's current ruler unit and uses it as the default. After that, the plugin remembers your last selected unit independently.

Preset Management

Grid-and-Go and Geek-Set-Go both support preset management:

When exporting presets, you can choose to export to a file for team sharing.

Section Collapse State

Click a Section header to collapse/expand that area; collapse state is automatically saved and restored when the plugin is reopened.

Progress Bar Feedback

When executing time-consuming operations (such as creating grid guides, Frames, or Shapes), the Section header displays an animated indeterminate progress bar at the bottom, providing visual feedback that the operation is in progress.

Keyboard Shortcuts

ShortcutFunction
DeleteClear all guides
EscapeExit preview mode
TabCycle focus through buttons and input fields

FAQs

Q: Why aren't guides created at the expected position?

A: GuideMi determines guide positions in the priority order: Selection > Layer > Document. Please check:

  1. Whether an unexpected selection exists (press Ctrl+D to deselect)
  2. Whether the currently selected layer is correct
  3. If the selected layer is empty, it will fall back to document bounds

Q: How do I create guides at a specific position precisely?

A: Use the Crosshair placement feature:

  1. Click the Crosshair button to enter placement mode
  2. Click the target position on the canvas
  3. Crosshair guides will be automatically created at the clicked position
  4. Right-click the Crosshair button to switch between Color Sampler (default) and 1×1 Marquee methods

Q: Parameters don't respond in preview mode?

A: Please ensure:

  1. The Preview button is in active state (green background)
  2. A document is open in Photoshop
  3. Parameter values are within valid ranges

Q: How do grid guides and margin guides work together?

A: Margin-Go-Round and Grid-and-Go can work together:

  1. First set margins in Margin-Go-Round
  2. Then set grid parameters in Grid-and-Go
  3. Enable the "Consider Margin" toggle in Grid-and-Go
  4. When creating the grid, margins are automatically applied; the grid will be created within the margin area

Q: What's the difference between Grid-and-Go and Geek-Set-Go?

A:

Q: How do I quickly restore default settings?

A:

Q: Where are presets saved?

A: Presets are saved in Photoshop's internal storage and are retained with Photoshop configuration. Use the export feature to save presets as JSON files for backup or team sharing.

Q: How do I change the interface language?

A: Click the hamburger menu (☰) in the top-right corner of the plugin panel, then select your preferred language from the Language section. The setting is saved automatically.

Q: When importing a preset, are existing guides cleared or kept?

A: The behavior depends on the current Keep/Clear toggle state:

This applies to Grid-and-Go, Geek-Set-Go, and Some Guides Like You preset imports. Check the Keep/Clear toggle before importing if you need specific behavior.

Q: How do I create guides for multiple layers at once?

A: Select multiple layers, then use any guide function. Right-click on the Top button to choose:

This setting is global and persists until changed.

Version Information