explaingit

azw413/ternos

Analysis updated 2026-07-06 · repo last pushed 2026-03-19

103RustAudience · generalComplexity · 4/5MaintainedSetup · moderate

TLDR

TernOS is custom software that turns a pocket-sized e-ink screen into a useful everyday device for reading eBooks and carrying digital wallet items like boarding passes and loyalty cards.

Mindmap

mindmap
  root((repo))
    What it does
      E-ink home screen
      eBook reader
      Digital wallet
      Image viewer
    Tech stack
      Rust
      PalmOS emulation
      Web app converter
      SD card storage
    Use cases
      Read books offline
      Carry boarding passes
      Show loyalty cards
      Run old Palm apps
    Hardware
      XTEink X4
      Physical buttons
      No touchscreen
      Low-power display
    Audience
      E-ink enthusiasts
      Minimalist carriers
      Retro tech fans
      Non-developers
Click or tap to explore — scroll the page freely

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Read eBooks on a pocket-sized e-ink screen without needing a touchscreen.

USE CASE 2

Carry and display boarding passes, loyalty cards, and tickets with QR codes.

USE CASE 3

Browse and view images converted to a compact format for low-power screens.

USE CASE 4

Run classic PalmOS applications on modern e-ink hardware.

What is it built with?

RustWeb appDesktop toolsPalmOS emulator

How does it compare?

azw413/ternosqewer33/ratscadl0ng-ai/papr
Stars1039888
LanguageRustRustRust
Last pushed2026-03-19
MaintenanceMaintained
Setup difficultymoderatemoderateeasy
Complexity4/53/52/5
Audiencegeneraldevelopergeneral

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 30min

Requires compatible e-ink hardware like the XTEink X4 and a computer to convert files before loading them onto the device's SD card.

In plain English

TernOS is custom software that turns a small, pocket-sized e-ink screen into a genuinely useful everyday device. Instead of being locked into a single app, it gives the hardware a home screen, a file browser, an eBook reader, and an image viewer. Its two main goals are letting you read books on the low-power e-ink screen and acting as a wallet to carry around loyalty cards, tickets, and boarding passes. Because e-ink displays are persistent, the screen keeps showing your boarding pass even if the device completely loses power. The software is designed for devices like the XTEink X4, a small reader with physical buttons and no touchscreen. To make content work on this limited hardware, you first convert your files on a regular computer using the project's web app or desktop tools. Images and EPUB books are processed into compact, pre-formatted files that the small device can easily handle. For things like QR codes on boarding passes, the conversion tool can even detect the barcode and re-render it so scanners can read it reliably. Once your files are on the device's SD card, you navigate using the physical buttons to browse your library and open books or images. The reader includes standard features like a table of contents, embedded images, and a resume function that remembers where you left off. The device also has a power-saving sleep mode that kicks in after five minutes of inactivity, leaving your current page or pass on the screen. Beyond just reading, the project is notable because it acts as a general-purpose operating system inspired by the classic PalmOS. It actually emulates the old Palm hardware, meaning it can run decades-old Palm apps. The project is written in Rust and is still actively being developed, with ongoing work to expand its library and finish the native app system. For non-developers, the easiest way to get started is using the web app to flash the firmware and convert files.

Copy-paste prompts

Prompt 1
Using the TernOS project, how do I convert an EPUB file so it works on the XTEink X4 e-ink device?
Prompt 2
How can I add a boarding pass with a QR code to TernOS so it shows reliably on the e-ink screen?
Prompt 3
Explain how to use the TernOS web app to flash firmware and get started with my e-ink reader.
Prompt 4
How does TernOS emulate PalmOS, and can I run old Palm apps on the XTEink X4 device?

Frequently asked questions

What is ternos?

TernOS is custom software that turns a pocket-sized e-ink screen into a useful everyday device for reading eBooks and carrying digital wallet items like boarding passes and loyalty cards.

What language is ternos written in?

Mainly Rust. The stack also includes Rust, Web app, Desktop tools.

Is ternos actively maintained?

Maintained — commit in last 6 months (last push 2026-03-19).

How hard is ternos to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is ternos for?

Mainly general.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.