Knowledge base

Understand Nocturne

What each step in the pipeline actually does, and how to choose between the options it offers. Installing the app and the tools it drives is its own page: Install & set up.

14pipeline steps
11finishing tools
0destructive edits
0tools needed to start

Getting started

Nocturne turns a stacked smart-telescope image into a finished picture through a guided, non-destructive flow. Nothing you do is permanent until you export, so you can experiment freely — undo, redo, or jump back to any step.

1. Install it

Grab a build from the downloads page — macOS or Linux — and see Install & set up for the first-launch step each platform needs and for the free tools worth adding. None of them are required to start.

2. Open a stack

Choose Open Image and pick a stacked master (.fit / .fits, or a .tif stacked in another tool — see below). Don't have a stack yet? Use Stack to point Nocturne at a folder of raw subs — it grades out the bad frames, aligns the rest (handling the field rotation from an alt-az mount), and integrates a clean master for you. If your subs cover several pointings, tick Mosaic and it stacks each panel, plate-solves them and assembles one wide image. That one needs ASTAP installed, and takes considerably longer. A stack can also run in the background: press Stack in background and the app stays usable while it works, with progress in the Jobs panel.

Opening a TIFF

A master stacked in Siril, APP or DeepSkyStacker can be finished here, and a picture you already finished can still reach Share, Star Spikes, Upscale and the plate-solve annotations. Nocturne works out whether the file is still unstretched — in which case the whole process applies, exactly as for a FITS — or has already been stretched, in which case it opens at the finishing steps and nothing tries to stretch it again. It decides by measuring the pixels and says which it chose, so you can correct it if a starless frame or an unusually bright subject fools it.

A TIFF carries no capture details — no target, frame count, exposure or camera — so the Import panel shows only what can be read from the file and its name, and Nocturne will not guess a camera it was not told about. An embedded colour profile is ignored.

Nocturne at the Import step, with the target, integration, frame count and camera read from the file
What Nocturne read from the file: target, integration, frame count, sensor and image scale — before you change anything.

No data of your own yet? Download a sample set — real Seestar captures, free to use, ready to open.

Raw data looks almost black — that is normal. Astronomical data is linear, so it stays dark until it is stretched. Nocturne previews it stretched so you can see what you are doing, and commits the real stretch when you reach that step.

Why your first open looks like nothing

3. Work down the steps

Each step offers simple choices (often just Light / Medium / Strong) with a live before/after. The panel explains what the step does; once you know it, collapse the help with “How this works” and it stays out of the way. When you're happy, move on with Next.

The external tools

Nocturne drives a few best-in-class tools rather than reinventing them: GraXpert for gradients and denoise, StarNet2 for star separation, ASTAP for plate solving, and RC-Astro if you have it. The first three are free. Every step that can use one also works without it, so none of this blocks you from starting.

How to install each of them, on macOS and Linux →

How the pipeline works

A quick tour of the steps, in the order Nocturne walks you through them. You can skip any you don't need.

Prepare — Stack, Crop, Background

Stack builds a master from raw subs (or you open one directly). Crop trims stacking artefacts at the edges, with composition guides. Background (GraXpert) removes gradients and light-pollution glow so the sky is even and neutral — tick Show what was removed afterwards to see the gradient on its own and confirm it took sky-glow rather than the faint edges of your target.

The same field with the gradient removed A nebula field with a light-pollution gradient across it BeforeBackground removed

Background extraction on IC 1396A. Corner-to-corner brightness across the frame drops by 39% — the glow goes, the nebula stays.

Colour — sky balance or photometric

Colour neutralises the sky and sets white balance. Choose Sky balance (works offline) or Photometric (SPCC), which measures real catalogue stars in your frame to get colour objectively right. Then, if the result is not quite to your taste, two sliders — Green ↔ Magenta and Cool ↔ Warm — shift the overall colour with a live preview. They multiply the channels rather than clipping one, so the colour differences between stars survive: an orange star stays orange next to a blue one. Seestar data tends to land slightly magenta, and that is the camera rather than the stacking, so a small nudge toward green is often all it wants. If you shot a dualband/LP target, Colourise and the Narrowband tool map that Ha + OIII data into a finished two-gas colour image in a single press.

The same nebula mapped to two-gas colour, red hydrogen around a teal oxygen core A dualband master in flat pink before narrowband colour mapping Dualband masterNarrowband

NGC 281 through the Narrowband tool. The oxygen core separates from the hydrogen shell that surrounds it — two gases the camera recorded together, told apart.

Detail & stretch

Deconvolution sharpens tight star and structure detail while the data is still linear (BlurXTerminator, or a free fallback). Stretch is the big reveal — it pulls the faint signal up into the visible range. Recover Core tames blown-out galaxy and nebula cores (HDR), and Levels and Curves fine-tune the tones.

Choosing a stretch by looking at it

The stretch is the one step where there is no right answer, and the honest way to say so is to show you. Visual stretch, on the Stretch panel, opens your own image rendered several ways and asks you to click the one you prefer. It only moves the slider — Apply still commits, and you can nudge the slider afterwards.

It asks two things, one at a time.

Colour first: linked or unlinked. A linked stretch puts one curve through all three channels and keeps the sky’s own colour. An unlinked stretch normalises each channel on its own, which evens the sky out and usually brings out more variety in star and dust colour. Both panels are rendered at the same brightness so that only the colour differs — one decision at a time. Neither is labelled the correct one, because neither is: they are two defensible readings of the same data.

The Visual stretch window asking linked or unlinked, the same nebula shown twice at matching brightness
Pick one of two: Linked keeps the sky’s own colour, Unlinked evens the channels out. Same brightness in both, so only the colour is being judged.

Then brightness. Six real stretches of your image, from darkest to brightest, each labelled with the slider value it lands on and the sky level it produces. Click the picture you like. A darker sky looks cleaner, because the same grain is far less visible on it — but pull too far and faint nebulosity stops being visible at all, and that loss cannot be recovered later. There is genuinely no universal answer: across four of our own targets the same photographer wanted the darkest option three times and something two steps brighter on the fourth.

The Visual stretch window showing six versions of the same nebula from darkest to brightest
Six real stretches of your own image. The name is a handle; the numbers are the slider value you land on and the sky level it gives you.

You can also make the colour choice earlier, at Import, where a Linked / Unlinked switch changes only how the unstretched data is drawn. Nothing is committed there — it is a way to see what is in the file before deciding anything — and whichever you pick becomes the starting point when you reach Stretch. One consequence worth knowing: an unlinked stretch undoes a photometric colour calibration completely, because normalising each channel is exactly what removes a per-channel correction. Choose unlinked and Nocturne skips the Colour step rather than letting you pay for one that would have no effect.

Nocturne at the Stretch step: five completed steps ticked off in the list, the stretch controls, and the histogram
Mid-pipeline at Stretch. Completed steps stay ticked and revisitable, and the log records what each one changed.
The same image with the black point set A stretched nebula with a raised, milky black point BeforeLevels

Levels on the same frame: setting the black point takes the sky from 42 to 27 and the picture stops looking washed.

Finish

Saturation (with a masked nebula boost), De-green Stars, Noise Reduction, Local Contrast and Star Reduction put on the final polish — each with a live preview and its own undo. Star reduction and the star-aware steps work even without RC-Astro, using a built-in star separator. Star Spikes can add artistic diffraction spikes if you like the look.

The same crop with the grain removed and the stars intact A grainy stretched nebula at full pixel scale BeforeDenoised

Noise Reduction, shown at full pixel scale rather than shrunk to fit. Background noise falls by 93% and the stars keep their brightness.

The same nebulosity with mid-scale structure lifted Flat nebulosity before local contrast BeforeLocal Contrast

Local Contrast adds 31% more mid-scale structure. It lifts the background grain with it, which is why it belongs after denoise.

The same field with the stars pulled back so the nebula reads A star-dominated field before star reduction BeforeStars reduced

Star Reduction takes 13% out of the star area. The bright cores stay sharp points; it is the faint wings that go.

Enhancements & Export

Enhancements offers eleven tap-to-stack finishing moves — hue-selective colour boosts, vibrance, star colour, sky darken/lighten, dark structure, soft glow and nebulosity sharpening. Each tap is its own undoable nudge, so you can dial the effect in precisely. Export writes a finished 16-bit image (and, if you plate-solved, burns in the annotations and keeps the WCS in exported FITS).

Late fixes — Trim & fullscreen

Trim is the crop for artefacts you could not see at the start. The first crop happens on linear data that is nearly black, so ragged stacking edges and smeared corners often only appear once you have stretched — and going back to Crop would throw away every step since. Trim appends a crop at the END of your history instead, with the same aspect ratios and composition guides. Press F at any point for fullscreen: everything except the picture steps aside, which is how you judge noise and star shapes without the interface competing for attention.

Colour, at the end

Colour Balance (toolbar) is for the finishing colour work that used to mean exporting to another program. Pick a tonal range — shadows, midtones or highlights — and push it toward a colour; each range keeps its own settings, so you can warm the midtones and cool the highlights in one go. Then narrow Limit to so the change only touches a band of brightness: on a galaxy, that lets you colour the arms and leave the golden core alone. Tick Show the mask and the areas that will change light up while the rest dims, so you can see exactly where it lands. Your stars are separated out and laid back untouched, and because it appends to your history it never discards work you have already done — run it twice with different settings if you want.

Some problems only become visible once the image is stretched. A ragged stacking border at the frame edge is the classic one: invisible in the linear data, obvious at the end. Going back to the Crop step would work, but it discards every step taken since — an hour of work to remove twenty pixels. Trim exists for exactly this: it's a finishing tool, not a pipeline step, so it appends to your history rather than reaching back into it. Your whole edit survives, and undo still works.

To find those edge problems in the first place, press F for a distraction-free fullscreen canvas and pan and zoom around the frame. Esc brings the panels back.

Plate solving & annotation

With ASTAP installed, Plate Solve works out exactly where your image points. Nocturne then identifies the target and can overlay deep-sky object labels, named bright stars, a compass and a scale bar — a great way to learn what's actually in your frame. Toggle the overlay on and off, and it burns into PNG exports if you want to keep it.

Nocturne's plate-solve annotation overlay identifying objects in a nebula field
Plate-solved and annotated — 13 objects found, with the compass, scale bar and RA/Dec grid overlaid on the image.
New to plate solving? See the ASTAP setup — you'll need the app plus its D05 star database.