[brand-header]

# 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.
