Skip to content
@usetrmnl

TRMNL

Dedicated e-ink screen for the content you care about.

Clarity, at a glance

TRMNL is an e-ink display that connects with popular products and renders their most useful information. We believe this black & white, focused, hands-off approach is the best way to stay informed without getting distracted.

Our proprietary device is available for purchase at https://usetrmnl.com, however we also provide guides to build your own device, install and mod our open source firmware, and even point your own device (or ours) at your own web server for end-to-end privacy.

See the other repositories in this GitHub organization and our API docs (https://docs.usetrmnl.com) to get started.

Hardware

Firmware - the PlatformIO project to drive e-ink displays with ESP32

Mounts - clever 3D-printable mounting solutions, submitted by users

Bring Your Own Server (BYOS)

Terminus - our flagship self-hosted server in Ruby's Hanami framework

BYOS Laravel - a self-hosted server in PHP's Laravel framework

BYOS Node Lite - a lightweight self-hosted server in Node.js

BYOS Next.js - a self-hosted server in Next.js

BYOS Django - a self-hosted server in Python's Django framework

BYOS Phoenix - a self-hosted server in Elixir's Phoenix framework

Plugin Development

Plugins - a collection of community plugins

TRMNLP - a local dev server for rapidly iterating on plugins

TRMNL::I18n - translations for the web app and custom plugins

TRMNL::Liquid - Liquid filters and tags for advanced plugin markup

Miscellaneous

Mockups - high fidelity render templates to share your work

TRMNL::API - a Ruby gem for interacting with the TRMNL API

Docs - the GitBook documentation at docs.usetrmnl.com

Alternative Screens and Clients

Nook - repurpose an old e-reader

Kobo - repurpose an old e-reader

Amazon Kindle - repurpose an old e-reader

Android - use a tablet or phone

iPad - put your dusty old tablet to use

Raspberry Pi - output TRMNL screens directly to HDMI

Mozilla Firefox - see TRMNL content in new tabs

Google Chrome - see TRMNL content in new tabs

Pinned Loading

  1. trmnl-firmware trmnl-firmware Public

    TRMNL e-ink device firmware

    C++ 708 118

  2. plugins plugins Public

    e-ink dashboard plugin logic

    HTML 168 46

  3. byos_hanami byos_hanami Public

    A TRMNL BYOS application.

    Ruby 210 39

  4. mounts mounts Public

    3D printable accessories to mount your device

    84 2

  5. trmnl-i18n trmnl-i18n Public

    web app translations

    Ruby 18 53

  6. byos_laravel byos_laravel Public

    A self-hosted server (BYOS) in PHP's Laravel framework

    PHP 117 25

Repositories

Showing 10 of 33 repositories
  • byos_hanami Public

    A TRMNL BYOS application.

    usetrmnl/byos_hanami’s past year of commit activity
    Ruby 210 MIT 39 3 0 Updated Oct 25, 2025
  • api-docs Public

    powers docs.usetrmnl.com

    usetrmnl/api-docs’s past year of commit activity
    4 5 0 0 Updated Oct 24, 2025
  • byos_laravel Public

    A self-hosted server (BYOS) in PHP's Laravel framework

    usetrmnl/byos_laravel’s past year of commit activity
    PHP 117 MIT 25 2 0 Updated Oct 23, 2025
  • trmnl-firmware Public

    TRMNL e-ink device firmware

    usetrmnl/trmnl-firmware’s past year of commit activity
    C++ 708 GPL-3.0 118 27 10 Updated Oct 23, 2025
  • trmnl-android Public

    Utility to display TRMNL screens on an Android device

    usetrmnl/trmnl-android’s past year of commit activity
    Kotlin 49 MIT 1 9 0 Updated Oct 21, 2025
  • trmnl-i18n Public

    web app translations

    usetrmnl/trmnl-i18n’s past year of commit activity
    Ruby 18 MIT 53 4 1 Updated Oct 16, 2025
  • byos_sinatra Public

    DIY server in Ruby/Sinatra for self hosted screen generation

    usetrmnl/byos_sinatra’s past year of commit activity
    Ruby 144 MIT 29 0 0 Updated Oct 10, 2025
  • trmnl-api Public

    A monadic TRMNL API client.

    usetrmnl/trmnl-api’s past year of commit activity
    Ruby 3 MIT 1 0 0 Updated Oct 8, 2025
  • plugins Public

    e-ink dashboard plugin logic

    usetrmnl/plugins’s past year of commit activity
    HTML 168 46 13 (1 issue needs help) 0 Updated Oct 5, 2025
  • trmnl-kindle Public

    Turn your Kindle into a personal dashboard

    usetrmnl/trmnl-kindle’s past year of commit activity
    Shell 198 MIT 12 8 4 Updated Oct 3, 2025