# Custom Emojis

Put your custom PNG files in `png/` and custom GIF files in `gif/`.

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.

For Zhengchen CAM boards, the build selects one subdirectory:

- `CONFIG_ZHENGCHEN_CAM_USE_GIF_EMOJI=y`: use `gif/`
- unset `CONFIG_ZHENGCHEN_CAM_USE_GIF_EMOJI`: use `png/`

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

```bash
idf.py flash
```