Stupid Satellites

Docs

Using Stupid Satellites

Install from the download page — drag the app to Applications on macOS, or run the per-user installer on Windows (no admin needed). Everything below happens on your machine; nothing is uploaded anywhere.

Quick start

  1. Open a photo. Drag it onto the window, click Open…, or double-click a TIFF/DNG via “Open With”. Detection starts immediately — the console shows the scan, the candidate count, and each validated lock as it happens.

    The processing screen: a sweep beam crossing the photo while the console reports scan angle and 9,438 candidates
    The scan in progress. No settings to pick first — processing is automatic.

  2. Review. Every removed trail is a row on the right — satellite or plane icon, σ score, channel, and how many pixels the repair touched. Untick a row to put that trail back (double star? real object?); click 1:1 to inspect it at native resolution. Faint candidates below the auto threshold wait for your call — press + to remove one.

    The review window: before/after divider over the photo, ten removed trails and thirty faint candidates listed on the right
    The review window — this frame had one plane and nine satellites.

  3. Save. Save writes <name>_clean.tif next to the original; Save As… picks a location. 16-bit TIFF, EXIF and colour profile preserved, pixels outside the repairs byte-for-byte identical.

Lightroom Classic round-trip

The app registers itself with Lightroom Classic automatically: the first time you open Stupid Satellites, it drops an external editor preset into Lightroom's preset folder. Restart Lightroom once, and Photo › Edit In › Stupid Satellites is there — no Preferences digging, and it doesn't touch your existing “Additional External Editor” slot (preset files are unlimited; that single slot in Preferences is just Lightroom's UI).

Lightroom Classic's Photo menu open, showing Stupid Satellites in the Edit In submenu
Lightroom Classic after one app launch + Lightroom restart — Stupid Satellites appears under Photo › Edit In.

  1. Select a photo → Photo › Edit In › Stupid Satellites. For raws Lightroom renders a copy with your adjustments; for TIFF/JPEG choose Edit a Copy with Lightroom Adjustments.

  2. The app opens the handed-off TIFF (16-bit ProPhoto RGB, per the preset) and processes it. Review as usual.

  3. Save. The Overwrite original toggle is pre-ticked — the app recognises Lightroom's -Edit naming — so Save writes straight back and the result appears in your catalog, stacked with the original.

Note: Lightroom reads preset files at launch. If Lightroom was open the first time you ran the app, restart Lightroom to see the menu entry. You can re-run the registration any time with stupidsat lightroom-setup (see CLI below).

Manual setup (fallback)

When you need it: the Mac App Store build (sandboxed — it can't write into Lightroom's folder), or a custom configuration.

  1. Lightroom Classic → Preferences → External Editing → Additional External Editor → Choose… and pick the Stupid Satellites app.

  2. Set TIFF, 16 bits, ProPhoto RGB (or your working space), compression None.

  3. In the Preset dropdown pick Save Current Settings as New Preset… and name it “Stupid Satellites”. Saving it as a preset gives it a permanent Photo › Edit In entry without occupying the single slot.

Command line

The same binary drives a CLI — useful for batch work. On macOS use /Applications/Stupid\ Satellites.app/Contents/MacOS/Stupid\ Satellites (alias it to stupidsat); from a source install it's just stupidsat.

stupidsat clean photo.tif             # auto-clean → photo_clean.tif
stupidsat clean photo.tif -o out.tif  # choose the output
stupidsat clean photo.tif --in-place  # overwrite the input
stupidsat detect photo.tif --json out.json   # detection only, no edits
stupidsat gui photo.tif               # open the review UI on a file
stupidsat lightroom-setup             # (re)register the Lightroom preset

# batch: clean every TIFF in a folder
for f in *.tif; do stupidsat clean "$f"; done

What it guarantees

  • 16-bit output; EXIF and colour profile preserved.
  • Pixels outside a repaired trail are byte-for-byte identical.
  • Stars are never invented — subtraction can only remove the trail's light. No AI, nothing generated.
  • No network access; nothing leaves your machine.
Mask view in the review window highlighting exactly which pixels the engine modified
Don't take our word for it — the Mask view shows every pixel the engine touched.

Troubleshooting

“Stupid Satellites” is missing from Photo › Edit In

Restart Lightroom — presets are read at launch. Still missing? If you use Lightroom's “Store presets with this catalog” option, presets live next to your catalog instead of the global folder; run stupidsat lightroom-setup and copy the printed .lrtemplate into <catalog folder>/Lightroom Settings/External Editor Presets/, or use the manual setup above.

I see two entries — “Edit in StupidSatellites…” and “Stupid Satellites”

The first is an old manually-configured Additional External Editor slot; the second is the auto-installed preset. Both work. To drop the old one, open Preferences → External Editing and point the Additional External Editor elsewhere (the preset entry stays).

The result didn't come back into Lightroom

The round-trip relies on saving over the -Edit file Lightroom created. Check the Overwrite original toggle was on when you saved — if you used Save As… to a new name, import that file or use Library → Synchronize Folder.

Lightroom sent an 8-bit file / wrong colour space

That photo went through an old manual slot, not the preset — the auto-installed preset always requests 16-bit ProPhoto TIFF. Use the “Stupid Satellites” entry, or fix the manual slot's settings.

macOS says it can't verify the developer / Windows SmartScreen warns

First-launch trust prompts for fresh downloads — see the support page for the two-click fix on each OS.

Stuck on a frame? The support page has the FAQ and a contact link — real frames make the tool better.