LeseflussDocumentation
Guides for the app, website and the ESP32 companion.
ESP32 Build Guide
Lesefluss runs on two ESP32 variants:
1.91" AMOLED display, richer contrast, smaller form factor and better performance. Costs a bit more and requires soldering a JST connector onto the battery if you want to use the same as I did.
ESP32-S3 dev board with an integrated ST7789 LCD. Cheaper and no soldering needed because we can use a bigger battery made for esp32 specifically.
1Ordering parts
Pick a variant and order its board and battery. Case files are printed from the repo - see step 2.
AMOLED variant
- -Board: LilyGO T-Display-S3 AMOLED (ESP32-S3, 1.91" AMOLED)
- -Battery: 3.7 V 500 mAh LiPo, 50×22×5 mm (502248). Most come with a 2 mm JST connector - you'll need to solder on a 1.25 mm JST connector to fit the board.
ST7789 variant
- -Board: ESP32-S3 with integrated ST7789 display
- -Battery: 3.7 V 1000 mAh LiPo, 44×26×12 mm with protection board and JST 1.25 mm connector pre-attached
2Printing the case
Case files are 3MF - open in Bambu Studio, PrusaSlicer, or Orca. PLA works well at 0.2 mm layer height. Print body, cover, and button separately. Supports are not required.
AMOLED case (oled-v1)
ST7789 case (base-v1)
3Flashing the firmware
The setup.sh script erases flash, writes MicroPython, and uploads the Lesefluss code in one go.
- Clone the repo:
git clone https://github.com/sch-28/lesefluss - Make sure you have Python 3 installed and connect the board via USB-C.
- Both firmware binaries ship in
apps/esp32/etc/- the AMOLED build comes from nspsck/RM67162_Micropython_QSPI (upstream MicroPython build for ESP32-S3 + RM67162). No manual download needed. - From
apps/esp32, run:
or./scripts/setup.sh --board AMOLED
The script creates a Python venv, installs./scripts/setup.sh --board ST7789esptool+mpremote, flashes firmware, and uploads the app. - Then you have to make sure the Dev mode is disabled, to do that run:
or./scripts/run.sh --board AMOLED
Open the lesefluss app, device settings, connect, disable the Dev mode and sync it to the esp32../scripts/run.sh --board ST7789
4Assembly
- Gather the printed case parts (body, cover, button) for your variant.
- AMOLED only: solder a 1.25 mm JST connector onto the battery wires and make sure the polarity is correct!
- Plug the battery into the board's JST socket.
- Fit the board into the case body, seat the button, and close with the cover.