📰 News TUI

Interactive terminal news browser powered by React and neo-blessed.

┌──────────────────────────────────────────────────────┐
│  1:ALL  2:NEWS  3:TECH  4:BLOGS  5:HN    ✓ Ready    │
├──────────────┬───────────────────────────────────────┤
│ Sources      │  Articles                             │
│ ▸ BBC        │  1. Breaking: Major Event Unfolds     │
│   TOI        │     BBC · 2h ago                      │
│   OpenAI     │  2. New AI Model Released             │
│   GitHub     │     OpenAI · 5h ago                   │
│   HN         │  3. Show HN: My Side Project          │
│              │     Hacker News · 1d ago              │
│              ├───────────────────────────────────────┤
│              │  Preview                              │
│              │  Article summary text appears here... │
├──────────────┴───────────────────────────────────────┤
│ j/k:Nav  Tab:Focus  Enter:Open  /:Search  i:Image  q:Quit │
└──────────────────────────────────────────────────────┘

✨ Features

• Multi-pane layout — sources sidebar, article list, scrollable preview pane
• Bloomberg Terminal view — press v for dense 4-quadrant layout with scrolling ticker
• 4 color themes — Default, Bloomberg (orange/amber), Hacker (green), Dracula (purple) — cycle with t
• 12 built-in feeds across 4 categories (tech / news / blogs / hn)
• Vim-style navigation — j/k, arrow keys, Tab cycles Articles → Sources → Preview
• Live search — press / to filter articles in real-time
• Bookmarks — b to save, persisted to ~/.newsbookmarks.json
• Inline image viewing — press i to view article images directly in terminal (iTerm2, Kitty, chafa, timg)
• Open in browser — Enter or o to launch article URL
• Auto-refresh — feeds refresh every 5 minutes, or press r
• Sort cycling — press s to cycle between time / source / title
• Color-coded sources — each source gets a distinct color
• Relative timestamps — "2h ago", "1d ago" style dates
• Focus indicators — ● shows which pane is active, highlighted borders

🚀 Install

One-liner (bunx — no install needed)

bunx news-tui

Global install

bun install -g news-tui
news-tui

Clone & run locally

git clone https://github.com/yashness/news-tui.git
cd news-tui
bun install
bun start

⌨️ Keyboard Shortcuts

| Key | Action | |-----|--------| | j / ↓ | Next article | | k / ↑ | Previous article | | Tab | Cycle focus: Articles → Sources → Preview | | 1-5 | Switch category (all/news/tech/blogs/hn) | | Enter / o | Open article in browser | | c | Open comments in browser (HN) | | / | Search / filter articles | | Escape | Clear search | | b | Bookmark current article | | i | View article image inline | | r | Refresh feeds | | s | Cycle sort (time → source → title) | | t | Cycle theme (default → bloomberg → hacker → dracula) | | v | Toggle Bloomberg terminal view | | ? | Show help overlay | | q / Ctrl-C | Quit |

📡 Built-in Sources

| Category | Sources | |----------|---------| | News | BBC, Times of India | | Tech | Facebook Eng, Google AI, Netflix, LinkedIn Eng, OpenAI, Spotify Eng, GitHub, Anthropic | | Blogs | WoodFromEden | | HN | Hacker News (with top comments from HN API) |

➕ Custom Sources

Add your own RSS feeds by creating ~/.newsources.json:

[
  { "name": "Ars Technica", "url": "https://feeds.arstechnica.com/arstechnica/index", "category": "tech" },
  { "name": "The Verge", "url": "https://www.theverge.com/rss/index.xml", "category": "news" }
]

Use any category name — new categories auto-appear as tabs (6, 7, etc).

🛠️ Requirements

• Bun ≥ 1.0
• A terminal with Unicode support (iTerm2, Alacritty, Kitty, etc.)

📄 License

MIT