Quantum Photoboom docs

Getting Started & Features Guide

Learn the layout, menus, export options, cropping workflow, and adjustment tools available in Quantum Photoboom.

Documentation

Quantum Photoboom — User Guide

This getting started guide explains how to use Quantum Photoboom: the menu bar, the editing sidebar, the filmstrip, and what each adjustment does.


Window layout

AreaWhat it is
Left sidebarHistogram at the top, then collapsible Editing Controls sections. Click a section title to expand or collapse it.
Top of sidebarHide Edits / Show Edits — toggles whether your adjustments appear on the main preview (before/after).
Main areaLarge live preview of the active photo. Scroll when the image is larger than the view. Double-click the preview to Fit To Window.
BottomFilmstrip — thumbnails for every photo in the open photobook.
FooterName of the open photobook, photo count, app version, and update notice when available.

Application menus

File

ItemWhat it does
New PhotobookCreate a new, empty photobook (you name it in a dialog).
Open PhotobookPick an existing photobook from a list and open it.
Export PhotobookExport all photos in the current photobook.
Manage PhotobooksRename or delete photobooks, or remove individual photos from a photobook.
Import PhotosAdd image files to the photobook that is currently open (available after a photobook is open).
Export Selected PhotosExport only the photos selected in the filmstrip (see Filmstrip).

Edit

ItemWhat it does
UndoReverts the last edit change (shortcut shown in the menu, typically ⌘Z / Ctrl+Z).
RedoReapplies an undone change (⌘⇧Z on macOS, Ctrl+Y on Windows/Linux, as shown in the menu).
CropEnters crop mode on the active photo (see Crop).
Remove CropClears the crop on the active photo (available when a crop exists).
Convert to Black and White / Convert to ColorToggles black-and-white treatment for the active photo. The menu label switches to match the action you will get.
Reset Current Photo’s EditsReturns all sliders and related settings for the active photo to their defaults.

View

ItemWhat it does
Zoom In / Zoom OutSteps the preview zoom level.
Fit To WindowScales the preview so the whole image fits and resets pan to the center.
Switch To Dark Mode / Switch To Light ModeToggles light or dark appearance (the label shows the mode you will switch to).

Help

ItemWhat it does
AboutApp information and contact details.
View LicenseShows your current license status.
Activate LicenseOpens the license key dialog.

Histogram

At the top of the sidebar, the Histogram shows how bright and dark tones are distributed in the current preview.

Below the chart, five labels mark broad regions: Blacks, Shadows, Exposure, Highlights, and Whites. Moving the pointer across the histogram highlights the region you are over, which helps you decide which tone sliders to use.


Filmstrip

The filmstrip is the horizontal row of thumbnails along the bottom of the window.

Selecting and navigating

  • Click a thumbnail to make that photo active — it appears in the center preview and receives any edits you make.
  • The active photo has a blue border.
  • ⌘+click (macOS) or Ctrl+click (Windows/Linux) toggles whether a photo is included in a multi-selection for export. Selected photos also show a green outline.
  • Scroll horizontally when there are more photos than fit on screen.

Edited badge

A small Edited label on a thumbnail means that photo has adjustments that differ from the defaults.

Right-click menu

Right-click (or Control+click on macOS) a thumbnail to open a short menu:

ActionWhat it does
Reset Photo's EditsClears all edits on that photo.
Export PhotoOpens the export dialog for that photo only.
Remove PhotoRemoves the photo from the photobook (you will be asked to confirm).

Export dialog

When you choose Export Selected Photos or Export Photobook, you can set:

  • Format — JPEG, PNG, or WEBP.
  • Max Dimension (px) — Caps the longest side; use 0 for no cap (full resolution, within other settings).
  • Naming Pattern — How files are named; {name} and {index} are common placeholders.
  • Destination Folder — Where files are saved. Use Browse… to pick a folder.

Click Export to start, or Cancel to close without exporting.


Crop

Choose Edit → Crop to place a crop frame on the preview. The frame has corner and edge handles and a rule-of-thirds grid.

ControlWhat it does
Drag the frame or handlesMove or resize the crop.
AspectFree, 1:1, 4:5, 3:2, or 16:9.
LockKeeps the chosen aspect ratio while resizing.
W / HSet export width and height in pixels; swaps W and H.
CancelExit crop mode without applying.
DoneApply the crop and return to normal editing.

Keyboard (when crop mode is active and focus is not in a text field):

  • Arrow keys — Nudge the crop box.
  • Shift + arrows — Resize instead of move.
  • Alt (Windows/Linux) or Option (macOS) — Smaller nudge steps.

Use Edit → Remove Crop to clear an applied crop.


Editing controls

Each slider has a matching number field. You can drag the slider, type a value, or drag horizontally on the number field to scrub. Double-click the slider or number to reset that control to its default.

Sections are grouped in collapsible panels (Basic, Tone Curve, and so on).

Basic

ControlEffect on the photo
TemperatureShifts overall color toward warmer (yellow/orange) or cooler (blue).
TintBalances green versus magenta in the image.
ExposureBrightens or darkens the entire image.
ContrastIncreases or decreases separation between lights and darks overall.
HighlightsTargets bright areas — recover detail in blown highlights or brighten them further.
ShadowsTargets dark areas — lift shadow detail or deepen shadows.
WhitesSets how bright the brightest tones can become (white point).
BlacksSets how dark the deepest tones can become (black point).
TextureEnhances or softens medium-scale detail (skin texture, fabric weave) without strongly changing overall contrast.
ClarityAdds midtone contrast and local punch; strong values can look gritty or harsh on faces.
DehazeCuts through haze and flatness, or adds a foggy look when reduced.
VibranceBoosts muted colors more than colors that are already strong — useful for natural-looking saturation.
SaturationRaises or lowers color intensity across the whole image.

Tone Curve

Parametric sliders bend tone in four zones before the point curve:

ControlEffect
Parametric highlightsBrightest tonal region above the main highlight range.
Parametric lightsUpper midtones and lighter areas.
Parametric darksLower midtones and darker areas.
Parametric shadowsDeepest shadow region.

Point curve

  • Choose Channel: RGB for overall tone, or Red, Green, or Blue for per-channel curves.
  • Click the graph to add a point; drag points to reshape contrast. The corner points stay fixed.
  • Reset Curve restores a straight diagonal for the current channel.

Sharpening

ControlEffect
AmountOverall sharpening strength.
RadiusHow wide the area around each edge is sharpened.
DetailEmphasis on fine versus coarse structure.
MaskingRestricts sharpening to stronger edges; higher values leave smooth areas (sky, skin) softer. While dragging Masking, hold Alt (Windows/Linux) or Option (macOS) to preview which areas receive sharpening.

Noise Reduction

ControlEffect
LuminanceReduces brightness “grain” and speckle.
Luminance detailHow much fine texture is preserved versus smoothed away.
Luminance contrastKeeps or softens contrast in noisy areas after luminance smoothing.
ColorReduces colored speckles and blotches.
Color detailPreserves or smooths fine color variation.
Color smoothnessHow evenly color noise is blended away.

Color Grading

Three wheelsShadows, Midtones, and Highlights — let you add a color cast to each tonal range. Drag on a wheel: distance from the center sets saturation, and angle sets hue. A readout under each wheel shows the current values.

ControlEffect
BlendingHow smoothly the three zones blend into one another.
BalanceShifts grading influence toward shadows or highlights.

Lens Corrections

ControlEffect
Profile CorrectionsStrength of automatic lens-profile fixes when applicable.
Remove Chromatic AberrationReduces purple/green fringing along high-contrast edges.
Manual DefringeExtra cleanup for remaining color fringe.

Effects

Applied as creative finishing on the cropped image:

ControlEffect
Vignette amountDarkens or lightens the edges of the frame.
Vignette midpointWhere the vignette transition sits between center and edge.
Vignette roundnessMore circular versus more rectangular falloff.
Vignette featherSoftness of the vignette edge.
Highlights priorityHow much bright areas resist being darkened by the vignette.
Grain amountStrength of added film-like grain.
Grain sizeCoarseness of the grain pattern.
Grain roughnessIrregularity and character of the grain.

Optics (Manual)

Manual lens-style adjustments without relying on a profile:

ControlEffect
DistortionCorrects or adds barrel/pincushion bending at the edges.
Lens vignette amountDarkens or lightens corners optically.
Lens vignette midpointHow far from the center the lens vignette begins.
CA Red / CyanShifts red–cyan fringing correction.
CA Blue / YellowShifts blue–yellow fringing correction.

Transform

Changes geometry — perspective, rotation, scale, and position within the frame:

ControlEffect
VerticalTilts the image to correct converging vertical lines (keystoning).
HorizontalTilts to correct converging horizontal lines.
Rotate (°)Rotates the image within the frame.
AspectStretches or compresses width relative to height.
ScaleZooms the image in or out inside the frame.
Offset X / Offset YMoves the image left/right or up/down.

Masking

Masking applies adjustments only where you define a mask. Global sliders still affect the whole image; mask sliders add on top of those values inside the masked area (0 means no extra change there).

Create Mask opens a dialog to pick a mask type:

GroupTypes
GeometryRadial, Linear gradient, Brush
RangeColor range, Luminance range
AutoSubject, Sky, People, Objects (AI-assisted; use Generate AI mask in the drawer when needed)

After creating a mask:

  1. Select it in the list under Masking.
  2. Use the drawer to name the mask, adjust components, and set local edit sliders.
  3. Add to mask adds another component (layer) to the selected mask; choose Add to mask or Subtract from mask when combining.
  4. Edit Mask (for brush, radial, or linear types) lets you adjust the shape on the preview.
  5. Delete mask removes the entire mask and its components.

Mask-specific controls (depend on type):

ControlEffect
Invert componentApplies the opposite of the masked region for that layer.
Density (component)Strength of that mask component (0–100%).
Feather (radial/linear)Softness of the mask edge.
Brush size / hardness / flow / strengthSize, edge softness, build-up rate, and opacity of brush strokes. Erase subtracts from the mask; Clear strokes removes brush strokes.
Hue center / width / falloff (color range)Which colors are selected and how softly the selection fades.
Low / high / falloff (luminance range)Which brightness range is selected.

Relative adjustment sliders in the drawer (exposure, contrast, highlights, shadows, whites, blacks, texture, clarity, dehaze, saturation, vibrance, sharpen amount, noise luminance, temperature, tint) change the photo only inside the mask, added to your global settings.

Mask overlay options help you see the selection: show overlay, color, intensity, and overlay view mode (color on image, color on grayscale, highlight outside selection, or selection only).

On the preview, drag on-image handles for radial gradients, linear gradients, and brush strokes when Edit Mask is active.

Calibration

Fine-tuning of how the app interprets color:

ControlEffect
Shadow TintGreen–magenta balance in shadow regions.
Red / Green / Blue Primary HueShifts where each primary sits on the color wheel.
Red / Green / Blue Primary SaturationHow vivid each primary is rendered.

Tips

  • With the preview focused, ⌘+ / Ctrl+ zooms in and ⌘- / Ctrl- zooms out, similar to many other apps.
  • Hide Edits is handy for a quick before/after on the active photo without changing any settings.
  • Use the histogram zones and tone sliders together: if highlights clip, try Highlights or Whites before pushing Exposure further.