terminal newsroom · v0.4.3 · MIT · by nishal.dev

WORLD NEWS

World News CLI is a full-screen terminal news reader for Python. Pick a category, skim headlines, open the story, speak it aloud, or summarize with AI when you want help.

Free on PyPI as worldnews-cli. Runs in Windows Terminal, macOS, and Linux.

$ pip install worldnews-cli && worldnews

Install

Get it running

Needs Python 3.9+. Install the package, then start the app with worldnews or news.

  • pip pip install worldnews-cli
  • pipx pipx install worldnews-cli
  • uv uv tool install worldnews-cli
  • run worldnews
  • module python -m worldnews
  • win py py -m pip install worldnews-cli
  • win run py -m worldnews

Python or pip not on PATH?

On Windows, python and pip often fail with "not recognized" even after install. Use the launcher instead:

  1. Install: py -m pip install worldnews-cli
  2. Run: py -m worldnews

If python works but worldnews does not, Scripts is probably off PATH. Use python -m worldnews (same idea on macOS/Linux).

Permanent fix on Windows: reinstall from python.org and check Add python.exe to PATH, or add your Python Scripts folder to the user PATH in Environment Variables.

  • voice pip install "worldnews-cli[voice]"
  • tech worldnews --category tech
  • offline worldnews --offline
  • version worldnews --version

Mobile

Phones and small screens

This is a terminal app, not a store app. On Android it usually runs inside Termux. On a narrow screen the layout collapses to list-or-reader instead of three panes.

Android (Termux)

  1. Install Termux from its official site or F-Droid (not a random Play Store clone).
  2. Open Termux and run the commands below.
  3. Prefer python -m worldnews if worldnews is missing from PATH.
  • deps pkg update && pkg install python libxml2 libxslt libjpeg-turbo
  • pip pip install worldnews-cli
  • voice pip install "worldnews-cli[voice]"
  • extras pkg install termux-api ffmpeg
  • run python -m worldnews

termux-api helps open links in the system browser. ffmpeg helps some voice playback paths.

iOS and other options

There is no App Store build. On iOS, people sometimes use a-Shell or iSH with Python and pip, but setup is fiddly and packages can fail. A steadier path is SSH (JuiceSSH, ConnectBot, or similar) into a machine that already has worldnews installed.

Limitations

  • Not a native mobile UI. You are in a terminal. Touch works for taps, but the app is keyboard-first.
  • Width changes the layout. Below about 84 columns you get one column at a time. Enter opens the reader; Esc goes back to the list.
  • Complex scripts. Malayalam, Hindi, Arabic, and similar scripts often overlap in cell-grid terminals. Default safe mode hides those glyphs in the TUI; press o to read in a browser, or t to hear the story.
  • Fonts matter. In Termux, install a font that covers the languages you care about (for example Noto). Without that, more characters look broken.
  • Install weight. You need Python plus native libs (libxml2, libxslt, JPEG). First install can take a while on older phones.
  • Battery and data. Fetching feeds uses the network. Speak and AI features add more work when you turn them on.
Columns Layout
100+ Sidebar + list + reader
84-99 List first; Enter opens the reader
under 84 Single column; Enter = reader, Esc = list
under 56 Compact rows and short key hints

Features

Made for reading in a terminal

Keyboard first. Offline cache. Infinite headline pages. Works on wide desktops and phone-width terminals.

  1. 01

    Three panes, one keyboard

    Feeds on the left, headlines in the middle, article on the right. Themes range from Newsroom to High Contrast.

  2. 02

    Hear the piece

    Press t to speak the article. Edge TTS is free by default. Fish Audio, Gemini, and Groq are optional.

  3. 03

    AI when you ask

    Summarize or explain from the action row. The free OpenCode Zen path needs no API key.

  4. 04

    Your own feeds

    Built-in categories (Tech, Anime, AI, and more) plus My Feeds. Paste a site or RSS URL and discovery fills the rest when it can.

Inside the TUI

Feeds, list, reader

The mock below cycles stories the way the live app feels.

worldnews v0.4.3 · ready j/k · enter · t speak

Keys

Home-row controls

A few bindings cover most of the day.

j / k Move in the list
Enter Open article
a / e AI summarize / explain
t Speak (again to stop)
/ Filter headlines
b Bookmark
o Open in browser
s Settings
1–9 Jump category
? Help

FAQ

Quick answers

Straight replies for install, PATH issues, and what the app actually does.