Setting Peashell as your default image editor

Peashell can open image files directly when you double‑click them — but first you need to tell your operating system to use Peashell for those file types. macOS and Windows each handle this a little differently. Pick your platform below.

Peashell can be the default for these image types:

PNG · JPEG (JPG) · WebP · GIF · BMP · SVG · PSD


macOS

macOS sets the default app per file type, so you choose Peashell once for each kind of image you want it to own (for example, once for PNG, once for JPEG, and so on).

  1. In Finder, find any file of the type you want — say a .png image.
  2. Click it once to select it, then press ⌘ I (or right‑click → Get Info).
  3. In the Info window, click the triangle next to “Open with” to expand that section.
  4. Open the pop‑up menu and choose Peashell.
    • If Peashell isn’t listed, choose Other…, then select Peashell in your Applications folder. If it appears greyed out, set the Enable menu at the bottom of that dialog to Recommended Applications (or All Applications).
  5. Click Change All… — this is the important step. It makes every file of that type open in Peashell, not just the one you selected. Confirm when prompted.
  6. Repeat for any other image types you want Peashell to handle (JPEG, WebP, GIF, BMP, SVG, PSD).

Tip: Make sure Peashell is in your Applications folder and that you’ve opened it at least once. macOS only offers an app as a default after it has seen it run.

If Peashell was just downloaded

The first time you open a downloaded app, macOS may show a Gatekeeper prompt:

  • macOS 14 (Sonoma) and earlier: right‑click (Control‑click) Peashell → Open → Open again.
  • macOS 15 (Sequoia) and later: double‑click, then go to System Settings → Privacy & Security, scroll down, and click Open Anyway.

Once it has opened successfully, it will appear in the “Open with” list above.


Windows

The easiest way is from inside Peashell:

  1. Click the ⚙ gear icon in the Peashell toolbar.
  2. Peashell registers itself as an image handler and opens Windows Settings → Default apps.
  3. Find the file type (e.g. .png) and choose Peashell.

You can also do it manually at any time:

  1. Open Settings → Apps → Default apps.
  2. Search for the file type (for example, type .png) or scroll to Choose defaults by file type.
  3. Select Peashell for each image type you want it to open.

Note: Windows 11 requires you to confirm the default for each file type yourself — apps aren’t allowed to set it silently. So you’ll pick Peashell once per extension.


Troubleshooting

Peashell doesn’t appear in the list (macOS). Make sure Peashell is in your Applications folder and has been launched once, then try again. Relaunching Finder (or logging out and back in) refreshes the list.

Double‑clicking still opens my old editor. On macOS, make sure you clicked Change All… — just choosing Peashell in the menu only changes that single file. On Windows, confirm you selected Peashell under Default apps for that specific file type.

I want different apps for different image types. That’s fine — both macOS and Windows track the default per file type, so you can set Peashell for some (say PNG and PSD) and leave others on another app.