DocsGet started

Projects

Edit a photo on the web

Open a photo from Projects, put one of the phone's film looks on it, adjust the light, crop it for the feed and lay words over it. Save to library adds the result as a new item named Edited, and the photo you started from stays as it was.

Projects: editing a photo

Not captured yet

This picture is taken from the running app, not drawn by hand. Run npm run docs:shots to take it.

photo-editor.png

  1. 1Open a photoIn Projects, open a photo and press Edit photo, or select one and press Edit photo in the bar. Upload → Edit a photo opens the editor empty, where you can choose from Projects, pick a file from this computer, or drop one on the window. A file from this computer is saved to the library as the edited copy only.
  2. 2Work through the tabsThe table below says what each tab holds. Every change shows on the photo at once.
  3. 3Check it against the originalHold Hold to compare to see the photo as it opened, framing included. Let go to see your edit.
  4. 4SaveSave to library writes a JPEG into Projects, in the folder that is open if one is. From there, Schedule it opens the composer with the photo attached.
TabWhat it does
LooksAll of the phone's looks, under the same names and in the same packs: Signature (five looks, one for every kind of light), then Film, Warm, Clean, Moody, B&W and Classics. They are the phone's own tables, so a look matches what the phone gives the same photo. Strength sets how much of it you wear: 0 is your photo untouched, 100 is the full look. A color look starts at 80 and black and white at 100, as on the phone.
AdjustExposure, Contrast, Highlights, Shadows and Fade under Light; Saturation, Vibrance, Warmth and Tint under Color; Clarity, Noise, Vignette and Grain under Detail. Noise smooths the grain and color speckle of a dark or high-ISO photo and keeps the edges. The ranges are the phone's. Double-click a slider, or press the small arrow beside it, to put it back.
CropFree, 1:1, 4:5, 3:4, 9:16 or 16:9, with the box draggable by its corners and edges. Turn the shape on its side swaps 4:5 for 5:4. Straighten tilts the photo up to 15 degrees and zooms in just enough that no corner shows paper. Turn left, Turn right and Flip are one press each.
TextAdd text puts a line low on the photo in Instrument Serif Italic. Drag it into place, then change the words, the font (eight faces from the phone's library), size, angle, color and shadow. Several lines can sit on one photo.

Keys

⌘ZUndo. A slider drag or a move of the crop box is one step
⇧⌘ZRedo
⌘SSave to library
SpaceHold on Hold to compare to see the original
←→↑↓Nudge the crop box or the selected text; with ⇧, five times as far
+−Resize the crop box when it is in focus
DeleteTake out the selected text
EscClose; it asks first when there are unsaved edits

The files

WhatSize
Save to libraryA JPEG at most 2,560 pixels on its long edge, like every photo in Projects
Download, JPEG or PNGThe full size the editor worked at, up to 4,096 pixels on the long edge

Photos open at up to 4,096 pixels on the long edge, decoded by the browser away from the page, so a 12 megapixel or larger photo does not freeze it and nothing is refused for being big. Edits are kept as a small recipe beside the saved photo. Open an Edited item in the editor and it comes back with its look, sliders and text still adjustable, on the original.

When something does not go through

WhatWhat happens
A photo only on your phoneThe editor says so. Ask my phone on its tile in Projects sends it, then open it again.
A videoLeft alone: the editor takes photos. Videos open in the video editor on the phone.
A HEIC photo outside SafariMost browsers cannot read HEIC. The editor says so and asks for a JPEG copy, or edit it on the phone.
A look that does not loadThe photo keeps its last look and the line under it says to check your connection and pick it again.
Save does not reach your libraryThe finished photo is kept, with the reason, Try again and Download it instead.
A browser with WebGL 2 offThe editor draws with it, so it says so and points you to another browser or your phone.