support · milkglass

support

support for milkglass, the film simulation darkroom for macOS.

contact

questions, bug reports, feature requests. email hello@miraisoft.io.

i read every message. usually back to you in a day or two.

requirements

  • macOS 14 (Sonoma) or later
  • Apple silicon or Intel Mac
  • a P3-capable display is recommended for accurate film stock previews

getting started

  1. open a photo via File > Open, or drag a RAW or image onto the app
  2. open the Looks panel from the toolbar and pick a film stock
  3. adjust with the other HUDs: tone, white balance, curves, HSL, masks, crop, perspective, effects
  4. save via the Output panel: image file at pixel size or print to paper with soft proofing

supported files

raws and standard image formats:

  • raw: sony (arw), nikon (nef), canon (cr2, cr3), fuji (raf), leica (dng), ricoh (dng), most other cameras Core Image supports
  • standard: open jpeg, heif/heic, tiff, png, webp. export jpeg, png and tiff

saved edits

edits are saved inside milkglass's own library under Application Support, one small record per photo. the original raw or jpeg is never modified, and nothing is written next to it.

if you move or rename a photo on the same drive, milkglass finds its edits again the next time you open it. copying a photo to another drive makes a new file, and a new file starts with no edits. if an older version of milkglass left a .milkglass file beside a photo, the app reads it once on open, moves those edits into its library, and removes the file.

troubleshooting

  • install the latest version from the Mac App Store
  • quit and reopen the app if it gets stuck
  • if a raw won't open, check the format against the list above. milkglass relies on macOS Core Image for raw decoding, so support follows what your version of macOS supports
  • if your edits seem missing after reopening a photo, check whether it was copied rather than moved. a copy is a new file and starts with no edits; the original still has them
  • if the Looks panel is empty, the app bundle is corrupt. delete and reinstall from the Mac App Store
  • if a stock looks washed out or blown, check your display profile in System Settings > Displays > Color
  • if print colors look wrong, check that you've picked a printer profile that matches your paper in Output > Paper

purchases

purchases are processed by Apple through the Mac App Store. miraisoft does not see or store payment information.

  • view or refund through the App Store app > your account > Purchase History
  • or System Settings > Apple ID > Media & Purchases > Manage
  • billing questions go through Apple Support

bug reports

useful detail when reporting a bug:

  • app version (Milkglass > About Milkglass)
  • macOS version (Apple menu > About This Mac)
  • Mac model and chip (M1 / M2 / M3 / M4 / Intel)
  • file format and camera that produced the file, if relevant
  • what happened versus what you expected
  • steps to reproduce, if you can find them

see also

milkglass(1)