Getting Started

A guided walkthrough of the FITS Blaster workflow — from opening a folder to handing off clean frames to your stacking tool.

The Interface

FITS Blaster has four main areas. You will use all of them during a typical culling session.

Sidebar (left)

Thumbnail strip of all loaded frames, grouped by filter. The three pills at the bottom switch between All, Flagged, and Rejected views.

Main viewer (centre)

The currently selected frame, stretched for visual inspection. File name and a summary of key metrics are shown in the info bar below it.

Session chart (bottom)

One dot per frame, plotted in capture order. Dot colour is the filter group. Brightness shows rejection/flag state. A white dot marks your current position.

Inspector (right, Geek mode)

Exact metric values for the selected frame: FWHM, Eccentricity, SNR, Stars, Sky Background, PSF Signal Weight, and the composite Score, plus any quality warnings.

Simple vs Geek mode — press G to toggle. Simple mode hides metrics and the session chart for a quick visual pass. Geek mode enables the full quality analysis. The toolbar button shows the current mode name.

Display Controls

A slim controls bar sits below the image viewer. All three sliders are non-destructive display adjustments — they never touch the original FITS data.

Zoom

Scales the image from 0.25× to 4×. Click the icon or the percentage label to jump to 1:1, or the fit button (↖↘) next to it to fit the whole image in the viewer. Pinch on the trackpad also zooms. The zoom level persists across restarts.

Target Background

Sets the desired sky background brightness (0.05–0.50, default 0.25). The STF auto-stretch targets ~0.25, so the default is a no-op. Lower values (0.10–0.15) darken the background; higher values (0.25–0.40) suit images with large extended objects. Persists across restarts.

Stretch

Post-stretch contrast multiplier (0.5×–3.0×, default 1.0×). Increasing it brightens mid-tones and brings out faint structure; decreasing it flattens contrast. Resets when a new session is loaded.

Zoom anchor. Click anywhere on the image to pin a point of interest — a crosshair marks it. All zoom changes then keep that point centred. Click the lit scope icon to re-centre the viewport on the anchor after scrolling. Click the crosshair itself to clear it. The anchor persists across image navigation, so the same sky region stays in view as you step through frames.

The Basic Workflow

1
Open your folder

Press ⌘O or drag a folder onto the window. FITS Blaster starts loading and measuring quality metrics immediately — you can begin reviewing before the full set has finished loading.

If your session spans multiple subfolders (e.g. one per filter or night), turn on Include files from subfolders in the popover that appears when you click Open Folder… or press ⌘O. Each subfolder appears as a separate section in the sidebar.

No images at hand? Download the M31 sample set (255 MB, eight colour frames) to follow along.

2
Read the session chart

Glance at the dot chart at the bottom. Each dot is one frame, coloured by filter group. Look for:

Runs of bad frames — a stretch of frames where the metric is clearly worse than the dashed median line (higher FWHM, Ecc, or Sky BG; lower SNR, Stars, PSF·S, or Score). This usually means clouds, wind, a focus drift, or a guiding glitch. Use the metric buttons above the chart to switch between FWHM, Ecc, SNR, Stars, Sky BG, PSF·S (PSF Signal Weight, which drops with both haze and poor seeing), and Score. The button at the end of the row switches between dots and bars.

Isolated outliers — single bad frames scattered through an otherwise good session.

Click any dot to jump to that frame in the viewer. The dot turns white to mark your position.

3
Collect suspects into the Flagged view

The Flagged view is a review queue — frames you want to inspect more closely before deciding. Nothing is moved on disk yet.

From the session chart: drag across a run of bad dots. A confirmation sheet lets you add them to the Flagged view in one step.

From the sidebar: use ⇧↑ / ⇧↓ or ⇧+click to build an orange range, then press F to flag the whole range at once.

One frame at a time: navigate with ↑ / ↓ and press F to toggle the flag on any frame.

Automatically: click Auto-Flag in the toolbar to flag all frames that fall below configurable quality thresholds. You can preview the result before applying it.

4
Review and reject in the Flagged view

Switch to the Flagged view using the pill at the bottom of the sidebar. Now you see only your suspect frames.

Step through them with ↑ / ↓. For each frame, decide:

Reject it — press X. The frame is moved to a REJECTED/ subfolder immediately. It stays visible in the Flagged view so you can undo straight away by pressing X again (or U if toggle mode is off).

Keep it — press F to remove it from the Flagged view, or just leave it; flagged-but-not-rejected frames are not moved anywhere.

To reject a batch in one go: use ⌘A to orange-select all flagged frames, then X to reject them all. Use ⌘R to orange-select any that have already been rejected so you can undo them in bulk.

5
Hand off to your stacking tool

Point PixInsight, Siril, AstroPixelProcessor, or any other stacking tool at the same folder. Rejected frames are in REJECTED/ and will not appear in a normal folder scan.

Changed your mind? Reopen the folder with Include REJECTED folder turned on in the Open Folder popover, switch to the Rejected view, select the frames, and press U (or X in toggle mode) to move them back.

Want a record of the session? Click Export… to save a CSV, TSV, or text report with every frame's metrics and any FITS header values you choose (see the FAQ).

Two Things That Look Similar but Are Not

FITS Blaster has two independent selection systems. Understanding the difference makes everything else click.

Cursor (blue highlight)

The single frame shown in the viewer. Move it with ↑ / ↓ or by clicking. It never affects the Flagged view or triggers any batch operation on its own.

Range selection (orange highlight)

A group of frames used for batch operations — reject, flag, or unflag all at once. Built with ⇧↑ / ⇧↓ or ⇧+click. Cleared with ⌘D or any plain click.

When a range is active, action keys operate on the range, not just the cursor. Press X to reject the whole range. Press F to flag or unflag the whole range. ⌘A selects all visible frames; ⌘I inverts the selection.

Keys at a Glance

Every shortcut is configurable in Settings → Interface. These are the defaults.

Navigation

↑ / ↓Previous / next frame (moves cursor)
⇧↑ / ⇧↓Extend orange range selection
Home / EndFirst / last frame

Rejection

XReject the cursor or the orange range (moves frames to REJECTED/)
UUndo rejection (moves frames back). In toggle mode, X does both.

Flagging

FToggle flag on the cursor or orange range
DDeflag all — clear the entire Flagged view

Range selection

⌘ASelect all visible frames (orange)
⌘DClear the orange range
⌘IInvert the orange range
⌘RSelect all rejected frames visible in the current view

View & display

GToggle Simple / Geek mode
CToggle colour / greyscale (OSC cameras)
RRemove the current frame from the list (does not touch the file)
PPlay / pause — auto-advance through the frames
VFlip the image 180° for display (does not touch the file)
⌘OOpen a folder

See the full keyboard shortcut reference for mouse shortcuts and more detail on each action.

Tips for Large Sessions

Sort by quality score. In the sidebar sort dropdown, choose Score and set direction to ascending. Your worst frames are now at the top. ⇧+click the last clearly-bad frame to orange-select the whole bad tail, then press X to reject them all at once.
Use Auto-Flag for a first pass. Click Auto-Flag in the toolbar, set thresholds (relative to each filter group's median by default, or fixed values such as FWHM > 7 px or Score < 40 in Absolute mode), and preview how many frames match. To catch haze or thin cloud, turn on the Sky BG and PSF Signal Weight criteria. Apply it, then switch to the Flagged view to eyeball each one before committing to rejection.
Single key reject/undo. In Settings → Interface, turn on Single key reject/undo (toggle) and assign it to the spacebar. You can then reject and undo with one thumb while navigating with the other hand. Many users prefer this to the two-key default.
You do not need to wait. FITS Blaster pipelines loading, stretching, and metric computation in parallel. By the time you have finished scanning the first frames in the sidebar, the rest of the session is usually done.