tui-trends

tui-trends

Cyberpunk Google Trends visualizer in your terminal.

Install globally

From npm:

npm install -g tui-trends
tui-trends "buy bitcoin"

From this repo:

npm install
npm run build
npm install -g .
tui-trends "buy bitcoin"

One-off without installing:

npx tui-trends "buy bitcoin"

Usage

# Google Trends (default)
tui-trends "buy bitcoin"

# npm package download trends — no rate limits, great for testing
tui-trends --npm react
tui-trends --npm typescript
tui-trends --npm next

Development

npm install
npm start -- "buy bitcoin"        # runs via tsx, no build step
npm run dev -- "buy bitcoin"      # tsx watch mode, reloads on save
npm start -- --npm react          # npm mode in dev

Keybindings

Key	Action
q	Quit
← →	Cycle through themes

Themes

Cycle through 6 built-in colour themes with ← / →:

#	Name	Vibe
1	Synthwave	Neon cyan & hot pink (default)
2	Matrix	All green on black
3	C64	Commodore 64 blue/white
4	Amber	Phosphor amber monitor
5	Nord	Muted arctic pastels
6	Blood Moon	Deep red & orange

What you'll see

• Loading screen — animated spinner with ASCII art banner while data is fetched
• Line chart — braille-rendered trend line (0–100 index, last 12 months)
• Bar chart — top regions (Google mode) or peak download weeks (npm mode)
• Table — related queries (Google mode) or monthly download breakdown (npm mode)

Stack

• Rezi — TypeScript TUI framework with native C rendering engine
• google-trends-api — unofficial Google Trends client
• tsx — run TypeScript directly

Notes

• Requires Node 18+ (uses native fetch for npm API)
• Google Trends mode hits trends.google.com directly and may rate-limit if called repeatedly
• Use --npm mode for unlimited local testing
• Best displayed in a terminal at least 120 columns wide