Skip to content
@usetrmnl

TRMNL

An ePaper dashboard for the content you care about.

TRMNL is an ePaper 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 ePaper 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

LaraPaper - 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

Inker - a self-hosted server in TypeScript and React

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 (tiny) collection of open source plugins

TRMNLP - a local dev server for rapidly iterating on plugins

TRMNL Arcade - open infrastructure for turn-based games

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

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

TRMNL::OAuth2Providers - community-maintained authorization templates

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

TRMNL::WordPress - WP gallery to showcase your plugins

BYOD Catalog - DIY hardware quickstart instructions

Docs - the GitBook documentation at docs.trmnl.com

Alternative Screens and Clients

Seeed Studio - turn 5+ DIY kits into a dashboard

Nook - repurpose an old e-reader

Nook Simple Touch - 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 ePaper devices

iPad - put your dusty old tablet to use

Raspberry Pi - output directly to HDMI or ePaper

Inkplate - turn 10+ Inkplate displays into a dashboard

Mozilla Firefox - see TRMNL content in new tabs

Google Chrome - see TRMNL content in new tabs

iOS/macOS Widgets - see TRMNL content on your Apple devices home screen or desktop

ZecTrix Note 4/4C - use a ZecTrix device as TRMNL display

Pinned Loading

  1. trmnl-firmware trmnl-firmware Public

    TRMNL ePaper device firmware

    C 1.2k 249

  2. plugins plugins Public

    e-ink dashboard plugin logic

    HTML 235 66

  3. terminus terminus Public

    The flagship TRMNL BYOS application.

    Ruby 712 135

  4. mounts mounts Public

    3D printable accessories to mount your device

    149 4

  5. trmnl-i18n trmnl-i18n Public

    Localizations for the TRMNL web application, plugins, and Recipes.

    Ruby 22 64

  6. larapaper larapaper Public

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

    PHP 391 79

Repositories

Showing 10 of 54 repositories
  • terminus Public

    The flagship TRMNL BYOS application.

    usetrmnl/terminus's past year of commit activity
    Ruby 712 MIT 135 1 0 Updated Sep 9, 2026
  • trmnl-i18n Public

    Localizations for the TRMNL web application, plugins, and Recipes.

    usetrmnl/trmnl-i18n's past year of commit activity
    Ruby 22 MIT 64 4 2 Updated Sep 9, 2026
  • trmnl-homey-app Public

    Alpha: Homey app that pushes your smart home to a TRMNL e-ink screen

    usetrmnl/trmnl-homey-app's past year of commit activity
    JavaScript 0 MIT 0 0 1 Updated Sep 9, 2026
  • trmnl-firmware Public

    TRMNL ePaper device firmware

    usetrmnl/trmnl-firmware's past year of commit activity
    C 1,163 GPL-3.0 248 58 42 Updated Sep 9, 2026
  • 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 171 16 1 0 Updated Sep 8, 2026
  • trmnl-remarkable Public

    Color TRMNL dashboards on reMarkable Paper Pro with a verified no-terminal Windows installer

    usetrmnl/trmnl-remarkable's past year of commit activity
    Go 16 MIT 2 1 5 Updated Sep 8, 2026
  • trmnlp Public

    a local dev server for building TRMNL plugins

    usetrmnl/trmnlp's past year of commit activity
    Ruby 227 MIT 40 4 0 Updated Sep 7, 2026
  • larapaper Public

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

    usetrmnl/larapaper's past year of commit activity
    PHP 391 MIT 79 13 1 Updated Sep 7, 2026
  • terminalwire-ruby Public Forked from terminalwire/ruby

    RubyGem for Terminalwire

    usetrmnl/terminalwire-ruby's past year of commit activity
    Ruby 0 Apache-2.0 4 0 0 Updated Sep 6, 2026
  • trmnl-liquid Public

    Liquid templating engine for TRMNL plugins.

    usetrmnl/trmnl-liquid's past year of commit activity
    Ruby 15 MIT 6 0 0 Updated Sep 5, 2026