libretui

A terminal UI for visualising Abbott FreeStyle Libre continuous glucose monitor (CGM) data, right in your terminal.

Features

• Live screen — real-time BG reading with large pallet-font value and braille trend arrow, colour-coded by measurement state
• Graph screen — scrolling historical BG graph with high/low threshold lines
• Settings screen — switch between mg/dL and mmol/L; configure alert thresholds
• Single shared poller — one background poll (every 60 s) feeds all screens simultaneously
• Credential storage — login credentials persisted securely via the envsec SDK
• Settings persistence — unit and threshold settings saved to ~/.config/libretui/settings.json

Requirements

• Bun runtime
• An active LibreView account linked to a FreeStyle Libre sensor

Installation

git clone https://github.com/Huulivoide/libretui.git
cd libretui
npm install

Usage

npm start
# or
bun src/index.ts

On first launch you will be prompted to select your LibreView server region, enter your email address and password. Credentials are saved and reused on subsequent launches.

Key bindings

Key	Action
Tab / Shift+Tab	Cycle between Live, Graph and Settings screens
Ctrl+C	Quit

Development

npm run typecheck  # TypeScript type check
npm run lint       # ESLint
npm run format     # Prettier (writes)
npm run build      # Compile to dist/
bun test           # Run tests

License

ISC © Jesse Jaara