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 — FWHM, eccentricity, SNR, star count — for the selected frame, with its score and 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.

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), check Include files from subfolders in the open panel. Each subfolder appears as a separate section in the sidebar.

2
Read the session chart

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

Clusters of low dots — a run of frames where the metric (FWHM, SNR, Score…) dips clearly below the dashed median line. 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, and Score.

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 in FITS Blaster, switch to the Rejected view, select the frames, and press U (or X in toggle mode) to move them back.

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 → Keyboard. 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)
⌘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 (e.g. FWHM > 7 px, Score < 40), and preview how many frames match. Apply it, then switch to the Flagged view to eyeball each one before committing to rejection.
Single key reject/undo. In Settings → Keyboard, 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.