Knowledge base

Understand Nocturne

Updated

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.

New to Nocturne? Start here for a first picture with a free sample file, or read Getting started. Need to understand the order? Read How the pipeline works.

Getting started

Nocturne turns a stacked smart-telescope image into a finished picture, one guided step at a time. Nothing is permanent until you export, so you can experiment freely: undo, redo, or go back to any step.

1. Install it

Download Nocturne for macOS, Linux or Windows from the downloads page. Install & set up explains the first-launch step each platform needs, and the free tools worth adding. You don’t need any of them to start. What Nocturne works with lists the telescopes, files and computers.

Laptop screens

Nocturne works on any screen from 1280 × 800 up. On a Mac that means the size under System Settings → Displays marked “Looks like”, not the panel’s pixel count; on Linux it is the screen resolution. On Windows it is the resolution divided by the Scale setting under Settings → System → Display.

  • 1280 × 800 and up: it works. Choose Icons only for the toolbar in Settings → General, and the tools that still do not fit sit under More. Curves opens its large editor from a button instead of squeezing the curve into the panel, and Stack starts with its help, options and chart folded, one click from open.
  • About 1440 × 900: comfortable. A 13-inch MacBook Air’s default (1470 × 956) and a 16-inch MacBook Pro’s (1728 × 1117) are here: everything shows, Stack with its chart open.
  • 1920 × 1080 or an external display: best. Room for the preview beside the panels, and for the Plate Solve window beside the picture.
Curves on a 1280 by 800 screen: instead of a cramped curve in the panel, a button opens the large curve editor
On a small screen, Curves opens its large editor from a button.

2. Open a stack

Choose Open Image and pick a stacked master: a .fit or .fits file, or a .tif stacked in another program (see below). No stack yet? Point Stack at a folder of raw subs. It sets aside the poor frames, aligns the rest, including the field rotation of an alt-az mount, and combines them into a clean master. If your subs cover several pointings, tick Mosaic: Nocturne stacks each panel, plate-solves them and joins them into one wide image. Mosaic needs ASTAP and takes considerably longer. Press Stack in background to keep using the app while it stacks, with progress in the Jobs panel.

Opening a TIFF

A master stacked in Siril, APP or DeepSkyStacker can be finished here. A picture you have already finished can still use Share, Star Spikes, Upscale and the plate-solve annotations. Nocturne measures the pixels to tell whether the file is still unstretched or already stretched. An unstretched file goes through the whole process, just like a FITS. A stretched one opens at the finishing steps, so nothing stretches it twice. Nocturne says which it chose, and you can correct it if a starless frame or an unusually bright subject fools it.

A TIFF doesn’t record capture details such as the target, frame count, exposure or camera. The Import panel shows only what can be read from the file and its name, and Nocturne won’t guess the camera. An embedded colour profile is honoured: the picture is converted as it opens, so it looks the same as in the program that saved it.

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 and ready to open.

Raw data looks almost black, and that is normal. Astronomical data is linear, so it stays dark until it is stretched. Nocturne shows you a stretched preview so you can see what you’re doing, and applies the real stretch when you reach that step.

Why a raw image looks black

3. Work down the steps

Each step offers a few simple choices, often just Light, Medium and Strong, with a live before-and-after view. The panel explains what the step does. Once you know, fold the help away with “How this works” and it stays folded. When you’re happy, click Next.

The external tools

Some jobs are done by separate programs that Nocturne runs for you: GraXpert for gradients and denoise, StarNet2 for separating stars, 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 you can start without any of them.

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

Settings

Settings has three tabs. External tools is where Nocturne looks for GraXpert, RC-Astro, StarNet2 and ASTAP. It finds them in their usual places on its own; Test checks one, and Download opens its page.

The External tools tab of Settings: GraXpert, RC-Astro, StarNet2 and ASTAP, each found, with Browse, Test and Download beside it
Each tool's path, whether it was found, and where to get it.

General shows which version you have (Check now asks whether a newer one is out), your default folder, the handle printed on shared images, and whether the toolbar shows icons with text or icons only. Privacy lists the two things Nocturne sends on its own, the update check and an anonymous daily count, each explained beside its switch.

The General tab of Settings: version with Check now, default folder, handle and toolbar style
General.
The Privacy tab of Settings: the update check and the anonymous daily count, each with its explanation
Privacy.

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. Afterwards, tick Show what was removed to see the removed glow on its own, and check that it took sky glow and not 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. The difference in brightness from corner to corner falls by 39%: the glow goes and the nebula stays.

Colour — sky balance or photometric

Colour neutralises the sky and sets the white balance. Choose Sky balance, which works offline, or Photometric (SPCC), which measures catalogued stars in your picture to get the colour objectively right. If the result isn’t quite to your taste, two sliders, Green ↔ Magenta and Cool ↔ Warm, shift the overall colour with a live preview. Photometric colour steps aside on pictures shot through a dual-band filter, because star colours seen through it don’t match the catalogue; Nocturne balances on the sky instead and says so. They scale 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 come out slightly magenta, because of the camera rather than the stacking, so a small nudge toward green is often all it needs. If you shot through a dual-band filter, Colourise and the Narrowband tool turn the Hα and OIII data into a two-gas colour picture in a single click.

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

NGC 281 through the Narrowband tool. The oxygen core stands apart from the hydrogen shell around it, although the camera recorded both gases together.

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 lifts the faint signal 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 with no right answer, so Nocturne lets you choose by eye. Visual stretch, on the Stretch panel, shows your own image stretched several ways, and you click the one you prefer. It only sets the slider: Apply still commits, and you can fine-tune 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 balances each channel on its own, which evens out the sky and usually brings out more variety in star and dust colour. Both are shown at the same brightness, so you judge only the colour. Neither is marked as correct, because both are fair 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 gives. Click the picture you like. A darker sky looks cleaner, because the same grain shows much less on it. Go too dark, though, and faint nebulosity disappears, and that loss can’t be recovered later. There is no universal answer: across four of our own targets, the same photographer chose the darkest option three times and one 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, each showing the slider value it lands on and the sky level it gives.

You can also make the colour choice earlier, at Import, where a Linked / Unlinked switch changes only how the unstretched data is displayed. Nothing is committed there; it lets you see what is in the file before you decide anything. Whichever you pick becomes the starting point at Stretch. Worth knowing: an unlinked stretch completely undoes a photometric colour calibration, because balancing each channel on its own removes exactly that kind of correction. So if you choose unlinked, Nocturne skips the Colour step rather than having you run one that would make no difference.

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.

Curves opens a large editor for finer control: drag the curve for all three colours at once or for one channel, or aim it at a single colour range such as the blues. Presets such as Add contrast and Lift faint detail give you a starting point.

The Curves editor: the blue channel's curve bent below the diagonal in the shadows, the Blues range selected, and a live preview of the nebula
The blue channel, aimed at the blues, with the preview updating as you drag.

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 finishing touches: colour boosts for single hues, vibrance, star colour, sky darken and lighten, dark structure, soft glow and nebulosity sharpening. Each tap is a small step you can undo, and taps add up. Export writes the finished image as a 16-bit TIFF, a PNG or a FITS. If you plate-solved, the annotations are burned in, and an exported FITS keeps the WCS. Every export is tagged with its colour space, so other programs show it as you see it here. sRGB is the default and almost always right. A 16-bit TIFF can also be written in Display P3, Adobe RGB or ProPhoto RGB, for a program that works in that space. A wider space adds no colour; it only changes how the same colours are recorded. It isn’t offered for 8-bit PNG, where it would cause banding in smooth gradients.

Late fixes: Trim and fullscreen

Trim is a crop for flaws you couldn’t 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 after the stretch. Going back to Crop would throw away every step since, so Trim adds a crop at the end of your history instead, with the same aspect ratios and composition guides. Your whole edit survives, and undo still works.

To find edge problems and judge noise and star shapes, press F for fullscreen: everything but the picture steps aside, and you can pan and zoom around the frame. Esc brings the panels back.

Colour, at the end

Colour Balance, in the toolbar, is for finishing colour work you would otherwise do in 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 affects 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. Your stars are separated out and put back untouched. Colour Balance adds to your history rather than replacing work, so you can run it twice with different settings.

Plate solving & annotation

With ASTAP installed, Plate Solve works out exactly where your image points. Nocturne then identifies the target and can overlay labels for deep-sky objects and named bright stars, a compass and a scale bar, which is a good way to learn what is in your picture. You can turn the overlay on and off, and burn it into PNG exports to keep it.

Nocturne's plate-solve annotation overlay identifying objects in a nebula field
Plate-solved and annotated — 11 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.