hansmrtn

hansmrtn / pulp-os

Public

a minimal e-ink os targeting the esp32c3 and xteink x4 e-reader

eink embedded-rust epub no-std xteink-x4
48
2
100% credibility
Found Mar 04, 2026 at 48 stars -- GitGems finds repos before they trend. Get early access to the next one.
Sign Up Free
AI Analysis
Rust
AI Summary

pulp-os is a lightweight custom operating system for the XTEink X4 e-reader that enables efficient TXT and EPUB reading, file browsing, bookmarks, WiFi uploads, and optimized e-paper display control.

How It Works

1
📖 Discover pulp-os

You find pulp-os, a custom operating system that turns your XTEink X4 e-reader into a smooth, battery-saving reading machine with beautiful text and easy book management.

2
💻 Prepare your e-reader

Connect your e-reader to your computer with a USB cable, just like charging it, and get the simple update files ready.

3
âš¡ Update with one click

Use the easy tool to flash the new software onto your device—it takes just a few minutes and feels straightforward.

4
🔥 Boot into your new reader

Your e-reader restarts with crisp black-and-white pages, instant page turns, and a home screen full of your books—everything looks sharper and faster than before.

5
📂 Browse and read books

Navigate files on the SD card, open TXT or EPUB books, jump chapters, add bookmarks, and adjust fonts easily with buttons.

6
📱 Upload new books wirelessly

Connect to WiFi once, then drag books from your phone or computer to pulp.local—your library grows effortlessly.

😊 Enjoy endless reading

Set sleep timers, clear screen ghosts automatically, and read for days on a single charge—your perfect pocket library is ready.

Sign up to see the full architecture

5 more

Sign Up Free

Star Growth

See how this repo grew from 48 to 48 stars Sign Up Free
Repurpose This Repo

Repurpose is a Pro feature

Generate ready-to-use prompts for X threads, LinkedIn posts, blog posts, YouTube scripts, and more -- with full repo context baked in.

Unlock Repurpose
AI-Generated Review

What is pulp-os?

Pulp-os is a bare-metal operating system in Rust for the ESP32-C3-powered XTEink X4 e-reader, turning a cheap e-ink board into a functional device with TXT/EPUB reading, file browsing, 16-slot bookmarks, and WiFi file uploads over a drag-and-drop web UI at pulp.local. It handles partial screen refreshes for snappy page turns, deep sleep at ~8uA total draw, and settings like font sizes or ghost-clear intervals. No std lib or framebuffer – just Embassy async tasks on esp-rtos for a minimal e-ink experience.

Why is it gaining traction?

In a sea of bloated e-reader firmwares, pulp-os shines with its forkable kernel/app design, letting you swap readers or add apps without touching drivers. Rust's no_std safety pairs with clever strip rendering and shared SPI for SD/EPD, delivering smooth performance on 172KB heap. Minimal e-ink fans on Reddit dig the wifi upload and proportional fonts from TTFs, evoking custom minimal e-ink clocks or wallpapers.

Who should use this?

Rust-embedded hackers customizing XTEink X4 boards for personal e-readers. Makers prototyping minimal e-ink phones or qwerty devices. No_std enthusiasts seeking a production-ready base for ESP32-C3 e-paper projects.

Verdict

Grab it if you're into minimal e-ink OS experiments – the README covers building/flashing, but 46 stars and 1.0% credibility signal early-stage maturity without tests or examples. Fork for your pulp osaka build; it's MIT and ready to extend.

(198 words)

Sign up to read the full AI review Sign Up Free

Similar repos coming soon.