https://github.com/tsndr/waveshare-epaper-image-converter

Convert GIF to Binary for WaveShare ePaper Displays
https://github.com/tsndr/waveshare-epaper-image-converter

converter eink epaper esp32 image microcontroller waveshare

Last synced: about 1 month ago
JSON representation

Convert GIF to Binary for WaveShare ePaper Displays

• Host: GitHub
• URL: https://github.com/tsndr/waveshare-epaper-image-converter
• Owner: tsndr
• License: mit
• Created: 2021-03-20T01:37:39.000Z (about 4 years ago)
• Default Branch: main
• Last Pushed: 2021-03-20T01:40:32.000Z (about 4 years ago)
• Last Synced: 2025-01-26T05:24:35.535Z (3 months ago)
• Topics: converter, eink, epaper, esp32, image, microcontroller, waveshare
• Language: Python
• Homepage:
• Size: 4.93 MB
• Stars: 5
• Watchers: 2
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# Convert GIF to binary

## Apply color palette using Photoshop

### 1. Create document

Create document with the exact resolution of the screen.

![](screenshots/create_document.png)

### 2. Save for Web (Legacy)

![](screenshots/context.png)

### 3. Select preset

Select `GIF 128 Dithered` preset.

![](screenshots/select_preset.png)

### 4. Load color palette

![](screenshots/load_palette.png)

### 5. Select color palette

The palette files can be found in the `palettes/` folder.

![](screenshots/select_palette.png)

### 6. Save image

Save the image into the `input/` folder.

![](screenshots/save_image.png)

### 7. Convert image

Convert image using this command:

```bash

./convert.py input/[filename].gif

```

### 8. Copy byte array into Arduino project

Copy the `output.c` files content into the Arduino project and upload it to ESP32 (see `examples/` folder).

### 9. Connect screen to ESP32

ePaper | ESP32

------ | -----

VCC    | 3.3V

GND    | GND

DIN    | 14

CLK    | 13

CS     | 15

DC     | 27

RST    | 26

BUSY   | 25

### Sources

[Make BMP file for e-Paper](https://www.waveshare.com/wiki/E-Paper_Floyd-Steinberg)