git404hub

what is tiding fr?

srsatt/tiding — explained in plain English

Analysis updated 2026-05-18

3TypeScriptAudience · developerComplexity · 3/5LicenseSetup · moderate

tl;dr

A self-hosted server for TRMNL e-ink display devices, built to run on small computers like a Raspberry Pi, with AI assisted screen design through MCP.

vibe map

mindmap
  root((repo))
    What it does
      TRMNL device server
      Screen design admin panel
      Data source connections
      AI assisted widget creation
    Tech stack
      TypeScript
      Bun runtime
      SQLite
      MCP
    Use cases
      Self host TRMNL devices
      Design e-ink screens
      Connect JSON data feeds
      Build widgets with AI
    Audience
      Developers
      Raspberry Pi hobbyists
    Setup
      Install Bun
      Bootstrap database
      Set admin PIN

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 make with this?

VIBE 1

Self host a server for TRMNL e-ink display devices instead of using TRMNL's hosted service.

VIBE 2

Design and manage screens, playlists, and data sources through a web based admin panel.

VIBE 3

Connect an AI tool through MCP to create or update screens and widgets automatically.

VIBE 4

Run the server on a small low power computer such as a Raspberry Pi.

what's the stack?

TypeScriptBunSQLiteMCP

how it stacks up fr

srsatt/tiding000madz000/payload-test-api-route-handlerakash-sr/memobsidian
Stars333
LanguageTypeScriptTypeScriptTypeScript
Setup difficultymoderateeasymoderate
Complexity3/52/53/5
Audiencedeveloperdevelopergeneral

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

how do i run it?

Difficulty · moderate time til it works · 30min

Requires the Bun runtime, and a Linux ARM64 system if packaging for an actual Raspberry Pi.

Use freely for any purpose, including commercial use, as long as you keep the copyright and license notice.

in plain english

Tiding is a self-hosted server for TRMNL devices, which are small black-and-white e-ink screens that display things like the weather, news, or calendars. TRMNL normally expects its devices to talk to a server, and this project lets you run that server yourself instead of relying on TRMNL's own hosted service, an approach TRMNL itself calls BYOS, short for build your own server. Tiding is built to run comfortably on small, low power computers such as a Raspberry Pi. The server handles the parts a TRMNL device needs: setting up new devices, sending them the images to display, receiving their logs, and serving firmware. It also includes a web based admin panel where you can manage devices, design screens, set up playlists of different screens, and connect data sources like JSON feeds. A visual screen designer lets you build layouts using reusable building blocks, and the finished screens are rendered into the specific black and white image format the TRMNL hardware expects. One notable feature is an MCP endpoint, which lets AI tools connect to Tiding directly and create or update screens, widgets, and data sources on your behalf, using the same underlying logic as the regular admin interface. This means an AI assistant can build a working screen the same way a person would through the web interface. Getting started requires the Bun JavaScript runtime. You install dependencies, start the server with a couple of environment variables to set an admin PIN and initialize the database, then open a local web address to sign in and set up your first screen and device. Running it on an actual Raspberry Pi means installing Linux built for that ARM64 hardware. The project is explicit that it is still experimental, an independent community effort not affiliated with TRMNL, and recommends backing up your database before trying it. Tiding is released under the Apache License 2.0.

prompts (copy fr)

prompt 1
Help me install and start Tiding on a Raspberry Pi for my TRMNL device.
prompt 2
Set up the admin PIN and MCP token environment variables for a secure Tiding install.
prompt 3
Use the Tiding MCP endpoint to create a new weather widget for my TRMNL screen.
prompt 4
Explain how to connect my TRMNL device to a Tiding server I am running locally.

Frequently asked questions

what is tiding fr?

A self-hosted server for TRMNL e-ink display devices, built to run on small computers like a Raspberry Pi, with AI assisted screen design through MCP.

What language is tiding written in?

Mainly TypeScript. The stack also includes TypeScript, Bun, SQLite.

What license does tiding use?

Use freely for any purpose, including commercial use, as long as you keep the copyright and license notice.

How hard is tiding to set up?

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

Who is tiding for?

Mainly developer.

peek the repo → explain another one

This repo across BitVibe Labs

double-check against the repo, no cap.