Clean, consistent PixInsight workspaces.

Chapel Astro Utilities batch-processes open PixInsight images with focused tools: apply automatic screen stretches, turn long stacked master frame names into readable identifiers, save batches deliberately, and line up open windows to a chosen reference.

Batch tools Process many open images from one PixInsight menu.
Filter aware L, R, G, B, H, O, S, and OSC rename defaults.
Easy inspection Auto-stretch selected images, then align them for comparison.

Built for the messy middle of image processing.

PixInsight can generate beautifully calibrated data, wildly long window names, and image windows that all open at different sizes. These utilities keep the workspace readable when you are moving fast.

1

Reveal linear images

Apply a linked or unlinked automatic ScreenTransferFunction to selected open images without changing their pixel data.

2

Line up open images

Use one image as the reference, then batch-match the other open windows to its zoom, frame size, and pixel dimensions when needed.

3

Reduce naming friction

Batch-rename mono stacked masters into clean filter identifiers, then append processing-stage suffixes as the workflow develops.

4

Save with confidence

Choose between batch rename-only, save-as output, and overwrite saves back to each image source folder.

Inspect a whole image set in one pass.

BatchSTFStretch brings PixInsight's familiar automatic screen stretch to a selectable batch. Check the images you want, choose how RGB channels should be treated, and apply or reset the display stretch together.

  • Linked mode preserves the relative RGB channel balance.
  • Unlinked mode calculates an independent stretch per channel.
  • Select All, Select None, and Refresh keep large sessions manageable.
  • Reset Screen Transfer returns selected images to an identity STF.
  • The operation changes only the display—not the underlying pixels.
BatchSTFStretch 1.0.0 dialog in PixInsight showing image selection, linked and unlinked stretch modes, Apply Auto Stretch, and Reset Screen Transfer controls

Recommended workflow order.

Make linear images visible, align the workspace for comparison, then clean the names and save each processing stage deliberately.

1. Apply a batch screen stretch

Select the linear images you want to inspect, choose linked or unlinked channel handling, and apply an automatic STF without altering image pixels.

2. Resize images to reference

Select a reference image and batch-match the other open windows to its zoom and frame. If their pixel dimensions differ, the utility resamples them to the reference dimensions.

3. Shorten long file names

Follow the wizard to match words such as Red, Hydrogen, or Nofilter in the file path, caption, or image ID and batch-rename them to concise identifiers such as R, H, or OSC.

4. Mark and save processing stages

Append suffixes such as PreNoiseX or PostCrop, then save source-backed images in place or choose a folder for newly created images.

PixInsight workspace showing long master light names before filter renaming
Stacked master lights on the left carry long generated names across the top bar and side tabs. On the right are images with names derived from a custom filter mapping table. Options exist so source images can remain open, collapsed, or closed.
PixInsight workspace showing renamed LRGB files and pre-processing suffix files
After: saved output uses concise filter identifiers and processing-stage suffixes.

What each utility does.

All three scripts live under the same PixInsight menu, but they solve different workspace problems.

BatchSTFStretch

A selectable batch utility for making linear images visible without changing their pixel data.

  • Lists all open main images with individual checkboxes.
  • Includes Select All, Select None, and Refresh controls.
  • Applies a linked RGB stretch to preserve relative channel balance.
  • Applies an unlinked per-channel stretch when independent channel balancing is preferred.
  • Resets the ScreenTransferFunction on the selected images.

ImageBatchManager

A wizard-led batch naming and save workflow for open image windows. It is especially useful straight after stacking, when mono master frames inherit long file names from the integration process, and it also handles OSC data through editable mappings.

  • Guides rename, selection, save, reopen, and summary steps through a simple wizard.
  • Batch-maps filename, caption, or view-id text to short filter names.
  • Targets mono filter sets first, with default LRGB/SHO-style mappings plus NoFilter to OSC for one-shot colour images.
  • Stores editable user mappings between sessions.
  • Batch-appends PixInsight-safe processing suffixes to current names.
  • Renames one selected image with an ad-hoc identifier.
  • Saves renamed images, reopens saved output, and can close or collapse sources.
  • Overwrites selected files using the current open image name and source folder.

MatchOpenImageSizes

A batch visual consistency tool for comparing open images. Choose the image that already looks right, then bring the rest of the workspace into line.

  • Uses the selected image window as the reference.
  • Copies the reference zoom factor to all other open images.
  • Copies the reference window frame size when PixInsight exposes writable geometry.
  • Resamples images whose pixel dimensions differ from the reference.
  • Leaves the reference image unchanged.
  • Supports PixInsight process icons for repeated reference-based use.
PixInsight workspace showing images renamed with a PreABE suffix and collapsed source icons stacked vertically
Suffix workflows can keep the current filter name and add the processing state, while collapsed source images are stacked into a tidy column.
PixInsight workspace showing image windows aligned after running MatchOpenImageSizes
MatchOpenImageSizes batch-aligns open windows into a consistent display layout based on the selected reference.

Install through PixInsight updates.

Add the repository once, then update from PixInsight whenever a new Chapel Astro Utilities package is published.

Repository URL

https://raw.githubusercontent.com/GrandPaClanger/pixinsight-toolbox-scripts/main/
  1. Open Resources > Updates > Manage Repositories.
  2. Add the repository URL above.
  3. Run Resources > Updates > Check for Updates.
  4. After installation, use Script > Chapel Astro Utilities.

User guide.

Choose the utility for the job, select the open images involved, and use the focused controls below to stretch, rename, save, or align them.

BatchSTFStretch

  • Select images: tick only the open images whose screen display should change, or use Select All and Select None.
  • Choose Linked: use one shared stretch for RGB channels to preserve their relative balance.
  • Choose Unlinked: calculate each RGB channel independently to neutralize strong channel imbalance in the display.
  • Apply Auto Stretch: updates only the selected images' ScreenTransferFunction display; pixel values remain unchanged.
  • Reset Screen Transfer: returns the selected images to an identity screen transfer.

ImageBatchManager

  • Choose a mode: the wizard starts by asking whether to use filter mappings, append a suffix, or rename one image. Apply stays disabled until a mode is selected.
  • Edit mappings: add, update, or delete rows in the mapping table. More specific matches win before generic ones.
  • Mono first, OSC ready: filter renaming is aimed at mono master lights such as L, R, G, B, H, O, and S, but OSC users can map NoFilter or their own camera naming convention to OSC.
  • Use valid names: output identifiers must start with a letter or underscore and only contain letters, digits, or underscores.
  • Select the batch: checked preview rows are processed. Collapsed windows are unchecked by default when PixInsight exposes that state.
  • Apply Rename / Append: batch-renames open images. If saving is not enabled, images are not closed, collapsed, or saved.
  • Save images after renaming: saves the renamed output to the selected folder and can reopen saved images.
  • After save: leave, close, or collapse selected source images.
  • Single Image Rename: select exactly one preview row, enter an ad-hoc name, and rename both the side tab and top caption.
  • Save & Overwrite Selected: choose Save selected images only on Step 1, tick the images on Step 2, then save them back to their source folders using their current open image names.
  • Save newly created images: if a selected image has no source path because it was created inside PixInsight, choose one destination folder when prompted. Images that already have source paths still save in their original folders.

MatchOpenImageSizes

Use this companion utility when open images need to match a selected reference image. It copies the reference zoom and attempts to match the frame size where PixInsight exposes that geometry.

  • Pick the reference: click the image window with the size, zoom, and dimensions you want to keep.
  • Run the utility: open Script > Chapel Astro Utilities > MatchOpenImageSizes.
  • Confirm the summary: the script reports the reference image, pixel size, zoom, and frame size before making changes.
  • Let it match the rest: every other open image is batch-matched to the reference zoom and frame size.
  • Understand resampling: if another image has different pixel dimensions, it is resampled to the reference width and height.
  • Continue into naming: after matching, run ImageBatchManager separately from the same Chapel Astro Utilities menu.
  • Use process icons: drag the New Instance triangle to the workspace, then drag that process icon onto an image to use it as the reference.
  • Know the limit: if PixInsight does not expose writable window geometry, the script still matches zoom and dimensions but may not be able to copy the frame size.
PixInsight workspace before resizing, with open image windows at different zooms and sizes
Before: open images can end up at different zoom factors and frame sizes, making visual comparison awkward.
PixInsight workspace after resizing, with open image windows matched to the selected reference
After: the selected reference drives the display size, zoom, and dimensions of the other open image windows in the batch.

Designed to protect the session you are in.

These scripts are intentionally direct, but they include guardrails for the naming and saving decisions that are easiest to get wrong late at night.

Identifier checks Ad-hoc names must follow PixInsight identifier rules and cannot duplicate another open image ID.
Selection preview The preview shows current, matched, new, and status columns before batch operations run.
Overwrite confirmation Overwrite operations ask once for the batch, then save selected images deliberately.
Folder defaults The save folder defaults to the source directory used by the majority of open images.
Reference preserved MatchOpenImageSizes leaves the selected reference image unchanged.
Resample warning Images with different pixel dimensions are resized to the reference, so choose the reference deliberately.

Spend less time decoding tabs and more time processing data.

Chapel Astro Utilities keeps PixInsight workspaces legible and consistent from stacked masters through comparison, processing, and final pre-stretch saves.