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://trmnl.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.trmnl.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 FastAPI - a self-hosted server in Python's FastAPI framework

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

TRMNL::FormBuilder - a WYSIWYG component for plugin form fields

TRMNL::Picker - JavaScript library for managing device models and palettes

TRMNL::PluginLicense - TOS for community plugin development

Miscellaneous

Mockups - high fidelity render templates to share your work

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

TRMNL Companion - iOS application to sync any calendar natively

Docs - the GitBook documentation at docs.trmnl.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

KOReader - repurpose dozens of e-ink devices

iPad - put your dusty old tablet to use

Raspberry Pi - output directly to HDMI or e-ink

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++ 872 162

  2. plugins plugins Public

    e-ink dashboard plugin logic

    HTML 194 52

  3. byos_hanami byos_hanami Public

    The flagship TRMNL BYOS application.

    Ruby 340 77

  4. mounts mounts Public

    3D printable accessories to mount your device

    107 2

  5. trmnl-i18n trmnl-i18n Public

    Locales/translations for plugins and recipes.

    Ruby 21 59

  6. byos_laravel byos_laravel Public

    A self-hosted, community-driven server (BYOS) with Recipe support in PHP's Laravel framework

    PHP 202 51

Repositories

Showing 10 of 43 repositories
  • trmnl-home-assistant Public

    Add-ons and plugins for Home Assistant designed for TRMNL e-ink displays.

    usetrmnl/trmnl-home-assistant’s past year of commit activity
    TypeScript 73 2 7 2 Updated Feb 5, 2026
  • byos_hanami Public

    The flagship TRMNL BYOS application.

    usetrmnl/byos_hanami’s past year of commit activity
    Ruby 340 MIT 77 4 0 Updated Feb 4, 2026
  • trmnl-liquid Public

    Liquid templating engine for TRMNL plugins.

    usetrmnl/trmnl-liquid’s past year of commit activity
    Ruby 11 MIT 3 0 1 Updated Feb 4, 2026
  • byos_laravel Public

    A self-hosted, community-driven server (BYOS) with Recipe support in PHP's Laravel framework

    usetrmnl/byos_laravel’s past year of commit activity
    PHP 202 MIT 51 11 (1 issue needs help) 0 Updated Feb 3, 2026
  • oauth2-providers Public

    Community-maintained OAuth2 provider templates for TRMNL

    usetrmnl/oauth2-providers’s past year of commit activity
    0 MIT 0 0 0 Updated Feb 3, 2026
  • trmnl-firmware Public

    TRMNL e-ink device firmware

    usetrmnl/trmnl-firmware’s past year of commit activity
    C++ 872 GPL-3.0 162 37 7 Updated Feb 3, 2026
  • trmnl-i18n Public

    Locales/translations for plugins and recipes.

    usetrmnl/trmnl-i18n’s past year of commit activity
    Ruby 21 MIT 59 5 1 Updated Feb 3, 2026
  • trmnl-chrome Public

    New Tab Extension for Chrome that displays your current TRMNL screen whenever you open a new tab.

    usetrmnl/trmnl-chrome’s past year of commit activity
    JavaScript 15 2 1 0 Updated Feb 3, 2026
  • trmnl-firefox Public

    New Tab Extension for Firefox that displays your current TRMNL screen whenever you open a new tab.

    usetrmnl/trmnl-firefox’s past year of commit activity
    JavaScript 1 0 1 0 Updated Feb 3, 2026
  • trmnl-form-builder Public

    A JS component for building custom plugin form fields.

    usetrmnl/trmnl-form-builder’s past year of commit activity
    JavaScript 2 MIT 0 1 0 Updated Feb 2, 2026