NanumOS

Photo Retouch (command line)

Portrait retouching with Photoshop's keys, for whole photo sessions.

About this app

Photo Retouch fixes faces in photos: spots, skin, eyes, teeth, light and colour, face shape. In this release it works as the retouch command in the Terminal and as the engine behind the coming window; the editing window comes next.

Basics

A session is one folder per customer visit: raw/ (originals, never touched), edit/ (retouched), export/ (sizes for Google Photos and print), log/ (who retouched what). A preset is one small text file (.rtp) with the steps a store always applies; the same file in every store gives the same look. Everything stays on this Mac; nothing is sent anywhere.

How to use it

  1. Make a session: retouch session new DIR -c CUSTOMER -b BOOKING -g PHOTOGRAPHER -p PRESET.rtp, then copy the photos into DIR/raw.
  2. Run it: retouch session run DIR -u YOURNAME -e google -e print4x6. If it stops (power, crash), run it again: finished photos are skipped.
  3. One photo with your own steps: retouch apply IN.jpg OUT.jpg "spot 1200 800 14" "smooth 6 45 70 30" "curves 3 0 0 128 134 255 255".
  4. Check a preset: retouch preset check FILE.rtp (the id must be the same in every store). retouch profiles lists export sizes.

Try it yourself

Make a session, put three photos in raw/, run step 2, then run it again: the second run says "0 done, 3 skipped". Open log/retouch.tsv to see your name next to each photo.

How it works

Each tool is one text line (smooth 6 45 70 30). The engine works on 256 x 256 tiles so a 24 MP photo never needs a full-size copy, and it writes every file under a temporary name first, so a crash never leaves a half photo. Skin smoothing keeps a share of the pores (texture) and, with skinsel, touches only skin-coloured pixels. A smoothing amount above the preset's max_smooth is lowered and logged as a warning.

FAQ

Does it send my photos anywhere?

No. Photo Retouch works offline; the delivery list in outbox/ only waits for a later delivery step.

Do the keys match Photoshop?

The key model does (J, S, B, [ ], Cmd+Z, pinch to zoom, Space-drag); the window that uses them is still to come.

Are my originals safe?

Yes. raw/ is only read.

NanumOS 0.1.8349 · 2026-11-16