teletext-tui

A terminal-based Swiss teletext viewer with vim-like navigation. Browse teletext pages from Swiss television channels (SRF, RTS, RSI) directly in your terminal.

Features

• Full teletext rendering with proper charset support
• Vim-like keyboard navigation
• Multiple Swiss TV channels (German, French, Italian)
• Page navigation with history (back/forward)
• Subpage support
• Auto-refresh functionality
• Channel switcher overlay
• Interactive help screen

Installation

Install globally via npm:

npm install -g teletext-tui

Usage

Launch the teletext viewer:

teletext

Command Line Options

teletext [options]

Options:
  -c, --channel   Initial channel                                    [choices: "SRF1", "SRFzwei", "SRFInfo", "RTSUn", "RTSDeux", "RSILA1", "RSILA2"] [default: "SRF1"]
  -p, --page      Initial page number                                [number] [default: 100]
  -r, --refresh   Auto-refresh interval in seconds (0 to disable)    [number] [default: 600]
      --help      Show help                                          [boolean]
      --version   Show version number                                [boolean]

Examples

Start with a specific channel and page:

teletext --channel SRFInfo --page 200

Start with auto-refresh disabled:

teletext --refresh 0

Start with 5-minute auto-refresh:

teletext -r 300

Keyboard Commands

Navigation

| Key | Action | | ---------- | ---------------------------------------- | | h or ← | Previous page | | l or → | Next page | | j or ↓ | Next subpage | | k or ↑ | Previous subpage | | g | Go to page 100 (home) | | 0-9 | Enter page number (3 digits to navigate) |

Channels

| Key | Action | | --- | --------------------- | | c | Open channel selector | | [ | Previous channel | | ] | Next channel |

In channel selector:

• j/k or ↓/↑ to navigate
• 1-7 for direct channel selection
• Enter to confirm
• Esc to cancel

History

| Key | Action | | -------- | --------------------- | | Ctrl+O | Go back in history | | Ctrl+I | Go forward in history |

Other

| Key | Action | | --------------- | --------------------------------------- | | r | Refresh current page | | ? | Show help | | Esc | Clear page number input / Close overlay | | q or Ctrl+C | Quit |

Available Channels

• SRF 1 (German)
• SRF zwei (German)
• SRF Info (German)
• RTS 1 (French)
• RTS 2 (French)
• RSI LA 1 (Italian)
• RSI LA 2 (Italian)

Requirements

• Node.js >= 22

License

ISC