LaraPaper (PHP/Laravel)#

LaraPaper is a self-hostable implementation of a TRMNL server (BYOS), built with Laravel. It allows you to manage TRMNL devices, generate screens using native plugins (Screens API, Markup), recipes (130+ from the OSS community catalog, 700+ from the TRMNL catalog, or your own), or the API, and can also act as a proxy for the native cloud service (Core). With over 50k downloads and 200+ stars, it’s the most popular community-driven BYOS.

Key Features#

• 📡 Device Information – Display battery status, WiFi strength, firmware version, and more.
• 🔍 Auto-Join – Automatically detects and adds devices from your local network.
• 🖥️ Screen Generation – Supports Plugins (including Mashups), Recipes, API, Markup, or updates via Code.
  • Support for TRMNL Design Framework
  • Compatible open-source recipes are available in the community catalog
  • Import from the TRMNL community recipe catalog
  • Supported Devices
    • TRMNL OG (1-bit & 2-bit)
    • SeeedStudio TRMNL 7,5" (OG) DIY Kit
    • Seeed Studio (XIAO 7.5" ePaper Panel)
    • reTerminal E1001 Monochrome ePaper Display
    • Custom ESP32 with TRMNL firmware
    • E-Reader Devices
      • KOReader (trmnl-koreader)
      • Kindle (trmnl-kindle)
      • Nook (trmnl-nook)
      • Kobo (trmnl-kobo)
    • Android Devices with trmnl-android
    • Raspberry Pi (HDMI output) trmnl-display
• 🔄 TRMNL API Proxy – Can act as a proxy for the native cloud service (requires TRMNL Developer Edition).
  • This enables a hybrid setup – for example, you can update your custom Train Monitor every 5 minutes in the morning, while displaying native TRMNL plugins throughout the day.
• 🌙 Dark Mode – Switch between light and dark mode.
• 🐳 Deployment – Dockerized setup for easier hosting (Dockerfile, docker-compose).
• 💾 Flexible Database configuration – uses SQLite by default, also compatible with MySQL or PostgreSQL
• 🛠️ Devcontainer support for easier development.

Support ❤️#

This repo is maintained voluntarily by @bnussbau.

Support the development of this package by purchasing a TRMNL device through the referral link: https://trmnl.com/?ref=laravel-trmnl. At checkout, use the code laravel-trmnl to receive a $15 discount on your purchase.

or

GitHub Sponsors

Releated Work#

• bnussbau/laravel-trmnl-blade – Blade Components on top of the TRMNL Design System
• bnussbau/trmnl-pipeline-php – Browser Rendering and Image Conversion Pipeline with support for TRMNL Models API
• bnussbau/trmnl-recipe-catalog – A community-driven catalog of public repositories containing trmnlp-compatible recipes.

License#

MIT