# Custom Emojis

Put your custom PNG or GIF files in this directory, or in `png/` and `gif/`
subdirectories.

The filename without extension is used as the emotion name. Directory names are
not part of the emotion name, so `png/neutral.png` is loaded as `neutral`.

The display code looks up images by names such as:

- `neutral.png` or `neutral.gif`
- `happy.png` or `happy.gif`
- `sad.png` or `sad.gif`
- `angry.png` or `angry.gif`
- `thinking.png` or `thinking.gif`
- `confused.png` or `confused.gif`
- `surprised.png` or `surprised.gif`
- `shocked.png` or `shocked.gif`
- `sleepy.png` or `sleepy.gif`
- `relaxed.png` or `relaxed.gif`

Recommended minimum set:

- `neutral`
- `happy`
- `thinking`
- `sad`
- `angry`

If an emotion-specific image is missing, the firmware falls back to `neutral`
before using the built-in icon. Do not add both `png/happy.png` and
`gif/happy.gif`; only one image per emotion should be used.

After adding or replacing files, run a full flash so the assets partition is
updated:

```bash
idf.py flash
```